You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: docs/developer/auth.md
+4-2Lines changed: 4 additions & 2 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -228,11 +228,11 @@ Below is a proposal and not yet implemented.
228
228
229
229
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.
230
230
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:
232
232
233
233
### JWT Renew Token Structure
234
234
235
-
JWT tokens issued by Bifrost follow this structure:
235
+
JWT renew tokens follow this structure:
236
236
237
237
**Header**:
238
238
```json
@@ -255,6 +255,8 @@ Where:
255
255
-**delegate**: The original delegate token signed by the issuer. Importantly this token contains the permissions, nonce and delegateKey
256
256
-**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.
257
257
258
+
Note the subtype (styp) in the header is set to renew.
259
+
258
260
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.
0 commit comments