GitLab API

GitlabTool
Join our community

Actions1000

Overview

This node operation retrieves SSH certificates associated with a specific GitLab group by making an API call to the GitLab server. It is useful for managing and auditing SSH keys linked to group access in GitLab, especially in DevOps and security workflows.

Use Case Examples

  1. Fetch SSH certificates for a GitLab group to verify authorized keys.
  2. Automate the retrieval of SSH certificates for groups to integrate with security monitoring tools.

Properties

Name Meaning
Skip Authentication Option to bypass authentication for the API request.
Authentication Type of authentication used for the API request, defaulting to GitLab API key.
baseUrl Base URL of the GitLab instance to which the API request is sent.
Method HTTP method used for the API request, default is GET.
Query Parameters Optional query parameters for pagination such as page number and items per page.
Path Parameters Path parameters required for the API endpoint, specifically the group ID.

Output

JSON

  • ssh_certificates - List of SSH certificates associated with the specified GitLab group

Dependencies

  • GitLab API key credential

Troubleshooting

  • Ensure the group ID provided in the path parameters is valid and exists in the GitLab instance.
  • Verify that the API key used for authentication has sufficient permissions to access group SSH certificates.
  • Check the baseUrl to confirm it points to the correct GitLab instance, especially if using a self-hosted GitLab server.
  • If pagination parameters are used, ensure they are valid integers to avoid request errors.

Links

Discussion