Skip to content

Commit 47df201

Browse files
committed
docs: FAQ on revoking GitLab OAuth Application
Add FAQ entry detailing how to revoke/re-authorize a GitLab OAuth Application's access. This is needed when the application is updated, e.g. when new scopes are added to it.
1 parent e284ef4 commit 47df201

File tree

3 files changed

+14
-0
lines changed

3 files changed

+14
-0
lines changed

docs/faq.md

Lines changed: 14 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -150,3 +150,17 @@ After revoking access, any tokens created by GCM will be invalidated and can no
150150
### I used the install from source script to install GCM on my Linux distribution. Now how can I uninstall GCM and its dependencies?
151151

152152
Please see full instructions [here](./linux-fromsrc-uninstall.md).
153+
154+
### How do I revoke access for a GitLab OAuth application?
155+
156+
There are some scenarios (e.g. updated scopes) for which you will need to manually revoke and re-authorize access for a GitLab OAuth application. You can do so by:
157+
158+
1. Navigating to [the **Applications** page within your **User Settings**](https://gitlab.com/-/profile/applications).
159+
2. Scrolling to **Authorized applications**.
160+
3. Clicking the **Revoke** button next to the name of the application for which you would like to revoke access (Git Credential Manager is used here for demonstration purposes).
161+
162+
![Button to revoke GitLab OAuth Application access](./img/gitlab-oauthapp-revoke.png)
163+
4. Waiting for a notification stating **The application was revoked access**.
164+
165+
![Notifaction of successful revocation](./img/gitlab-oauthapp-revoked.png)
166+
5. Re-authorizing the application with the new scope (GCM should automatically initiate this flow for you next time access is requested).

docs/img/gitlab-oauthapp-revoke.png

139 KB
Loading

docs/img/gitlab-oauthapp-revoked.png

44.5 KB
Loading

0 commit comments

Comments
 (0)