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

HMAC-SHA1、HMAC-SHA256、HMAC-SHA384、HMAC-SHA512 などのメッセージ認証コード (MAC または対称署名とも呼ばれます) に使用するアルゴリズム。 この値を 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 [デスクトップ アプリのみ]
Header	webservices.h