diff --git a/content/platform/administration/dropbox-integration/DataTrailsDisconnect.png b/content/platform/administration/dropbox-integration/DataTrailsDisconnect.png new file mode 100644 index 000000000..967f6004a Binary files /dev/null and b/content/platform/administration/dropbox-integration/DataTrailsDisconnect.png differ diff --git a/content/platform/administration/dropbox-integration/DropBoxAuth.png b/content/platform/administration/dropbox-integration/DropBoxAuth.png index 83cc41422..f40f4b98a 100644 Binary files a/content/platform/administration/dropbox-integration/DropBoxAuth.png and b/content/platform/administration/dropbox-integration/DropBoxAuth.png differ diff --git a/content/platform/administration/dropbox-integration/DropBoxConnected.png b/content/platform/administration/dropbox-integration/DropBoxConnected.png index d3fbe7e90..f39d822e3 100644 Binary files a/content/platform/administration/dropbox-integration/DropBoxConnected.png and b/content/platform/administration/dropbox-integration/DropBoxConnected.png differ diff --git a/content/platform/administration/dropbox-integration/DropBoxDisconnectApp.png b/content/platform/administration/dropbox-integration/DropBoxDisconnectApp.png index 921c639a7..bab8f6538 100644 Binary files a/content/platform/administration/dropbox-integration/DropBoxDisconnectApp.png and b/content/platform/administration/dropbox-integration/DropBoxDisconnectApp.png differ diff --git a/content/platform/administration/dropbox-integration/DropBoxRKVSTAllow.png b/content/platform/administration/dropbox-integration/DropBoxRKVSTAllow.png deleted file mode 100644 index fc0fb5803..000000000 Binary files a/content/platform/administration/dropbox-integration/DropBoxRKVSTAllow.png and /dev/null differ diff --git a/content/platform/administration/dropbox-integration/DropBoxStart.png b/content/platform/administration/dropbox-integration/DropBoxStart.png index 0d1fff925..16f065f20 100644 Binary files a/content/platform/administration/dropbox-integration/DropBoxStart.png and b/content/platform/administration/dropbox-integration/DropBoxStart.png differ diff --git a/content/platform/administration/dropbox-integration/DropboxDataTrailsAllow.png b/content/platform/administration/dropbox-integration/DropboxDataTrailsAllow.png new file mode 100644 index 000000000..213529a95 Binary files /dev/null and b/content/platform/administration/dropbox-integration/DropboxDataTrailsAllow.png differ diff --git a/content/platform/administration/dropbox-integration/RKVSTDisconnect.png b/content/platform/administration/dropbox-integration/RKVSTDisconnect.png deleted file mode 100644 index bf98b7e2d..000000000 Binary files a/content/platform/administration/dropbox-integration/RKVSTDisconnect.png and /dev/null differ diff --git a/content/platform/administration/dropbox-integration/index.md b/content/platform/administration/dropbox-integration/index.md index 250315855..e313e3bce 100644 --- a/content/platform/administration/dropbox-integration/index.md +++ b/content/platform/administration/dropbox-integration/index.md @@ -15,29 +15,42 @@ toc: true ## The Dropbox Integration -This integration allows you to connect your DataTrails tenancy directly with Dropbox to automatically add provenance to your files and create an immutable audit trail. +This integration allows you to connect your DataTrails tenancy directly with Dropbox to automatically record and maintain the provenance metadata of your files in an immutable audit trail. -During the set up process you will select which Dropbox folders will be linked to DataTrails. Any files found in the linked folders, and their subfolders, will always be added to your DataTrails tenancy as a **public** [Document Profile Asset](/developers/developer-patterns/document-profile/). These assets can be verified using [Instaproof](/platform/overview/instaproof/). +DataTrails uses transparent and auditable distributed ledger technology to maintain an immutable trail of provenance metadata independent of, but in concert with, the original file in Dropbox. +The original data never enters the DataTrails system and remains on Dropbox. +The provenance metadata that is recorded in the immutable audit trail can be shared and verified globally completely independently of the data itself. This increases the scope for efficient and transparent collaboration without changing the risk profile of the data. -From then on, each time a new file is created a corresponding asset will also be created on DataTrails and any modifications to an existing file will be registered as a [Publish Event](/developers/developer-patterns/document-profile/#publish-event) on the correct asset. +During the set up process you will select which Dropbox folders will be linked to DataTrails. A provenance metatdata record will be created on your DataTrails tenancy for every file found within a linked folder. It will be created as a [Document Profile Asset](/developers/developer-patterns/document-profile/) which can be verified using [Instaproof](/platform/overview/instaproof/). -{{< note >}} -**Note:** DataTrails will **never** upload a copy of the file. +From then on, each time a new file is created in a linked folder, a corresponding provenance metadata record will be created on DataTrails. Any modifications to a file in a linked folder will be recorded as a [Publish Event](/developers/developer-patterns/document-profile/#publish-event) in the provenance metadata record for that file. +The result is that the auditable provenance record for your files begins at the moment that you link a folder and that an immutable audit trail for each file automatically grows as the files are modified. + +**A note on subfolders.**
+During configuration, when you link a folder in the UI we will automatically link any subfolders too. Similarly, if you unlink a folder in the UI we will automatically unlink any subfolders. + +If you create a subfolder in Dropbox after the integration has been set up it will be automatically added to the linked folder list. If you delete a subfolder or move it to an unlinked location it will be automatically removed from the linked folder list. + +You are free, at any time, to link and unlink a folder at all levels of your folder tree using the instructions at [Editing the list of Linked folders](/platform/administration/dropbox-integration/#editing-the-list-of-linked-folders) -DataTrails uses xxx... to mask the file name and file path in the UI. This is intentional so that private information cannot be accidentally released via the Instaproof search results and because DataTrails is not intended to replace the excellent file management functionality that is provided by Dropbox.
+Please also see our [FAQ](https://support.datatrails.ai/hc/en-gb/articles/14378210620562-Dropbox-File-and-Folder-Management-FAQ) for more information. + + +{{< note >}} +**Note**: DataTrails uses xxx... to mask the file name and file path in the UI. This is intentional so that private information cannot be accidentally released via the Instaproof search results and because DataTrails is not intended to replace the excellent file management functionality that is provided by Dropbox.
Knowledge of the filename is not needed to prove provenance because Instaproof will attest and verify the content of a file even if the filename has been changed. {{< /note >}} ### Connecting DataTrails to Dropbox -1. Select **Settings** from the side bar and then the **Integrations** tab +1. Select **Settings** or **Integrations** from the side bar and then the **Integrations** tab {{< img src="DropboxStart.png" alt="Dropbox Integration" caption="Settings" class="border-0">}} 1. Select **Dropbox** and then **Proceed**. {{< img src="DropboxProceed.png" alt="Dropbox Integration" caption="Proceed" class="border-0">}} If you are already logged into Dropbox on the device that you are using to set up the integration then you will proceed directly to step 3.
If you are not logged in then Dropbox will ask you to authenticate. {{< img src="DropboxAuth.png" alt="Dropbox Integration" caption="Log in to Dropbox" class="border-0">}} 1. DataTrails now asks for permission to see metadata for your files and folders. Click **Allow** to give DataTrails permission to access your Dropbox Folders. -{{< img src="DropboxRKVSTAllow.png" alt="Dropbox Integration" caption="Select Allow" class="border-0">}} +{{< img src="DropboxDataTrailsAllow.png" alt="Dropbox Integration" caption="Select Allow" class="border-0">}} 1. Select the Dropbox folder that you wish to link to DataTrails and then click **Confirm**. The contents of this folder and *all its subfolders* will be added to DataTrails as public Document Profile Assets. {{< img src="DropboxConfirm.png" alt="Dropbox Integration" caption="Select folder and Confirm" class="border-0">}} 1. You will see a success message. Dropbox will be connected and the selected folders will be linked. @@ -52,7 +65,7 @@ Click on an icon on the right to edit the connection or to disconnect. ### Editing the list of Linked folders 1. Select the File icon in DataTrails -{{< img src="RKVSTDisconnect.png" alt="Dropbox Integration" caption="File icon on the right" class="border-0">}} +{{< img src="DataTrailsDisconnect.png" alt="Dropbox Integration" caption="File icon on the right" class="border-0">}} 1. You will see the list of available folders. Select a folder to link or deselect a folder to unlink and then click **Confirm** {{< img src="DropboxConfirm.png" alt="Dropbox Integration" caption="Reconfigure folders and Confirm" class="border-0">}} @@ -61,7 +74,7 @@ Click on an icon on the right to edit the connection or to disconnect. To disconnect DataTrails and Dropbox you have the option to disconnect using both applications. 1. Select the Disconnect icon in DataTrails -{{< img src="RKVSTDisconnect.png" alt="Dropbox Integration" caption="Disconnect Dropbox" class="border-0">}} +{{< img src="DataTrailsDisconnect.png" alt="Dropbox Integration" caption="Disconnect Dropbox" class="border-0">}} You will see a warning message. {{< img src="DisconnectWarning.png" alt="Dropbox Integration" caption="Disconnect Warning" class="border-0">}} This means that this specific tenancy will no longer be used for provenance. You would do this if you no longer want to use a connected tenancy while continuing to use other connected tenancies. diff --git a/content/platform/overview/core-concepts/TheGoldenThread.png b/content/platform/overview/core-concepts/TheGoldenThread.png index b3b9d94f0..e3a036ea9 100644 Binary files a/content/platform/overview/core-concepts/TheGoldenThread.png and b/content/platform/overview/core-concepts/TheGoldenThread.png differ diff --git a/content/platform/overview/scitt-receipts/index.md b/content/platform/overview/scitt-receipts/index.md index 2bbc3403d..e19a881f7 100644 --- a/content/platform/overview/scitt-receipts/index.md +++ b/content/platform/overview/scitt-receipts/index.md @@ -102,8 +102,8 @@ The transaction_id is available once the event has been committed to the blockch | jq -r .stateRoot) ``` -1. Finally, use the `rkvst_receipt_scittv1` command to verify the receipt offline at any time. +1. Finally, use the `datatrails_receipt_scittv1` command to verify the receipt offline at any time. ```bash - echo ${RECEIPT} | rkvst_receipt_scittv1 verify -d --worldroot ${WORLDROOT} + echo ${RECEIPT} | datatrails_receipt_scittv1 verify -d --worldroot ${WORLDROOT} ```