Commit b2c817e
committed
fix(docs): describe a self-issued credential by the kind it actually is
Round two returned the same finding on 14 pages: the one sentence covering
self-issued credentials still read as if the scope table were something to
apply to them. It cannot be one sentence, because the credential models
differ in what is true about them.
A Google service account is the sharp case. Its access comes from the key
and the domain-wide delegation granted in Workspace, and
`getServiceAccountToken` strips the two `userinfo` scopes from the JWT
because Google rejects user-identity scopes for a service account. Naming
those scopes beside that credential describes access it can never hold.
A pasted API token is the opposite: most have no permission picker at all
and simply carry their creating account's access, so any instruction to
grant something sends the reader looking for a setting that does not
exist.
Carry the `serviceAccountProviderId` through the docs catalog instead of a
boolean, and pick the sentence from it. Neither variant tells the reader to
match the table.
The excluded identity scopes now live in `scopes.ts` and
`credential-service.ts` imports them, so the published claim and the filter
that makes it true cannot drift apart.
The self-hosting reference gains one line saying what every table on it is:
the OAuth flow's request, and so what the app registration must allow. A
credential issued by hand is not governed by it.1 parent 872d91f commit b2c817e
37 files changed
Lines changed: 140 additions & 53 deletions
File tree
- apps
- docs/content/docs
- integrations
- platform/self-hosting
- sim/lib/oauth
- scripts
| Original file line number | Diff line number | Diff line change | |
|---|---|---|---|
| |||
41 | 41 | | |
42 | 42 | | |
43 | 43 | | |
44 | | - | |
| 44 | + | |
45 | 45 | | |
46 | 46 | | |
47 | 47 | | |
| |||
| Original file line number | Diff line number | Diff line change | |
|---|---|---|---|
| |||
38 | 38 | | |
39 | 39 | | |
40 | 40 | | |
41 | | - | |
| 41 | + | |
42 | 42 | | |
43 | 43 | | |
44 | 44 | | |
| |||
| Original file line number | Diff line number | Diff line change | |
|---|---|---|---|
| |||
46 | 46 | | |
47 | 47 | | |
48 | 48 | | |
49 | | - | |
| 49 | + | |
50 | 50 | | |
51 | 51 | | |
52 | 52 | | |
| |||
| Original file line number | Diff line number | Diff line change | |
|---|---|---|---|
| |||
48 | 48 | | |
49 | 49 | | |
50 | 50 | | |
51 | | - | |
| 51 | + | |
52 | 52 | | |
53 | 53 | | |
54 | 54 | | |
| |||
| Original file line number | Diff line number | Diff line change | |
|---|---|---|---|
| |||
73 | 73 | | |
74 | 74 | | |
75 | 75 | | |
76 | | - | |
| 76 | + | |
77 | 77 | | |
78 | 78 | | |
79 | 79 | | |
| |||
| Original file line number | Diff line number | Diff line change | |
|---|---|---|---|
| |||
46 | 46 | | |
47 | 47 | | |
48 | 48 | | |
49 | | - | |
| 49 | + | |
50 | 50 | | |
51 | 51 | | |
52 | 52 | | |
| |||
| Original file line number | Diff line number | Diff line change | |
|---|---|---|---|
| |||
39 | 39 | | |
40 | 40 | | |
41 | 41 | | |
42 | | - | |
| 42 | + | |
43 | 43 | | |
44 | 44 | | |
45 | 45 | | |
| |||
| Original file line number | Diff line number | Diff line change | |
|---|---|---|---|
| |||
43 | 43 | | |
44 | 44 | | |
45 | 45 | | |
46 | | - | |
| 46 | + | |
47 | 47 | | |
48 | 48 | | |
49 | 49 | | |
| |||
| Original file line number | Diff line number | Diff line change | |
|---|---|---|---|
| |||
38 | 38 | | |
39 | 39 | | |
40 | 40 | | |
41 | | - | |
| 41 | + | |
42 | 42 | | |
43 | 43 | | |
44 | 44 | | |
| |||
| Original file line number | Diff line number | Diff line change | |
|---|---|---|---|
| |||
41 | 41 | | |
42 | 42 | | |
43 | 43 | | |
44 | | - | |
| 44 | + | |
45 | 45 | | |
46 | 46 | | |
47 | 47 | | |
| |||
0 commit comments