AS2 Partners

An AS2Partner is a counterparty of the Files.com site's AS2 connectivity. Generally you will have one AS2 Partner created for each counterparty with whom you send and/or receive files via AS2.

Resource Schema

Required

PropertyDescription
as2_station_id
Int64		ID of the AS2 Station associated with this partner.
name
String		The partner's formal AS2 name.
uri
String		Public URI where we will send the AS2 messages (via HTTP/HTTPS).

Optional

PropertyDescription
server_certificate
String		Should we require that the remote HTTP server have a valid SSL Certificate for HTTPS? (This only applies to Outgoing AS2 message from Files.com to a Partner.)
Possible values: require_match, allow_any
http_auth_username
String		Username to send to server for HTTP Authentication.
additional_http_headers
Dynamic		Additional HTTP Headers for outgoing message sent to this partner.
default_mime_type
String		Default mime type of the file attached to the encrypted message
mdn_validation_level
String		How should Files.com evaluate message transfer success based on a partner's MDN response? This setting does not affect MDN storage; all MDNs received from a partner are always stored. none: MDN is stored for informational purposes only, a successful HTTPS transfer is a successful AS2 transfer. weak: Inspect the MDN for MIC and Disposition only. normal: weak plus validate MDN signature matches body, strict: normal but do not allow signatures from self-signed or incorrectly purposed certificates. auto: Automatically set the correct value for this setting based on next mdn received.
Possible values: none, weak, normal, strict, auto
signature_validation_level
String		Should Files.com require signatures on incoming AS2 messages? normal: require that incoming messages are signed with a valid matching signature. none: Unsigned incoming messages are allowed. auto: A one-time starting state. The next message received is always accepted and switches this to normal if it carries a valid signature, or none if it does not.
Possible values: normal, none, auto
enable_dedicated_ips
Bool		If true, we will use your site's dedicated IPs for all outbound connections to this AS2 Partner.
public_certificate
String		Public certificate used for message security.
http_auth_password
String		Password to send to server for HTTP Authentication.
pkcs12
String		Base64-encoded PKCS#12 (.pfx or .p12) file containing the partner's public certificate. Provide this instead of public_certificate. Any private key in the file is discarded. A public-only file must contain exactly one certificate.
pkcs12_password
String		Password for pkcs12. The file and password are used only for import; the extracted public certificate is stored as PEM.

Read Only

PropertyDescription
id
Int64		ID of the AS2 Partner.
workspace_id
Int64		ID of the Workspace associated with this AS2 Partner.
hex_public_certificate_serial
String		Serial of public certificate used for message security in hex format.
public_certificate_md5
String		MD5 hash of public certificate used for message security.
public_certificate_subject
String		Subject of public certificate used for message security.
public_certificate_issuer
String		Issuer of public certificate used for message security.
public_certificate_serial
String		Serial of public certificate used for message security.
public_certificate_not_before
String		Not before value of public certificate used for message security.
public_certificate_not_after
String		Not after value of public certificate used for message security.

Example Resource

resource "files_as2_partner" "example_as2_partner" {
  enable_dedicated_ips       = true
  http_auth_username         = "username"
  mdn_validation_level       = "none"
  signature_validation_level = "normal"
  server_certificate         = "require_match"
  default_mime_type          = "application/octet-stream"
  additional_http_headers    = {
    X-Partner = "acme"
  }
  as2_station_id             = 1
  name                       = "AS2 Partner Name"
  uri                        = "example"
  public_certificate         = "example"
}

Resource Import

This Resource supports importing using the following syntax:

Example Import Command

# As2 Partners can be imported by specifying the id.
terraform import files_as2_partner.example_as2_partner 1

Data Source Schema

Required

PropertyDescription
id
Int64		ID of the AS2 Partner.

Read Only

PropertyDescription
workspace_id
Int64		ID of the Workspace associated with this AS2 Partner.
as2_station_id
Int64		ID of the AS2 Station associated with this partner.
name
String		The partner's formal AS2 name.
uri
String		Public URI where we will send the AS2 messages (via HTTP/HTTPS).
server_certificate
String		Should we require that the remote HTTP server have a valid SSL Certificate for HTTPS? (This only applies to Outgoing AS2 message from Files.com to a Partner.)
Possible values: require_match, allow_any
http_auth_username
String		Username to send to server for HTTP Authentication.
additional_http_headers
Dynamic		Additional HTTP Headers for outgoing message sent to this partner.
default_mime_type
String		Default mime type of the file attached to the encrypted message
mdn_validation_level
String		How should Files.com evaluate message transfer success based on a partner's MDN response? This setting does not affect MDN storage; all MDNs received from a partner are always stored. none: MDN is stored for informational purposes only, a successful HTTPS transfer is a successful AS2 transfer. weak: Inspect the MDN for MIC and Disposition only. normal: weak plus validate MDN signature matches body, strict: normal but do not allow signatures from self-signed or incorrectly purposed certificates. auto: Automatically set the correct value for this setting based on next mdn received.
Possible values: none, weak, normal, strict, auto
signature_validation_level
String		Should Files.com require signatures on incoming AS2 messages? normal: require that incoming messages are signed with a valid matching signature. none: Unsigned incoming messages are allowed. auto: A one-time starting state. The next message received is always accepted and switches this to normal if it carries a valid signature, or none if it does not.
Possible values: normal, none, auto
enable_dedicated_ips
Bool		If true, we will use your site's dedicated IPs for all outbound connections to this AS2 Partner.
hex_public_certificate_serial
String		Serial of public certificate used for message security in hex format.
public_certificate
String		Public certificate used for message security.
public_certificate_md5
String		MD5 hash of public certificate used for message security.
public_certificate_subject
String		Subject of public certificate used for message security.
public_certificate_issuer
String		Issuer of public certificate used for message security.
public_certificate_serial
String		Serial of public certificate used for message security.
public_certificate_not_before
String		Not before value of public certificate used for message security.
public_certificate_not_after
String		Not after value of public certificate used for message security.

Example Data Source

data "files_as2_partner" "example_as2_partner" {
  id = 1
}