Zitadel

Overview

This node integrates with the Zitadel API to perform various operations across multiple services such as UserService, OrganizationService, AuthService, ManagementService, AdminService, ZITADELActions, and UserSchemaService. Specifically, for the setPassword operation under the UserService resource, it allows updating a user's password by providing the user ID, current password, new password, and a verification code.

Common scenarios where this node is beneficial include:

• Automating user password resets or updates within an organization's identity management system.
• Integrating password management workflows into broader automation pipelines.
• Enforcing security policies by programmatically changing passwords after verification.

Practical example:

• An admin workflow that triggers when a user requests a password reset, using the setPassword operation to update the password securely after verifying the user's identity via a verification code.

Properties

Output

The node outputs a JSON object representing the response from the Zitadel API for the invoked operation. For the setPassword operation, the output JSON typically contains confirmation details about the password update status or any relevant metadata returned by the API.

No binary data output is produced by this node.

Example output structure (simplified):

{
  "result": {
    "success": true,
    "message": "Password updated successfully"
  }
}

Dependencies

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

Troubleshooting

• Invalid Credentials: If the API token is missing or invalid, the node will fail to authenticate. Ensure the correct API key credential is configured.
• Incorrect Parameters: Missing or malformed parameters like userId, newPassword, currentPassword, or verificationCode can cause errors. Verify all required fields are provided and correctly formatted.
• Verification Code Errors: If the verification code is expired or incorrect, the password update will be rejected. Confirm the code validity before running the node.
• Network Issues: Connectivity problems to the Zitadel API endpoint may cause timeouts or failures. Check network access and endpoint availability.
• JSON Parsing Errors: The node attempts to parse input parameters as JSON if possible; invalid JSON strings will fallback to raw string usage. Ensure inputs are properly formatted.

Links and References

• Zitadel Official Documentation
• Zitadel API Reference
• n8n Documentation on Creating Custom Nodes