Skip to content

Add docs for personal access tokens

Achilleas Pipinellis requested to merge docs/personal-access-tokens into master

What does this MR do?

Create a dedicated personal access tokens document.

Places where access tokens are mentioned and should link back to the new docs page:

  • api/oauth2.md:94:2. These users can access the API using [personal access tokens] instead.
  • api/oauth2.md:104:Never store the users credentials and only use this grant type when your client is deployed to a trusted environment, in 99% of cases [personal access tokens] are a better choice.
  • api/oauth2.md:137:[personal access tokens]: ./README.md#personal-access-tokens
  • api/README.md:83:access tokens.
  • api/README.md:124:You can create as many personal access tokens as you like from your GitLab
  • api/session.md:6:2. These users can access the API using [personal access tokens] instead.
  • api/session.md:55:[personal access tokens]: ./README.md#personal-access-tokens
  • ci/docker/using_docker_build.md:286: to pass a personal access token instead of your password in order to login to
  • user/project/container_registry.md:118:The preferred way to do this, is by using personal access tokens, which can be
  • user/project/new_ci_build_permissions_model.md:216: to pass a personal access token instead of your password in order to login to
  • user/profile/account/two_factor_authentication.md:136:1. Save the personal access token somewhere safe.
  • user/profile/account/two_factor_authentication.md:138:When using Git over HTTPS on the command line, enter the personal access token
  • user/profile/account/two_factor_authentication.md:125:## Personal access tokens

Next iteration:

Tokens description:

  • read_user: Allows access to the read-only endpoints under /users. Essentially, any of the GET requests in the Users API are allowed.
  • api: Complete access to the API.
  • read_registry: Allows to read container registry images.

Relevant issues

Closes https://gitlab.com/gitlab-org/gitlab-ce/issues/31740 and https://gitlab.com/gitlab-org/gitlab-ce/issues/33261.

Relevant to https://gitlab.com/gitlab-org/gitlab-ce/issues/27450

Edited by Achilleas Pipinellis

Merge request reports