通过

WS_REQUEST_SECURITY_TOKEN_PROPERTY_ID枚举 (webservices.h)

  • 项目

标识用于从颁发者请求安全令牌的属性。 它与 WsRequestSecurityToken 一起使用，作为 WS_REQUEST_SECURITY_TOKEN_PROPERTY* 参数的一部分。

语法

typedef enum {
  WS_REQUEST_SECURITY_TOKEN_PROPERTY_APPLIES_TO = 1,
  WS_REQUEST_SECURITY_TOKEN_PROPERTY_TRUST_VERSION = 2,
  WS_REQUEST_SECURITY_TOKEN_PROPERTY_SECURE_CONVERSATION_VERSION = 3,
  WS_REQUEST_SECURITY_TOKEN_PROPERTY_ISSUED_TOKEN_TYPE = 4,
  WS_REQUEST_SECURITY_TOKEN_PROPERTY_REQUEST_ACTION = 5,
  WS_REQUEST_SECURITY_TOKEN_PROPERTY_EXISTING_TOKEN = 6,
  WS_REQUEST_SECURITY_TOKEN_PROPERTY_ISSUED_TOKEN_KEY_TYPE = 7,
  WS_REQUEST_SECURITY_TOKEN_PROPERTY_ISSUED_TOKEN_KEY_SIZE = 8,
  WS_REQUEST_SECURITY_TOKEN_PROPERTY_ISSUED_TOKEN_KEY_ENTROPY = 9,
  WS_REQUEST_SECURITY_TOKEN_PROPERTY_LOCAL_REQUEST_PARAMETERS = 10,
  WS_REQUEST_SECURITY_TOKEN_PROPERTY_SERVICE_REQUEST_PARAMETERS = 11,
  WS_REQUEST_SECURITY_TOKEN_PROPERTY_MESSAGE_PROPERTIES = 12,
  WS_REQUEST_SECURITY_TOKEN_PROPERTY_BEARER_KEY_TYPE_VERSION = 13
} WS_REQUEST_SECURITY_TOKEN_PROPERTY_ID;

常量

 
WS_REQUEST_SECURITY_TOKEN_PROPERTY_APPLIES_TO
值：1
指向 WS_ENDPOINT_ADDRESS 结构的指针，其中包含所请求的服务 (“信赖方”) 的地址
将显示 token。
.
WS_REQUEST_SECURITY_TOKEN_PROPERTY_TRUST_VERSION
值： 2
指定要使用的 WS-Trust 版本的WS_TRUST_VERSION值。

如果未指定此属性，则默认为 WS_TRUST_VERSION_FEBRUARY_2005。
WS_REQUEST_SECURITY_TOKEN_PROPERTY_SECURE_CONVERSATION_VERSION
值： 3
WS_SECURE_CONVERSATION_VERSION值
指定WS_REQUEST_SECURITY_TOKEN_ACTION_NEW_CONTEXT时要使用的 WS-SecureConversation 版本
指定 或WS_REQUEST_SECURITY_TOKEN_ACTION_RENEW_CONTEXT 。


如果未指定此属性，则默认为 WS_SECURE_CONVERSATION_VERSION_FEBRUARY_2005。
WS_REQUEST_SECURITY_TOKEN_PROPERTY_ISSUED_TOKEN_TYPE
值： 4
指向 WS_XML_STRING 结构的指针，该结构指定要颁发的安全令牌的类型。 如果未指定此属性，
请求安全令牌消息中未生成相应的元素，并且
假设颁发者知道所需的令牌类型。
WS_REQUEST_SECURITY_TOKEN_PROPERTY_REQUEST_ACTION
值： 5
一个WS_REQUEST_SECURITY_TOKEN_ACTION值，该值指定要与请求一起使用的操作。 默认值为 WS_REQUEST_SECURITY_TOKEN_ACTION_ISSUE。
WS_REQUEST_SECURITY_TOKEN_PROPERTY_EXISTING_TOKEN
值： 6
指向 WS_SECURITY_TOKEN 结构的指针，
如果指定，则通过基于请求新令牌来续订提供的令牌，而不是请求新令牌
现有。 如果此操作成功，旧令牌将变为无效。
仅 支持 WS_REQUEST_SECURITY_TOKEN_ACTION_RENEW_CONTEXT。
WS_REQUEST_SECURITY_TOKEN_PROPERTY_ISSUED_TOKEN_KEY_TYPE
值： 7
一个WS_SECURITY_KEY_TYPE值，该值指定要为 请求的加密密钥的类型
已颁发安全令牌。 这必须设置为 WS_SECURITY_KEY_TYPE_NONE 或 WS_SECURITY_KEY_TYPE_SYMMETRIC。


