ZitadelInstall

Overview

This node integrates with the Zitadel API, allowing users to interact with various Zitadel services programmatically. Specifically, for the registerTOTP operation under the "Default" resource, it facilitates registering a Time-based One-Time Password (TOTP) for a user. This is useful in scenarios where multi-factor authentication (MFA) setup is required, enhancing account security by enabling TOTP-based verification.

Practical examples include:

• Automating the enrollment of users into MFA workflows.
• Integrating TOTP registration as part of user onboarding processes.
• Managing user authentication settings programmatically within an organization.

Properties

Output

The node outputs a JSON object representing the response from the Zitadel API for the invoked operation. For registerTOTP, this will typically include details about the TOTP registration status or any relevant metadata returned by the API.

No binary data output is indicated by the source code.

Example output structure (simplified):

{
  "json": {
    // Response fields from Zitadel's registerTOTP method
  }
}

Dependencies

• Requires an API authentication token credential for Zitadel (referred generically as an API key credential).
• Connects to the Zitadel API endpoint at https://zitadel.studentcouncil.dk.
• Uses gRPC client libraries (nice-grpc) to communicate with Zitadel services.
• The node dynamically selects the appropriate Zitadel service and method based on input parameters.

Troubleshooting

• Common issues:

  • Missing or invalid API authentication token will cause authorization failures.
  • Providing incorrect or missing userId when required will result in errors from the API.
  • Malformed JSON input for request parameters may cause parsing errors.

• Error messages:

  • Authorization errors typically indicate problems with the provided API token; ensure the token is valid and has necessary permissions.
  • Validation errors from Zitadel API usually point to missing or invalid input parameters; verify that all required fields are correctly set.
  • JSON parsing errors occur if input parameters expected as JSON strings are malformed; ensure proper JSON formatting.

Links and References

• Zitadel Official Documentation
• Zitadel API Reference
• Multi-Factor Authentication Concepts