> ## Documentation Index
> Fetch the complete documentation index at: https://docs.dfns.co/llms.txt
> Use this file to discover all available pages before exploring further.

# Register a new passkey

> A user can register as many credentials as needed for logging in to their Dfns org and signing actions.

Passkeys provide a secure and convenient way to sign in to your Dfns account and approve actions without needing to enter a password.

<Info>
  **What is a Passkey?**

  A passkey is a digital credential, like a key to a house, that is stored on your device (computer, phone, or hardware security key). It replaces traditional passwords with a more secure, phishing-resistant authentication method using biometrics (like Face ID or a fingerprint) or a device PIN.

  Read more about passkeys on the dedicated page: [why-dfns-uses-passkeys](/core-concepts/passkeys)
</Info>

<Warning>
  If you lose access to your only credential and have no recovery key, you are locked out of your account until an administrator re-enrolls you. Register at least two credentials on separate devices (for example, your primary computer and a YubiKey) to ensure you always have a way in.
</Warning>

### Prerequisites

Before you begin, please ensure you have the following:

* An active Dfns account with permissions to manage your own security settings,
* Access to the Dfns Dashboard using an existing credential,
* The physical device (computer, Yubikey) on which you want to create and store the new passkey.

### Step-by-step guide

Follow these steps to register a new passkey to your Dfns account.

<Steps>
  <Step title="Log in and navigate to credentials">
    Navigate to the Dfns Dashboard and head to your Profile page. Direct link: [https://app.dfns.io/profile](https://app.dfns.io/profile)

    You can see here the list of existing credentials, notice the checkbox to activate/deactivate each one of them. This can be useful in case you lost a device for example.

    <Frame>
      <img src="https://mintcdn.com/dfns-6d8c7466/2kpqVE6bPN0ElHJ8/images/spaces_2FtnSPOZGQ2hBmgoVWX5H6_2Fuploads_2FyzZDRzMjnCXhSjLBJjHh_2FCapture_20d_E2_80_99e_CC_81cran_202025-08-13_20a_CC_80_2009.55.01.png?fit=max&auto=format&n=2kpqVE6bPN0ElHJ8&q=85&s=6514f66a8867943ffca6383be1bfbf66" alt="" width="3412" height="1808" data-path="images/spaces_2FtnSPOZGQ2hBmgoVWX5H6_2Fuploads_2FyzZDRzMjnCXhSjLBJjHh_2FCapture_20d_E2_80_99e_CC_81cran_202025-08-13_20a_CC_80_2009.55.01.png" />
    </Frame>
  </Step>

  <Step title="Name the new credential">
    Click the "**Create Credential**" button and give a name to the new credential.

    <Info>
      **Pro Tip:** Use clear and specific names to easily distinguish your passkeys.

      For example: `MacBook Pro (Work)`,  `Backup Yubikey`, or `Google Titan Key`...
    </Info>

    <Frame>
      <img src="https://mintcdn.com/dfns-6d8c7466/aH8Z4RyoX4Vg4edY/images/spaces_2FtnSPOZGQ2hBmgoVWX5H6_2Fuploads_2F7CpfSOAixHarys16fFYO_2FCapture_20d_E2_80_99e_CC_81cran_202025-08-13_20a_CC_80_2009.56.44.png?fit=max&auto=format&n=aH8Z4RyoX4Vg4edY&q=85&s=b8bc7a487badf8784a3a64672e4b7a2c" alt="" width="3412" height="1808" data-path="images/spaces_2FtnSPOZGQ2hBmgoVWX5H6_2Fuploads_2F7CpfSOAixHarys16fFYO_2FCapture_20d_E2_80_99e_CC_81cran_202025-08-13_20a_CC_80_2009.56.44.png" />
    </Frame>
  </Step>

  <Step title="Register your passkey as the new credential">
    Click the "**Create Credential**" button.

    Your browser (or your password manager) will now take over and prompt you to create a new access key for `dfns.io`. This step will vary depending on your operating system and browser (e.g., Windows Hello, Apple Touch ID/Face ID, Android fingerprint).

    Use your new device's security method to confirm. This could be:

    * **Biometrics:** Fingerprint scan, Face ID, etc.
    * **PIN:** Your device's local PIN code.
    * **Hardware Key:** Tapping a connected YubiKey or other FIDO2-compliant security key.

    Follow the browser prompts until your key is created.

    <Frame>
      <img src="https://mintcdn.com/dfns-6d8c7466/2kpqVE6bPN0ElHJ8/images/spaces_2FtnSPOZGQ2hBmgoVWX5H6_2Fuploads_2FyeiJkdupLWdW4NtJS2BU_2FCapture_20d_E2_80_99e_CC_81cran_202025-08-13_20a_CC_80_2009.59.45.png?fit=max&auto=format&n=2kpqVE6bPN0ElHJ8&q=85&s=43124e78dac5c05b24eeddef6818789b" alt="" width="3412" height="1886" data-path="images/spaces_2FtnSPOZGQ2hBmgoVWX5H6_2Fuploads_2FyeiJkdupLWdW4NtJS2BU_2FCapture_20d_E2_80_99e_CC_81cran_202025-08-13_20a_CC_80_2009.59.45.png" />
    </Frame>
  </Step>

  <Step title="Sign your request with an existing credential">
    Your new passkey has submitted the credential, you just have to save it now.

    Click "**Save Credential**" and 🔑 sign the action with your existing passkey.

    <Frame>
      <img src="https://mintcdn.com/dfns-6d8c7466/aH8Z4RyoX4Vg4edY/images/spaces_2FtnSPOZGQ2hBmgoVWX5H6_2Fuploads_2Fd5Dpm8Ij9SftBAit1seD_2FCapture_20d_E2_80_99e_CC_81cran_202025-08-13_20a_CC_80_2010.04.28.png?fit=max&auto=format&n=aH8Z4RyoX4Vg4edY&q=85&s=79b4a00bda363143a6bc437ac74d75f1" alt="" width="3412" height="1792" data-path="images/spaces_2FtnSPOZGQ2hBmgoVWX5H6_2Fuploads_2Fd5Dpm8Ij9SftBAit1seD_2FCapture_20d_E2_80_99e_CC_81cran_202025-08-13_20a_CC_80_2010.04.28.png" />
    </Frame>
  </Step>

  <Step title="Confirmation">
    The last screen shows a confirmation that your new credential has been created.

    <Frame>
      <img src="https://mintcdn.com/dfns-6d8c7466/aH8Z4RyoX4Vg4edY/images/spaces_2FtnSPOZGQ2hBmgoVWX5H6_2Fuploads_2FU2N7xkdxOprQfNBQIKSi_2FCapture_20d_E2_80_99e_CC_81cran_202025-08-13_20a_CC_80_2010.10.12.png?fit=max&auto=format&n=aH8Z4RyoX4Vg4edY&q=85&s=63771829dcf602d9bb8f610c55d10ff1" alt="" width="3412" height="1792" data-path="images/spaces_2FtnSPOZGQ2hBmgoVWX5H6_2Fuploads_2FU2N7xkdxOprQfNBQIKSi_2FCapture_20d_E2_80_99e_CC_81cran_202025-08-13_20a_CC_80_2010.10.12.png" />
    </Frame>
  </Step>
</Steps>

<Check>
  Your passkey is now registered and appears in the **Passkeys** tab. You can use it to log in and approve policy-controlled actions.
</Check>

## Registering from a different device

If the new passkey needs to live on a device that isn't currently logged in (e.g. a phone or a YubiKey you don't have plugged in), use the device registration flow instead.

