> ## 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

> Register passkey credentials so a user can log in to their DFNS organization across multiple devices, with cross-device sync and rotation.

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="Open your Profile page">
    Log in to the DFNS Dashboard, click your account at the bottom-left (1), then click **Profile** (2). Direct link: [https://app.dfns.io/profile](https://app.dfns.io/profile)

    <Frame>
      <img src="https://mintcdn.com/dfns-6d8c7466/v6srhukTTRatLjKd/images/auto/registering-a-passkey-1.png?fit=max&auto=format&n=v6srhukTTRatLjKd&q=85&s=954c09259908a0e23f7b5df81c559c64" alt="Account menu open with the account button and the Profile item highlighted" width="2688" height="1672" data-path="images/auto/registering-a-passkey-1.png" />
    </Frame>
  </Step>

  <Step title="View your credentials">
    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/zgEWrhBKlQ63Pyvw/images/auto/registering-a-passkey-2.png?fit=max&auto=format&n=zgEWrhBKlQ63Pyvw&q=85&s=5a2df0f0a0eaf03ff7cbff86b8a979cc" alt="Profile page Passkeys tab listing existing credentials, with the Add passkey button highlighted" width="2688" height="1672" data-path="images/auto/registering-a-passkey-2.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/v6srhukTTRatLjKd/images/auto/registering-a-passkey-3.png?fit=max&auto=format&n=v6srhukTTRatLjKd&q=85&s=a69ca26b4c7ec05a6d3d2e9d3103c27f" alt="Add Credential dialog with a credential name entered and the Create Credential button highlighted" width="2688" height="1672" data-path="images/auto/registering-a-passkey-3.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.
  </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/v6srhukTTRatLjKd/images/auto/registering-a-passkey-4.png?fit=max&auto=format&n=v6srhukTTRatLjKd&q=85&s=b95a5788c9cf1c07b359ca25539a160b" alt="Confirm Credential dialog with the Save Credential button highlighted" width="2688" height="1672" data-path="images/auto/registering-a-passkey-4.png" />
    </Frame>
  </Step>

  <Step title="Confirmation">
    Once saved, the dialog closes and your new passkey appears in the **Passkeys** tab.
  </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.

    <Frame>
      <img src="https://mintcdn.com/dfns-6d8c7466/v6srhukTTRatLjKd/images/auto/registering-a-passkey-5.png?fit=max&auto=format&n=v6srhukTTRatLjKd&q=85&s=de86a5dddc3fad44a0d93d3b6a4dbf12" alt="Register a new device dialog showing a QR code and the 9-character credential code" width="2688" height="1672" data-path="images/auto/registering-a-passkey-5.png" />
    </Frame>
  </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>
      <img src="https://mintcdn.com/dfns-6d8c7466/v6srhukTTRatLjKd/images/auto/registering-a-passkey-6.png?fit=max&auto=format&n=v6srhukTTRatLjKd&q=85&s=1f05e21845bb110a56e7b51087556229" alt="Register a device page with the code entered and the Create Passkey button highlighted" width="2688" height="1672" data-path="images/auto/registering-a-passkey-6.png" />
    </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.
