Zitadel icon

Zitadel

Interact with the Zitadel API

Overview

This node integrates with the Zitadel API, a platform for identity and access management. Specifically, the verifyU2FRegistration operation under the UserService resource verifies a U2F (Universal 2nd Factor) registration for a user. This is useful in scenarios where you want to confirm that a user's hardware security key or other U2F device has been properly registered and is valid.

Practical examples include:

  • Enhancing login security by verifying U2F tokens during multi-factor authentication setup.
  • Validating new U2F devices before associating them with a user account.
  • Automating security compliance checks in user management workflows.

Properties

Name Meaning
Service The Zitadel service to interact with. Options: UserService, OrganizationService, AuthService, ManagementService, AdminService, ZITADELActions, UserSchemaService. For this operation, select UserService.
userId The unique identifier of the user whose U2F registration is being verified.
u2fId The identifier of the U2F device/token to verify.
publicKeyCredential The public key credential string associated with the U2F device, used for verification.
tokenName A name assigned to the U2F token, typically for identification purposes in the system.

Output

The node outputs a JSON object containing the response from the Zitadel API's verifyU2FRegistration method. This response typically includes details about the verification status of the U2F registration, such as success confirmation or error information if verification failed.

No binary data output is produced by this node.

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 is set up in n8n credentials.
  • Malformed Input: The properties userId, u2fId, publicKeyCredential, and tokenName must be correctly formatted strings. Invalid JSON or empty values may cause errors.
  • Operation Not Found: Selecting an unsupported operation or service combination will result in no action. Verify that UserService and verifyU2FRegistration are selected together.
  • API Errors: Errors returned from Zitadel (e.g., user not found, token invalid) will be included in the output JSON. Review these messages to adjust inputs accordingly.

Links and References

Discussion