Skip to main content

Adding 2FA to your workflow

Simplex offers three ways to authenticated with 2FA: Seed, Email, and Text. In the Settings page, you can click + Add Config in the Two-Factor Authentication section.

Seed

You can get this 2FA code from the QR codes that you would put in a Google Auth or Duo app. You should take a screenshot of the QR code, then put it into Google images. You’re looking for the “seed” or “secret” parameter (example below).

Email

We can integrate directly with your existing PCI compliant data store to pull email and password tokens, and decrypt them on our containers through a custom microservice. Contact us on Slack if you need this.

Text

We can spin up Twilio phone numbers for you that we pull 2FA codes from. Contact us on Slack if you need this.

Integrating 2FA configs into your agent

For all of three methods above (Seed/Email/Text), Simplex will make a tool call to extract the 2FA code. When you create a new agent in the Agents page, you can add the 2FA tool generate_2fa_code as a Tool for your agent to use. The generate_2fa_code tool takes in a name parameter as a way to specify the exact config you’d like to use to generate the 2FA code. If you don’t specify a name in the tool call, Simplex will default to matching by partial URL.
I