OTPilot

Stagehand

Amazon Web Services 2FA login with Stagehand: step-by-step for agents

Your Stagehand agent gets to Amazon Web Services's “enter the code from your authenticator app” screen and stops. Here is how to make it type the right 6-digit code by itself, without putting the TOTP seed in your code, prompts or logs.

  1. 1 · Save the secret

    In Amazon Web Services, turn on authenticator-app 2FA and click “Can't scan?” to reveal the setup key. Save it in your OTPilot vault — it becomes the account amazon-web-services. Detailed Amazon Web Services steps.

  2. 2 · Create a scoped key

    Create an agent key that can read only Amazon Web Services, and put it in the agent's environment as OTPILOT_KEY.

  3. 3 · Fetch the code in Stagehand

    Fetch the code right before Stagehand fills the 2FA field, so it is always fresh.

    Stagehand · typescript
    // npm i @browserbasehq/stagehand
    async function otp(account = "amazon-web-services") {
      const r = await fetch(`https://otpilot.vibiz.app/api/v1/codes/${account}?reason=stagehand-login`, {
        headers: { Authorization: `Bearer ${process.env.OTPILOT_KEY}` },
      });
      const data = await r.json();
      if (!r.ok) throw new Error(`${data.error.message} Fix: ${data.error.fix}`);
      if (data.status === "pending") { await new Promise((s) => setTimeout(s, 5000)); return otp(account); }
      return data.code as string;
    }
    
    await page.act("log into Amazon Web Services with the saved email and password");
    const code = await otp();
    await page.act(`type ${code} into the authenticator code field and submit`);

Good to know

Try it with your own secret — no signup

Paste a TOTP secret on the home page and get a live code plus a working API call in seconds.

Amazon Web Services with other frameworks

Use only with Amazon Web Services accounts you own and may automate. Not affiliated with Amazon Web Services or Stagehand.