Docs /
... / Access Control / Edit scope, renew, and revoke certificates

Edit scope, renew, and revoke certificates

Manage issued client certificates for a custom domain at app.odac.run. From a domain's Access sheet, you can change which hosts a certificate unlocks without issuing a new file, create a replacement certificate while existing devices transition, revoke a certificate immediately, and inspect expired or revoked certificates. For .odac.cc tunnel device certificates, see Tunnel sign-in and device certificates.

Edit which hosts a certificate opens

  1. Open a custom domain's Access sheet from Domains (see Protect a domain with client certificates) and look under Certificates. Each active or expiring row shows its status dot (green when active, amber with an Expiring badge when nearing expiration), expiration date, allowed host chips (certificates that open only the sheet's root domain omit the chip), and up to three action icons on the right: Renew, Edit scope, and Revoke. If the domain is restricted or its server is offline, these buttons appear disabled. Click Edit scope (the pencil icon) on the certificate you want to update.

Access sheet for example.com showing active and expiring certificates with the pointer on Edit scope and its tooltip

  1. An inline checklist expands beneath the row with checkboxes for every host on the domain and the note No new certificate needed. The change applies on the next request. Select or clear the hosts you want the certificate to unlock, then click Save scope (or Cancel to discard your changes). You must keep at least one host checked; clicking Save scope with every host cleared shows Pick at least one host. To stop it opening anything, revoke it. Once saved, Scope updated appears and the certificate row updates immediately without reinstalling the file on any device.

Inline Edit scope checklist expanded under Alice's laptop with api.example.com checked and the pointer on Save scope

Renew a certificate

  1. On any active, expiring, or expired certificate row under Certificates, click Renew (the circular arrow icon).
  2. The Renew certificate dialog opens with Name prefilled and locked to the existing certificate (A renewal keeps the name of the certificate it replaces.), Opens preselected with its current hosts, and Valid for set to 1 year. Adjust the allowed hosts or validity period if needed, enter or generate a File password (or click I have my own key to paste a certificate request), then click Renew certificate.

Renew certificate dialog stacked over the Access sheet with Name locked to CI deploy runner and the pointer on Renew certificate

  1. When Certificate ready appears, download the new .p12 file (or .crt and CA chain files) and install it on your devices (see Issue and install a client certificate). Below the installation tabs, a notice states The old certificate keeps working. Once every device uses the new one, revoke the old one. with a Revoke the old one button. When downloading a .p12 file, Revoke the old one stays disabled with the tooltip Download the new file first until you click the download link so you do not lose the only copy of the new private key. Click Revoke the old one once devices are updated, or click Done to keep both certificates active during the transition.

Certificate ready screen after renewing CI deploy runner showing the download button, transition notice, and Revoke the old one

  1. Back in the Access sheet, both certificates appear in the Certificates list while devices switch over: the replacement shows Renews <name> below its host chips, and the previous live certificate shows Renewed as <name>, revoke this one once every device has switched.

Access sheet showing both the new CI deploy runner certificate with Renews notice and the older expiring certificate with Renewed as notice

Revoke a certificate

  1. To block a certificate immediately, click Revoke (the crossed-shield icon) on its row under Certificates, or click Revoke the old one on the renewal completion screen. Revoke is available on active, expiring, and expired certificates.
  2. In the Revoke certificate confirmation dialog, review the warning (Every device using <name> is refused on its next request, and its open connections, WebSockets included, are closed. This cannot be undone.) and click Revoke (or Cancel to keep it active). If no other certificate uses the same key, Certificate revoked appears, the dialog closes, and the certificate moves to Expired and revoked.

Revoke certificate confirmation modal stacked over the Access sheet with the pointer on Revoke

  1. If other active certificates share the same key (for example, after renewing with I have my own key using the same key pair), the dialog stays open and displays an amber notice listing every matching certificate: Revoked. Another certificate uses the same key and still works: <name>. If the key may have been exposed, revoke it too. Click Done to leave the remaining certificate active, or click Revoke it (or Revoke all when multiple certificates share the key) to revoke them as well.

Revoke certificate modal showing the same-key amber warning and the pointer on Revoke it

View expired and revoked certificates

  1. Whenever a domain has past certificates, an Expired and revoked (<count>) toggle appears at the bottom of Certificates (below No active certificates. if none are active). Click Expired and revoked (<count>) to expand the section and inspect each row's Expired or Revoked badge, expiration or revocation date, allowed hosts, and renewal history. Expired certificates still include Renew and Revoke buttons, while revoked certificates show no actions. Click the toggle again to collapse the section.

Access sheet with Expired and revoked (2) expanded showing one Expired certificate with Renew and Revoke buttons and one Revoked certificate