GitLab API

GitlabTool
Join our community

Actions1000

Overview

This node operation retrieves the job token scope groups allowlist for a specific project in GitLab. It is useful for scenarios where you need to manage or audit the groups that are allowed to use job tokens within a project, enhancing security and access control. For example, a DevOps engineer might use this to verify which groups have job token access to a project before deploying CI/CD pipelines.

Use Case Examples

  1. Retrieve the list of groups allowed to use job tokens for project ID 123 to ensure only authorized groups have access.
  2. Paginate through the allowlist groups to audit permissions across multiple pages.

Properties

Name Meaning
Skip Authentication Option to skip authentication for the request, useful for public or unauthenticated endpoints.
Authentication The authentication method used for the request, typically an API key or token for GitLab.
baseUrl The base URL of the GitLab instance, defaulting to https://gitlab.com.
Method HTTP method to use for the request, default is GET.
Query Parameters Optional query parameters for pagination, including page number and items per page.
Path Parameters Path parameters required for the request, specifically the project ID.

Output

JSON

  • groups - Array of groups allowed to use job tokens in the specified project
  • pagination
    • page - Current page number of the results
    • per_page - Number of items per page in the results
    • total - Total number of items available
    • total_pages - Total number of pages available

Dependencies

  • GitLab API authentication token

Troubleshooting

  • Ensure the project ID is valid and accessible with the provided authentication token.
  • Check that the base URL is correct and points to the intended GitLab instance.
  • Verify that the authentication token has sufficient permissions to access project job token scope allowlist data.
  • If pagination parameters are used, ensure they are valid integers and within the allowed range.

Links

Discussion