corda.p2p.gateway

Configuration schema for the P2P gateway.

• connectionConfig - Controls the TCP connection pool to peer gateways.
  • acquireTimeout - Time (in seconds) after which a connection request will fail.
    Minimum value: 1
    Maximum value: 3000
    Default value: 10
  • connectionIdleTimeout - 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 - 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 - Time (in milli seconds) after which a message delivery is considered failed.
    Minimum value: 100
    Maximum value: 10000
    Default value: 1000
  • retryDelay - Time (in milli seconds) after which a message is retried, when previously failed.
    Minimum value: 100
    Maximum value: 10000
    Default value: 1000

• hostAddress - The host name or IP address where the HTTP server will bind.
  Default value: 0.0.0.0

• hostPort - The HTTP port.
  Maximum value: 65535
  Default value: 8080

• maxRequestSize - The maximum request size accepted by the gateway, in bytes. Any requests crossing that threshold will be rejected.
  Minimum value: 10000000
  Default value: 500000000

• sslConfig - Used for TLS between Gateways.
  • revocationCheck - How to check for revocation of the TLS certificate.
    • mode This must be set to one of the following values:
      • SOFT_FAIL - The revocation check will succeed if the revocation status cannot be determined under certain circumstances. See java.security.cert.PKIXRevocationChecker.Option.SOFT_FAIL java doc for more details.
      • HARD_FAIL - Opposite of SOFT_FAIL - i.e. most rigorous check. Among other things, this check requires that CRL checking URL is available on every level of certificate chain.
      • OFF - Switch CRL check off.
      
      Default value: SOFT_FAIL
  • tlsType - What kind of TLS connections to establish between the gateways in our cluster and gateways in other clusters. This setting MUST be the same on all Gateways that need to communicate via HTTPS. This must be set to one of the following values:
    • ONE_WAY - Establishes a regular TLS connection, where the server gateway will be authenticated.
    • MUTUAL - Establishes a mutual TLS connection, where both the server and client gateway are authenticated.
    
    Default value: ONE_WAY

• urlPath - The url path the gateway server will be listening to.
  Default value: /