SignInRequestMessage Класс

Ссылка

Определение

Пространство имен:: System.IdentityModel.Services

Сборка:: System.IdentityModel.Services.dll

Важно!

Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.

Представляет сообщение запроса входа 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

Наследование: Object

FederationMessage

WSFederationMessage
SignInRequestMessage

Примеры

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 следующей спецификации: Web Services Federation Language (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)

Применяется к

См. также раздел

SignInResponseMessage