WS_SECURITY_ALGORITHM_SUITE結構 (webservices.h)

定義要與 WS-Security 搭配使用的安全性演算法和金鑰長度。 此設定與訊息安全性系結和混合模式安全性系結有關。

語法

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;

成員

canonicalizationAlgorithm

用於 XML 標準化的演算法，例如專屬的 XML 標準化演算法。 將此值設定為 WS_SECURITY_ALGORITHM_DEFAULT 預設為 WS_SECURITY_ALGORITHM_CANONICALIZATION_EXCLUSIVE。

digestAlgorithm

用於訊息部分摘要的演算法，例如SHA-1、SHA-256、SHA-384或SHA-512。 將此值設定為 WS_SECURITY_ALGORITHM_DEFAULT 預設為 WS_SECURITY_ALGORITHM_DIGEST_SHA1。

symmetricSignatureAlgorithm

用於訊息驗證碼的演算法 (也稱為 MAC 或對稱簽章) ，例如 HMAC-SHA1、HMAC-SHA256、HMAC-SHA384 或 HMAC-SHA512。 將此值設定為 WS_SECURITY_ALGORITHM_DEFAULT 預設為 WS_SECURITY_ALGORITHM_SYMMETRIC_SIGNATURE_HMAC_SHA1。

asymmetricSignatureAlgorithm

用於非對稱簽章的演算法。 將此值設定為 WS_SECURITY_ALGORITHM_DEFAULT 預設為 WS_SECURITY_ALGORITHM_ASYMMETRIC_SIGNATURE_RSA_SHA1。

encryptionAlgorithm

用於訊息部分加密的演算法。 保留供未來使用。 應該設定為 WS_SECURITY_ALGORITHM_DEFAULT。

keyDerivationAlgorithm

用於從其他對稱金鑰衍生金鑰的演算法。 將此值設定為 WS_SECURITY_ALGORITHM_DEFAULT 預設為 WS_SECURITY_ALGORITHM_KEY_DERIVATION_P_SHA1。

symmetricKeyWrapAlgorithm

用來加密對稱金鑰與其他對稱金鑰的演算法。 保留供未來使用。 應該設定為 WS_SECURITY_ALGORITHM_DEFAULT。

asymmetricKeyWrapAlgorithm

使用非對稱金鑰加密對稱金鑰的演算法。 將此值設定為 WS_SECURITY_ALGORITHM_DEFAULT 預設為 WS_SECURITY_ALGORITHM_ASYMMETRIC_KEYWRAP_RSA_OAEP。

minSymmetricKeyLength

對稱金鑰安全性令牌) 位 (的最小密鑰長度。 將此值設定為 0 預設為 128 位。

maxSymmetricKeyLength

對稱金鑰安全性令牌) 位 (的最大金鑰長度。 將此值設定為 0 預設為 512 位。

minAsymmetricKeyLength

非對稱金鑰安全性令牌) 位 (最小密鑰長度。 將此值設定為0預設為1024位。

maxAsymmetricKeyLength

非對稱金鑰安全性令牌) 位 (的最大金鑰長度。 將此值設定為 0 預設為 16384 位。

properties

演算法屬性。 保留供未來使用。 應設定為 NULL。

propertyCount

屬性陣列中的項目數目。 保留供未來使用。 應設定為 0。

備註

使用密鑰衍生時，金鑰長度限制會套用至衍生簽署或加密衍生令牌的來源安全性令牌。

規格需求

需求	值
最低支援的用戶端	Windows 7 [僅限傳統型應用程式]
最低支援的伺服器	Windows Server 2008 R2 [僅限傳統型應用程式]
標頭	webservices.h