Package software.amazon.awssdk.services.transfer.model

Class As2ConnectorConfig

    • Method Detail

      • localProfileId

        public final String localProfileId()

        A unique identifier for the AS2 local profile.

        Returns:
        A unique identifier for the AS2 local profile.

      • partnerProfileId

        public final String partnerProfileId()

        A unique identifier for the partner profile for the connector.

        Returns:
        A unique identifier for the partner profile for the connector.

      • messageSubject

        public final String messageSubject()

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

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

      • compressionAsString

        public final String compressionAsString()

        Specifies whether the AS2 file is compressed.

        If the service returns an enum value that is not available in the current SDK version, compression will return CompressionEnum.UNKNOWN_TO_SDK_VERSION. The raw value returned by the service is available from compressionAsString().

        Returns:
        Specifies whether the AS2 file is compressed.
        See Also:
        CompressionEnum

      • encryptionAlgorithm

        public final EncryptionAlg encryptionAlgorithm()

        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.

        If the service returns an enum value that is not available in the current SDK version, encryptionAlgorithm will return EncryptionAlg.UNKNOWN_TO_SDK_VERSION. The raw value returned by the service is available from encryptionAlgorithmAsString().

        Returns:
        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.

        See Also:
        EncryptionAlg

      • encryptionAlgorithmAsString

        public final String encryptionAlgorithmAsString()

        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.

        If the service returns an enum value that is not available in the current SDK version, encryptionAlgorithm will return EncryptionAlg.UNKNOWN_TO_SDK_VERSION. The raw value returned by the service is available from encryptionAlgorithmAsString().

        Returns:
        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.

        See Also:
        EncryptionAlg

      • signingAlgorithm

        public final SigningAlg signingAlgorithm()

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

        If the service returns an enum value that is not available in the current SDK version, signingAlgorithm will return SigningAlg.UNKNOWN_TO_SDK_VERSION. The raw value returned by the service is available from signingAlgorithmAsString().

        Returns:
        The algorithm that is used to sign the AS2 messages sent with the connector.
        See Also:
        SigningAlg

      • signingAlgorithmAsString

        public final String signingAlgorithmAsString()

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

        If the service returns an enum value that is not available in the current SDK version, signingAlgorithm will return SigningAlg.UNKNOWN_TO_SDK_VERSION. The raw value returned by the service is available from signingAlgorithmAsString().

        Returns:
        The algorithm that is used to sign the AS2 messages sent with the connector.
        See Also:
        SigningAlg

      • mdnSigningAlgorithm

        public final MdnSigningAlg mdnSigningAlgorithm()

        The signing algorithm for the MDN response.

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

        If the service returns an enum value that is not available in the current SDK version, mdnSigningAlgorithm will return MdnSigningAlg.UNKNOWN_TO_SDK_VERSION. The raw value returned by the service is available from mdnSigningAlgorithmAsString().

        Returns:
        The signing algorithm for the MDN response.

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

        See Also:
        MdnSigningAlg

      • mdnSigningAlgorithmAsString

        public final String mdnSigningAlgorithmAsString()

        The signing algorithm for the MDN response.

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

        If the service returns an enum value that is not available in the current SDK version, mdnSigningAlgorithm will return MdnSigningAlg.UNKNOWN_TO_SDK_VERSION. The raw value returned by the service is available from mdnSigningAlgorithmAsString().

        Returns:
        The signing algorithm for the MDN response.

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

        See Also:
        MdnSigningAlg

      • mdnResponse

        public final MdnResponse mdnResponse()

        Used for outbound requests (from an 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.

        If the service returns an enum value that is not available in the current SDK version, mdnResponse will return MdnResponse.UNKNOWN_TO_SDK_VERSION. The raw value returned by the service is available from mdnResponseAsString().

        Returns:
        Used for outbound requests (from an 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.

        See Also:
        MdnResponse

      • mdnResponseAsString

        public final String mdnResponseAsString()

        Used for outbound requests (from an 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.

        If the service returns an enum value that is not available in the current SDK version, mdnResponse will return MdnResponse.UNKNOWN_TO_SDK_VERSION. The raw value returned by the service is available from mdnResponseAsString().

        Returns:
        Used for outbound requests (from an 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.

        See Also:
        MdnResponse

      • basicAuthSecretId

        public final String basicAuthSecretId()

        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 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 Amazon Web Services 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=""'

        Returns:
        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 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 Amazon Web Services 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=""'

      • preserveContentType

        public final PreserveContentType preserveContentType()

        Allows you to use the Amazon S3 Content-Type that is associated with objects in S3 instead of having the content type mapped based on the file extension. This parameter is enabled by default when you create an AS2 connector from the console, but disabled by default when you create an AS2 connector by calling the API directly.

        If the service returns an enum value that is not available in the current SDK version, preserveContentType will return PreserveContentType.UNKNOWN_TO_SDK_VERSION. The raw value returned by the service is available from preserveContentTypeAsString().

        Returns:
        Allows you to use the Amazon S3 Content-Type that is associated with objects in S3 instead of having the content type mapped based on the file extension. This parameter is enabled by default when you create an AS2 connector from the console, but disabled by default when you create an AS2 connector by calling the API directly.
        See Also:
        PreserveContentType

      • preserveContentTypeAsString

        public final String preserveContentTypeAsString()

        Allows you to use the Amazon S3 Content-Type that is associated with objects in S3 instead of having the content type mapped based on the file extension. This parameter is enabled by default when you create an AS2 connector from the console, but disabled by default when you create an AS2 connector by calling the API directly.

        If the service returns an enum value that is not available in the current SDK version, preserveContentType will return PreserveContentType.UNKNOWN_TO_SDK_VERSION. The raw value returned by the service is available from preserveContentTypeAsString().

        Returns:
        Allows you to use the Amazon S3 Content-Type that is associated with objects in S3 instead of having the content type mapped based on the file extension. This parameter is enabled by default when you create an AS2 connector from the console, but disabled by default when you create an AS2 connector by calling the API directly.
        See Also:
        PreserveContentType

      • hashCode

        public final int hashCode()
        Overrides:
        hashCode in class Object

      • equals

        public final boolean equals​(Object obj)
        Overrides:
        equals in class Object

      • toString

        public final String toString()
        Returns a string representation of this object. This is useful for testing and debugging. Sensitive data will be redacted from this string using a placeholder value.
        Overrides:
        toString in class Object

      • getValueForField

        public final <T> Optional<T> getValueForField​(String fieldName,
                                              Class<T> clazz)