Skip to content

Commit

Permalink
Updated Dropbox article, removed rkvst from scitt-receipts and update…
Browse files Browse the repository at this point in the history
…d the Golden Thread image (#723)

Signed-off-by: pcnorth <120174435+pcnorth@users.noreply.github.com>
  • Loading branch information
pcnorth committed Dec 5, 2023
1 parent f0981fc commit 0863ff9
Show file tree
Hide file tree
Showing 11 changed files with 25 additions and 12 deletions.
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file not shown.
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file not shown.
33 changes: 23 additions & 10 deletions content/platform/administration/dropbox-integration/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -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.**<br>
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 <em>xxx...</em> 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.<br>
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 <em>xxx...</em> 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.<br>
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="<em>Settings</em>" class="border-0">}}
1. Select **Dropbox** and then **Proceed**.
{{< img src="DropboxProceed.png" alt="Dropbox Integration" caption="<em>Proceed</em>" 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.<br>If you are not logged in then Dropbox will ask you to authenticate.
{{< img src="DropboxAuth.png" alt="Dropbox Integration" caption="<em>Log in to Dropbox</em>" 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="<em>Select Allow</em>" class="border-0">}}
{{< img src="DropboxDataTrailsAllow.png" alt="Dropbox Integration" caption="<em>Select Allow</em>" 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="<em>Select folder and Confirm</em>" class="border-0">}}
1. You will see a success message. Dropbox will be connected and the selected folders will be linked.
Expand All @@ -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="<em>File icon on the right</em>" class="border-0">}}
{{< img src="DataTrailsDisconnect.png" alt="Dropbox Integration" caption="<em>File icon on the right</em>" 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="<em>Reconfigure folders and Confirm</em>" class="border-0">}}

Expand All @@ -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="<em>Disconnect Dropbox</em>" class="border-0">}}
{{< img src="DataTrailsDisconnect.png" alt="Dropbox Integration" caption="<em>Disconnect Dropbox</em>" class="border-0">}}
You will see a warning message.
{{< img src="DisconnectWarning.png" alt="Dropbox Integration" caption="<em>Disconnect Warning</em>" 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.
Expand Down
Binary file modified content/platform/overview/core-concepts/TheGoldenThread.png
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
4 changes: 2 additions & 2 deletions content/platform/overview/scitt-receipts/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -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}
```

0 comments on commit 0863ff9

Please sign in to comment.