SignInRequestMessage Класс
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Представляет сообщение запроса входа WS-Federation.
public ref class SignInRequestMessage : System::IdentityModel::Services::WSFederationMessage
public class SignInRequestMessage : System.IdentityModel.Services.WSFederationMessage
type SignInRequestMessage = class
inherit WSFederationMessage
Public Class SignInRequestMessage
Inherits WSFederationMessage
- Наследование
Примеры
string identityProviderUri = Request.QueryString["whr"];
string action = Request.QueryString["wa"];
SignInRequestMessage signInRequest = FederatedAuthentication.WSFederationAuthenticationModule.CreateSignInRequest(Guid.NewGuid().ToString(),
"http://MyAppreturnUrl",
false);
signInRequest.Realm = "htp://MyApp.com";
signInRequest.HomeRealm = identityProviderUri;
Response.Redirect(signInRequest.RequestUrl);
Комментарии
WS-Federation сообщение о входе отправляется проверяющей стороной (RP) в службу маркеров безопасности (STS) для запроса маркера безопасности. Параметр wa должен иметь значение wsignout1.0, а параметр wtrealm — область безопасности запрошенного ресурса (часто это URL-адрес запрошенного ресурса). В запросе также могут быть указаны другие необязательные параметры.
Сообщение SignOutRequestMessage создается статическими методами SignOutRequestMessage класса , например методом CreateFromUri , если для параметра wa задано значение "wsignin1.0", отсутствует параметр wresult или wresultptr и присутствует параметр wtrealm или параметр wreply.
Важно!
Для обеспечения обратной совместимости с службы федерации Active Directory (AD FS) (AD FS) версии 1.0 Windows Identity Foundation (WIF) позволяет задать параметр wtrealm или параметр wreply, чтобы сообщение входа было действительным. Однако протокол WS-Federation требует, чтобы параметр wtrealm присутствовал в запросе на вход. В большинстве сценариев следует убедиться, что указан параметр wtrealm.
Класс SignInRequestMessage предоставляет несколько свойств, которые можно использовать для установки или доступа к отдельным параметрам сообщения. Эти параметры также можно задать или получить к ней доступ через словарь Parameters . Например, параметр wtrealm в сообщении можно прочитать через Realm свойство или указав wtrealm в качестве ключа к словарю Parameters .
Дополнительные сведения о сообщении, представляемом этим классом, см. в разделе 13 следующей спецификации: Язык федерации веб-служб (WS-Federation) версии 1.2.
Конструкторы
SignInRequestMessage(Uri, String) |
Инициализирует новый экземпляр класса SignInRequestMessage с указанным базовым URL-адресом и параметром wtrealm. |
SignInRequestMessage(Uri, String, String) |
Инициализирует новый экземпляр класса SignInRequestMessage с помощью указанного базового URL-адреса, параметра wtrealm и параметра wreply. Поддерживает создание нестандартных сообщений для обеспечения обратной совместимости. |
Свойства
Action |
Получает или задает параметр wa сообщения. (Унаследовано от WSFederationMessage) |
AuthenticationType |
Получает или задает параметр wauth сообщения. |
BaseUri |
Получает или задает базовый URL-адрес, к которому применяется сообщение. (Унаследовано от FederationMessage) |
Context |
Получает или задает параметр wctx сообщения. (Унаследовано от WSFederationMessage) |
CurrentTime |
Получает или задает параметр wct сообщения. |
Encoding |
Получает или задает параметр wencoding сообщения. (Унаследовано от WSFederationMessage) |
Federation |
Получает или задает параметр wfed сообщения. |
Freshness |
Получает или задает параметр wfresh сообщения. |
HomeRealm |
Получает или задает параметр whr сообщения. |
Parameters |
Получает параметры сообщения в виде словаря. (Унаследовано от FederationMessage) |
Policy |
Получает или задает параметр wp сообщения. |
Realm |
Получает или задает параметр wtrealm сообщения. |
Reply |
Получает или задает параметр wreply сообщения. |
Request |
Получает или задает параметр wreq сообщения. |
RequestPtr |
Получает или задает параметр wreqptr сообщения. |
RequestUrl |
Получает строковое представление URL-адреса, соответствующего этому сообщению. |
Resource |
Получает или задает параметр wres сообщения. |
Методы
Equals(Object) |
Определяет, равен ли указанный объект текущему объекту. (Унаследовано от Object) |
GetHashCode() |
Служит хэш-функцией по умолчанию. (Унаследовано от Object) |
GetParameter(String) |
Возвращает указанное значение параметра из словаря параметров. (Унаследовано от FederationMessage) |
GetType() |
Возвращает объект Type для текущего экземпляра. (Унаследовано от Object) |
MemberwiseClone() |
Создает неполную копию текущего объекта Object. (Унаследовано от Object) |
RemoveParameter(String) |
Удаляет параметр из словаря параметров. (Унаследовано от FederationMessage) |
SetParameter(String, String) |
Задает значение параметра в словаре параметров. (Унаследовано от FederationMessage) |
SetUriParameter(String, String) |
Задает значение параметра в словаре параметров. Значение должно представлять собой абсолютный URI. (Унаследовано от FederationMessage) |
ToString() |
Возвращает строку, представляющую текущий объект. (Унаследовано от Object) |
Validate() |
Проверяет текущий экземпляр. |
Write(TextWriter) |
Записывает это сообщение в виде строки запроса в указанный модуль записи текста. |
WriteFormPost() |
Сериализует сообщение в виде отправляемой формы и возвращает результирующую форму и ее код JavaScript в виде строки. (Унаследовано от FederationMessage) |
WriteQueryString() |
Возвращает строковое представление сообщения в формате строки запроса. (Унаследовано от FederationMessage) |