> For the complete documentation index, see [llms.txt](https://docs.beefree.io/beefree-sdk/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.beefree.io/beefree-sdk/getting-started/readme/installation/set-up-two-factor-authentication.md).

# Set up two-factor authentication

## Overview <a href="#overview" id="overview"></a>

Setting up two-factor authentication will keep your developer account extra secure. Two-factor authentication means that users will need to provide two different identifications to log in to their [Beefree SDK Console](https://developers.beefree.io/): their regular login credentials, and a token generated by a two-factor authentication app.

When 2FA is set up, users will need to:

* download a two-factor authentication app to their mobile device (e.g. [Authy](https://dam.beefree.io/authy), [Google Authenticator](https://dam.beefree.io/googleauth), [Authenticator Plus](https://dam.beefree.io/authplus), and others);
* use their device and the app to generate a token and log in.

## Setup for Account owners <a href="#setup-for-account-owners" id="setup-for-account-owners"></a>

If you’re an account owner (i.e. the user who created the Beefree SDK account), you may require all account users to use two-factor authentication to log in. To do so, go to the *Setting & Security* section in your personal area and enable *Require two-factor authentication at login*.

<figure><img src="/files/yNLj6ZKZb2CJqKH0nTHC" alt=""><figcaption></figcaption></figure>

After saving the setting, you will be prompted to scan a QR code with a 2FA application to generate a security token to complete the setup.

When this setting is ON:

* every user will need to enter an authentication token, generated with a 2FA mobile app, to log into the account;
* when you create a new user, the 2FA toggle will be set to ON by default.

When adding or editing a user, you may also decide to turn on or off 2FA for that user, in order to:

* turn on 2FA, when 2FA is OFF at the account level;
* turn off 2FA, when 2FA is ON at the account level.

## Setup for Account admins <a href="#setup-for-account-admins" id="setup-for-account-admins"></a>

If 2FA is OFF at the account level, additional users, i.e. admins, can turn on 2FA for themselves, for their peace of mind. They can go to the “Profile” section of their personal area and turn it on.

<figure><img src="/files/t2kABAochLNcfT2RAnbq" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
**Note:** Instead, if 2FA is ON at the account level, admins cannot turn it off from the “Profile” page and must contact their account owner.
{% endhint %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## 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, and the optional `goal` query parameter:

```
GET https://docs.beefree.io/beefree-sdk/getting-started/readme/installation/set-up-two-factor-authentication.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.
