Compartir a través de

enumeración WS_REQUEST_SECURITY_TOKEN_PROPERTY_ID (webservices.h)

  • Artículo

Identifica las propiedades para solicitar un token de seguridad de un emisor. Se usa con WsRequestSecurityToken como parte del parámetro WS_REQUEST_SECURITY_TOKEN_PROPERTY* .

Syntax

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;

Constantes

 
WS_REQUEST_SECURITY_TOKEN_PROPERTY_APPLIES_TO
Valor: 1
Puntero a una estructura de WS_ENDPOINT_ADDRESS que contiene la dirección del servicio ("usuario de confianza") al que se solicitó
se presentará el token.
.
WS_REQUEST_SECURITY_TOKEN_PROPERTY_TRUST_VERSION
Valor: 2
Valor de WS_TRUST_VERSION que especifica la versión de WS-Trust que se va a usar.

Si no se especifica esta propiedad, el valor predeterminado es WS_TRUST_VERSION_FEBRUARY_2005.
WS_REQUEST_SECURITY_TOKEN_PROPERTY_SECURE_CONVERSATION_VERSION
Valor: 3
Valor de WS_SECURE_CONVERSATION_VERSION que
especifica la versión de WS-SecureConversation que se va a usar cuando se WS_REQUEST_SECURITY_TOKEN_ACTION_NEW_CONTEXT
o WS_REQUEST_SECURITY_TOKEN_ACTION_RENEW_CONTEXT se especifican.


Si no se especifica esta propiedad, el valor predeterminado es WS_SECURE_CONVERSATION_VERSION_FEBRUARY_2005.
WS_REQUEST_SECURITY_TOKEN_PROPERTY_ISSUED_TOKEN_TYPE
Valor: 4
Puntero a una estructura de WS_XML_STRING que especifica el tipo del token de seguridad que se va a emitir. Si no se especifica esta propiedad,
el elemento correspondiente no se genera en el mensaje de token de seguridad de solicitud y .
se supone que el emisor conoce el tipo de token necesario.
WS_REQUEST_SECURITY_TOKEN_PROPERTY_REQUEST_ACTION
Valor: 5
Valor de WS_REQUEST_SECURITY_TOKEN_ACTION que especifica la acción que se va a usar con la solicitud. El valor predeterminado es WS_REQUEST_SECURITY_TOKEN_ACTION_ISSUE.
WS_REQUEST_SECURITY_TOKEN_PROPERTY_EXISTING_TOKEN
Valor: 6
Puntero a una estructura WS_SECURITY_TOKEN que,
si se especifica, en lugar de solicitar un nuevo token, el token proporcionado se renueva solicitando un nuevo token basado en
el existente. El token antiguo no es válido si esta operación se realiza correctamente.
Solo se admite con WS_REQUEST_SECURITY_TOKEN_ACTION_RENEW_CONTEXT.
WS_REQUEST_SECURITY_TOKEN_PROPERTY_ISSUED_TOKEN_KEY_TYPE
Valor: 7
Valor de WS_SECURITY_KEY_TYPE que especifica el tipo de la clave criptográfica que se va a solicitar para el
token de seguridad emitido. Debe establecerse en WS_SECURITY_KEY_TYPE_NONE o WS_SECURITY_KEY_TYPE_SYMMETRIC.


El valor WS_SECURITY_KEY_TYPE_NONE especifica un token de portador sin
claves de prueba de posesión. Estos tokens no generarán una firma cuando se use para proteger un mensaje.


Si no se especifica esta propiedad, el elemento de tipo de clave correspondiente no se emite en las solicitudes de token.
No emitir el tipo de clave en las solicitudes de token da como resultado el valor predeterminado implícito de las claves simétricas para .
token emitido, tal como se define en la especificación WS-Trust.
WS_REQUEST_SECURITY_TOKEN_PROPERTY_ISSUED_TOKEN_KEY_SIZE
Valor: 8
ULONG que especifica el tamaño (en bits) de la clave criptográfica que se va a solicitar.
en el token de seguridad emitido. Esta propiedad solo se puede especificar para
tokens emitidos con claves simétricas. Si no se especifica esta propiedad,
el elemento de tamaño de clave correspondiente no se emite en las solicitudes de token.
WS_REQUEST_SECURITY_TOKEN_PROPERTY_ISSUED_TOKEN_KEY_ENTROPY
Valor: 9
Valor de WS_SECURITY_KEY_ENTROPY_MODE que especifica cómo se contribuye la entropía a la clave criptográfica de .
token emitido. Esta propiedad solo se puede especificar para los tokens emitidos.
con claves simétricas. Si no se especifica esta propiedad, se usa el modo WS_SECURITY_KEY_ENTROPY_MODE_SERVER_ONLY .
WS_REQUEST_SECURITY_TOKEN_PROPERTY_LOCAL_REQUEST_PARAMETERS
Valor: 10
Puntero a un WS_XML_BUFFER que contiene
parámetros principales adicionales que se incluirán textualmente en la solicitud.
mensajes de token de seguridad. Cada parámetro de este tipo debe ser de nivel superior.
elemento del búfer XML proporcionado. Si no se especifica esta propiedad,
no se emiten parámetros. El búfer se serializa en el elemento RequestSecurityToken.
al solicitar un token de seguridad.


A diferencia de WS_REQUEST_SECURITY_TOKEN_PROPERTY_SERVICE_REQUEST_PARAMETERS, solicitud local
El cliente define los parámetros como medio para agregar parámetros a la solicitud de token.
WS_REQUEST_SECURITY_TOKEN_PROPERTY_SERVICE_REQUEST_PARAMETERS
Valor: 11
Puntero a un WS_XML_BUFFER que contiene
los parámetros de servicio que se van a incluir en el token de seguridad de la solicitud
mensajes, proporcionados como un búfer XML. Cada parámetro de este tipo debe ser un
elemento de nivel superior del búfer XML proporcionado. Si no se especifica esta propiedad,
no se emiten parámetros.


Si WS_TRUST_VERSION_FEBRUARY_2005 se especifica este búfer se serializa.
en el elemento RequestSecurityToken que sigue a
WS_REQUEST_SECURITY_TOKEN_PROPERTY_LOCAL_REQUEST_PARAMETERS.


Si se especifica WS_TRUST_VERSION_1_3 este búfer se serializa en .
Elemento RequestSecurityToken/SecondaryParameters.


Los parámetros de solicitud de servicio son instrucciones sobre cómo emitir un token. Se obtienen del servicio,
normalmente por medio de la importación de metadatos. En ese caso, este parámetro se puede obtener
desde fuera. Campo RequestSecurityTokenTemplate del WS_ISSUED_TOKEN_MESSAGE_SECURITY_BINDING_CONSTRAINT.
WS_REQUEST_SECURITY_TOKEN_PROPERTY_MESSAGE_PROPERTIES
Valor: 12
Conjunto de WS_MESSAGE_PROPERTIES que se va a especificar
al crear los dos mensajes con WsCreateMessage y son
se usa para el token de seguridad que obtiene el intercambio. Si esta propiedad
no se especifica, se crean los mensajes de solicitud y respuesta con el
propiedades predeterminadas del mensaje.
WS_REQUEST_SECURITY_TOKEN_PROPERTY_BEARER_KEY_TYPE_VERSION
Valor: 13

Requisitos

Requisito Value
Cliente mínimo compatible Windows 7 [aplicaciones de escritorio | Aplicaciones para UWP]
Servidor mínimo compatible Windows Server 2008 R2 [aplicaciones de escritorio | Aplicaciones para UWP]
Encabezado webservices.h