ZitadelInstall

Overview

This node integrates with the Zitadel API, allowing users to perform various operations on different Zitadel services. Specifically, for the setPassword operation under the default resource, it enables updating a user's password by providing the current password, a new password, and a verification code. This is useful in scenarios where an administrator or user needs to securely change their password within the Zitadel identity management system.

Practical examples include:

• Resetting a user's password after verifying their identity.
• Allowing users to update their passwords as part of a security policy enforcement.
• Automating password changes during user onboarding or offboarding processes.

Properties

Output

The node outputs a JSON object representing the response from the Zitadel API's setPassword method. This typically includes confirmation of the password change or any relevant status information returned by the API.

No binary data output is produced by this operation.

Example output structure (simplified):

{
  "result": {
    // API-specific fields confirming password update success or failure
  }
}

Dependencies

• Requires an API authentication token (Personal Access Token) for Zitadel, configured in the 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 Credentials: If the API token is missing or invalid, the node will fail to authenticate. Ensure the correct API key/token is configured.
• Incorrect Parameters: Missing or malformed parameters like userId, currentPassword, newPassword, or verificationCode can cause errors. Verify all required fields are correctly filled.
• Verification Code Issues: If the verification code is expired or incorrect, the password change will be rejected. Confirm the code is valid and has not timed out.
• Network/Endpoint Errors: Connectivity issues to the Zitadel API endpoint may cause failures. Check network access and endpoint URL correctness.

Common error messages usually relate to authorization failures, invalid input data, or service unavailability. Reviewing the exact API response in the node output can help diagnose these issues.

Links and References

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