énumération WS_REQUEST_SECURITY_TOKEN_PROPERTY_ID (webservices.h)

Identifie les propriétés permettant de demander un jeton de sécurité à un émetteur. Il est utilisé avec WsRequestSecurityToken dans le cadre du paramètre 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 Valeur : 1 Pointeur vers une structure de WS_ENDPOINT_ADDRESS contenant l’adresse du service (« partie de confiance ») à laquelle le demandé le jeton sera présenté. .
WS_REQUEST_SECURITY_TOKEN_PROPERTY_TRUST_VERSION Valeur : 2 Valeur WS_TRUST_VERSION qui spécifie la version de WS-Trust à utiliser. Si cette propriété n’est pas spécifiée, la valeur par défaut est WS_TRUST_VERSION_FEBRUARY_2005.
WS_REQUEST_SECURITY_TOKEN_PROPERTY_SECURE_CONVERSATION_VERSION Valeur : 3 Valeur WS_SECURE_CONVERSATION_VERSION qui spécifie la version de WS-SecureConversation à utiliser quand WS_REQUEST_SECURITY_TOKEN_ACTION_NEW_CONTEXT ou WS_REQUEST_SECURITY_TOKEN_ACTION_RENEW_CONTEXT sont spécifiés. Si cette propriété n’est pas spécifiée, la valeur par défaut est WS_SECURE_CONVERSATION_VERSION_FEBRUARY_2005.
WS_REQUEST_SECURITY_TOKEN_PROPERTY_ISSUED_TOKEN_TYPE Valeur : 4 Pointeur vers une structure WS_XML_STRING qui spécifie le type du jeton de sécurité à émettre. Si cette propriété n’est pas spécifiée, l’élément correspondant n’est pas généré dans le message de jeton de sécurité de la demande, et le l’émetteur est supposé connaître le type de jeton requis.
WS_REQUEST_SECURITY_TOKEN_PROPERTY_REQUEST_ACTION Valeur : 5 Valeur WS_REQUEST_SECURITY_TOKEN_ACTION qui spécifie l’action à utiliser avec la requête. La valeur par défaut est WS_REQUEST_SECURITY_TOKEN_ACTION_ISSUE.
WS_REQUEST_SECURITY_TOKEN_PROPERTY_EXISTING_TOKEN Valeur : 6 Pointeur vers une structure de WS_SECURITY_TOKEN qui, si spécifié, au lieu de demander un nouveau jeton, le jeton fourni est renouvelé en demandant un nouveau jeton basé sur l’existant. L’ancien jeton devient non valide si cette opération réussit. Pris en charge uniquement avec WS_REQUEST_SECURITY_TOKEN_ACTION_RENEW_CONTEXT.
WS_REQUEST_SECURITY_TOKEN_PROPERTY_ISSUED_TOKEN_KEY_TYPE Valeur : 7 Valeur WS_SECURITY_KEY_TYPE qui spécifie le type de la clé de chiffrement à demander pour le émission d’un jeton de sécurité. Ce paramètre doit être défini sur WS_SECURITY_KEY_TYPE_NONE ou WS_SECURITY_KEY_TYPE_SYMMETRIC. La valeur WS_SECURITY_KEY_TYPE_NONE spécifie un jeton de porteur sans clés de preuve de possession. Ces jetons ne produisent pas de signature lorsqu’ils sont utilisés pour sécuriser un message. Si cette propriété n’est pas spécifiée, l’élément de type clé correspondant n’est pas émis dans les demandes de jeton. Le fait de ne pas émettre le type de clé dans les demandes de jeton entraîne la valeur par défaut implicite des clés symétriques pour le jeton émis, tel que défini dans la spécification WS-Trust.
WS_REQUEST_SECURITY_TOKEN_PROPERTY_ISSUED_TOKEN_KEY_SIZE Valeur : 8 ULONG qui spécifie la taille (en bits) de la clé de chiffrement à demander dans le jeton de sécurité émis. Cette propriété peut être spécifiée uniquement pour émission de jetons avec des clés symétriques. Si cette propriété n’est pas spécifiée, l’élément de taille de clé correspondant n’est pas émis dans les demandes de jeton.
WS_REQUEST_SECURITY_TOKEN_PROPERTY_ISSUED_TOKEN_KEY_ENTROPY Valeur : 9 Valeur WS_SECURITY_KEY_ENTROPY_MODE qui spécifie comment l’entropie est apportée à la clé de chiffrement du jeton émis. Cette propriété peut être spécifiée uniquement pour les jetons émis avec des clés symétriques. Si cette propriété n’est pas spécifiée, le mode WS_SECURITY_KEY_ENTROPY_MODE_SERVER_ONLY est utilisé.
WS_REQUEST_SECURITY_TOKEN_PROPERTY_LOCAL_REQUEST_PARAMETERS Valeur : 10 Pointeur vers un WS_XML_BUFFER qui contient paramètres principaux supplémentaires à inclure textuellement dans la demande messages de jeton de sécurité. Chaque paramètre de ce type doit être un niveau supérieur dans la mémoire tampon XML fournie. Si cette propriété n’est pas spécifiée, par exemple les paramètres ne sont pas émis. La mémoire tampon est sérialisée dans l’élément RequestSecurityToken lors de la demande d’un jeton de sécurité. Contrairement à WS_REQUEST_SECURITY_TOKEN_PROPERTY_SERVICE_REQUEST_PARAMETERS, demande locale les paramètres sont définis par le client comme moyen d’ajouter des paramètres à la demande de jeton.
WS_REQUEST_SECURITY_TOKEN_PROPERTY_SERVICE_REQUEST_PARAMETERS Valeur : 11 Pointeur vers un WS_XML_BUFFER qui contient paramètres de service à inclure dans le jeton de sécurité de la demande messages, fournis sous forme de mémoire tampon XML. Chaque paramètre de ce type doit être un élément de niveau supérieur dans la mémoire tampon XML fournie. Si cette propriété n’est pas spécifiée, par exemple les paramètres ne sont pas émis. Si WS_TRUST_VERSION_FEBRUARY_2005 est spécifié, cette mémoire tampon est sérialisée dans l’élément RequestSecurityToken suivant le WS_REQUEST_SECURITY_TOKEN_PROPERTY_LOCAL_REQUEST_PARAMETERS. Si WS_TRUST_VERSION_1_3 est spécifié, cette mémoire tampon est sérialisée dans le Élément RequestSecurityToken/SecondaryParameters. Les paramètres de demande de service sont des instructions concernant l’émission d’un jeton. Ils sont obtenus auprès du service, généralement au moyen d’une importation de métadonnées. Dans ce cas, ce paramètre peut être obtenu de l’extérieur. Champ RequestSecurityTokenTemplate du WS_ISSUED_TOKEN_MESSAGE_SECURITY_BINDING_CONSTRAINT.
WS_REQUEST_SECURITY_TOKEN_PROPERTY_MESSAGE_PROPERTIES Valeur : 12 Ensemble de WS_MESSAGE_PROPERTIES à spécifier lors de la création des deux messages avec WsCreateMessage et sont à être utilisé pour l’obtention de l’échange du jeton de sécurité. Si cette propriété n’est pas spécifié, les messages de demande et de réponse sont créés avec le propriétés de message par défaut.
WS_REQUEST_SECURITY_TOKEN_PROPERTY_BEARER_KEY_TYPE_VERSION Valeur : 13

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows 7 [applications de bureau | Applications UWP]
Serveur minimal pris en charge	Windows Server 2008 R2 [applications de bureau | Applications UWP]
En-tête	webservices.h