WebAuth on desktop: add your computer as a device - Episode 3.1

WebAuth on desktop: add your computer as a device - Episode 3.1

WebAuth also runs in your browser at webauth.com. The browser wallet uses the same account as your phone. What it adds is a device: a new key that your computer can use to sign. On Windows the key is a passkey from Windows Hello, on a Mac from Touch ID, or it can be saved in a password manager such as Bitwarden. Once the device is on your account, you can approve transactions on your computer without the WebAuth app.

artwebin
|
|
3 min read
|
Beginner

What you need

  • A WebAuth account in the app on your phone. Episode 1.2 covers creating one.
  • Your recovery phrase, backed up. Episode 1.3 covers backups.
  • A computer with a browser, and a way to save a passkey: Windows Hello, Touch ID, or a password manager.
📝NOTE

Only add accounts that belong to you.

1. Log in with a QR code

  1. Open webauth.com and click Login.
  2. Click log in with mobile / desktop wallet, then choose Mobile. A QR code appears.
  3. In WebAuth on your phone, scan the code. The request names Bloks.io and asks to verify your public account. Tap Authorize.

2. Add your computer as a device

  1. After the login you land on your devices, under the key icon in the bottom bar. A new account shows No devices yet.
  2. Click Add new device.
  3. Under Authentication method, choose Windows Hello (Native platform authenticator). The other options are Yubikey (any YubiKey or Google Titan) and Ethereum (any Ethereum wallet). Click Next.
  4. Your browser asks where to save the passkey. With Windows Hello it is saved on the computer. In the video, Bitwarden offers Save passkey as new login, and the passkey goes into the Bitwarden vault.
  5. WebAuth shows the Device Key, the new public key. It starts with PUB_WA_.
  6. Type a Device Name, for example the name of your computer, and click Add device.

3. Sign the change on your phone

Adding a key changes your account, so your phone signs it one last time.

  1. The page shows a Signing Request with a two-minute timer.
  2. Open WebAuth on your phone. It shows Confirm Transaction from Bloks.io. In the video, the transaction was a propose action on eosio.msig with proposer: xprbasics, the account adding the device.
  3. Check that the account is yours, then tap Authorize and confirm on your phone.
  4. The page shows Success, and the device appears in your device list with its key.

Add a second account

  1. Click your account icon in the middle of the bottom bar, then Import.
  2. Log in to the other account with a QR code, the same way as in step 1.
  3. The new account starts with no devices. Add a device for it too, as in steps 2 and 3. That change is signed with the other account.

Sign in with the passkey

  1. Click your account icon, then Import, and type your username.
  2. Pick your device from the list.
  3. Bitwarden asks Log in with passkey?. Choose the passkey for webauth.com, and you are signed in. No phone needed.

Connect to an app with Browser wallet

  1. In an app such as Metal X, click Connect Wallet.
  2. In Connect WebAuth, choose Browser wallet (Authorize device). Mobile App, with a QR code, still works too.
  3. A WebAuth window opens. It shows which site is asking, for example https://app.metalx.com/ wants to verify your public account. Check the site, then click Authorize.
💡TIP

Add only devices that you own and control. A device key can sign for your account.

📝NOTE

Protect your password manager. If your passkey is saved in a password manager, anyone who opens your vault can sign. Use a strong master password and two-factor login.

⚠️WARNING

Keep your recovery phrase. WebAuth warns that deleting all browser data deletes the key stored in the browser, and you then recover your account with your recovery phrase. Private keys can't be exported from the browser wallet.