SignInRequestMessage 类

参考

定义

命名空间:: System.IdentityModel.Services

程序集:: System.IdentityModel.Services.dll

重要

一些信息与预发行产品相关，相应产品在发行之前可能会进行重大修改。对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。

表示 WS-Federation Sign-In 请求消息。

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) 版本 1.0，Windows Identity Foundation (WIF) 允许将 wtrealm 参数或 wreply 参数设置为 (或两者) 才能使登录消息有效;但是，WS-Federation 协议要求在登录请求中存在 wtrealm 参数。在大多数情况下，应确保指定 wtrealm 参数。

类 SignInRequestMessage 公开了多个属性，这些属性可用于设置或访问单个消息参数。还可以通过 Parameters 字典设置或访问这些参数。例如，可以通过属性或通过指定“wtrealm”作为字典的键来读取消息 Realm 中的 Parameters wtrealm 参数。

有关此类表示的消息的详细信息，请参阅以下规范的第 13 部分： Web 服务联合语言 (WS 联合身份验证) 版本 1.2。

构造函数

SignInRequestMessage(Uri, String)	使用指定的基础 URL 和参数初始化 SignInRequestMessage 类的新实例。
SignInRequestMessage(Uri, String, String)	使用指定的基础 URI、 wtrealm 和 wreply 参数初始化 SignInRequestMessage 类的新实例。支持向后兼容性的非标准消息创建。

属性

Action	获取或设置消息的 wa 参数。 (继承自 WSFederationMessage)
AuthenticationType	获取或设置消息的 wauth 参数。
BaseUri	获取或设置消息要应用于的基 URI。 (继承自 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

通过

SignInRequestMessage 类

定义

示例

注解

构造函数

属性

方法

适用于

另请参阅

反馈

其他资源