# Automatic Identification using a Certificate

> Historical reference: automatic Identification using a Certificate.

Textual supports sending a client-side [certificate](<https://en.wikipedia.org/wiki/Public_key_certificate>) during [Transport Layer Security (TLS)](<https://en.wikipedia.org/wiki/Transport_Layer_Security>) negotiation. This feature allows for automatic, secure identification with NickServ (or other services) without the need for a password.

Skip to section:

- [Creating Certificate](<https://www.textualapp.com/docs/legacy/guides/using-certfp#faq-entry-1>)

- [Adding Certificate to Textual](<https://www.textualapp.com/docs/legacy/guides/using-certfp#faq-entry-2>)

- [Registering Certificate with NickServ](<https://www.textualapp.com/docs/legacy/guides/using-certfp#faq-entry-3>)


## Creating Certificate

If you already have a certificate of your own installed, then you can [skip this section](<https://www.textualapp.com/docs/legacy/guides/using-certfp#faq-entry-2>).

To get started, open **Launchpad** from the Dock and navigate to the folder named **Other**. Within this folder, launch the application named **Keychain Access**. This application has a set of keys on a key ring as its icon.

Once launched, a window will appear that is visually similar to the following:

![Automatic Identification using a Certificate: archived screenshot 1](<https://www.textualapp.com/docs-media/12d47f20fdb3638e0765.png>)

Inside this window, in the top left corner, in the list labeled **Keychains**; select the keychain named **login**.

---

To create a certificate in this keychain, follow these steps:

1. In the main menu, in the top left corner of the screen, open the bold **Keychain Access** menu. Within this menu, open the **Certificate Assistant** submenu, then click the menu item labeled **Create a Certificate…**.

![Automatic Identification using a Certificate: archived screenshot 2](<https://www.textualapp.com/docs-media/34535b9bed6bb20d407f.png>)

Once clicked, the following window will appear:

![Automatic Identification using a Certificate: archived screenshot 3](<https://www.textualapp.com/docs-media/13d3b339be10598805ef.png>)

2. Inside this window, enter a name into the field labeled **Name**. The name you chose is not important. It is only used to make your certificate easier to find.

3. Leave the **Identity Type** as **Self Signed Root**

4. Change the **Certificate Type** to **SSL Client**.

5. Click **Create**

6. Ignore the **You are about to create a self-signed certificate** warning by clicking **Continue**.

After a few seconds your certificate will be ready for immediate use:

![Automatic Identification using a Certificate: archived screenshot 4](<https://www.textualapp.com/docs-media/9f19735d22d01c6712c0.png>)


## Adding Certificate to Textual

To add a certificate to Textual, follow these steps:

1. Begin by opening **Server Properties** using the keyboard combination [Command U](<https://www.textualapp.com/docs/legacy/guides/keyboard-shortcuts>).

2. In the window that appears, click **Client Certificate** under the **Advanced** section of the navigation list.

Once clicked, the following window will appear:

![Automatic Identification using a Certificate: archived screenshot 5](<https://www.textualapp.com/docs-media/1ec4b4aab03c46c14d6c.png>)

3. Inside this window, click the **Select Certificate** button.

A list of certificates will appear:

![Automatic Identification using a Certificate: archived screenshot 6](<https://www.textualapp.com/docs-media/3bbbf05b4d64264fa11f.png>)

4. Select the certificate that you created.

5. Click the **Chose** button to continue.

**Server Properties** will update the window to confirm your selection:

![Automatic Identification using a Certificate: archived screenshot 7](<https://www.textualapp.com/docs-media/338b23e2ff0e8cefd0a0.png>)

6. Finish by clicking the **Save** button.


## Registering Certificate with NickServ

To identify with NickServ using a certificate, the fingerprint of the certificate must be registered.

Which fingerprint you are supposed to register will vary depending on how old the software an IRC network uses is.

Try registering each fingerprint in the following order:

- SHA-256

- SHA-1

- MD5

Registration is made easy thanks to the **Copy** button next to each fingerprint. When clicked, this button will copy the command needed to register the fingerprint. Paste the result into Textual's main text field and submit.

## Using Certificate with SASL

When a client-side certificate is configured, Textual will automatically attempt to use EXTERNAL as the authentication mechanism for SASL. There is nothing that has to be configured to enable this behavior.

For certain use cases, this behavior may not be desirable. This behavior can be disabled using the [*defaults*](<https://www.textualapp.com/docs/legacy/reference/commands#cr=defaults>) command.

**It is recommended that you do not disable this behavior unless you have a very good reason.**
