Skip to main content

🔐 Using Setup Keys for Browser 2FA Settings

M
Written by Miki Doi

📝 Overview

When setting up two-factor authentication (2FA) for browser-based automated tasks, you may sometimes find that you cannot scan a QR code. In these cases, you can use a "Setup Key" to complete the configuration. Think of this key as a manual alternative to a QR code that allows Yoom to securely generate your authentication codes.


🛠️ How to Set Up

1. Get Your Setup Key

First, retrieve the setup key from the service you want to automate.

  • Look for labels like "Setup Key," "Manual Entry Key," or "Secret Key" within the service's 2FA settings.

  • If you don't see it immediately, look for links such as "Can't scan QR code?", "Enter key manually," or "Show text code."

  • If you absolutely cannot find the setup key, please contact the support team of the service you are trying to link.

⭐️ Important: Be sure to add this same setup key (or scan the corresponding QR code) to your own 2FA app, such as Google Authenticator or Authy, so you can still access the service yourself.

⚠️ Disclaimer: Your setup key is as sensitive as a password. If a third party gains access to it, they can generate your authentication codes. Always handle and store your setup keys securely.

2. If a Setup Key is Not Provided

If the service only shows a QR code and does not explicitly provide a text-based setup key, you can extract the key directly from the QR code.

How to extract the key:

  1. Use a QR code reader app that displays the raw text content of the code.

  2. Scan the 2FA setup QR code.

  3. Look for a string of text that starts with `otpauth://`.

  4. Find the section that says `secret=`. The characters immediately following this (until the next `&` or the end of the string) are your setup key.

📍Example:

In the string

otpauth://totp/Yoom:user@example.com?secret=YYYYYYYYYYYYYY&issuer=Yoom

The setup key is

 YYYYYYYYYYYYYY.

3. Checking QR Codes from a PC Screen

If you have the QR code saved as an image file on your computer, you can use a local QR code reading tool to extract the text.

⚠️ Disclaimer: Your 2FA credentials are vital for security. If you use an image reader, please do so at your own risk. We strongly recommend using local apps or tools rather than uploading the image to an external website to ensure your data remains private.

That’s it!

You’re now ready to use your setup key to power your automated browser operations with secure 2FA. 🎉


📚 Related Guides

Search Keywords

2FA, two-factor authentication, setup key, secret key, manual entry, QR code, browser operation, security, authentication code

Did this answer your question?