open-nomad/website/source/docs/agent/configuration/tls.html.md

layout	page_title	sidebar_current	description
docs	tls Stanza - Agent Configuration	docs-agent-configuration-tls	The "tls" stanza configures Nomad's TLS communication via HTTP and RPC to enforce secure cluster communication between servers, clients, and between.

tls Stanza

Placement	**tls**

The tls stanza configures Nomad's TLS communication via HTTP and RPC to enforce secure cluster communication between servers, clients, and between.

tls {
  http = true
  rpc  = true
}

~> Incorrect configuration of the TLS configuration can result in failure to start the Nomad agent.

This section of the documentation only covers the configuration options for tls stanza. To understand how to setup the certificates themselves, please see the Agent's Gossip and RPC Encryption.

tls Parameters

• ca_file (string: "") - Specifies the path to the CA certificate to use for Nomad's TLS communication.

• cert_file (string: "") - Specifies the path to the certificate file used for Nomad's TLS communication.

• key_file (string: "") - Specifies the path to the key file to use for Nomad's TLS communication.

• http (bool: false) - Specifies if TLS should be enabled on the HTTP endpoints on the Nomad agent, including the API.

• rpc (bool: false) - Specifies if TLS should be enabled on the RPC endpoints and Raft traffic between the Nomad servers. Enabling this on a Nomad client makes the client use TLS for making RPC requests to the Nomad servers.

• verify_server_hostname (bool: false) - Specifies if outgoing TLS connections should verify the server's hostname.

tls Examples

The following examples only show the tls stanzas. Remember that the tls stanza is only valid in the placements listed above.

Enabling TLS

This example shows enabling TLS configuration. This enables TLS communication between all servers and clients using the default system CA bundle and certificates.

tls {
  http = true
  rpc  = true
}

Custom Certificates

This example shows configuring Nomad to communicate via TLS over HTTP and RPC using a custom certificate and CA bundle.

tls {
  http = true
  rpc  = true

  ca_file   = "/etc/certs/ca.crt"
  cert_file = "/etc/certs/nomad.crt"
  key_file  = "/etc/certs/nomad.key"
}