# Set up your identity with Cerby's MFA methods

With Cerby's **multi-factor authentication (MFA) methods**, you can choose how users confirm their identities through a push notification on the Cerby mobile app or via an email with a magic link. These methods ensure secure access for performing identity-sensitive actions, such as viewing or editing a secret, regardless of any device constraints.

This article describes how each MFA method works and the actions that require identity confirmation:

* [Push notification on the Cerby mobile app](#push-notification-on-the-cerby-mobile-app)
* [Email magic link](#email-magic-link)
* [List of actions that require identity verification](#list-of-actions-that-require-identity-confirmation)

The following sections contain the steps to confirm your identity using each method.

***

## Push notification on the Cerby mobile app

With the push notification on the Cerby mobile app, you receive a push notification in real time on your registered mobile device whenever you need to confirm your identity.

{% hint style="danger" %}
**IMPORTANT:** Cerby is configured to use this method by default to confirm users’ identities for the actions listed in the [List of actions that require identity confirmation section](#list-of-actions-that-require-identity-confirmation).
{% endhint %}

To confirm your identity through the Cerby mobile app, you must complete the following steps:

1. Install the Cerby mobile app on your phone.
2. Set up a trusted session with your mobile device.
3. Perform any of the actions listed in the [List of actions that require identity confirmation](#list-of-actions-that-require-identity-confirmation) section. The **Confirm your identity to continue** dialog box is displayed, and a push notification is sent to the Cerby mobile app.
4. Tap the **It’s me!** button in the **Confirmation Request** screen of the Cerby mobile app. The **Confirm your identity to continue** dialog box closes in the Cerby web app, and a success message box is displayed.

***

## Email magic link

The email magic link is an alternative if you have restrictions or issues with receiving push notifications on your phone or if your company prefers to confirm users’ identities through email. When this option is enabled, you receive an email containing a magic link that, when clicked, confirms your identity in the Cerby web app and grants access.

{% hint style="danger" %}
**IMPORTANT:** If you are interested in this feature but don't see it available in your workspace, contact our **Customer Support** team via email at <support@cerby.com>.
{% endhint %}

***

To confirm your identity through an email magic link, you must complete the following steps:

1. Perform any of the actions listed in the [List of actions that require identity confirmation](#list-of-actions-that-require-identity-confirmation) section. The **Confirm your identity to continue** dialog box is displayed. ​**NOTE:** The actions apply to any Cerby clients: web app, browser extension, and mobile app.
2. Click the **Send email** button. The **Check your inbox** dialog box is displayed, and Cerby sends an email with a magic link to your inbox.
3. Open the **Action required: Confirm your identity** email in your inbox.
4. Click or tap the **Confirm my identity** magic link from the email message. The Cerby web app is displayed on a new browser tab:
   * If the identity confirmation is correct, then the **Identity is confirmed. Your good to go!** message is displayed, and you are redirected to the action you previously performed.
   * If the identity confirmation fails, an error message is displayed, and you must repeat the identity verification process.

***

## List of actions that require identity confirmation

You must confirm your identity when performing the following actions:

* [Managing the attachments of a secret and secret item](https://help.cerby.com/cerby-web-app/secrets/managing-your-secrets/manage-the-attachments-of-a-secret-and-secret-item)
* [Deleting a secret and secret item](https://help.cerby.com/cerby-web-app/secrets/managing-your-secrets/delete-a-secret-and-secret-item)
* [Editing a secret](https://help.cerby.com/cerby-web-app/secrets/managing-your-secrets/edit-a-secret)
* [Viewing a secret](https://help.cerby.com/cerby-web-app/secrets/managing-your-secrets/view-a-secret) (only if the identity verification is configured)
* [Viewing the secret history and restoring a secret](https://help.cerby.com/cerby-web-app/secrets/managing-your-secrets/view-the-secret-history-and-restore-a-secret)
* [Share a secret or secret item](https://help.cerby.com/cerby-web-app/secrets/managing-access-to-your-secrets/share-a-secret-or-secret-item)
* [Removing an App](https://help.cerby.com/setup-and-admin/identity-lifecycle-management-idlcm/business-hubs/managing-your-integrations/remove-a-business-hub)
* [Retrieving the SCIM API authentication token from Cerby](https://help.cerby.com/setup-and-admin/workspace-identity-federation/retrieve-the-scim-api-authentication-token-from-cerby)
* [Sharing items with external users via a link](https://help.cerby.com/cerby-web-app/accounts/managing-access-to-your-accounts/share-items-with-external-users-via-a-link)
* [Creating and managing a vault](https://help.cerby.com/setup-and-admin/vault-management/create-a-vault)


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://help.cerby.com/tips-and-troubleshooting/best-practices/mfa/set-up-your-identity-with-cerby-s-mfa-methods.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
