ZitadelInstall

Overview

This node interacts with the Zitadel API to perform various operations across multiple services. Specifically, for the verifyPasskeyRegistration operation under the UserService resource, it verifies a user's passkey registration by sending the required user ID, passkey ID, public key credential, and passkey name to the Zitadel backend.

Common scenarios where this node is beneficial include:

• Verifying newly registered passkeys for users in an authentication system.
• Integrating passkey-based multi-factor authentication verification into workflows.
• Automating security checks during user onboarding or credential updates.

Practical example:

• After a user registers a new passkey on a website, this node can be used to verify that registration before allowing access or updating user records.

Properties

Output

The node outputs a JSON object containing the response from the Zitadel API's verifyPasskeyRegistration method. This typically includes verification results such as success status, any error messages, or metadata related to the passkey verification.

No binary data output is produced by this operation.

Example output structure (simplified):

{
  "success": true,
  "message": "Passkey registration verified successfully",
  "details": { /* additional verification info */ }
}

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 is set up in the node credentials.
• Malformed Input: The properties userId, passkeyId, publicKeyCredential, and passkeyName 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 verifyPasskeyRegistration is selected under UserService.
• Network Issues: Connectivity problems to the Zitadel API endpoint will cause request failures. Check network settings and endpoint availability.

Links and References

• Zitadel Official Documentation
• WebAuthn / Passkey Concepts
• n8n Documentation on Custom Nodes