interface As2ConfigProperty

Language	Type name
.NET	`Amazon.CDK.AWS.Transfer.CfnConnector.As2ConfigProperty`
Go	`github.com/aws/aws-cdk-go/awscdk/v2/awstransfer#CfnConnector_As2ConfigProperty`
Java	`software.amazon.awscdk.services.transfer.CfnConnector.As2ConfigProperty`
Python	`aws_cdk.aws_transfer.CfnConnector.As2ConfigProperty`
TypeScript	`aws-cdk-lib` » `aws_transfer` » `CfnConnector` » `As2ConfigProperty`

A structure that contains the parameters for an AS2 connector object.

Example

// The code below shows an example of how to instantiate this type.
// The values are placeholders you should change.
import { aws_transfer as transfer } from 'aws-cdk-lib';
const as2ConfigProperty: transfer.CfnConnector.As2ConfigProperty = {
  basicAuthSecretId: 'basicAuthSecretId',
  compression: 'compression',
  encryptionAlgorithm: 'encryptionAlgorithm',
  localProfileId: 'localProfileId',
  mdnResponse: 'mdnResponse',
  mdnSigningAlgorithm: 'mdnSigningAlgorithm',
  messageSubject: 'messageSubject',
  partnerProfileId: 'partnerProfileId',
  signingAlgorithm: 'signingAlgorithm',
};

Properties

Name	Type	Description
basicAuthSecretId?	`string`	Provides Basic authentication support to the AS2 Connectors API.
compression?	`string`	Specifies whether the AS2 file is compressed.
encryptionAlgorithm?	`string`	The algorithm that is used to encrypt the file.
localProfileId?	`string`	A unique identifier for the AS2 local profile.
mdnResponse?	`string`	Used for outbound requests (from an AWS Transfer Family server to a partner AS2 server) to determine whether the partner response for transfers is synchronous or asynchronous.
mdnSigningAlgorithm?	`string`	The signing algorithm for the MDN response.
messageSubject?	`string`	Used as the `Subject` HTTP header attribute in AS2 messages that are being sent with the connector.
partnerProfileId?	`string`	A unique identifier for the partner profile for the connector.
signingAlgorithm?	`string`	The algorithm that is used to sign the AS2 messages sent with the connector.

basicAuthSecretId?

Type: string (optional)

Provides Basic authentication support to the AS2 Connectors API.

To use Basic authentication, you must provide the name or Amazon Resource Name (ARN) of a secret in AWS Secrets Manager .

The default value for this parameter is null , which indicates that Basic authentication is not enabled for the connector.

If the connector should use Basic authentication, the secret needs to be in the following format:

{ "Username": "user-name", "Password": "user-password" }

Replace user-name and user-password with the credentials for the actual user that is being authenticated.

Note the following:

You are storing these credentials in Secrets Manager, not passing them directly into this API.
If you are using the API, SDKs, or CloudFormation to configure your connector, then you must create the secret before you can enable Basic authentication. However, if you are using the AWS management console, you can have the system create the secret for you.

If you have previously enabled Basic authentication for a connector, you can disable it by using the UpdateConnector API call. For example, if you are using the CLI, you can run the following command to remove Basic authentication:

update-connector --connector-id my-connector-id --as2-config 'BasicAuthSecretId=""'

compression?

Type: string (optional)

Specifies whether the AS2 file is compressed.

encryptionAlgorithm?

Type: string (optional)

The algorithm that is used to encrypt the file.

Note the following:

Do not use the DES_EDE3_CBC algorithm unless you must support a legacy client that requires it, as it is a weak encryption algorithm.
You can only specify NONE if the URL for your connector uses HTTPS. Using HTTPS ensures that no traffic is sent in clear text.

localProfileId?

Type: string (optional)

A unique identifier for the AS2 local profile.

mdnResponse?

Type: string (optional)

Used for outbound requests (from an AWS Transfer Family server to a partner AS2 server) to determine whether the partner response for transfers is synchronous or asynchronous.

Specify either of the following values:

SYNC : The system expects a synchronous MDN response, confirming that the file was transferred successfully (or not).
NONE : Specifies that no MDN response is required.

mdnSigningAlgorithm?

Type: string (optional)

The signing algorithm for the MDN response.

If set to DEFAULT (or not set at all), the value for SigningAlgorithm is used.

messageSubject?

Type: string (optional)

Used as the Subject HTTP header attribute in AS2 messages that are being sent with the connector.

partnerProfileId?

Type: string (optional)

A unique identifier for the partner profile for the connector.

signingAlgorithm?

Type: string (optional)

The algorithm that is used to sign the AS2 messages sent with the connector.