# Connection S3

# Purpose

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:

# Configuration

# Name & Description

Name & Description (Connection S3)

Name : Name of the Asset. Whitespaces are not allowed in the name.

Description : Enter a description.

The 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

Required Roles (Connection S3)

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.

Server Settings (Connection S3)

# Authentication Mode

Authentication Mode (Connection S3)

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.

# Region

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 and Secret - manual entry (Connection S3)

  • 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 Secret field will be replaced by a drop-down list which contains all previously configured Secrets. Pick one of the Secrets in the list.

Access Key and Secret - pre-configured (Connection S3)

# List bucket API version

The AWS API version supported by the endpoint interface. Usually this is 2 (version 2).

# Internal

# External

# 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 support@layline.io .

Last Updated: 7/5/2022, 4:50:56 PM