Condividi tramite

enumerazione WS_REQUEST_SECURITY_TOKEN_PROPERTY_ID (webservices.h)

  • Articolo

Identifica le proprietà per richiedere un token di sicurezza da un'autorità di certificazione. Viene usato con WsRequestSecurityToken come parte del parametro WS_REQUEST_SECURITY_TOKEN_PROPERTY* .

Sintassi

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;

Costanti

 
WS_REQUEST_SECURITY_TOKEN_PROPERTY_APPLIES_TO
Valore: 1
Puntatore a una struttura WS_ENDPOINT_ADDRESS contenente l'indirizzo del servizio ('relying party') a cui l'utente richiesto
verrà presentato il token.
.
WS_REQUEST_SECURITY_TOKEN_PROPERTY_TRUST_VERSION
Valore: 2
Valore WS_TRUST_VERSION che specifica la versione di WS-Trust da usare.

Se questa proprietà non è specificata, viene impostata per impostazione predefinita su WS_TRUST_VERSION_FEBRUARY_2005.
WS_REQUEST_SECURITY_TOKEN_PROPERTY_SECURE_CONVERSATION_VERSION
Valore: 3
Valore WS_SECURE_CONVERSATION_VERSION che
specifica la versione di WS-SecureConversation da usare quando WS_REQUEST_SECURITY_TOKEN_ACTION_NEW_CONTEXT
o WS_REQUEST_SECURITY_TOKEN_ACTION_RENEW_CONTEXT sono specificati.


Se questa proprietà non è specificata, viene impostata per impostazione predefinita su WS_SECURE_CONVERSATION_VERSION_FEBRUARY_2005.
WS_REQUEST_SECURITY_TOKEN_PROPERTY_ISSUED_TOKEN_TYPE
Valore: 4
Puntatore a una struttura WS_XML_STRING che specifica il tipo di token di sicurezza da rilasciare. Se questa proprietà non è specificata,
l'elemento corrispondente non viene generato nel messaggio del token di sicurezza della richiesta e
si presuppone che l'autorità emittente sappia il tipo di token richiesto.
WS_REQUEST_SECURITY_TOKEN_PROPERTY_REQUEST_ACTION
Valore: 5
Valore WS_REQUEST_SECURITY_TOKEN_ACTION che specifica l'azione da usare con la richiesta. Il valore predefinito è WS_REQUEST_SECURITY_TOKEN_ACTION_ISSUE.
WS_REQUEST_SECURITY_TOKEN_PROPERTY_EXISTING_TOKEN
Valore: 6
Puntatore a una struttura WS_SECURITY_TOKEN che,
se specificato, anziché richiedere un nuovo token, il token specificato viene rinnovato richiedendo un nuovo token in base a
esistente. Il token precedente diventa non valido se questa operazione ha esito positivo.
Supportato solo con WS_REQUEST_SECURITY_TOKEN_ACTION_RENEW_CONTEXT.
WS_REQUEST_SECURITY_TOKEN_PROPERTY_ISSUED_TOKEN_KEY_TYPE
Valore: 7
Valore WS_SECURITY_KEY_TYPE che specifica il tipo della chiave crittografica da richiedere
token di sicurezza rilasciato. Questa opzione deve essere impostata su WS_SECURITY_KEY_TYPE_NONE o WS_SECURITY_KEY_TYPE_SYMMETRIC.


Il valore WS_SECURITY_KEY_TYPE_NONE specifica un token di connessione senza
chiavi di prova di possesso. Tali token non generano una firma quando viene usata per proteggere un messaggio.


