Skip to content

Commit

Permalink
replaced outdated access grant creation with partial (#297)
Browse files Browse the repository at this point in the history
* replaced outdated access grant creation with partial
* moved warning about passphrase to the partial
  • Loading branch information
AlexeyALeonov authored Oct 25, 2023
1 parent 08457f6 commit 9574b30
Show file tree
Hide file tree
Showing 2 changed files with 11 additions and 44 deletions.
46 changes: 2 additions & 44 deletions app/dcs/third-party-tools/filezilla/filezilla-native/page.md
Original file line number Diff line number Diff line change
Expand Up @@ -23,7 +23,7 @@ The native integration uses [](docId:Pksf8d0TCLY2tBgXeT18d) for your object data
This is the only integration available for the **free version of Filezilla**. If you wish to use the Hosted Gateway MT you will need the [](docId:APk9353kCNcg5PKRPQ06u)
{% /callout %}

The**_ FileZilla_** Client is a fast and reliable cross-platform (Windows, Linux, and Mac OS X) FTP, FTPS, and SFTP client with many useful features and an intuitive graphical user interface.
The **_ FileZilla_** Client is a fast and reliable cross-platform (Windows, Linux, and Mac OS X) FTP, FTPS, and SFTP client with many useful features and an intuitive graphical user interface.

It includes a site manager to store all your connection details and logins, as well as an Explorer-style interface that shows the local and remote folders and can be customized independently.

Expand All @@ -35,49 +35,7 @@ With the launch of the native Storj DCS Integration into the FileZilla client, d

## Create an Access Grant

Navigate to the [](docId:b4-QgUOxVHDHSIWpAf3hG) page within your project and then click on **Create S3 Credentials**. A modal window will pop up where you should enter a name for this access grant.

![](https://link.storjshare.io/raw/jua7rls6hkx5556qfcmhrqed2tfa/docs/images/QNJWifIV1LD34MT6toKSc_s3-credentials.png)

![](https://link.storjshare.io/raw/jua7rls6hkx5556qfcmhrqed2tfa/docs/images/_98VnssVr5Qa2Qa_fQ0t__s3-credentials-2.png)

{% callout type="info" %}
If you click **Encrypt My Access**, our client-side javascript will finalize your access grant with your encryption passphrase. Your data will remain end-to-end encrypted until you explicitly register your access grant with [](docId:AsyYcUJFbO1JI8-Tu8tW3) for S3 compatibility. Only then will your access grant be shared with our servers. Storj does not know or store your encryption passphrase.

However, if you are still reluctant to enter your passphrase into our web application, that's completely understandable, and you should cancel creation of Access Grant in Web UI, select **Create Keys for CLI** and follow these [](docId:OXSINcFRuVMBacPvswwNU).

**The instructions below assume you selected Encrypt My Access.**
{% /callout %}

Assign the permissions you want this access grant to have, then click on **Encrypt My Access**:

![](https://link.storjshare.io/raw/jua7rls6hkx5556qfcmhrqed2tfa/docs/images/VDkm74BA40yFm9o4nT1Qf_s3-credentials-3.png)

Select a **Passphrase** type: Either **Enter** your own **_Encryption Passphrase_** or **Generate** a 12-Word **_Mnemonic Passphrase_**. Make sure you **save your encryption passphrase** as you'll not be able to reset this after it's created.

**Enter the Encryption Passphrase** you used for your other access grants. If this is your first access grant, we strongly encourage you to use a mnemonic phrase as your encryption passphrase (The GUI automatically generates one on the client-side for you.)

![](https://link.storjshare.io/raw/jua7rls6hkx5556qfcmhrqed2tfa/docs/images/cjkC2NEfDvsUmM-CjmmWp_s3-credentials-4.png)

{% callout type="warning" %}
**This passphrase is important!** Encryption keys derived from it are used to encrypt your data at rest, and your data will have to be re-uploaded if you want it to change!

Importantly, if you want two access grants to have access to the same data, **they must use the same passphrase**. You won't be able to access your data if the passphrase in your access grant is different than the passphrase you uploaded the data with.

Please note that **Storj does not know or store your encryption passphrase**, so if you lose it, you will not be able to recover your files.
{% /callout %}

Click either on the** Copy to clipboard** link or **Download .txt **and then confirm that you copied your Encryption Phrase to a safe place.

![](https://link.storjshare.io/raw/jua7rls6hkx5556qfcmhrqed2tfa/docs/images/cRptNujhW_fS5JN-PuxQ9_s3-credentials-5.png)

Click the **Create my Access** link to finish generating of Access Grant.

![](https://link.storjshare.io/raw/jua7rls6hkx5556qfcmhrqed2tfa/docs/images/dqRiMbrR6WZPxAD8SQehA_s3-credentials-6.png)

{% callout type="danger" %}
Please note that Storj does not know or store your encryption passphrase, so if you lose it, you will not be able to recover your files. Please store it in a safe place.
{% /callout %}
{% partial file="create-access-grant.md" /%}

## Downloading FileZilla

Expand Down
9 changes: 9 additions & 0 deletions src/markdoc/partials/create-access-grant.md
Original file line number Diff line number Diff line change
Expand Up @@ -42,6 +42,15 @@ Create Access Grant in the Storj Console:

![](https://link.storjshare.io/raw/jua7rls6hkx5556qfcmhrqed2tfa/docs/images/Uxn8zBqXQVmQvsswV3pJ2_image.png)


{% callout type="warning" %}
**This passphrase is important!** Encryption keys derived from it are used to encrypt your data at rest, and your data will have to be re-uploaded if you want it to change!

Importantly, if you want two access grants to have access to the same data, **they must use the same passphrase**. You won't be able to access your data if the passphrase in your access grant is different than the passphrase you uploaded the data with.

Please note that **Storj does not know or store your encryption passphrase**, so if you lose it, you will not be able to recover your files.
{% /callout %}

6. Click **Create Access** to finish creation of your S3 credentials

7. Click **Confirm** the Confirm details pop-up message
Expand Down

0 comments on commit 9574b30

Please sign in to comment.