Transport Layer Security

All communication to and from Releval takes place using Transport Layer Security (TLS) over an encrypted communication channel.

REST API configuration

Nothing specifically needs to be done to make use of TLS with the REST API; simply use the https://${RELEVAL_HOST} endpoint.

gRPC API configuration

gRPC handles configuration of the TLS channel using channel credentials, and you should refer to the gRPC documentation for additional configuration options for configuring channels.

The minimum configuration to configure a channel with credentials for popular languages is:

C#

var channel = GrpcChannel.ForAddress($"https://{relevalHost}");

// use the channel

Java

var channel = ManagedChannelBuilder.forAddress(relevalHost, 443)
    .useTransportSecurity()
    .build();

// use the channel

Python

channel_creds = grpc.ssl_channel_credentials()
channel = grpc.secure_channel(f"{releval_host}:443", channel_creds)

# use the channel

PHP

$opts = [
    'credentials' => Grpc\ChannelCredentials::createSsl(),
];

$channel = new Grpc\Channel($relevalHost, $opts);

// use the channel