← Privacy Proxy / privacy-proxy / reference

Заголовки HTTP

На этой странице описаны HTTP-заголовки, которые Privacy Proxy использует для аутентификации, геолокации и наблюдаемости. Подробнее о наблюдаемости см. в разделе GraphQL Analytics API и OpenTelemetry.

Заголовки запроса

При подключении к Privacy Proxy клиенты передают следующие заголовки.

`Proxy-Authorization`

Аутентифицирует клиента на прокси. Обязательно для всех запросов.

Формат предварительно распределенного ключа:

Proxy-Authorization: Preshared <key>

Формат токена Privacy Pass:

Proxy-Authorization: PrivateToken token=<base64-encoded-token>

Параметр	Описание
`<key>`	Предварительно согласованный ключ (PSK), предоставляемый Cloudflare
`<base64-encoded-token>`	Токен Privacy Pass в кодировке base64

Заголовки запросов GraphQL Analytics API

При запросе метрик Privacy Proxy через GraphQL Analytics API отправьте POST запрос к https://api.cloudflare.com/client/v4/graphql. Сведения об обязательных заголовках и аутентификации см. в GraphQL Analytics API.

`sec-ch-geohash`

Задает географическое расположение клиента для выбора исходящего IP-адреса. Необязательный параметр, но рекомендуется для точного определения геолокации.

sec-ch-geohash: <geohash>-<country_code>

Параметр	Описание
`<geohash>`	A geohash ↗ строка (обычно от 4 до 8 символов)
`<country_code>`	Код страны по стандарту ISO 3166-1 alpha-2

Пример

sec-ch-geohash: u4pruydqqvj-GB

В этом примере указано местоположение в Великобритании.

Заголовки ответа

Privacy Proxy включает в ответы следующие заголовки.

`Server-Timing`

Предоставляет информацию о времени обработки на прокси. Это часть OpenTelemetry конвейер наблюдаемости.

Server-Timing: proxy;dur=<milliseconds>

Параметр	Описание
`<milliseconds>`	Время обработки в миллисекундах, добавляемое прокси

Пример

Server-Timing: proxy;dur=8.2

Заголовки ответов GraphQL Analytics API

Сведения о заголовках ответа GraphQL API см. в GraphQL Analytics API.

`CONNECT` формат запроса

Полное CONNECT запрос к Privacy Proxy выглядит так:

CONNECT example.com:443 HTTP/2
Host: example.com
Proxy-Authorization: Preshared abc123xyz
sec-ch-geohash: 9q8yy-US

Прокси отвечает кодом состояния, указывающим на успех или неудачу:

Статус	Значение
`200 OK`	Туннель успешно установлен
`403 Forbidden`	Ошибка аутентификации
`502 Bad Gateway`	Не удалось подключиться к серверу назначения
`503 Service Unavailable`	Прокси временно недоступен

Заголовки HTTP

Заголовки запроса

Proxy-Authorization