> ## Knowledge Base Index
> Fetch the complete knowledge base index at: https://help.cxplanner.com/sitemap.xml
> Use this file to discover available pages before exploring further.
> Pure-Markdown content can be obtained by appending a '.md' suffix to the content URLs listed in the sitemap (without the trailing slash).

# Link a Yubikey to your CxPlanner profile

## Overview: link a YubiKey

The **YubiKey** section in profile settings registers a hardware key for login verification, which is used when you need physical two-factor authentication instead of only an authenticator app.

For app-based 2FA, see [Enable two-factor authentication (2FA / MFA)](https://help.cxplanner.com/en-us/article/enable-two-factor-authentication-2fa-for-your-account-1q5pmv/).

* Your role can be any registered CxPlanner user with password login.
* You can find the menu at Profile icon - **Profile** - **YubiKey**.
* This changes login so the linked YubiKey is required to verify your identity.

|| Only users with a registered CxPlanner account can link a YubiKey.

## Requirements for linking a YubiKey

| Requirement | Description |
|---|---|
| Account | Registered CxPlanner user |
| Hardware | Compatible YubiKey connected to the computer |
| Location | Profile settings - YubiKey |
| Limit | One YubiKey per user |

## How to link your YubiKey

1. Click your **profile icon** in the top right corner.
2. Select **Profile**.
3. Scroll down to the **YubiKey** section.
4. Connect your YubiKey to your computer and tap it.
5. When a code appears, save it.

![Screenshot: YubiKey section in profile settings](https://storage.crisp.chat/users/helpdesk/website/-/e/a/2/c/ea2cfd7bb6130800/image_wqtw9q.png)

## Results: login with a linked YubiKey

* The linked YubiKey is required to verify login
* Password alone is no longer enough once the key is linked
* Losing the key can block login until the method is reset

## Troubleshooting: YubiKey login

| Problem | Cause | Solution |
|---|---|---|
| YubiKey is not recognized | USB connection or port issue | Try another USB port, reconnect the key, then tap again in the YubiKey section |
| Code does not appear | Tap was not registered | Remove and reinsert the YubiKey, then tap firmly when prompted |
| Cannot log in without the YubiKey | YubiKey is required for this account | Ask a **Company Admin** or CxPlanner support to reset your login method, and include your email and that YubiKey access is lost |