Updated documentation to reflect Mastodon v4.1.0

changes to the application scopes screen.
This commit is contained in:
Justin Warren 2023-02-13 08:59:08 +11:00
parent 2a5873261f
commit b92dd21377
No known key found for this signature in database
1 changed files with 14 additions and 11 deletions

View File

@ -81,17 +81,16 @@ admin to add a new Application at
`https://<instance-domain>/settings/applications/` and then tell you the access `https://<instance-domain>/settings/applications/` and then tell you the access
token. token.
The application needs the `admin:read:domain_blocks` OAuth scope, but The application needs the `admin:read:domain_blocks` OAuth scope. You can allow
unfortunately this scope isn't available in the current application screen full `admin:read` access, but be aware that this authorizes someone to read all
(v4.0.2 of Mastodon at time of writing, but this has been fixed in the main the data in the instance. That's asking a lot of a remote instance admin who
branch). just wants to share domain_blocks with you.
You can allow full `admin:read` access, but be aware that this authorizes The `admin:read:domain_blocks` scope is available as of Mastodon v4.1.0, but for
someone to read all the data in the instance. That's asking a lot of a remote earlier versions admins will need to use the manual method described below.
instance admin who just wants to share domain_blocks with you.
For now, you can ask the instance admin to update the scope in the database You can update the scope for your application in the database directly like
directly like this: this:
``` ```
UPDATE oauth_applications as app UPDATE oauth_applications as app
@ -136,8 +135,12 @@ chmod o-r <configfile>
``` ```
You can also grant full `admin:write` scope to the application, but if you'd You can also grant full `admin:write` scope to the application, but if you'd
prefer to keep things more tightly secured you'll need to use SQL to set the prefer to keep things more tightly secured, limit the scope to
scopes in the database and then regenerate the token: `admin:read:domain_blocks`.
Again, this scope is only available in the application config screen as of
Mastodon v4.1.0. If your instance is on an earlier version, you'll need to use
SQL to set the scopes in the database and then regenerate the token:
``` ```
UPDATE oauth_applications as app UPDATE oauth_applications as app