Runtime settings
Look up listener, participant, AS4 timestamp and SMP discovery settings for the SDK Access Point process.
The runtime reads the properties file supplied with --config. In the Docker delivery, the installer supplies the process environment and mounts the configuration, keys and secret files. Configure container host ports through installation.json. Docker configuration example
Listeners and tenant
Section titled “Listeners and tenant”| Setting | Purpose |
|---|---|
bind.address and port |
Numeric bind address and port for the private listener in split mode. Inside the Docker container, the private port is 9443. |
AP_LISTENER_MODE=split |
Runs separate AS4 and private listeners. |
AP_AS4_BIND_ADDRESS and AP_AS4_PORT |
Numeric bind address and port for the AS4 listener. The Docker delivery uses container port 8443. |
AP_INTERNAL_TLS_CONFIG |
Path to the private listener’s TLS properties. |
AP_PKI_CONFIG |
Path to the trust and revocation policy properties. |
tenant.id |
Tenant served by this runtime. Match the private server certificate’s organizational unit to this ID. |
bearer.token.env |
Name of the environment variable that supplies the private API bearer token. |
AP_SERVED_PARTICIPANTS |
Comma-separated IDs for recipients served by this instance. In Docker, edit served_participants in installation.json. |
Use distinct internal and AS4 ports. The Docker test profile binds both published ports to host IPv4 loopback.
AS4 message profile
Section titled “AS4 message profile”| Property | Purpose |
|---|---|
transport.profile |
Transport-profile identifier used by this instance. Use the identifier from the selected release and environment. |
sdk.source.root |
Path to the SDK schema and reference directory supplied with the release. |
handling.service.id |
Local handling-service identifier used in package validation. |
peer.endpoint |
Peer HTTPS AS4 URL for a statically routed instance. |
timestamp.policy |
AS4 message timestamp policy. The runtime defaults to SIGNED. |
timestamp.ttl.seconds |
Timestamp lifetime. Default 300. |
timestamp.future-skew.seconds |
Tolerance for timestamps ahead of the local clock. Default 60. |
Set transport values for the destination environment and keep the host clock synchronized. Digg technical references
Dynamic peer discovery
Section titled “Dynamic peer discovery”Set smp.discovery.enabled=true when the runtime should resolve peers through SML and SMP. Supply the environment’s SML DNS zone, the HTTPS truststore and a separate truststore for metadata signatures. The runtime checks the signed metadata and the peer certificate before using the resolved route.
| Property | Purpose |
|---|---|
smp.sml.zone |
DNS zone used to look up the participant’s SMP publisher. |
smp.document.type |
Optional lookup document type. Defaults to the AS4 message action. |
smp.https.truststore.path, smp.https.truststore.password.env |
Truststore and secret reference for the HTTPS connection to SMP. |
smp.metadata.truststore.path, smp.metadata.truststore.password.env |
Truststore and secret reference for validating signed SMP metadata. |
smp.cache.positive.seconds and smp.cache.negative.seconds |
Cache lifetimes for found and missing routes. Defaults are 3600 and 300 seconds. |
smp.cache.max-entries |
Combined limit for positive and negative cache entries. Default 10000. |
smp.connect.timeout.seconds and smp.request.timeout.seconds |
HTTPS connection and request timeouts. Defaults are 5 and 10 seconds. |
Supply the discovery truststores and credentials using the secret-delivery mechanism for the chosen runtime. Monitoring discovery