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.
git-ecosystem · Jun 1, 2022 · 197b458 · 197b458
1 parent e284ef4
commit 197b458
Show file tree

Hide file tree

Showing 3 changed files with 15 additions and 0 deletions.
diff --git a/docs/faq.md b/docs/faq.md
@@ -150,3 +150,18 @@ After revoking access, any tokens created by GCM will be invalidated and can no
 ### I used the install from source script to install GCM on my Linux distribution. Now how can I uninstall GCM and its dependencies?
 
 Please see full instructions [here](./linux-fromsrc-uninstall.md).
+
+### How do I revoke access for a GitLab OAuth app?
+
+There are some scenarios (e.g. updated scopes) for which you will need to manually revoke and re-authorize access to a GitLab OAuth Application. You can do so by:
+
+1. Navigating to https://gitlab.com/-/profile/applications.
+2. Scrolling to **Authorized applications**.
+3. Clicking the **Revoke** button next to the name of the app for which you would like to revoke access (Git Credential Manager is used here for demonstration purposes).
+
+   ![](./img/gitlab-oauthapp-revoke.png)
+4. Waiting for a notification stating **The application was revoked access**.
+
+   ![](./img/gitlab-oauthapp-revoked.png)
+5. Re-authorizing the application with the new scope (GCM should automatically initiate this flow for you next time access is requested).
+
diff --git a/docs/img/gitlab-oauthapp-revoke.png b/docs/img/gitlab-oauthapp-revoke.png
diff --git a/docs/img/gitlab-oauthapp-revoked.png b/docs/img/gitlab-oauthapp-revoked.png