Access Key

If you intend to use CLI or API for accessing your data on EOS then you will need to define bucket permissions.

Customers can create access keys using Manage Access Keys and using Permission tab

Create access key

You can create access key from Permissions tab on Bucket details page or Manage access page.

../../_images/Access_01.png
  1. Enter a name for your access key. This can be an application name, project name or a team member name.

  2. Click Generate Key.

  3. If all goes well, you will see newly generated access and secret keys

  4. Keep a note of both these keys as you will not see them again after you close the modal window.

  5. If you have mc setup then use the given command to configure CLI for this access key.

Hint

Choose a short name for access key as you will be entering this for each command that you type in CLI.

Manage Access

Sometimes you may need to disable access for certain users or target applications. The way to do that is to lock their access key from manage access page.

../../_images/Access_06.png
  1. Go to Products > Storage Storage option in the sidebar menu

  2. Click Manage Access Key

  3. Identify the access you want to lock using key name

  4. Click lock icon as desired

To unlock, follow the same steps above except this time you will see an unlock icon instead of lock.

Using Manage Access Key

Using Manage access key you need to click on Manage Access Keys button.

../../_images/Access_02.png ../../_images/Access_03.png ../../_images/Access_05.png ../../_images/Access_07.png ../../_images/Access_08.png

Actions in Manage Access Key

Customers can perform two actions in Access key is Lock, Unlock and Delete

../../_images/Access_09.png ../../_images/Access_10.png ../../_images/Access_11.png ../../_images/Access_12.png ../../_images/Access_13.png
  1. Go to Products > Storage Storage option in the sidebar menu

  2. Choose any bucket or create a new one.

  3. Click the permission tab, it will be opened for the selected bucket.

  4. Click the Create access key button.

  5. Enter a name for your access key. This can be an application name, project name or a team member name.

  6. Choose an access key or Create access key.

  7. Assign a role:

    bucket admin

    can read, write, manage

    bucket writer

    can read, write

    bucket reader

    can read

../../_images/Access_14.png ../../_images/Access_15.png ../../_images/Access_16.png ../../_images/Access_17.png ../../_images/Access_18.png

Public Access Config

Usin Public access config we give the permissions of Upload, Download, Upload & Dowload and Private for the objects using URL. For Enable this you need to click on Public Access Config button and select permission which you want give.

../../_images/Access_19.png ../../_images/Access_20.png ../../_images/Access_21.png ../../_images/Objectstorage33.png ../../_images/Access_22.png

Protect Your Bucket Data With Encryption

Introduction:- The procedure on this page configures and enables Server-Side Encryption with Client-Managed Keys (SSE-C). EOS SSE-C supports client-driven encryption of objects before writing the object to the drive. Clients must specify the correct key to decrypt objects for read operations.

Prerequisite:

1) Generate the Encryption Key

First of all an encryption key is required. You can generate the encryption using the following command:

cat /dev/urandom | head -c 32 | base64 -
  • It is important to notice that a 256-bit base64-encoded string should be used.

  • Save the encryption key for future references.

2) Encrypt And Copy Object into Bucket Using Encryption Key

To encrypt an object using the mc client, refer to the following command

 mc cp ~/source_path/my_object.json ALIAS/BUCKET/my_object.json \
--encrypt-key "ALIAS/BUCKET/=ENCRYPTION_KEY"
  • Replace ALIAS with the key_name used while configuring the mc client on which you want to write the SSE-C encrypted object.

  • Replace BUCKET with the full path to the bucket or bucket prefix to which you want to write the SSE-C encrypted object.

  • Replace ENCRYPTION_KEY with the key generated in the first step.

3) Copy an SSE-C Encrypted Object Between Two Bucket

EOS also supports the copying an SSE-C encrypted object to another S3-compatible service:

 mc cp SOURCE/BUCKET/mydata.json TARGET/BUCKET/mydata.json  \
--encrypt-key \
 "SOURCE/BUCKET/=ENCRYPTION_KEY","TARGET/BUCKET/=ENCRYPTION_KEY"
  • Replace ALIAS with respecting key_name used while configuring the mc client on which you want to read and write the SSE-C encrypted object.

  • Replace source and destination BUCKET with the full path to the bucket or bucket prefix on which you want to read and write the SSE-C encrypted object.

  • Replace ENCRYPTION_KEY with the key generated in the first step.

Considerations:

  • SSE-C encrypted objects are not compatible with the EOS bucket replication feature.

  • User manage a mapping of which encryption key was used to encrypt which object. E2E does not store encryption keys. You are responsible for tracking which encryption key you provided for which object.

  • If your bucket is versioning-enabled, each object version that you upload by using this feature can have its own encryption key. You are responsible for tracking which encryption key was used for which object version.

  • For downloading an encrypted object encryption key is required, if the user loses the key then he can not download the data, and his data will be lost. In this case E2E is not responsible for the loss of your data.

References: