Skip to content

Commit c5ec875

Browse files
committed
fixup! docs: add permissions and tokens page
Signed-off-by: Radek Ježek <radek.jezek@ibm.com>
1 parent bf0ac47 commit c5ec875

1 file changed

Lines changed: 4 additions & 6 deletions

File tree

docs/guides/permissions-and-tokens.mdx

Lines changed: 4 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -284,9 +284,7 @@ Here is an example how you can create a context and generate a custom token with
284284

285285
- Context tokens **cannot** be used to generate other tokens
286286
- The permissions you grant must be a subset of your own permissions
287-
- Context token expiration is 20 minutes. If an agent runs longer it must request a new token using `AuthRequired`
288-
a2a
289-
message.
287+
- Context token expiration is 20 minutes. If an agent runs longer it must request a new token using `AuthRequired` a2a message.
290288
</Note>
291289

292290
### Using Context Tokens in Agent Runs
@@ -496,12 +494,12 @@ to authenticate itself with the platform API, this is abstracted away in the SDK
496494

497495
To make this crystal clear, let's break down the full low-level interaction with an agent that wants to upload a file.
498496
We will use the square brackets `[]` to denote the `Authorization: Bearer` header and placeholders
499-
`ACESS_TOKEN` and `CONTEXT_TOKEN` for the user access token and context token, respectively.
497+
`ACCESS_TOKEN` and `CONTEXT_TOKEN` for the user access token and context token, respectively.
500498

501499
**Part 1: Client code**:
502500
<Steps>
503501
<Step title="OAuth flow">
504-
Execute the Autorization code flow or similar to obtain an **ACCESS_TOKEN** from the identity
502+
Execute the Authorization code flow or similar to obtain an **ACCESS_TOKEN** from the identity
505503
provider (in this flow, the user will log in to the system with their credentials).
506504
</Step>
507505
<Step title="Create Context token">
@@ -562,7 +560,7 @@ We will use the square brackets `[]` to denote the `Authorization: Bearer` heade
562560
</Steps>
563561
<Danger>
564562
At no point did Agent receive or use `ACCESS_TOKEN`. This is on purpose, because based on user role this token
565-
can poses destructive permissions - to delete other agents, read all user data (if the user is ADMIN, etc.).
563+
can possess destructive permissions - to delete other agents, read all user data (if the user is ADMIN, etc.).
566564

567565
To prevent API misuse by untrusted agents, avoid passing the access token to the agent.
568566
</Danger>

0 commit comments

Comments
 (0)