WS_SECURITY_TOKEN_PROPERTY_ID-Enumeration (webservices.h)

  • Artikel

Definiert die Schlüssel für die Felder und Eigenschaften, die aus einem Sicherheitstoken extrahiert werden können. Nicht alle Eigenschaften sind für alle Sicherheitstokentypen gültig. Die Funktion WsGetSecurityTokenProperty verwendet die hier definierten Werte als Schlüssel.

Siehe auch WS_SECURITY_BINDING_PROPERTY.

Syntax

typedef enum {
  WS_SECURITY_TOKEN_PROPERTY_KEY_TYPE = 1,
  WS_SECURITY_TOKEN_PROPERTY_VALID_FROM_TIME = 2,
  WS_SECURITY_TOKEN_PROPERTY_VALID_TILL_TIME = 3,
  WS_SECURITY_TOKEN_PROPERTY_SERIALIZED_XML = 4,
  WS_SECURITY_TOKEN_PROPERTY_ATTACHED_REFERENCE_XML = 5,
  WS_SECURITY_TOKEN_PROPERTY_UNATTACHED_REFERENCE_XML = 6,
  WS_SECURITY_TOKEN_PROPERTY_SYMMETRIC_KEY = 7
} WS_SECURITY_TOKEN_PROPERTY_ID;

Konstanten

 
WS_SECURITY_TOKEN_PROPERTY_KEY_TYPE
Wert: 1
Der zugehörige Wertparameter der WsGetSecurityTokenProperty-Funktion ist ein WS_SECURITY_KEY_TYPE Wert, der den Typ des Proofschlüssels des Sicherheitstokens angibt.
WS_SECURITY_TOKEN_PROPERTY_VALID_FROM_TIME
Wert: 2
Der zugehörige Wertparameter der WsGetSecurityTokenProperty-Funktion ist eine WS_DATETIME Struktur, die den Zeitpunkt enthält, ab dem das Sicherheitstoken gültig ist. Für ein Sicherheitstoken
die keine explizite Startzeit für den Gültigkeitszeitraum definiert,
WS_DATETIME mit einer Tickanzahl von 0 wird zurückgegeben.
WS_SECURITY_TOKEN_PROPERTY_VALID_TILL_TIME
Wert: 3
Der zugehörige Wertparameter der WsGetSecurityTokenProperty-Funktion ist eine WS_DATETIME Struktur, die den Zeitpunkt enthält, zu dem ein aktuell gültiges Sicherheitstoken ungültig wird. Für ein Sicherheitstoken
die keine explizite Endzeit für den Gültigkeitszeitraum definiert,
WS_DATETIME mit einer Tickanzahl von 0 wird zurückgegeben.
WS_SECURITY_TOKEN_PROPERTY_SERIALIZED_XML
Wert: 4
Der zugehörige Wertparameter der WsGetSecurityTokenProperty-Funktion ist ein Zeiger auf einen WS_XML_BUFFER , der die XML-Wire-Form des Sicherheitstokens enthält.
WS_SECURITY_TOKEN_PROPERTY_ATTACHED_REFERENCE_XML
Wert: 5
Der zugehörige Wertparameter der WsGetSecurityTokenProperty-Funktion ist ein Zeiger auf einen WS_XML_BUFFER , der
die XML-Drahtform des angefügten Verweises auf das Sicherheitstoken.
Angefügte Verweise werden verwendet, um auf ein Sicherheitstoken zu verweisen, wenn
Sicherheitstoken und zugehörigen Verweispunkt (z. B. eine Signatur mit
token) treten beide in derselben Nachricht auf.
WS_SECURITY_TOKEN_PROPERTY_UNATTACHED_REFERENCE_XML
Wert: 6
Der zugehörige Wertparameter der WsGetSecurityTokenProperty-Funktion ist ein Zeiger auf einen WS_XML_BUFFER , der
die XML-Drahtform des nicht angefügten Verweises auf das Sicherheitstoken.
Nicht angefügte Verweise werden verwendet, um auf ein Sicherheitstoken zu verweisen, wenn
Das Sicherheitstoken tritt nicht in derselben Nachricht auf, in der es verweist.
punkt (z. B. eine Signatur, die dieses Token verwendet).
WS_SECURITY_TOKEN_PROPERTY_SYMMETRIC_KEY
Wert: 7
Der zugehörige Wertparameter der WsGetSecurityTokenProperty-Funktion ist ein Zeiger auf eine WS_BYTES Struktur, die
die Rohdaten des symmetrischen Tokenschlüssels. Diese Eigenschaft ist verfügbar, wenn WS_SECURITY_TOKEN_PROPERTY_KEY_TYPE
WS_SECURITY_KEY_TYPE_SYMMETRIC.


Wenn das Token über WsRequestSecurityToken abgerufen wurde, enthält der zurückgegebene Puffer Schlüsselmaterial, das während der
die Tokenanforderung, bei der es sich entweder um eine vom Client generierte Entropie, eine vom Server generierte Entropie oder um Schlüsselmaterial handelt, das von beiden Clients abgeleitet wird.
und Serverentropie, abhängig von WS_REQUEST_SECURITY_TOKEN_PROPERTY_ISSUED_TOKEN_KEY_ENTROPY.


Wenn Sie diese Eigenschaft mit WsGetSecurityTokenProperty verwenden, muss der Parameter "heap" nicht NULL sein.


Der zurückgegebene Puffer sollte sofort nach der Verwendung sicher gelöscht oder verschlüsselt werden, um das Auslaufen vertraulicher Daten zu verhindern.

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