Se questa proprietà non è specificata, l'elemento del tipo di chiave corrispondente non viene generato nelle richieste di token.
Non emettendo il tipo di chiave nelle richieste di token, viene restituito il valore predefinito implicito delle chiavi simmetriche per l'oggetto
token emesso, come definito nella specifica WS-Trust.
WS_REQUEST_SECURITY_TOKEN_PROPERTY_ISSUED_TOKEN_KEY_SIZE
Valore: 8
ULONG che specifica le dimensioni (in bit) della chiave crittografica da richiedere
nel token di sicurezza rilasciato. Questa proprietà può essere specificata solo per
token emessi con chiavi simmetriche. Se questa proprietà non è specificata,
l'elemento delle dimensioni della chiave corrispondente non viene generato nelle richieste di token.
WS_REQUEST_SECURITY_TOKEN_PROPERTY_ISSUED_TOKEN_KEY_ENTROPY
Valore: 9
Valore WS_SECURITY_KEY_ENTROPY_MODE che specifica il modo in cui l'entropia viene apportata alla chiave crittografica dell'oggetto
token emesso. Questa proprietà può essere specificata solo per i token emessi
con chiavi simmetriche. Se questa proprietà non è specificata, viene usata la modalità WS_SECURITY_KEY_ENTROPY_MODE_SERVER_ONLY .
WS_REQUEST_SECURITY_TOKEN_PROPERTY_LOCAL_REQUEST_PARAMETERS
Valore: 10
Puntatore a un WS_XML_BUFFER contenente
i parametri primari aggiuntivi da includere verbatim nella richiesta
messaggi di token di sicurezza. Ogni parametro di questo tipo deve essere un livello superiore
elemento nel buffer XML fornito. Se questa proprietà non è specificata, ad esempio
i parametri non vengono generati. Il buffer viene serializzato nell'elemento RequestSecurityToken
quando si richiede un token di sicurezza.


A differenza di WS_REQUEST_SECURITY_TOKEN_PROPERTY_SERVICE_REQUEST_PARAMETERS, richiesta locale
i parametri vengono definiti dal client come mezzo per aggiungere parametri alla richiesta di token.
WS_REQUEST_SECURITY_TOKEN_PROPERTY_SERVICE_REQUEST_PARAMETERS
Valore: 11
Puntatore a un WS_XML_BUFFER contenente
parametri del servizio da includere nel token di sicurezza della richiesta
messaggi, forniti come buffer XML. Ogni parametro di questo tipo deve essere un
elemento di primo livello nel buffer XML fornito. Se questa proprietà non è specificata, ad esempio
i parametri non vengono generati.


Se viene specificato WS_TRUST_VERSION_FEBRUARY_2005 questo buffer viene serializzato
nell'elemento RequestSecurityToken che segue
WS_REQUEST_SECURITY_TOKEN_PROPERTY_LOCAL_REQUEST_PARAMETERS.


Se WS_TRUST_VERSION_1_3 viene specificato questo buffer viene serializzato nell'oggetto
Elemento RequestSecurityToken/SecondaryParameters.


I parametri della richiesta di servizio sono istruzioni su come rilasciare un token. Vengono ottenuti dal servizio,
in genere tramite l'importazione dei metadati. In questo caso, questo parametro può essere ottenuto
dall'esterno. Campo RequestSecurityTokenTemplate del WS_ISSUED_TOKEN_MESSAGE_SECURITY_BINDING_CONSTRAINT.
WS_REQUEST_SECURITY_TOKEN_PROPERTY_MESSAGE_PROPERTIES
Valore: 12
Set di WS_MESSAGE_PROPERTIES da specificare
durante la creazione dei due messaggi con WsCreateMessage e devono
essere usato per il token di sicurezza che ottiene lo scambio. Se questa proprietà
non specificato, i messaggi di richiesta e risposta vengono creati con
proprietà del messaggio predefinite.
WS_REQUEST_SECURITY_TOKEN_PROPERTY_BEARER_KEY_TYPE_VERSION
Valore: 13

Requisiti

Requisito Valore
Client minimo supportato Windows 7 [app desktop | App UWP]
Server minimo supportato Windows Server 2008 R2 [app desktop | App UWP]
Intestazione webservices.h