Compartilhar via


enumeração WS_SECURITY_TOKEN_PROPERTY_ID (webservices.h)

Define as chaves para os campos e propriedades que podem ser extraídos de um token de segurança. Nem todas as propriedades são válidas para todos os tipos de token de segurança. A função WsGetSecurityTokenProperty usa os valores definidos aqui como chaves.

Consulte também 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;

Constantes

 
WS_SECURITY_TOKEN_PROPERTY_KEY_TYPE
Valor: 1
O parâmetro de valor que acompanha a função WsGetSecurityTokenProperty é um valor WS_SECURITY_KEY_TYPE que indica o tipo da chave de prova do token de segurança.
WS_SECURITY_TOKEN_PROPERTY_VALID_FROM_TIME
Valor: 2
O parâmetro de valor que acompanha a função WsGetSecurityTokenProperty é uma estrutura WS_DATETIME que contém a hora de quando o token de segurança é válido. Para um token de segurança
que não define uma hora de início explícita para seu período de validade, um
WS_DATETIME com uma contagem de tiques de 0 é retornada.
WS_SECURITY_TOKEN_PROPERTY_VALID_TILL_TIME
Valor: 3
O parâmetro de valor que acompanha a função WsGetSecurityTokenProperty é uma estrutura WS_DATETIME que contém o ponto no tempo em que um token de segurança atualmente válido se torna inválido. Para um token de segurança
que não define uma hora de término explícita para seu período de validade, um
WS_DATETIME com uma contagem de tiques de 0 é retornada.
WS_SECURITY_TOKEN_PROPERTY_SERIALIZED_XML
Valor: 4
O parâmetro de valor que acompanha a função WsGetSecurityTokenProperty é um ponteiro para um WS_XML_BUFFER que contém a forma de fio XML do token de segurança.
WS_SECURITY_TOKEN_PROPERTY_ATTACHED_REFERENCE_XML
Valor: 5
O parâmetro de valor que acompanha a função WsGetSecurityTokenProperty é um ponteiro para um WS_XML_BUFFER que contém
a forma de fio XML da referência anexada ao token de segurança.
Referências anexadas são usadas para se referir a um token de segurança quando o
token de segurança e seu ponto de referência (como uma assinatura usando isso
token) ambos ocorrem na mesma mensagem.
WS_SECURITY_TOKEN_PROPERTY_UNATTACHED_REFERENCE_XML
Valor: 6
O parâmetro de valor que acompanha a função WsGetSecurityTokenProperty é um ponteiro para um WS_XML_BUFFER que contém
a forma de fio XML da referência desanexada ao token de segurança.
Referências desanexadas são usadas para se referir a um token de segurança quando o
O token de segurança não ocorre na mesma mensagem que sua referência
ponto (como uma assinatura usando esse token).
WS_SECURITY_TOKEN_PROPERTY_SYMMETRIC_KEY
Valor: 7
O parâmetro de valor que acompanha a função WsGetSecurityTokenProperty é um ponteiro para uma estrutura de WS_BYTES que contém
os dados de chave bruta da chave de token simétrica. Essa propriedade está disponível quando WS_SECURITY_TOKEN_PROPERTY_KEY_TYPE está
WS_SECURITY_KEY_TYPE_SYMMETRIC.


Se o token tiver sido obtido por meio de WsRequestSecurityToken, o buffer retornado conterá o material de chave gerado durante
a solicitação de token, que é a entropia gerada pelo cliente, a entropia gerada pelo servidor ou o material de chave derivado de ambos os clientes
e entropia de servidor, dependendo de WS_REQUEST_SECURITY_TOKEN_PROPERTY_ISSUED_TOKEN_KEY_ENTROPY.


Ao usar essa propriedade com WsGetSecurityTokenProperty, o parâmetro 'heap' deve ser não NULL.


O buffer retornado deve ser apagado ou criptografado com segurança imediatamente após o uso para evitar o vazamento de dados confidenciais.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows 7 [aplicativos da área de trabalho | Aplicativos UWP]
Servidor mínimo com suporte Windows Server 2008 R2 [aplicativos da área de trabalho | Aplicativos UWP]
Cabeçalho webservices.h