值WS_SECURITY_KEY_TYPE_NONE指定不带持有者令牌
所有权证明密钥。 此类令牌在用于保护消息时不会生成签名。


如果未指定此属性，则不会在令牌请求中发出相应的键类型元素。
未在令牌请求中发出密钥类型会导致 对称密钥的隐式默认值
已颁发令牌，如 WS-Trust 规范中定义。
WS_REQUEST_SECURITY_TOKEN_PROPERTY_ISSUED_TOKEN_KEY_SIZE
值： 8
一个 ULONG，指定要请求的加密密钥的大小 () 位
在颁发的安全令牌中。 此属性只能指定为
使用对称密钥颁发的令牌。 如果未指定此属性，
令牌请求中不会发出相应的密钥大小元素。
WS_REQUEST_SECURITY_TOKEN_PROPERTY_ISSUED_TOKEN_KEY_ENTROPY
值： 9
一个WS_SECURITY_KEY_ENTROPY_MODE值，该值指定如何为 的加密密钥贡献熵
颁发的令牌。 只能为颁发的令牌指定此属性
使用对称密钥。 如果未指定此属性，则使用 模式WS_SECURITY_KEY_ENTROPY_MODE_SERVER_ONLY 。
WS_REQUEST_SECURITY_TOKEN_PROPERTY_LOCAL_REQUEST_PARAMETERS
值： 10
指向 包含的WS_XML_BUFFER 的指针
请求中要逐字包含的其他主参数
安全令牌消息。 每个此类参数都必须是顶级参数
提供的 XML 缓冲区中的 元素。 如果未指定此属性，则为
不会发出参数。 缓冲区序列化为 RequestSecurityToken 元素
请求安全令牌时。


与 WS_REQUEST_SECURITY_TOKEN_PROPERTY_SERVICE_REQUEST_PARAMETERS 不同，本地请求
参数由客户端定义为向令牌请求添加参数的一种方法。
WS_REQUEST_SECURITY_TOKEN_PROPERTY_SERVICE_REQUEST_PARAMETERS
值： 11
指向 包含的WS_XML_BUFFER 的指针
要包含在请求安全令牌中的服务参数
消息，作为 XML 缓冲区提供。 每个此类参数都必须是
提供的 XML 缓冲区中的顶级元素。 如果未指定此属性，则为
不会发出参数。


如果指定 了WS_TRUST_VERSION_FEBRUARY_2005 ，则会序列化此缓冲区
在 后面的 RequestSecurityToken 元素中
WS_REQUEST_SECURITY_TOKEN_PROPERTY_LOCAL_REQUEST_PARAMETERS。


如果指定 了WS_TRUST_VERSION_1_3 ，则会将此缓冲区序列化为
RequestSecurityToken/SecondaryParameters 元素。


服务请求参数是有关如何颁发令牌的说明。 它们从服务中获取，
通常通过元数据导入。 在这种情况下，可能会获取此参数
从输出。 WS_ISSUED_TOKEN_MESSAGE_SECURITY_BINDING_CONSTRAINT的 RequestSecurityTokenTemplate 字段。
WS_REQUEST_SECURITY_TOKEN_PROPERTY_MESSAGE_PROPERTIES
值： 12
要指定的 WS_MESSAGE_PROPERTIES 集
使用 WsCreateMessage 创建两条消息时，
用于获取交换的安全令牌。 如果此属性
未指定，使用 创建请求和回复消息
默认消息属性。
WS_REQUEST_SECURITY_TOKEN_PROPERTY_BEARER_KEY_TYPE_VERSION
值： 13

要求

要求 值
最低受支持的客户端 Windows 7 [桌面应用 |UWP 应用]
最低受支持的服务器 Windows Server 2008 R2 [桌面应用 |UWP 应用]
标头 webservices.h