S-Drive Authentication and Bucket Settings
On this page you can see your Bucket names, IDs Regions, File Level Encryption settings, FIPS enablement and Version settings. You can update/re-authenticate your credentials, and configure your Buckets, Bucket Folders, Metadata, and Multiple Bucket Settings.
![image-20240422-202852.png](../__attachments/2134606736/image-20240422-202852.png?inst-v=45374f53-f4b0-4a30-83dc-edc14e9d1f8c)
There are several features you can configure from this page.
Upload Amazon S3 Credentials (Access Key, Secret Key) and Bucket Configurations
This is where you can change your AWS credentials and manage your buckets.
Clicking Configure takes you to this page
![](../__attachments/2134606736/image-20220209-220446.png?inst-v=45374f53-f4b0-4a30-83dc-edc14e9d1f8c)
Enter your Access Key and Secret Key to be able to manage your bucket configurations and add new buckets
![](../__attachments/2134606736/image-20220209-220910.png?inst-v=45374f53-f4b0-4a30-83dc-edc14e9d1f8c)
Add buckets by choosing Use existing bucket or Create a new bucket
![](../__attachments/2134606736/image-20220209-191636.png?inst-v=45374f53-f4b0-4a30-83dc-edc14e9d1f8c)
Bucket Name: Amazon bucket name used for S-Drive is displayed here.
Bucket Id: Ttext field up to 40 characters and must be unique among all your buckets. This Id will be used in the bucket field you set up on the file object. For example, if your bucket field is a picklist, the picklist values need to be the bucket ids. The bucket id can be the same as the bucket name.
File Upload Encryption Type: Encryption used when files are uploaded to your S3 bucket. This can be the same type of encryption as configured in AWS for your bucket (see Configuring Encryption below) or can be different, which will override the setting in your bucket. You can also choose to use the same encryption as the bucket. The Encryption options are:
S3-Managed Keys (SSE-S3) (default)
AWS Key Managment Service (SSE-KMS)
Use same encryption as S3 bucket (not recommended if bucket is not encrypted)
Click Check Remote Site Settings and follow the instructions. When that is complete, check Configure New Amazon S3 Bucket to complete the configuration.
See Multi-Bucket Support for information about how to use multiple buckets.
Bucket Folder Configuration
Clicking the “Configure” button will take you to a page where you can configure Bucket Folders for each file object. Bucket Folders allow you to control where files are stored in your AWS bucket.
See Bucket Folders under Advanced Features for information on this feature and how to configure it.
Metadata Configuration
Clicking the “Configure” button will take you to a page where you can define metadata for each file object. Metadata is extra data stored with the file in your AWS bucket. For more information about metadata in AWS, see AWS’s Working with Metadata help page.
For information about configuring Metadata in S-Drive, see User-defined Metadata for how to configure this feature.
Multiple Bucket Settings
Clicking the “Configure” button will take you to a page where you can enable Multi-Bucket support for each object. See Multi-Bucket Support for more information.
S-Drive Account, Usage and Billing Information
You can access your S-Drive portal account for account, usage and billing information.
Configuring Encryption
When files are uploaded to S-Drive and stored in your AWS bucket, they may be encrypted depending on your configuration. There are 2 parts to configuring how files will be encrypted, described as follows:
S3 Bucket Encryption
In AWS, you can choose the encryption method for your bucket. See Setting default server-side encryption behavior for Amazon S3 buckets for more information. The options are
Disable (no encryption is enabled on the bucket)
Enable - Amazon S3 Key (SSE-S3)
Enable - AWS Key Management Service key (SSE-KMS).
For SSE-KMS, only AWS managed key will work with S-Drive.
![](../__attachments/2134606736/image-20211129-153631.png?inst-v=45374f53-f4b0-4a30-83dc-edc14e9d1f8c)
S-Drive File Upload Encryption
This setting determines how files will be encrypted when uploaded. The Upload File Encryption Type does not have to match your Bucket Encryption.
![](../__attachments/2134606736/image-20211130-202636.png?inst-v=45374f53-f4b0-4a30-83dc-edc14e9d1f8c)
The options are
S3-Managed Keys (SSE-S3)
AWS Key Management Service (SSE-KMS)
Use same encryption as S3 Bucket - this setting uploads files with the encryption type configured on your S3 bucket
If your bucket encryption is disabled (no encryption) and you choose “Use same encryption as S3 Bucket, your files will not be encrypted.
This table shows what encryption method is used for each combination of settings. The S-Drive File Upload Encryption Type overrides the bucket encryption unless the S-Drive setting is “use same encryption as S3 bucket)
Bucket Encryption ➡ S-Drive Configuration ⬇ | Disable | Enable/Amazon S3 Key (SSE-S3) | Enable/AWS Key Management Service key (SSE-KMS) |
---|---|---|---|
S3-Managed Keys (SSE-S3) | SSE-S3 | SSE-S3 | SSE-S3 |
AWS Key Management Service (SSE-KMS) | SSE-KMS | SSE-KMS | SSE-KMS |
Use same encryption as S3 Bucket | No Encryption | SSE-S3 | SSE-KMS |
If you are upgrading from a previous version, check that the custom setting for this configuration has been created:
Go to Setup-->Custom Settings
Click Manage next to SDriveConfig
See if there is a setting for S3EncryptionType. It should be set to AES256. This is the value that corresponds to SSE-S3 and is the default value for S-Drive Configuration
If there is no custom setting called S3EncryptionType, create it:
From the page with the list of settings (after you clicked Manage), click New at the top
Under Name, enter S3EncryptionType
Under Value, enter AES256
Once this value is set, you can change it if needed by going to the S-Drive Configuration page shown above