Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
tfa_type | string | Yes | Type of 2FA: SMS, EMAIL, AUTHENTICATOR, or MAGIC_LINK |
credential | string | Yes | Vault credential key for the 2FA receiver (phone number, email, or TOTP secret) |
selector | string | Conditional | XPath selector for the code input field. Required for STATIC execution when tfa_type is not MAGIC_LINK |
execution | string | No | Execution type: STATIC (UI: “Static”) or COMPUTER_USE (UI: “AI (Screenshot)”). Only used when tfa_type is not MAGIC_LINK. Default: STATIC |
wait_time | number | No | Maximum time (ms) to wait for the code to arrive. Default: 15000 |
link_regex_pattern | string | Conditional | Regex pattern to extract the magic link from the email body |
TFA Types
SMS
Automatically extracts the verification code from an SMS message. Requires usage of the CloudCruise phone number shown in your vault entry.AUTHENTICATOR
Generates a TOTP code using the stored authenticator secret. No external service needed.MAGIC_LINK
Automatically extracts the magic login link from an email and navigates to it. Requires email forwarding to be configured or direct usage of the CloudCruise email shown in your vault entry.Notes
- The
credentialparameter references a User ID in your vault - Codes are automatically entered and submitted (pressing Enter) after extraction. No subsequent Click action on a “Verify” or “Submit” button is required
- For more details on 2FA setup, see the Two-Factor Authentication guide