Skip to content

Commit 351fa93

Browse files
authored
Update auth.md
1 parent 38607f3 commit 351fa93

File tree

1 file changed

+4
-2
lines changed

1 file changed

+4
-2
lines changed

docs/developer/auth.md

Lines changed: 4 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -228,11 +228,11 @@ Below is a proposal and not yet implemented.
228228

229229
In general the delegateToken is short lived and cannot be renewed without involving signing byt the issuer wallet. This would require a user interaction in general. This poses a problem for usability in some applications and problems when working with automations and integrations that are long lived.
230230

231-
A delegate token can be marked for renewal (has renew: true, and nonce set in the attributes'). In this case an application can ask bifrost for a renewal certificate. This certificate allows the client (as identified by the delegateKey) to create it's own delegateToken. This delegate token has the following structure:
231+
A delegate token can be marked for renewal (has renew: true, and nonce set in the attributes'). In this case an application can ask bifrost for a renewal certificate. This certificate allows the client (as identified by the delegateKey) to create it's own delegateToken. This renew token has the following structure:
232232

233233
### JWT Renew Token Structure
234234

235-
JWT tokens issued by Bifrost follow this structure:
235+
JWT renew tokens follow this structure:
236236

237237
**Header**:
238238
```json
@@ -255,6 +255,8 @@ Where:
255255
- **delegate**: The original delegate token signed by the issuer. Importantly this token contains the permissions, nonce and delegateKey
256256
- **cert**: The certificate token signed by bifrost. Importantly it contains new created and expiration times as well as the nonce of the original delegate token and a bifrost key id.
257257

258+
Note the subtype (styp) in the header is set to renew.
259+
258260
A client application will periodically ask Bifrost for a new certificate token and build its own renew token based on this. This can then be used in the backend API calls according to the permissions of the original token. If the original token is revoked by the user, bifrost will not issue a new certificate.
259261

260262
Validation of a renew token follows the steps:

0 commit comments

Comments
 (0)