Zitadel

Overview

This node integrates with the Zitadel API, allowing users to perform various operations across multiple Zitadel services such as UserService, OrganizationService, AuthService, ManagementService, AdminService, ZITADELActions, and UserSchemaService. Specifically, for the passwordReset operation under the UserService resource, it facilitates triggering a password reset process for a user by providing necessary parameters like user ID, whether to send a reset link, and a return code.

Common scenarios where this node is beneficial include:

• Automating user management workflows in applications that use Zitadel for identity and access management.
• Resetting user passwords programmatically without manual intervention.
• Integrating password reset functionality into custom automation or workflow pipelines.

Practical example:

• A workflow that detects suspicious login activity could automatically trigger a password reset for the affected user by calling this node with the passwordReset operation.

Properties

Output

The node outputs a JSON object containing the response from the Zitadel API corresponding to the invoked operation. For the passwordReset operation, the output JSON will typically include details about the password reset request status or any relevant metadata returned by the API.

No binary data output is produced by this node.

Example output structure (simplified):

{
  "json": {
    // Response fields from Zitadel's password reset API call
  }
}

Dependencies

• Requires an API authentication token (Personal Access Token) for Zitadel, which must be configured in the node credentials.
• Depends on the Zitadel gRPC client libraries bundled within the node for communication with Zitadel services.
• Network access to the Zitadel API endpoint (https://zitadel.studentcouncil.dk) is required.

Troubleshooting

• Invalid Credentials: If the API token is missing or invalid, the node will fail to authenticate. Ensure the correct API key/token is set up in the node credentials.
• Incorrect Parameters: Missing or malformed parameters like userId, sendLink, or returnCode can cause errors. Verify all required inputs are provided and correctly formatted.
• Network Issues: Connectivity problems to the Zitadel API endpoint will result in request failures. Check network settings and firewall rules.
• JSON Parsing Errors: The node attempts to parse input parameters as JSON if possible. Providing invalid JSON strings may cause parsing errors. Use plain strings where appropriate.

Links and References

• Zitadel Official Documentation
• Zitadel API Reference
• n8n Documentation