CookieAuthenticationOptions Класс
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Параметры конфигурации для CookieAuthenticationOptions.
public ref class CookieAuthenticationOptions : Microsoft::AspNetCore::Authentication::AuthenticationSchemeOptions
public class CookieAuthenticationOptions : Microsoft.AspNetCore.Authentication.AuthenticationSchemeOptions
type CookieAuthenticationOptions = class
inherit AuthenticationSchemeOptions
Public Class CookieAuthenticationOptions
Inherits AuthenticationSchemeOptions
- Наследование
Конструкторы
CookieAuthenticationOptions() |
Создание экземпляра параметров, которые инициализируются со значениями по умолчанию |
Свойства
AccessDeniedPath |
Свойство AccessDeniedPath используется обработчиком для целевого объекта перенаправления при обработке ForbidAsync. |
ClaimsIssuer |
Возвращает или задает издателя, который должен использоваться для всех создаваемых утверждений. (Унаследовано от AuthenticationSchemeOptions) |
Cookie |
Определяет параметры, используемые для создания файлов cookie. |
CookieDomain |
Устаревшие..
Это свойство устарело и будет удалено в следующей версии. Рекомендуемый вариант — в Cookie. Определяет домен, используемый для создания файла cookie. По умолчанию не предоставляется. |
CookieHttpOnly |
Устаревшие..
Устаревшие..
Это свойство устарело и будет удалено в следующей версии. Рекомендуемый вариант — в Cookie. Определяет, следует ли браузеру разрешать JavaScript на стороне клиента доступ к файлам cookie. Значение по умолчанию — true, что означает, что файлы cookie будут передаваться только в HTTP-запросы, и скрипту на странице не будет разрешен к ним доступ. |
CookieManager |
Компонент, использованный для получения файлов cookie из запроса или задания их для отклика. Диспетчер ChunkingCookieManager, который будет использоваться по умолчанию. |
CookieName |
Устаревшие..
Устаревшие..
Это свойство устарело и будет удалено в следующей версии. Рекомендуемый вариант — в Cookie. Определяет имя файла cookie, используемого для сохранения удостоверения. Значение по умолчанию — ". AspNetCore.Cookies". Это значение следует изменить при изменении имени AuthenticationScheme, особенно если система использует обработчик проверки подлинности файлов cookie несколько раз. |
CookiePath |
Устаревшие..
Это свойство устарело и будет удалено в следующей версии. Рекомендуемый вариант — в Cookie. Определяет путь, используемый для создания файла cookie. Значение по умолчанию — "/" для обеспечения максимальной совместимости с браузером. |
CookieSecure |
Устаревшие..
Это свойство устарело и будет удалено в следующей версии. Рекомендуемый вариант — в Cookie. Определяет, должны ли файлы cookie передаваться только в HTTPS-запросе. По умолчанию файлы cookie ограничиваются HTTPS-запросами, если страница, на которой выполняется SignIn, также является HTTPS-страницей. Если имеется страница входа HTTPS, а некоторые части сайта — HTTP, то может потребоваться изменить это значение. |
DataProtectionProvider |
Если этот параметр задан, он будет использоваться CookieAuthenticationHandler для защиты данных. |
Events |
Параметр Provider может назначаться экземпляру объекта, созданному приложением в во время запуска. Обработчик вызывает методы поставщика, которые предоставляют приложению управление в определенных точках обработки. Если он не предоставлен, то используется экземпляр по умолчанию, который ничего не делает при вызове методов. |
EventsType |
Если задано значение , будет использоваться в качестве типа службы для получения экземпляра Events вместо свойства . (Унаследовано от AuthenticationSchemeOptions) |
ExpireTimeSpan |
Определяет, сколько времени билет проверки подлинности, хранящийся в файле cookie, будет оставаться действительным с момента его создания. Сведения об истечении срока действия хранятся в защищенном билете файла cookie. Из-за этого просроченный файл cookie будет игнорироваться, даже если он передается на сервер после того, как браузер должен был очистить его. Это значение отличается от значения Expires, которое указывает, как долго браузер будет хранить файл cookie. |
ForwardAuthenticate |
Если задано значение , это указывает целевую схему, в которую эта схема должна пересылать вызовы AuthenticateAsync. Например, Context.AuthenticateAsync("ThisScheme") => Context.AuthenticateAsync("ForwardAuthenticateValue"); Задайте для целевого объекта текущую схему, чтобы отключить пересылку и разрешить нормальную обработку. (Унаследовано от AuthenticationSchemeOptions) |
ForwardChallenge |
Если задано значение , это указывает целевую схему, в которую эта схема должна переадресовывать вызовы ChallengeAsync. Например, Context.ChallengeAsync("ThisScheme") => Context.ChallengeAsync("ForwardChallengeValue"); Задайте для целевого объекта текущую схему, чтобы отключить пересылку и разрешить нормальную обработку. (Унаследовано от AuthenticationSchemeOptions) |
ForwardDefault |
Если задано значение , это указывает схему по умолчанию, в которую обработчики проверки подлинности должны перенаправлять все операции проверки подлинности по умолчанию. Логика переадресации по умолчанию сначала проверка самый конкретный параметр ForwardAuthenticate/Challenge/Forbid/SignIn/SignOut, а затем проверка ForwardDefaultSelector, а затем ForwardDefault. Первый результат, отличный от NULL, будет использоваться в качестве целевой схемы для пересылки. (Унаследовано от AuthenticationSchemeOptions) |
ForwardDefaultSelector |
Используется для выбора схемы по умолчанию для текущего запроса, в который обработчики проверки подлинности должны пересылать все операции проверки подлинности по умолчанию. Логика переадресации по умолчанию сначала проверка самый конкретный параметр ForwardAuthenticate/Challenge/Forbid/SignIn/SignOut, а затем проверка ForwardDefaultSelector, а затем ForwardDefault. Первый результат, отличный от NULL, будет использоваться в качестве целевой схемы для пересылки. (Унаследовано от AuthenticationSchemeOptions) |
ForwardForbid |
Если задано значение , это указывает целевую схему, в которую эта схема должна пересылать вызовы ForbidAsync. Например, Context.ForbidAsync("ThisScheme") => Context.ForbidAsync("ForwardForbidValue"); Задайте для целевого объекта текущую схему, чтобы отключить пересылку и разрешить нормальную обработку. (Унаследовано от AuthenticationSchemeOptions) |
ForwardSignIn |
Если задано значение , то указывает целевую схему, в которую эта схема должна пересылать вызовы SignInAsync. Например, Context.SignInAsync("ThisScheme") => Context.SignInAsync("ForwardSignInValue"); Задайте для целевого объекта текущую схему, чтобы отключить пересылку и разрешить нормальную обработку. (Унаследовано от AuthenticationSchemeOptions) |
ForwardSignOut |
Если задано значение , это указывает целевую схему, в которую эта схема должна пересылать вызовы SignOutAsync. Например, Context.SignOutAsync("ThisScheme") => Context.SignOutAsync("ForwardSignOutValue"); Задайте для целевого объекта текущую схему, чтобы отключить пересылку и разрешить нормальную обработку. (Унаследовано от AuthenticationSchemeOptions) |
LoginPath |
Свойство LoginPath используется обработчиком для целевого объекта перенаправления при обработке ChallengeAsync. Текущий URL-адрес, который добавляется в LoginPath в качестве параметра строки запроса с именем ReturnUrlParameter. Когда запрос к LoginPath предоставляет новое удостоверение SignIn, значение ReturnUrlParameter используется для перенаправления браузера обратно на исходный URL-адрес. |
LogoutPath |
Если logoutPath указан обработчик, запрос на этот путь будет перенаправляться на основе ReturnUrlParameter. |
ReturnUrlParameter |
ReturnUrlParameter определяет имя параметра строки запроса, который добавляется обработчиком во время запроса. Это также параметр строки запроса, который ищется, когда запрос прибывает в путь входа или в путь выхода, чтобы получить исходный URL-адрес после выполнения этого действия. |
SessionStore |
Необязательный контейнер, в котором хранится удостоверение для всех запросов. При использовании только идентификатор сеанса отправляется клиенту. Можно использовать, чтобы нейтрализовать проблемы с большим числом удостоверений. |
SlidingExpiration |
Для параметра SlidingExpiration задано значение true, чтобы обработчик повторно выдал новый файл cookie с новым сроком действия каждый раз, когда он обрабатывает запрос, который находится более чем на полпути до истечения срока действия. |
TicketDataFormat |
TicketDataFormat используется для установки и снятия защиты Identity и других свойств, хранящихся в значении файла cookie. Если он не указан, он будет создан с помощью DataProtectionProvider. |
TimeProvider |
Используется для тестирования. (Унаследовано от AuthenticationSchemeOptions) |
Методы
Validate() |
Убедитесь, что параметры являются допустимыми. Должен вызывать исключение, если все не в порядке. (Унаследовано от AuthenticationSchemeOptions) |
Validate(String) |
Проверка допустимости параметров для конкретной схемы (Унаследовано от AuthenticationSchemeOptions) |