ACME Accounts in the pkiaas CLI
Overview
An ACME account is an ACME client (certbot, win-acme, Certify The Web, Traefik, …) registered under an ACME policy with its own key, which signs its requests. Clients register with an EAB or, before EABs, a provisioning URL.
The pkiaas acme account commands list a CA’s ACME accounts, show one, and revoke one. They work in the active CA, or the one --ca names (see Choose Your CA). An account is named by its ID: the number at the end of its account URL, which certbot show_account also prints. It isn’t a certificate serial.
The last use, the client and the EAB or provisioning URL an account registered with are recorded since 2026-10-27. Accounts not used since then show - or “not recorded” there.
List Accounts
$ pkiaas acme account listACME accounts of Example Issuing CA (a1B2c3D4e5)ID STATUS POLICY CONTACT CLIENT LAST USED ORDERS CERTS1204 valid Web servers (205) ops@example.com CertbotACMEClient/5.8.0 2026-11-05T14:14:03Z 14 121150 revoked Web servers (205) old-web@example.com win-acme/2.2.9.1701 2026-10-29T09:30:12Z 0 2 412 valid Web servers (205) noc@example.com - - 0 41 377 deactivated Intranet (206) - - - 0 04 accounts; "-" under CLIENT and LAST USED: not recorded (accounts used only before 2026-10-27)The most recently used accounts come first, and never-used ones last.
- Status:
validaccounts can order certificates.deactivatedmeans its client ended it, andrevokedmeans a CA member revoked it. Neither can be undone. - Client: the User-Agent of its last request, as the client sent it.
- Orders and certs: how many orders the account made, and how many of them got a certificate. Orders that got no certificate are deleted some time after they expire.
- Filters:
--policy "Web servers"keeps one policy’s accounts, and--status valid,deactivated,revokedthose with one of the statuses.--search certbotkeeps those whose contacts, client or initial IP address contain the text, in any case. An ID matches that account. - Sorting:
--sorttakesid,contact,policy,status,client,createdAt,lastUsedAt,orderCountorcertificateCount, with--order asc(the default with--sort) ordesc. - Limit: it lists the first 50 accounts.
--limitraises that to at most 1000.
Show an Account
$ pkiaas acme account show 1204ACME account 1204 of Example Issuing CA (a1B2c3D4e5) URL: https://acme-v02-api.pkiaas.io/acme/acct/1204 Status: valid ACME policy: Web servers (205) Contacts: ops@example.com Created: 2026-10-28T14:02:11Z Last used: 2026-11-05T14:14:03Z Client: CertbotACMEClient/5.8.0 (certbot; Ubuntu 24.04) Authenticator/dns-cloudflare Initial IP: 203.0.113.24 Registered with: EAB web-servers (57) Key: ES256, thumbprint pX3cJ0b1u9vYbq0s8yX5ZcT2wq3Fh7Lr1nM4aKd6sQk Orders: 14 Certificates: 12 (last order 2026-11-05T14:13:58Z)The key’s thumbprint is its RFC 7638 SHA-256 thumbprint. List its orders with pkiaas acme order list --acme-account 1204.
Contacts and the client are text the ACME client chose. The text output escapes control characters in them, and --json gives them as stored.
Revoke an Account
Revoking an account stops its client from ordering or renewing certificates: the ACME server refuses every request signed with its key. It can’t be undone.
$ pkiaas acme account revoke 1204ACME account 1204: valid, Web servers (205), ops@example.com, CertbotACMEClient/5.8.0Revoke ACME account 1204? Its client can't order or renew certificates any more, and this can't be undone. [y/N] yRevoked ACME account 1204 Status: revoked Inactive since: 2026-11-06T15:20:44ZIts 12 certificates stay valid; revoke any that mustn't be used with `pkiaas cert revoke SERIAL`.Its key can't register again, but a new key can while policy Web servers (205) has enabled EABs or provisioning URLs;to keep the client out, disable them too: pkiaas acme eab list --policy 205 --status enabled- Certificates stay valid. Revoke any that mustn’t be used with
pkiaas cert revoke SERIAL(see Certificates). - Keep the client out: its key can’t register again, but the client could register a new key while the policy has enabled EABs or provisioning URLs. Disable those too, with
pkiaas acme eab update ID --enabled off. - Without a terminal, add
--yesto revoke without asking. - Safe to run again: an account that is revoked already, or that its client deactivated, is left as it is, and the command says so and succeeds.