Learn what a connectToken is, why it’s needed, and how it’s used to secure passkey management actions in your application.
connectToken
to authorize actions that modify user data. Specifically, you will need to provide a connectToken
for the following:
CorbadoConnectAppend
and CorbadoConnectPasskeyList
connectToken
is a short-lived, single-use token that securely ties a user’s context (e.g., which account is being updated) to a particular action (such as passkey creation, listing, or deletion).
Whenever a flow needs to safely reference a specific user’s account for passkey management, a connectToken
is required. These tokens are created on your server (server-to-server via the Corbado Backend API) and then passed to the relevant front-end component or SDK method.
connectToken
:
Your web or native/mobile application makes a secure API call to your backend to request a connectToken
.connectToken
:
Your backend makes a secure API call to Corbado’s /v2/connectTokens
endpoint (see API Reference). This call identifies the user (for example, through a customerIdentifier
) and specifies the intended action ("passkey-append"
, "passkey-list"
, or "passkey-delete"
).connectToken
(e.g., ctk1_sxmexzS7RFBaJSA4V4kBFPs45bkxMK
). This token tells the UI component or SDK method precisely which user and action it is authorized for (e.g., “create a new passkey for user 123”).connectToken
:
On the frontend or native/mobile application, a Web UI component or SDK method receives the token and initiates the passkey flow. During this process, Corbado checks the token’s validity.connectToken
expires after a short period (configurable in Corbado’s systems) and is valid for one passkey operation (e.g., a single passkey creation). Once expired or used, it cannot be reused. This design helps prevent replay attacks and unauthorized reuse.connectToken
for the specific user and action.