Skip to content

docs(gitlab): troubleshoot groups that require fine-grained tokens - #79

Open
setlin-hacktron wants to merge 1 commit into
mainfrom
setlin/web-1197-gitlab-fine-grained-tokens
Open

setlin-hacktron wants to merge 1 commit into
mainfrom
setlin/web-1197-gitlab-fine-grained-tokens

Conversation

@setlin-hacktron

Copy link
Copy Markdown
Contributor

Part of WEB-1197
Web PR: https://github.com/HacktronAI/web/pull/1394

What

platform/repositories/gitlab.mdx:

  • Troubleshooting entry. When a top-level group has "Require fine-grained personal access tokens after a specific date" enforced, GitLab still lets a legacy token list the group's projects but rejects every project call (webhooks, branches, merge requests, deploy tokens) with 403 insufficient_granular_scope. Every Hacktron error used to point at Maintainer access. The entry names the setting and shows where a group Owner turns it off. The web PR changes Hacktron's error message to name the same setting.
  • Scopes. Says api alone is enough (it covers read_api and read_user). The web PR changes the connect modal and onboarding from api, read_api, read_user to api to match.
  • Token type. Says Hacktron needs a legacy personal access token for now. Fine-grained token support is a separate follow-up.

The "log in as the service account" copy the ticket mentions was only in the web app's onboarding step, and the web PR fixes it. These docs already describe the Settings > Service Accounts > Manage access tokens flow.

🤖 Generated with Claude Code

https://claude.ai/code/session_01DE6hCfReJxrQHuF9gesdqv

Add a troubleshooting entry for the top-level group setting that makes
GitLab reject legacy personal access tokens on every project endpoint
(403 insufficient_granular_scope), note that only the `api` scope is
needed, and say Hacktron needs a legacy token for now.

Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01DE6hCfReJxrQHuF9gesdqv

This branch has not been deployed

No deployments
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant