Authentication
The CEX integration uses two distinct kinds of authentication. Keep them separate:
| Portal login | API key | |
|---|---|---|
| Who | A human operator | Your server |
| Where | Browser, partner portal | X-Api-Key header on every request |
| Purpose | Create, rotate, revoke keys; accept pools; register omnibus | Make API calls |
| Lifetime | Session (+ 2FA step-up for sensitive actions) | Until rotated / revoked / expired |
- Humans log in to the portal to manage keys and account setup — they never put portal credentials in code.
- Machines present a key in the
X-Api-Keyheader to call the API — they never see the portal login flow.
The one place the two connect is generating a key: a human, in a portal session, mints the key your server uses from then on.