# Register a USB security key

> Add a USB security key to your CloudRepo account as a second factor, and keep a spare beside it.

A security key is a small device you plug into a USB port and touch to prove it’s you. CloudRepo accepts one as a second factor when you sign in to the portal. You can register more than one, so a spare key still gets you in if the first is lost.

## Before you start

- A browser that works with security keys, such as a current version of Chrome on your computer.

## Add a key to your account

1. Sign in to the portal, click the person icon at the top right (the account menu), then choose **Your account security**.

   Expected: a card titled **Passkeys and security keys**, listing any keys you already have.

2. In **Name**, type a name that tells this key apart from your others, such as *Keyring key*. If the card shows **I understand my password will no longer work for my builds.**, tick it first. Click **Add a security key**.

   Expected: **Confirm Your Identity**. If you have no second factor yet, it asks for your password; otherwise it asks for your current factor.

3. Confirm your identity.

   Expected: your browser asks you to insert your security key, or to touch it.

4. Plug the key in and touch it. If your browser asks for the key’s PIN, type it.

   Expected: if this is your first second factor, ten backup codes, shown once. Otherwise the card lists the new key by its name, marked *Not used yet.*

5. If backup codes are shown, save them somewhere other than your computer, tick the box, and click **I have saved my backup codes**.

   Expected: the card lists the new key by its name.

Adding a key signs you out of the portal everywhere else. The browser you used stays signed in.

## Keep a spare key

Repeat the steps above with your second key, and give it a different name. Your account can hold ten passkeys and security keys in all. Keep the spare somewhere apart from your everyday key.

## When the key is not added

The card says why, and what to do next.

- *The key wasn’t added. Make sure it’s plugged in, then touch it when it blinks.* Your browser got no answer from a key. You may have cancelled, or the prompt may have run out of time. Plug the key in, click **Add a security key** again, and touch the key when it blinks.
- *The key wasn’t added. Try again, and touch the key when it blinks.* Adding the key did not finish. Click **Add a security key** again, and touch the key when it blinks.
- *This key is already on your account.* Your browser refuses to register the same key twice. Use it as it is, or register a different key.

## Use a key when your organization first asks for two-factor authentication

If your organization requires two-factor authentication and you have no factor yet, the setup page you reach after your password may offer **Use a security key**.

1. Click **Use a security key**. The page says your organization requires two-factor authentication and that builds there no longer sign in with a password, so there is nothing to tick.

   Expected: your browser asks you to insert your security key, or to touch it.

2. Plug the key in, touch it, and type its PIN if your browser asks.

   Expected: ten backup codes, shown once.

3. Save the codes, tick the box, and click **I have saved my backup codes**.

   Expected: you are signed in to the portal.

---

The page: https://www.cloudrepo.io/docs/authenticate/security-keys.html
