WS_USERNAME_MESSAGE_SECURITY_BINDING構造体 (webservices.h)

直接 (つまり、ワンショット) セキュリティ トークンとして、アプリケーションによって提供されるユーザー名とパスワードのペアの使用を指定するためのセキュリティ バインディング サブタイプ。 このセキュリティ バインディングは、メッセージ セキュリティでのみ使用できます。 クライアント認証は提供されますが、トラフィックの署名や暗号化は提供されません。 そのため、メッセージ保護を提供する別のトランスポート セキュリティまたはメッセージ セキュリティ バインディングと組み合わせて使用されます。

セキュリティの説明には、このバインディングのインスタンスが 1 つだけ存在する場合があります。 このセキュリティ バインディングは、 WS_NAMEDPIPE_CHANNEL_BINDINGではサポートされていません。

このセキュリティ バインディングでは、セキュリティ バインド プロパティを指定できません。

構文

typedef struct _WS_USERNAME_MESSAGE_SECURITY_BINDING {
  WS_SECURITY_BINDING           binding;
  WS_MESSAGE_SECURITY_USAGE     bindingUsage;
  WS_USERNAME_CREDENTIAL        *clientCredential;
  WS_VALIDATE_PASSWORD_CALLBACK passwordValidator;
  void                          *passwordValidatorCallbackState;
} WS_USERNAME_MESSAGE_SECURITY_BINDING;

メンバー

binding

このセキュリティ バインディング サブタイプとその他のすべてのセキュリティ バインディング サブタイプの派生元となる基本型。

bindingUsage

このセキュリティ バインディングに対応するセキュリティ トークンをメッセージにバインドする方法。

WS_SUPPORTING_MESSAGE_SECURITY_USAGEのみがサポートされています。 この使用により、このセキュリティ バインディングはクライアント認証を提供しますが、メッセージ保護 (署名、暗号化、再生検出など) は提供しません。 したがって、このバインディングは、保護されたチャネルを提供する WS_SSL_TRANSPORT_SECURITY_BINDING などの別のセキュリティ バインディングと共に使用する必要があります。

SSL を使用せずに HTTP でこのバインディングを使用するには、セキュリティ記述プロパティ WS_SECURITY_PROPERTY_TRANSPORT_PROTECTION_LEVEL を明示的に WS_PROTECTION_LEVEL_NONE に設定する必要があります。 これは、クライアントまたは TCP ではサポートされていません。

clientCredential

このセキュリティ バインディングで使用するユーザー名の資格情報。 これは、このセキュリティ バインディングがクライアントで使用される場合に指定する必要があります。

passwordValidator

受信したユーザー名とパスワードのペアをチェックするために使用される検証コントロール。 これは、このセキュリティ バインディングがサービスで使用される場合に指定する必要があります。

passwordValidatorCallbackState

ユーザー名検証コントロールが呼び出されたときに引数として渡される省略可能な状態。

要件

要件	値
サポートされている最小のクライアント	Windows 7 [デスクトップ アプリのみ]
サポートされている最小のサーバー	Windows Server 2008 R2 [デスクトップ アプリのみ]
Header	webservices.h