Keys and IPs
The credential has a set of public keys and an IP allowlist. Both follow the same asymmetry: widening access waits 18 hours; narrowing it is immediate. The grace period exists so a human can see an alert if someone took the account and tried to register their own key or IP.
Host: https://client.api.corpx.com. Every call carries the
signing headers.
Rotate a key
Each credential accepts more than one active public key, so rotation has no 401 window:
POST /v1/backoffice/tenants/{tenantId}/credentials/{clientId}/public-keyswith the new key. The response isstatus: pendingandactiveFrom18 hours ahead.- After those 18h, your server starts signing with the new
kid. DELETE .../public-keys/{kid}retires the old one — immediate.
The API refuses to retire the last usable key (409 last_public_key):
that would leave the credential unusable, with no way back.
publicKeyPem is a -----BEGIN PUBLIC KEY----- (SPKI) block for EC P-256
or RSA ≥ 2048. A private-key PEM is refused with 422 invalid_public_key.
IP allowlist
Every credential declares which IPs it may call from — 1 to 20 CIDRs,
required at issuance. A request from outside the list is refused at the
edge, before the token (403 ip_not_allowed).
PUT takes the whole set ({"ips": [...]}):
ips is what applies now; pendingIps is the set that takes over when
the grace ends. If every entry in the PUT is new, the old list keeps
applying in the interval — the intent is to change IPs, not to sit
disconnected for 18 hours.
If your server’s egress IP changed (NAT, new provider), register the new CIDR, wait 18h, then change routing. Until then the old list still applies.
If you can’t wait, open a ticket with the internet bank. CorpX can release
the IPs in grace right away, with the ticket and the approval of an
administrator other than the person who asked; from then on pendingIps is
gone and the IPs are in ips. Neither the credential nor the master can
expedite it through the API.
What the holder sees
The bank’s internet banking shows the credential’s keys and IPs. Revoking the whole credential is immediate and invalidates token, keys and allowlist.