WS_REQUEST_SECURITY_TOKEN_PROPERTY_ID-Enumeration (webservices.h)

  • Artikel

Identifiziert die Eigenschaften zum Anfordern eines Sicherheitstokens von einem Aussteller. Es wird mit WsRequestSecurityToken als Teil des WS_REQUEST_SECURITY_TOKEN_PROPERTY*- Parameters verwendet.

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;

Konstanten

 
WS_REQUEST_SECURITY_TOKEN_PROPERTY_APPLIES_TO
Wert: 1
Ein Zeiger auf eine WS_ENDPOINT_ADDRESS-Struktur , die die Adresse des Diensts ("vertrauende Seite") enthält, an die die angeforderte
token wird angezeigt.
.
WS_REQUEST_SECURITY_TOKEN_PROPERTY_TRUST_VERSION
Wert: 2
Ein WS_TRUST_VERSION-Wert , der die zu verwendende Version von WS-Trust angibt.

Wenn diese Eigenschaft nicht angegeben ist, wird standardmäßig WS_TRUST_VERSION_FEBRUARY_2005.
WS_REQUEST_SECURITY_TOKEN_PROPERTY_SECURE_CONVERSATION_VERSION
Wert: 3
Ein WS_SECURE_CONVERSATION_VERSION-Wert , der
Gibt die Version von WS-SecureConversation an, die beim WS_REQUEST_SECURITY_TOKEN_ACTION_NEW_CONTEXT verwendet werden soll .
oder WS_REQUEST_SECURITY_TOKEN_ACTION_RENEW_CONTEXT angegeben werden.


Wenn diese Eigenschaft nicht angegeben ist, wird standardmäßig WS_SECURE_CONVERSATION_VERSION_FEBRUARY_2005.
WS_REQUEST_SECURITY_TOKEN_PROPERTY_ISSUED_TOKEN_TYPE
Wert: 4
Ein Zeiger auf eine WS_XML_STRING-Struktur , die den Typ des auszustellenden Sicherheitstokens angibt. Wenn diese Eigenschaft nicht angegeben ist,
das entsprechende Element wird in der Anforderungssicherheitstokennachricht nicht generiert, und die
Es wird davon ausgegangen, dass der Aussteller den erforderlichen Tokentyp kennt.
WS_REQUEST_SECURITY_TOKEN_PROPERTY_REQUEST_ACTION
Wert: 5
Ein WS_REQUEST_SECURITY_TOKEN_ACTION Wert, der die Aktion angibt, die mit der Anforderung verwendet werden soll. Der Standardwert ist WS_REQUEST_SECURITY_TOKEN_ACTION_ISSUE.
WS_REQUEST_SECURITY_TOKEN_PROPERTY_EXISTING_TOKEN
Wert: 6
Ein Zeiger auf eine WS_SECURITY_TOKEN-Struktur , die
Wenn angegeben, wird das bereitgestellte Token erneuert, anstatt ein neues Token anzufordern, indem ein neues Token basierend auf angefordert wird.
die vorhandene. Das alte Token wird ungültig, wenn dieser Vorgang erfolgreich ist.
Wird nur mit WS_REQUEST_SECURITY_TOKEN_ACTION_RENEW_CONTEXT unterstützt.
WS_REQUEST_SECURITY_TOKEN_PROPERTY_ISSUED_TOKEN_KEY_TYPE
Wert: 7
Ein WS_SECURITY_KEY_TYPE-Wert , der den Typ des kryptografischen Schlüssels angibt, der für die angefordert werden soll.
ausgestelltes Sicherheitstoken. Dies muss auf WS_SECURITY_KEY_TYPE_NONE oder WS_SECURITY_KEY_TYPE_SYMMETRIC festgelegt werden.


Der Wert WS_SECURITY_KEY_TYPE_NONE ein Bearertoken ohne
Schlüssel für den Besitznachweis. Solche Token erzeugen keine Signatur, wenn sie zum Sichern einer Nachricht verwendet werden.


