Skip to content

Commit

Permalink
DOCS-2063
Browse files Browse the repository at this point in the history
  • Loading branch information
shefulloflight committed Mar 11, 2024
1 parent 0ef15d2 commit e160392
Show file tree
Hide file tree
Showing 2 changed files with 66 additions and 1 deletion.
Original file line number Diff line number Diff line change
Expand Up @@ -22,7 +22,7 @@
{{site.data.alerts.important}}
<ul>
<li>By default, Qumulo requires an encrypted connection to connect to LDAP (either LDAPS or StartTLS). If you disable the option to connect without TLS, you might expose credentials over your network.</li>
<li>To use encrypted connections, you must install a valid certificate for your LDAP server.</li>
<li>To use encrypted connections, you must <a href="../encryption-data-security/installing-signed-ssl-certificate.html">install a valid certificate for your LDAP server</a>.</li>
</ul>
{{site.data.alerts.end}}

Expand Down
Original file line number Diff line number Diff line change
@@ -0,0 +1,65 @@
## Requirements

* An SSL certificate based on your certificate signing request (CSR) file from your certificate authority (CA)

* A CA-bundle PEM chain in the following order:

* Your certificate

* The intermediate CA

* The root CA

## To Install a Signed SSL Certificate on a Qumulo Cluster from the Command Line

1. Verify that your certificate and the CA-bundle are in the PEM format by running the `file *` command.

{{site.commandOutput}}

```bash
certbundle.pem: PEM certificate
private.key: PEM RSA private key
```

1. (Optional) If your file isn't an RSA key, use the `openssl rsa` command to convert your key. For example:

```bash
openssl rsa \
-in original.key \
-out private.key
```

1. Use the [`qq login`](https://docs.qumulo.com/qq-cli-command-guide/login/login.html) command to log in to your Qumulo cluster as an administrator. For example:

```bash
qq login \
-u admin \
--host {{site.exampleIP0}}
```

1. Use the [`qq ssl_modify_certificate`](https://docs.qumulo.com/qq-cli-command-guide/ssl/ssl_modify_certificate.html) command to install your certificate. For example:

```bash
qq ssl_modify_certificate \
--host {{site.exampleIP0}} \
-c certbundle.pem \
-k private.key.insecure
```

## To Import a Certificate Authority (CA) Certificate on macOS

1. Press **&#8984; + Space**, enter `Keychain Access`, and press **Enter**.

1. When prompted, click **Open Keychain Access**.

1. In the **Keychain Access** window, on the left panel, under **Default Keychains**, click **login**.

1. On the right, click **Certificates**.

1. Copy your CA certificate file to the list of certificates.

1. Right-click your certificate and then click **Get Info**.

1. On the window with the certificate information, expand the **Trust** section and **When using this certificate:** select **Always Trust**.

{% include note.html content="To ensure your certificate is installed correctly, restart your browser." %}

0 comments on commit e160392

Please sign in to comment.