This section does not apply if your DC/OS cluster is using a custom external certificate. In that case, your clients may already trust the Certificate Authority. Otherwise, your cluster administrator can tell you how to obtain and install the Certificate Authority certificate to enable your clients to trust the cluster.
To ensure that you are communicating with your DC/OS cluster and not another potentially malicious party, you must obtain the appropriate trust anchor. This trust anchor is part of the DC/OS CA bundle which is a collection of root CA certificates. In the simplest case, it just contains one item: the root CA certificate corresponding to the DC/OS certificate authority. You can obtain the DC/OS CA bundle, using one of these methods:
Out-of-band, recommended: the only secure way to retrieve the CA bundle is out-of-band.
Via HTTP(S) from Admin Router, insecure: using
curlto retrieve the certificate through insecure HTTP or insecure HTTPS.
The DC/OS CA bundle is located on any master node at the file system path
/run/dcos/pki/CA/ca-bundle.crt. For maximum security, you should manually retrieve this file. Alternatively, a reasonably secure method is to SSH into one of the master nodes to obtain the file, if the master nodes cannot be accessed physically. For simplification and to more easily use the
curl commands provided elsewhere in the documentation, you can rename the file from
ca-bundle.crt to e.g.,
Prerequisite: You must have the DC/OS CLI installed in order to retrieve the cluster URL in the command below.
Use the following command to retrieve the DC/OS CA bundle and save it in the current directory:
curl -k -v $(dcos config show core.dcos_url)/ca/dcos-ca.crt -o dcos-ca.crt