GitLab API icon

GitLab API

Gitlab

Actions880

Overview

This node operation triggers an LDAP synchronization for a specific GitLab group by making a POST request to the GitLab API endpoint `/api/v4/groups/{id}/ldap_sync`. It is useful for automating the synchronization of group membership and permissions from an LDAP directory to GitLab groups, ensuring that group data is up-to-date with the organization's LDAP server.

Use Case Examples

  1. Automate LDAP sync for a GitLab group after changes in LDAP directory.
  2. Schedule regular LDAP syncs for GitLab groups to maintain consistent access control.

Properties

Name Meaning
Skip Authentication Determines whether to skip API authentication for the request.
Authentication Specifies the authentication method to use if not skipping authentication.
baseUrl The base URL of the GitLab instance to which the request is sent.
Method HTTP method to use for the request, default is GET but POST is used for this operation.
Path Parameters Parameters to be included in the request path, specifically the group ID for LDAP sync.

Output

JSON

  • statusCode - HTTP response status code from the LDAP sync request
  • body - Response body returned by the GitLab API after triggering LDAP sync

Dependencies

  • GitLab API credentials

Troubleshooting

  • Ensure the group ID provided in path parameters is valid and exists in the GitLab instance.
  • Verify that the API credentials have sufficient permissions to perform LDAP synchronization on the group.
  • If skipping authentication, ensure the GitLab instance allows unauthenticated requests for this endpoint, otherwise the request will fail.
  • Check the baseUrl to confirm it points to the correct GitLab instance, especially if using a self-hosted GitLab server.

Links

Discussion