HttpWebRequest.PreAuthenticate Свойство
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Возвращает или задает значение, указывающее, следует ли отправлять заголовок авторизации вместе с запросом.
public:
virtual property bool PreAuthenticate { bool get(); void set(bool value); };
public override bool PreAuthenticate { get; set; }
member this.PreAuthenticate : bool with get, set
Public Overrides Property PreAuthenticate As Boolean
Значение свойства
true
для отправки заголовка авторизации HTTP с запросами после проверки подлинности; в противном случае — false
. Значение по умолчанию — false
.
Комментарии
После успешной проверки подлинности клиентского запроса к определенному Uri объекту, если PreAuthenticate задано значение и true
учетные данные, заголовок авторизации отправляется с каждым запросом в любой Uri из них, соответствующий определенной Uri косой черте до последней косой черты. Таким образом, если запрос клиента успешно прошел проверку подлинности в определенном Uri объекте, который содержит следующее:
http://www.contoso.com/firstpath/
Затем заголовок Authorization для предварительной проверки подлинности отправляется с каждым запросом в любой из следующих Uri экземпляров:
http://www.contoso.com/firstpath/
http://www.contoso.com/firstpath/default
http://www.contoso.com/firstpath/default.html
http://www.contoso.com/firstpath/sample.html
Однако заголовок Authorization не отправляется с запросами ни к одному из следующих Uri экземпляров:
http://www.contoso.com/
http://www.contoso.com/firstpath
http://www.contoso.com/secondpath/
http://www.contoso.com/firstpath/thirdpath/
Если клиентский запрос к определенному объекту Uri не прошел проверку подлинности, запрос использует стандартные процедуры проверки подлинности.
За исключением первого запроса, свойство указывает, PreAuthenticate следует ли отправлять сведения о проверке подлинности с последующими запросами в объект , соответствующий Uri определенной Uri косой черте до последней косой черты, не дожидаясь запроса сервера.
В следующем диалоговом окне между клиентом и сервером показано влияние этого свойства. В диалоговом окне предполагается, что используется обычная проверка подлинности.
PreAuthenticate имеет значение false
:
Клиент: GET someUrl
Сервер: 401 WWW-Authenticate Базовый
Клиент: GET с заголовками авторизации
Сервер: 200 OK
Клиент: GET someUrl
Сервер: 401 WWW-Authenticate Базовый
Клиент: GET с заголовками авторизации
Сервер: 200 OK
PreAuthenticate имеет значение true
:
Клиент: GET someUrl
Сервер: 401 WWW-Authenticate Базовый
Клиент: GET с заголовками авторизации
Сервер: 200 OK
Клиент: GET someUrl с заголовками авторизации
Если схема проверки подлинности не поддерживает предварительную проверку подлинности, значение этого свойства игнорируется.
Применяется к
Кері байланыс
https://aka.ms/ContentUserFeedback.
Жақында қолжетімді болады: 2024 жыл бойы біз GitHub Issues жүйесін мазмұнға арналған кері байланыс механизмі ретінде біртіндеп қолданыстан шығарамыз және оны жаңа кері байланыс жүйесімен ауыстырамыз. Қосымша ақпаратты мұнда қараңыз:Жіберу және пікірді көру