estrutura WS_SECURITY_ALGORITHM_SUITE (webservices.h)

Define os algoritmos de segurança e os comprimentos de chave a serem usados com o WS-Security. Essa configuração é relevante para associações de segurança de mensagens e associações de segurança de modo misto.

Sintaxe

typedef struct _WS_SECURITY_ALGORITHM_SUITE {
  WS_SECURITY_ALGORITHM_ID       canonicalizationAlgorithm;
  WS_SECURITY_ALGORITHM_ID       digestAlgorithm;
  WS_SECURITY_ALGORITHM_ID       symmetricSignatureAlgorithm;
  WS_SECURITY_ALGORITHM_ID       asymmetricSignatureAlgorithm;
  WS_SECURITY_ALGORITHM_ID       encryptionAlgorithm;
  WS_SECURITY_ALGORITHM_ID       keyDerivationAlgorithm;
  WS_SECURITY_ALGORITHM_ID       symmetricKeyWrapAlgorithm;
  WS_SECURITY_ALGORITHM_ID       asymmetricKeyWrapAlgorithm;
  ULONG                          minSymmetricKeyLength;
  ULONG                          maxSymmetricKeyLength;
  ULONG                          minAsymmetricKeyLength;
  ULONG                          maxAsymmetricKeyLength;
  WS_SECURITY_ALGORITHM_PROPERTY *properties;
  ULONG                          propertyCount;
} WS_SECURITY_ALGORITHM_SUITE;

Membros

canonicalizationAlgorithm

Algoritmo a ser usado para canonização XML, como o algoritmo de canonização XML exclusivo. Definir esse valor como WS_SECURITY_ALGORITHM_DEFAULT padrão será WS_SECURITY_ALGORITHM_CANONICALIZATION_EXCLUSIVE.

digestAlgorithm

Algoritmo a ser usado para resumos de parte da mensagem, como SHA-1, SHA-256, SHA-384 ou SHA-512. Definir esse valor como WS_SECURITY_ALGORITHM_DEFAULT padrão será WS_SECURITY_ALGORITHM_DIGEST_SHA1.

symmetricSignatureAlgorithm

Algoritmo a ser usado para códigos de autenticação de mensagem (também conhecidos como MACs ou assinaturas simétricas), como HMAC-SHA1, HMAC-SHA256, HMAC-SHA384 ou HMAC-SHA512. Definir esse valor como WS_SECURITY_ALGORITHM_DEFAULT padrão será WS_SECURITY_ALGORITHM_SYMMETRIC_SIGNATURE_HMAC_SHA1.

asymmetricSignatureAlgorithm

Algoritmo a ser usado para assinaturas assimétricas. Definir esse valor como WS_SECURITY_ALGORITHM_DEFAULT padrão será WS_SECURITY_ALGORITHM_ASYMMETRIC_SIGNATURE_RSA_SHA1.

encryptionAlgorithm

Algoritmo a ser usado para criptografia de parte da mensagem. Reservado para uso futuro. Deve ser definido como WS_SECURITY_ALGORITHM_DEFAULT.

keyDerivationAlgorithm

Algoritmo a ser usado para derivar chaves de outras chaves simétricas. Definir esse valor como WS_SECURITY_ALGORITHM_DEFAULT padrão será WS_SECURITY_ALGORITHM_KEY_DERIVATION_P_SHA1.

symmetricKeyWrapAlgorithm

Algoritmo a ser usado para criptografar chaves simétricas com outras chaves simétricas. Reservado para uso futuro. Deve ser definido como WS_SECURITY_ALGORITHM_DEFAULT.

asymmetricKeyWrapAlgorithm

Algoritmo a ser usado para criptografar chaves simétricas com chaves assimétricas. Definir esse valor como WS_SECURITY_ALGORITHM_DEFAULT padrão será WS_SECURITY_ALGORITHM_ASYMMETRIC_KEYWRAP_RSA_OAEP.

minSymmetricKeyLength

O comprimento mínimo da chave (em bits) de tokens de segurança de chave simétrica. Definir esse valor como 0 usará como padrão 128 bits.

maxSymmetricKeyLength

O comprimento máximo da chave (em bits) de tokens de segurança de chave simétrica. Definir esse valor como 0 usará como padrão 512 bits.

minAsymmetricKeyLength

O comprimento mínimo da chave (em bits) de tokens de segurança de chave assimétrica. Definir esse valor como 0 usará como padrão 1024 bits.

maxAsymmetricKeyLength

O comprimento máximo da chave (em bits) de tokens de segurança de chave assimétrica. Definir esse valor como 0 usará como padrão 16384 bits.

properties

Propriedades do algoritmo. Reservado para uso futuro. Deve ser definido como NULL.

propertyCount

Número de entradas na matriz de propriedades. Reservado para uso futuro. Deve ser definido como 0.

Comentários

Quando a derivação de chave é usada, as restrições de comprimento da chave se aplicam ao token de segurança de origem do qual o token derivado de assinatura ou criptografia são derivados.

Requisitos

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