<Steps>
  <Step title="On the existing device">
    Head to your [Profile page](https://app.dfns.io/profile) and click "Register a device". Validate the action with your existing passkey. A 9-character code is displayed, valid for 60 seconds.
  </Step>

  <Step title="On the new device">
    Open [app.dfns.io/register-device](https://app.dfns.io/register-device) in your browser, enter the code, and register your passkey on that device.

    <Frame hint="For easy access from a mobile device you can scan this QR Code" caption="https://app.dfns.io/register-device">
      <img src="https://mintcdn.com/dfns-6d8c7466/7RXjjGFAFWVoMpp-/images/qrcode-register-device.svg?fit=max&auto=format&n=7RXjjGFAFWVoMpp-&q=85&s=f2e8a79ace204d0d2a433e8d346f3691" width="30%" data-path="images/qrcode-register-device.svg" />
    </Frame>
  </Step>
</Steps>

### Troubleshooting

* **"Create Credential" button is not visible:** This may be a permissions issue. Please contact your Dfns organization administrator to ensure your role has the necessary permissions.
* **The browser prompt does not appear:** Ensure you are using a supported browser and that it is updated to the latest version. Check if any browser extensions or pop-up blockers are interfering with the process.
* **Authentication Failed:** If your biometric or PIN authentication fails, simply try again. Ensure your finger is clean for fingerprint scanners or that you are entering the correct PIN for your device.