Commit 872d91f
committed
fix(docs): stop the scope tables overstating what a self-issued token grants
Review findings from the first round, all in the generated prose rather
than the scope data.
Only some self-issued credentials have permissions to pick. An Airtable
PAT and a Slack custom bot do; a Wealthbox, Monday or Pipedrive token
carries its creating user's access with no picker at all, and a Google
service account uses domain-wide delegation over a set the JWT flow
filters. Telling every reader to "grant it the same access" sent most of
them looking for a setting that does not exist. Say instead that a
self-issued credential carries whatever access it was created with.
Slack's approval-gated scopes were invisible to a self-hoster. They stay
out of the tables so generated output cannot vary by deployment, but
anyone who sets `SLACK_EXTENDED_SCOPES` has to add them to the app first,
and Slack rejects the entire authorization when the app is not approved
for one. Both the integration page and the self-hosting reference now
name them and their flag, sourced from a new `ENV_GATED_SCOPES` entry that
`getSlackApprovalGatedScopes` also reads, so the prose cannot drift from
the grant.
`Chat.ReadWrite` and `Mail.ReadWrite` were labelled write-only. Both also
read, and these labels show on the consent screen as well as in the docs.
Also switch the scopes import in `oauth.ts` to the absolute specifier its
sibling OAuth imports use.1 parent f690e9b commit 872d91f
39 files changed
Lines changed: 125 additions & 47 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