forgejo/docs/content/doc/developers
Chongyi Zheng de484e86bc
Support scoped access tokens (#20908)
This PR adds the support for scopes of access tokens, mimicking the
design of GitHub OAuth scopes.

The changes of the core logic are in `models/auth` that `AccessToken`
struct will have a `Scope` field. The normalized (no duplication of
scope), comma-separated scope string will be stored in `access_token`
table in the database.
In `services/auth`, the scope will be stored in context, which will be
used by `reqToken` middleware in API calls. Only OAuth2 tokens will have
granular token scopes, while others like BasicAuth will default to scope
`all`.
A large amount of work happens in `routers/api/v1/api.go` and the
corresponding `tests/integration` tests, that is adding necessary scopes
to each of the API calls as they fit.


- [x] Add `Scope` field to `AccessToken`
- [x] Add access control to all API endpoints
- [x] Update frontend & backend for when creating tokens
- [x] Add a database migration for `scope` column (enable 'all' access
to past tokens)

I'm aiming to complete it before Gitea 1.19 release.

Fixes #4300
2023-01-17 15:46:03 -06:00
..
api-usage.en-us.md Remove insecure flag from curl (#21074) 2022-09-05 14:22:44 +01:00
api-usage.zh-cn.md Update curl usage in API docs (#21071) 2022-09-05 03:22:03 -04:00
guidelines-backend.en-us.md Refactor docs (#21627) 2022-10-31 23:16:19 +00:00
guidelines-frontend.en-us.md Fix broken link to frontend guidelines in hacking guidelines (#21382) 2022-10-11 21:23:21 -04:00
hacking-on-gitea.en-us.md inline gitpod image (#21494) 2022-10-18 09:55:57 +08:00
integrations.en-us.md Pre-fill suggested New File 'name' and 'content' with Query Params (#16556) 2021-07-29 05:39:46 +02:00
integrations.zh-tw.md docs: Fix broken anchors in links to awesome-gitea (#16331) 2021-07-03 21:42:33 +01:00
migrations.en-us.md Add markdownlint (#20512) 2022-07-28 09:22:47 +08:00
migrations.zh-tw.md Add markdownlint (#20512) 2022-07-28 09:22:47 +08:00
oauth2-provider.en-us.md Support scoped access tokens (#20908) 2023-01-17 15:46:03 -06:00
oauth2-provider.zh-tw.md Use neutral language in comments and docs (#20135) 2022-06-25 17:50:12 -05:00