> ## Documentation Index
> Fetch the complete documentation index at: https://docs.catproxy.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Методы аутентификации

> Узнайте о двух способах аутентификации ваших запросов к прокси-шлюзу Catproxy: с помощью имени пользователя и пароля, а также посредством внесёния IP-адресов в список разрешённых IP-адресов.

Чтобы пользоваться нашей прокси-сетью, каждый запрос, который вы отправляете на прокси-шлюз, должен быть аутентифицирован. Это гарантирует, что только авторизованные пользователи могут получить доступ к сервису и что мы сможем правильно отнести использование трафика к вашей учётной записи.

Мы предлагаем два метода аутентификации:

<CardGroup cols={2}>
  <Card title="Имя пользователя и пароль" icon="user-lock">
    Самый распространённый метод. Вы включаете уникальные учётные данные вашего прокси в каждый запрос.
  </Card>

  <Card title="Разрешённые IP-адреса (скоро)" icon="shield-check">
    Более простой метод для серверов. Вы предварительно авторизуете IP-адрес своего сервера, позволяя ему подключаться без отправки учётных данных.
  </Card>
</CardGroup>

***

## 1. Аутентификация по имени пользователя и паролю

Это стандартный и наиболее гибкий метод аутентификации. Каждый прокси, который вы создаёте в панели управления, имеет свое уникальное имя пользователя и пароль.

### Как это работает

Вам нужно включить эти учётные данные в строку подключения к прокси в следующем формате:
`protocol://username:password@host:port`

### Пример

Допустим, ваши учётные данные:

* **Имя пользователя:** `cat-customer-a1b2-proxy-steam`
* **Пароль:** `a_very_secure_password`
* **Хост и порт:** `proxy.catproxy.net:5555`

Ваша строка подключения для HTTP-клиента будет выглядеть так:

```
http://cat-customer-a1b2-proxy-steam:a_very_secure_password@proxy.catproxy.net:5555
```

<CodeGroup>
  ```bash cURL theme={null}
  # Подключение через cURL
  curl "https://api.ipify.org" \
    --proxy "http://cat-customer-a1b2-proxy-steam:a_very_secure_password@proxy.catproxy.net:5555"
  ```

  ```python Python (Requests) theme={null}
  # Using the credentials with Python's Requests library
  import requests

  proxies = {
      "http": "http://cat-customer-a1b2-proxy-steam:a_very_secure_password@proxy.catproxy.net:5555",
      "https": "http://cat-customer-a1b2-proxy-steam:a_very_secure_password@proxy.catproxy.net:5555",
  }

  response = requests.get("https://api.ipify.org", proxies=proxies)
  print(response.text)
  ```
</CodeGroup>

<Info>
  Помните, что вы можете динамически добавлять параметры вроде `-country-de` к своему имени пользователя, чтобы контролировать поведение прокси. Узнайте больше в руководстве по [параметрам геотаргетинга](/ru/proxy-products/configuration/geo-targeting).
</Info>

***

## 2. Разрешённые IP-адреса (авторизованные IP) (скоро)

Этот метод идеально подходит для серверов или любых машин со статическим IP-адресом. Добавив свой IP в список разрешённых IP-адресов, вы сможете отправлять запросы без встраивания учётных данных в код.

### Как это работает

1. **Добавьте свой IP:** на странице настроек вашего прокси перейдите в раздел "Управление доступом" и добавьте IP-адрес вашего сервера (например, `34.123.45.67`) в список **Разрешённые IP-адреса**.
2. **Подключайтесь без учётных данных:** теперь любой запрос, поступающий с этого IP-адреса на `host:port` вашего прокси, будет автоматически аутентифицирован.

### Пример

Предположим, что IP-адрес вашего сервера `34.123.45.67` был внесён в список разрешённых IP-адресов для прокси по адресу `proxy.catproxy.net:5555`.

<CodeGroup>
  ```bash cURL theme={null}
  # No username or password needed!
  curl "https://api.ipify.org" \
    --proxy "http://proxy.catproxy.net:5555"
  ```

  ```python Python (Requests) theme={null}
  # The proxies dictionary is now much simpler
  import requests

  proxies = {
      "http": "http://proxy.catproxy.net:5555",
      "https": "http://proxy.catproxy.net:5555",
  }

  response = requests.get("https://api.ipify.org", proxies=proxies)
  print(response.text)
  ```
</CodeGroup>

<Warning>
  **Важно:** Разрешённые IP-адреса работает только для **IPv4**-адресов. Если ваш сервер имеет динамический IP, вы должны использовать метод имени пользователя и пароля.
</Warning>

### Какой метод использовать?

| Сценарий                                                                       | Рекомендуемый метод           |
| :----------------------------------------------------------------------------- | :---------------------------- |
| Запуск скриптов с локальной машины (динамический IP)                           | **Имя пользователя и пароль** |
| Запуск скриптов на облачном сервере (статический IP)                           | **Разрешённые IP-адреса**     |
| Использование инструмента, который не поддерживает аутентификацию через прокси | **Разрешённые IP-адреса**     |
| Нужна максимальная гибкость и контроль                                         | **Имя пользователя и пароль** |