Zitadel icon

Zitadel

Interact with the Zitadel API

Overview

This node integrates with the Zitadel API, allowing users to interact with various Zitadel services programmatically. Specifically, the listIDPLinks operation under the "Default" resource (mapped here as the "UserService") fetches a list of Identity Provider (IDP) links associated with a given user. This is useful in scenarios where you want to retrieve external authentication links or federated identity connections tied to a user account.

Practical examples include:

  • Auditing which external IDPs a user has linked to their account.
  • Displaying linked social or enterprise login providers in a user management dashboard.
  • Automating workflows that depend on a user's linked identity providers.

Properties

Name Meaning
Service The Zitadel service to use. Options: UserService, OrganizationService, AuthService, ManagementService, AdminService, ZITADELActions, UserSchemaService. For this operation, "UserService" is used.
userId The unique identifier of the user whose IDP links are to be listed.
query JSON object specifying query parameters for listing IDP links. Includes:
- limit: Number of results to return (default 10).
- offset: Pagination offset (default 0).
- order: Sort order, e.g., "ASC" for ascending (default).

Output

The output is a JSON object representing the response from the Zitadel API's listIDPLinks method. It contains the data about the IDP links associated with the specified user. The exact structure depends on the Zitadel API but typically includes details such as linked IDP identifiers, types, and metadata.

No binary data output is produced by this node.

Dependencies

  • Requires an API authentication token (Personal Access Token) for Zitadel, provided via node credentials.
  • Connects to the Zitadel API endpoint at https://zitadel.studentcouncil.dk.
  • Uses gRPC client libraries internally to communicate with Zitadel services.

Troubleshooting

  • Invalid or missing API token: Ensure the Zitadel API token credential is correctly configured and valid.
  • Incorrect userId: Verify that the userId parameter corresponds to an existing user in Zitadel.
  • Malformed JSON in query property: The query input must be valid JSON. Errors parsing this will cause the request to fail.
  • Operation not found: If the selected operation does not exist in the chosen service, the node returns empty JSON.
  • Network issues: Connectivity problems to the Zitadel API endpoint will cause errors; check network access and endpoint availability.

Links and References

Discussion