Cisco ASA¶
Preview feature
This feature is available in Preview and isn't yet generally available (GA). Functionality and behavior can change before GA.
Warning
Rebinding a certificate disconnects the remote-access VPN users connected through it, and Certificate Manager - SaaS doesn't warn you at push time. Schedule provisioning to a binding that serves remote-access VPN in a maintenance window.
The Cisco ASA rejects a certificate whose chain includes a CA certificate signed with SHA-1, and a certificate with an RSA key shorter than 2048 bits. Provision certificates that have a SHA-256 chain and either an ECDSA key or an RSA key of at least 2048 bits.
- In the Certificate Manager - SaaS toolbar, click Machines.
- Click the more options
button at the right end of the Cisco ASA machine's row, and then select Provision. -
From the Search a certificate by name, expiration, or fingerprint field, begin typing the certificate name you want to provision. Click the certificate when it appears in the list.
-
Under Certificate Information, leave Trustpoint Name as it is. The field is read-only. When Certificate Manager - SaaS installs the certificate, it names the trustpoint
venafi-followed by the first 32 hexadecimal characters of the certificate's SHA-256 fingerprint, so a retry reuses the same trustpoint. -
Leave Previous Trustpoint Name as it is. The field is read-only. When you renew a certificate, Certificate Manager - SaaS fills it in with the trustpoint this certificate replaces and removes that trustpoint after it binds the new certificate. Certificate Manager - SaaS removes only trustpoints that it created.
-
Leave Security Context as it is. The field is read-only. When Certificate Manager - SaaS installs the certificate, it fills in the machine's Security Context, or
singleif the machine doesn't have one. -
Under Server Store Details, for Binding Type, choose how to bind the certificate on the Cisco ASA:
- Management Interface: the management interface.
- Interface: any other interface.
- VPN Load-Balancing IP: the VPN load-balancing address on an interface, instead of the interface itself.
- Domain (SNI): a specific fully qualified domain name (FQDN), using Server Name Indication (SNI). This binding takes precedence over interface bindings.
- Global Fallback: used when no more specific binding matches.
- IKEv2 Remote Access: Internet Key Exchange version 2 (IKEv2) remote-access VPN. A firewall has at most one.
- Unbound: installs the certificate without binding it.
Note
When you bind to the interface that Certificate Manager - SaaS uses to manage the Cisco ASA, the firewall restarts its HTTPS listener with the new certificate. Management connectivity drops briefly, and other sessions to that interface, including ASDM, disconnect. This is expected. Certificate Manager - SaaS confirms the binding by reading the configuration back.
-
In Interface Name, enter the interface's name (
nameif) as the Cisco ASA reports it inshow nameif. For Domain (SNI), Global Fallback, IKEv2 Remote Access, and Unbound, enter(unbound), including the parentheses. -
If you chose Domain (SNI), in Domain Name, enter the FQDN the certificate serves.
-
To save without pushing the certificate, disable Push certificate on save.
-
Click Save.
Tip
You can schedule your provisions daily, weekly, or monthly. See Set up a machine provisioning schedule.
After you save, Certificate Manager - SaaS imports the certificate, its private key, and its issuing chain into a trustpoint on the Cisco ASA. It then binds the trustpoint, saves the configuration so the change survives a reboot, and removes the trustpoint the certificate replaces. An installation appears on the Installations tab.
Important
When you renew a certificate, Certificate Manager - SaaS removes every binding of the replaced trustpoint and deletes it, even if you choose Unbound for the new certificate. To keep a service running, bind the new certificate to the same service the old certificate served.
Note
If Certificate Manager - SaaS can't remove the replaced trustpoint, it leaves the trustpoint in place and logs a warning. The provisioning still succeeds. The Cisco ASA allows at most 16 trustpoints for each interface, so leftover trustpoints can eventually block a new binding. If the warning repeats, remove every ssl trust-point reference to the named trustpoint, and then remove the trustpoint with no crypto ca trustpoint <name>.