HTTP Proxy-Authenticate заголовок ответа определяет метод аутентификации (или вызов), который следует использовать для получения доступа к ресурсу за прокси-сервером. Он отправляется в ответе 407 Proxy Authentication Required, чтобы клиент мог идентифицировать себя прокси-серверу, требующему аутентификации.

Синтаксис

Proxy-Authenticate: <challenge>, …

Значение представляет собой разделённый запятыми список вызовов, где <challenge> состоит из <auth-scheme>, за которым следует необязательный <token68> или разделённый запятыми список <auth-params>:

challenge = <auth-scheme> <auth-param>, …, <auth-paramN>
challenge = <auth-scheme> <token68>

Например:

Proxy-Authenticate: <auth-scheme>
Proxy-Authenticate: <auth-scheme> token68
Proxy-Authenticate: <auth-scheme> auth-param1=param-token1
Proxy-Authenticate: <auth-scheme> auth-param1=param-token1, …, auth-paramN=param-tokenN

Наличие token68 или параметров аутентификации зависит от выбранного <auth-scheme>. Например, для базовой аутентификации требуется <realm>; допускается необязательное использование ключа charset, но не поддерживается token68:

Proxy-Authenticate: Basic realm="Dev", charset="UTF-8"

Директивы

<auth-scheme>

Токен без учёта регистра, указывающий используемую схему аутентификации. К наиболее распространённым типам относятся Basic, Digest, Negotiate и AWS4-HMAC-SHA256. IANA ведёт список схем аутентификации, однако службы узлов предлагают и другие схемы.

<auth-param> Необязательно

Параметр аутентификации, формат которого зависит от <auth-scheme>. <realm> описан ниже, поскольку это распространённый параметр аутентификации во многих схемах.

<realm> Необязательно

Строка realm, за которой следует = и строка в кавычках, описывающая защищённую область, например realm="staging environment". Область позволяет серверу разделять защищаемые им области (если схема поддерживает такое разделение). Некоторые клиенты показывают это значение пользователю, чтобы сообщить, какие именно учётные данные необходимы, хотя большинство браузеров перестали это делать для защиты от фишинга. Для этого значения надёжно поддерживается только набор символов us-ascii. Если область не указана, клиенты часто показывают отформатированное имя хоста.

<token68> Необязательно

Токен, который может быть полезен для некоторых схем. Токен допускает 66 незарезервированных символов URI и несколько других. Он может содержать данные в кодировке base64, base64url, base32 или base16 (шестнадцатеричной), с заполнением или без него, но без пробельных символов. Вариант token68 вместо списков auth-param поддерживается для совместимости с устаревшими схемами аутентификации.

Как правило, для каждого <auth-scheme> необходимо сверяться с соответствующими спецификациями, чтобы определить требуемые параметры аутентификации.

Примеры

Базовая аутентификация Proxy-Authenticate

Следующий ответ указывает, что требуется схема базовой аутентификации с областью:

Proxy-Authenticate: Basic realm="Staging server"

Спецификации

Совместимость с браузерами

См. также

• WWW-Authenticate
• Аутентификация HTTP
• Authorization, Proxy-Authorization
• 401, 403, 407