corda.p2p.gateway

Configuration schema for the P2P gateway.

• connectionConfig - Settings for the TCP connection pool to peer gateways.
  • acquireTimeout - The time, in seconds, after which a connection request fails.
    Minimum value: 1
    Maximum value: 3000
    Default value: 10
  • connectionIdleTimeout - The time, in seconds, after which an inactive connection in the pool will be released (closed).
    Minimum value: 1
    Maximum value: 3000
    Default value: 60
  • initialReconnectionDelay - The initial time, in seconds, to wait before trying to reconnect.
    Minimum value: 1
    Maximum value: 3000
    Default value: 1
  • maxClientConnections - The maximum size of the connection pool.
    Minimum value: 1
    Maximum value: 10000
    Default value: 100
  • maxReconnectionDelay - The maximum time, in seconds, to delay before trying to reconnect.
    Minimum value: 1
    Maximum value: 3000
    Default value: 16
  • responseTimeout - The time, in milliseconds, after which the delivery of a message is considered failed.
    Minimum value: 100
    Maximum value: 10000
    Default value: 3000
  • retryDelay - The time, in milliseconds, after which a message that previously failed is retried.
    Minimum value: 100
    Maximum value: 10000
    Default value: 2000

• maxRequestSize - The maximum request size, in bytes, accepted by the gateway. The gateway rejects requests larger than the specified size.
  Minimum value: 10000000
  Default value: 500000000

• serversConfiguration - The HTTP servers. The hostAddress and hostPort pair must be unique for each server.
  • hostAddress - The hostname or IP address where the HTTP server will bind.
    Default value: 0.0.0.0
  • hostPort - The HTTP port of the server.
    Maximum value: 65535
    Default value: 8080
  • urlPath - The URL path the gateway server will listen on.
    Default value: /

• sslConfig - Settings for TLS connections between gateways.
  • revocationCheck - The type of revocation check for the TLS certificate.
    • mode This must be set to one of the following values:
      • SOFT_FAIL - The revocation check succeeds if the revocation status cannot be determined under certain circumstances. See java.security.cert.PKIXRevocationChecker.Option.SOFT_FAIL Javadoc for more details.
      • HARD_FAIL - The opposite of SOFT_FAIL. This is the most rigorous check. Amongst other requirements, this check requires that the CRL checking URL is available on every level of certificate chain.
      • OFF - Disables the CRL check.
      
      Default value: SOFT_FAIL
  • tlsType - The type of TLS connections to establish between the gateways in the cluster and gateways in other clusters. This setting MUST be the same on all gateways that communicate via HTTPS. This must be set to one of the following values:
    • ONE_WAY - Establishes a regular TLS connection, where the server gateway is authenticated.
    • MUTUAL - Establishes a mutual TLS connection, where both the server and client gateway are authenticated.
    
    Default value: ONE_WAY