---
sidebar_position: 1
---

# Authentication

## Current Method (versions >= 1.9.0)

OF DL allows you to log in to your OnlyFans account directly. This simplifies the authentication process significantly.
When prompted by the application, log into your OnlyFans account. Do not close the opened window, tab, or navigate away to another webpage.
The new window will close automatically when the authentication process has finished.

!!! warning

    Some users have reported that "Sign in with Google" has not been working with this authentication method.
    If you use the Google sign-in option to log into your OnlyFans account, use one of the [legacy authentication methods](#legacy-methods) described below.

!!! info

    If you are using docker, follow the special [authentication instructions documented](/installation/docker) to authenticate OF-DL

## Legacy Methods

Legacy authentication methods involve creating/editing `auth.json` file yourself.

### Browser Extension

You can use a browser extension to help get the required info for the `auth.json` file. The extension supports Google Chrome and Firefox and can be found [here](https://github.com/whimsical-c4lic0/OF-DL-Auth-Helper/) (https://github.com/whimsical-c4lic0/OF-DL-Auth-Helper/).

### Manual Method

Open `auth.json` in a text editor of your choice. The default windows notepad is sufficient. When you open `auth.json` for the first time you should see something like this:

```json
{
    "USER_ID": "",
    "USER_AGENT": "",
    "X_BC": "",
    "COOKIE": ""
}
```

Next, log into OnlyFans, and press F12 to open the dev tools. In the filter box, type `api`, and open any page on OnlyFans (e.g. Messages). You should see some requests appear in the list within the network tab:

![Image of dev tools panel showing network tab](/img/network_tab.png)

Click on one of the requests you see in the list, and scroll down until you find the 'Request Headers' section.

![Image of dev tools panel showing request headers](/img/request_headers.png)

You should be able to find the 3 fields we need, `Cookie`, `User-Agent` and `x-bc`.

Within Cookie you will find 2 bits of information that we need to copy, these being `sess` and `auth_id`.

So heading back to your text editor:

The value of `USER_ID` will be set to what `auth_id` is set to.

The value of `USER_AGENT` will be set to what the `User-Agent` is set to in the Request Headers.

The value of `X_BC` will be set to what the `X-Bc` is set to in the Request Headers.

The value of `COOKIE` will be set to `auth_id=YOUR AUTH_ID HERE; sess=YOUR SESS HERE;`, please make sure you copy the values from within the Cookie field found in the Request Headers section.

If you have done everything correct you should end up with something like this (this is all dummy info):

```json
{
  "USER_ID": "123456",
  "USER_AGENT": "Mozilla/5.0 (Windows NT 10.0; Win64; x64; rv:121.0) Gecko/20100101 Firefox/121.0",
  "X_BC": "2a9b28a68e7c03a9f0d3b98c28d70e8105e1f1df",
  "COOKIE": "auth_id=123456; sess=k3s9tnzdc8vt2h47ljxpmwqy5r;"
}
```
