diff options
| author | Douwe Maan <douwe@selenight.nl> | 2017-03-07 09:29:55 -0600 |
|---|---|---|
| committer | Douwe Maan <douwe@selenight.nl> | 2017-03-07 09:29:55 -0600 |
| commit | 6a52cda31da4becc3e342530a2bdf0868d8921cc (patch) | |
| tree | c1dda64455fb29597100513596ae02f1d1946089 /doc/api/README.md | |
| parent | 61cfe6dea6f2d6725771a0f341e70975cf91c7f7 (diff) | |
| parent | 005749a616c19b90d6ec0415df9ae5e35151e33c (diff) | |
| download | gitlab-ce-6a52cda31da4becc3e342530a2bdf0868d8921cc.tar.gz | |
Merge remote-tracking branch 'origin/personal_access_token_api_and_impersonation_token'
Diffstat (limited to 'doc/api/README.md')
| -rw-r--r-- | doc/api/README.md | 8 |
1 files changed, 8 insertions, 0 deletions
diff --git a/doc/api/README.md b/doc/api/README.md index 45048294298..58d090b8f5e 100644 --- a/doc/api/README.md +++ b/doc/api/README.md @@ -221,6 +221,14 @@ GET /projects?private_token=9koXpg98eAheJpvBs5tK&sudo=23 curl --header "PRIVATE-TOKEN: 9koXpg98eAheJpvBs5tK" --header "SUDO: 23" "https://gitlab.example.com/api/v4/projects" ``` +## Impersonation Tokens + +Impersonation Tokens are a type of Personal Access Token that can only be created by an admin for a specific user. These can be used by automated tools +to authenticate with the API as a specific user, as a better alternative to using the user's password or private token directly, which may change over time, +and to using the [Sudo](#sudo) feature, which requires the tool to know an admin's password or private token, which can change over time as well and are extremely powerful. + +For more information about the usage please refer to the [Users](users.md) page + ## Pagination Sometimes the returned result will span across many pages. When listing |