ZitadelInstall

Overview

This node integrates with the Zitadel API, allowing users to perform various operations across multiple Zitadel services. Specifically, for the createPasskeyRegistrationLink operation under the UserService resource, it creates a registration link for passkey authentication associated with a user. This is useful in scenarios where you want to enable passwordless login or multi-factor authentication by generating secure passkey registration links that can be sent to users.

Practical examples include:

• Automating the creation and distribution of passkey registration links to new or existing users.
• Integrating passkey-based authentication flows into your user management system.
• Enhancing security by enabling users to register hardware-backed credentials or biometric authentication methods.

Properties

Output

The node outputs a JSON object containing the response from the Zitadel API for the invoked operation. For createPasskeyRegistrationLink, this typically includes details about the generated registration link, such as the URL and any metadata related to the passkey registration process.

If the operation involves binary data (not indicated here), the node would output it accordingly, but in this case, the output is purely JSON.

Example output structure (conceptual):

{
  "registrationLink": "https://zitadel.example.com/passkey/register?token=abc123",
  "expiresAt": "2024-12-31T23:59:59Z",
  "userId": "user-xyz"
}

Dependencies

• Requires an API key credential for authenticating with the Zitadel API.
• The node uses gRPC clients generated from Zitadel's protobuf definitions to communicate with the API.
• The base URL for the Zitadel API is set to https://zitadel.studentcouncil.dk.
• No additional environment variables are explicitly required beyond the API key credential.

Troubleshooting

• Authentication errors: Ensure the provided API key credential is valid and has sufficient permissions for the requested operation.
• Invalid parameters: The node expects certain parameters like userId, sendLink, and returnCode to be provided when using the createPasskeyRegistrationLink operation. Missing or malformed inputs may cause errors.
• JSON parsing errors: Input parameters are parsed as JSON if possible; invalid JSON strings will fallback to raw strings. Make sure complex parameters are correctly formatted.
• Operation not found: If an unsupported operation is selected, the node returns an empty JSON object. Verify that the operation name matches one supported by the selected service.

Links and References

• Zitadel Official Documentation
• Zitadel API Reference
• Passkey Authentication Concepts