Configure servers for Tessera API

Configure the servers for the Tessera API in the Tessera configuration file.

Specify the servers to be started as a list in serverConfigs.

"serverConfigs": [
   <server settings>
]

Server Addresses

The server configuration has two address entries:

• serverAddress - Always specified.
• bindingAddress - Optional endpoint to use for the binding. Specify to bind to an internal IP while advertising an external IP using serverAddress.

Each server is individually configured and can advertise over HTTP, HTTPS, or a Unix Socket.

HTTP server configuration

HTTP

{
    "app": "<app type>",
    "enabled": <boolean>,
    "serverAddress":"http://[host]:[port]/[path]",
    "communicationType" : "REST"
}

Third Party Example

{
   "app": "ThirdParty",
   "enabled": true,
   "serverAddress": "http://localhost:9081",
   "communicationType": "REST"
}

HTTPS server configuration

HTTPS

{
    "app": "<app type>",
    "enabled": <boolean>,
    "serverAddress":"https://[host]:[port]/[path]",
    "communicationType" : "REST",
    "sslConfig": {
        <SSL settings> 
    }
}

P2P Example

{
    "app": "P2P",
      "enabled": true,
      "serverAddress": "http://localhost:9001",
      "sslConfig": {
        "tls": "enum STRICT,OFF",
        "generateKeyStoreIfNotExisted": "boolean",
        "serverKeyStore": "Path",
        "serverTlsKeyPath": "Path",
        "serverTlsCertificatePath": "Path",
        "serverKeyStorePassword": "String",
        "serverTrustStore": "Path",
        "serverTrustCertificates": [
          "Path"
        ],
        "serverTrustStorePassword": "String",
        "serverTrustMode": "TOFU",
        "clientKeyStore": "Path",
        "clientTlsKeyPath": "Path",
        "clientTlsCertificatePath": "Path",
        "clientKeyStorePassword": "String",
        "clientTrustStore": "Path",
        "clientTrustCertificates": [
          "Path"
        ],
        "clientTrustStorePassword": "String",
        "clientTrustMode": "TOFU",
        "knownClientsFile": "Path",
        "knownServersFile": "Path"
      },
      "communicationType": "REST",
      "properties": {
         "partyInfoInterval": "Long",
         "enclaveKeySyncInterval": "Long",
         "syncInterval": "Long",
         "resendWaitTime": "Long"
      }
    }

Unix socket server configuration

Unix socket

{
    "app": "<app type",
    "enabled": <boolean,
    "serverAddress":"unix://[path]",
    "communicationType" : "REST"
}

Q2T Example

{
    "app": "Q2T",
    "enabled": true,
    "serverAddress": "unix:/tmp/tm.ipc",
    "communicationType": "REST"
}