Wenn diese Eigenschaft nicht angegeben ist, wird das entsprechende Schlüsseltypelement nicht in Tokenanforderungen ausgegeben.
Das Nicht-Ausgeben des Schlüsseltyps in Tokenanforderungen führt zum impliziten Standard von symmetrischen Schlüsseln für die
ausgestelltes Token, wie in der WS-Trust-Spezifikation definiert.
WS_REQUEST_SECURITY_TOKEN_PROPERTY_ISSUED_TOKEN_KEY_SIZE
Wert: 8
Eine ULONG , die die Größe (in Bits) des kryptografischen Schlüssels angibt, der angefordert werden soll.
im ausgestellten Sicherheitstoken. Diese Eigenschaft kann nur für angegeben werden.
ausgestellte Token mit symmetrischen Schlüsseln. Wenn diese Eigenschaft nicht angegeben ist,
Das entsprechende Schlüsselgrößenelement wird in Tokenanforderungen nicht ausgegeben.
WS_REQUEST_SECURITY_TOKEN_PROPERTY_ISSUED_TOKEN_KEY_ENTROPY
Wert: 9
Ein WS_SECURITY_KEY_ENTROPY_MODE-Wert , der angibt, wie Entropie zum kryptografischen Schlüssel des
ausgestelltes Token. Diese Eigenschaft kann nur für ausgestellte Token angegeben werden.
mit symmetrischen Schlüsseln. Wenn diese Eigenschaft nicht angegeben ist, wird der Modus WS_SECURITY_KEY_ENTROPY_MODE_SERVER_ONLY verwendet.
WS_REQUEST_SECURITY_TOKEN_PROPERTY_LOCAL_REQUEST_PARAMETERS
Wert: 10
Ein Zeiger auf eine WS_XML_BUFFER , die enthält
die zusätzlichen primären Parameter, die wörtlich in die Anforderung eingeschlossen werden sollen
Sicherheitstokenmeldungen. Jeder dieser Parameter muss eine oberste Ebene sein.
-Element im angegebenen XML-Puffer. Wenn diese Eigenschaft nicht angegeben ist, z. B.
Parameter werden nicht ausgegeben. Der Puffer wird in das RequestSecurityToken-Element serialisiert.
beim Anfordern eines Sicherheitstokens.


Im Gegensatz zu WS_REQUEST_SECURITY_TOKEN_PROPERTY_SERVICE_REQUEST_PARAMETERS, lokale Anforderung
-Parameter werden vom Client definiert, um der Tokenanforderung Parameter hinzuzufügen.
WS_REQUEST_SECURITY_TOKEN_PROPERTY_SERVICE_REQUEST_PARAMETERS
Wert: 11
Ein Zeiger auf eine WS_XML_BUFFER , die enthält
Die Dienstparameter, die in das Anforderungssicherheitstoken eingeschlossen werden sollen
-Nachrichten, die als XML-Puffer bereitgestellt werden. Jeder dieser Parameter muss ein
Element der obersten Ebene im bereitgestellten XML-Puffer. Wenn diese Eigenschaft nicht angegeben ist, z. B.
Parameter werden nicht ausgegeben.


Wenn WS_TRUST_VERSION_FEBRUARY_2005 angegeben ist, wird dieser Puffer serialisiert.
in das RequestSecurityToken-Element nach dem
WS_REQUEST_SECURITY_TOKEN_PROPERTY_LOCAL_REQUEST_PARAMETERS.


Wenn WS_TRUST_VERSION_1_3 angegeben ist, wird dieser Puffer in den serialisiert.
RequestSecurityToken/SecondaryParameters-Element.


Dienstanforderungsparameter sind Anweisungen zum Ausgeben eines Tokens. Sie werden aus dem Dienst bezogen,
in der Regel mittels Metadatenimport. In diesem Fall kann dieser Parameter abgerufen werden.
von außen. RequestSecurityTokenTemplate-Feld des WS_ISSUED_TOKEN_MESSAGE_SECURITY_BINDING_CONSTRAINT.
WS_REQUEST_SECURITY_TOKEN_PROPERTY_MESSAGE_PROPERTIES
Wert: 12
Der Satz der anzugebenden WS_MESSAGE_PROPERTIES
beim Erstellen der beiden Nachrichten mit WsCreateMessage und
für das Sicherheitstoken verwendet werden, das austauscht. Wenn diese Eigenschaft
ist nicht angegeben, die Anforderungs- und Antwortnachrichten werden mit dem
Standardnachrichteneigenschaften.
WS_REQUEST_SECURITY_TOKEN_PROPERTY_BEARER_KEY_TYPE_VERSION
Wert: 13

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows 7 [Desktop-Apps | UWP-Apps]
Unterstützte Mindestversion (Server) Windows Server 2008 R2 [Desktop-Apps | UWP-Apps]
Kopfzeile webservices.h