Common Token Claims
The following are claims in common, used within the kya, pay, and kya-pay tokens.
Header
| Claim | Description |
|---|---|
alg (algorithm) | Cryptographic algorithm to sign the token |
kid (key ID) | JWT key ID |
typ (type) | Type of the token - MUST be kya+jwt, pay+jwt, or kya-pay+jwt |
Payload
| Claim | Description |
|---|---|
env (environment) | Issuer environment - production or sandbox |
btg (buyer tag) | OPTIONAL - An opaque reference ID internal to the buyer. |
ssi (seller service ID) | OPTIONAL - Seller Service ID that this token was created for. |
sdm (seller domain) | OPTIONAL - Seller domain, associated with the audience claim, the token is intended for. |
ori (originator) | OPTIONAL - URL of the token's originator. |
iat (issued at) | Identifies the time at which the JWT was issued. This claim must have a value in the past and can be used to determine the age of the JWT. |
iss (issuer) | URL of the token's issuer. Used for discovering JWK Sets for token signature verification, via the /.well-known/jwks.json suffix mechanism. |
jti (JWT ID) | Provides a unique identifier (UUID) for the JWT. The value may be used for rate limiting. Note a token may be used multiple times by the agent until it expires. |
aud(audience) | Seller agent ID, used for audience binding and replay attack mitigation. |
sub (subject) | Subject Identifier. Must be pairwise unique within a given issuer. On Skyfire, the ID of the buyer agent that created the token. For an agent that belongs to an agent group, this is the agent's own ID, not the group's. |
exp (expiration time) | Identifies the expiration time on or after which the JWT MUST NOT be accepted for processing. |
Additional claims MAY be defined and used in these tokens. The recipient MUST ignore any unrecognized claims.
Updated 17 days ago
Did this page help you?

