GitLab API icon

GitLab API

Gitlab
Join our community

Actions917

Overview

This node interacts with the GitLab API to reset the authentication token for runners. It is useful in scenarios where a user needs to invalidate and regenerate the authentication token for GitLab runners, enhancing security or resolving token-related issues. For example, a DevOps engineer might use this node to reset runner tokens after a security breach or when rotating credentials.

Use Case Examples

  1. Resetting the authentication token for a GitLab runner to ensure security after a suspected token compromise.
  2. Automating the token reset process for GitLab runners as part of a CI/CD pipeline maintenance routine.

Properties

Name Meaning
Skip Authentication Determines whether to skip authentication for the API request.
Authentication Specifies the authentication method to use, defaulting to GitLab API key authentication.
baseUrl The base URL of the GitLab instance to which the API requests are sent.
Method The HTTP method used for the API request, defaulting to GET but can be POST, PUT, DELETE, HEAD, or PATCH.
Parameter Schema Defines the schema for the parameters sent in the request body for the reset authentication token operation.
Request Body Schema Defines the schema for the request body, if applicable, for the reset authentication token operation.
Request Path The API endpoint path for resetting the runner's authentication token.

Output

JSON

  • response - The JSON response from the GitLab API after resetting the runner's authentication token, typically including the new token and related runner information.

Dependencies

  • GitLab API key credential for authentication

Troubleshooting

  • Ensure the GitLab API key credential is valid and has sufficient permissions to reset runner tokens.
  • Verify the baseUrl is correctly set to the GitLab instance URL.
  • Check that the HTTP method is set to POST as required by the reset authentication token endpoint.
  • If the API returns an authentication error, confirm that 'Skip Authentication' is not enabled unless intentionally bypassing authentication.

Links

Discussion