SignInRequestMessage 类
定义
重要
一些信息与预发行产品相关,相应产品在发行之前可能会进行重大修改。 对于此处提供的信息,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
- 继承
示例
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) |