# Connection S3
Amazon Simple Storage Service (Amazon S3) is an object storage service that offers industry-leading scalability, data availability, security, and performance. Next to Amazon's S3 there are now various object storage providers which grant S3 compatible access to their storage solutions as well (e.g. Google Cloud Storage, IONOS, et al).
This UI helps to define the connection parameters for a S3 compatible storage endpoint.
# This Asset is required by:
# Name & Description
Name : Name of the Asset. Whitespaces are not allowed in the name.
Description : Enter a description.
Asset Usage box shows how many times this Asset is used and which parts are referencing it. Click to expand and then click to follow, if any.
# Required roles
In case you are deploying to a Cluster which is running (a) Reactive Engine Nodes which have (b) specific Roles configured, then you can restrict use of this Asset to those Nodes with matching roles.
If you want this restriction, then enter the names of the
Required Roles here. Otherwise, leave empty to match all Nodes (no restriction).
# S3 Server
Use these settings to define the S3 connection parameters.
# Authentication Mode
Select the mode of authentication accepted by the endpoint. Choice of:
No credentials required: Pick this for access to an S3 store which does not require authentication.
Use the default credential provider chain (AWS only): To avoid using clear text credentials in S3 connector, customers can enable "Default AWS Credentials Provider Chain" and use Role in S3 connector. Please check Working with AWS Credentials (opens new window) to learn more about this type of authentication.
Access key / Secret key credentials: Pick this for an Access and Secret Key driven authentication. This requires the provision of an Access Key and a Secret as described below.
Use this setting if your S3 Server requires region information. You can find standard Amazon Web Services (AWS) regions in the drop-down list. If your S3 endpoint does not require a region, simply ignore the entry or leave empty.
# S3 Endpoint URL
If you are connecting to an AWS S3 endpoint, you can ignore this field. Otherwise, you need to enter the endpoint URL here.
# Access Key and Secret
If you have selected
Access key / Secret key credentials as the Authentication Mode above,
then you will have to enter the Access Key and Secrete here respectively.
Both are made available to you by the S3 endpoint provider.
Access Key: Enter the Access Key you want to use to access this S3 endpoint.
Secret Key: Enter the Secret Key for the Access Key.
Use Secret: Check this box, if you have a configured a secret and want to reference this here instead of entering the Secret directly. The
Secretfield will be replaced by a drop-down list which contains all previously configured Secrets. Pick one of the Secrets in the list.
# List bucket API version
The AWS API version supported by the endpoint interface. Usually this is
2 (version 2).
# Related Topics
# Potential problems
Can't find what you are looking for?
Please note, that the creation of the online documentation is Work-In-Progress. It is constantly being updated. Should you have questions or suggestions, please don't hesitate to contact us at firstname.lastname@example.org .