RPC_SECURITY_QOS_V5_A 構造体 (rpcdce.h)

RPC_SECURITY_QOS_V5構造では、バインディング ハンドルに対してバージョン 5 のセキュリティサービス品質設定を定義します。 Windows エディションでのバージョンの可用性については、「解説」を参照してください。

構文

typedef struct _RPC_SECURITY_QOS_V5_A {
  unsigned long Version;
  unsigned long Capabilities;
  unsigned long IdentityTracking;
  unsigned long ImpersonationType;
  unsigned long AdditionalSecurityInfoType;
  union {
    RPC_HTTP_TRANSPORT_CREDENTIALS_A *HttpCredentials;
  } u;
  void          *Sid;
  unsigned int  EffectiveOnly;
  void          *ServerSecurityDescriptor;
} RPC_SECURITY_QOS_V5_A, *PRPC_SECURITY_QOS_V5_A;

メンバー

Version

使用されている RPC_SECURITY_QOS 構造体のバージョン。 このトピックでは、 RPC_SECURITY_QOS 構造のバージョン 5 について説明します。 その他 のバージョンについては、「 RPC_SECURITY_QOS、RPC_SECURITY_QOS_V2、 RPC_SECURITY_QOS_V3、 RPC_SECURITY_QOS_V4 」を参照してください。

Capabilities

アプリケーションに提供されているセキュリティ サービス。 機能 は、ビットごとの OR 演算子を使用して組み合わせることができるフラグのセットです。

IdentityTracking

コンテキスト追跡モードを次のいずれかの値として指定します。

ImpersonationType

サーバー プロセスがクライアントを偽装できるレベル。

AdditionalSecurityInfoType

u 共用体に存在する追加の資格情報の種類。 次の定数がサポートされています。

u

u.HttpCredentials

RPC_HTTP_TRANSPORT_CREDENTIALS構造の形式で RPC に渡す追加の資格情報セット。 AdditionalSecurityInfoType メンバーが RPC_C_AUTHN_INFO_TYPE_HTTP に設定されている場合に使用されます。

Sid

セキュリティ識別子 (SID) へのポインター。 SID は ServerPrincName メンバーの代替手段であり、指定できるのは 1 つだけです。 セキュリティ プロバイダーが SCHANNEL SSP の場合、 Sid メンバーを NULL 以外に設定することはできません。 セキュリティのために内部的に Sid を使用するプロトコル シーケンスもあれば、 ServerPrincName を使用するプロトコル シーケンスもあります。 たとえば、 ncalrpc は内部的に Sid を使用し、呼び出し元が SID と ServerPrincName の両方を認識している場合、SID が渡されると 、ncalrpc を使用した呼び出しがはるかに高速に完了する場合があります。 これに対し、 ncacn_ および ncadg_ プロトコル シーケンスでは ServerPrincName が内部的に使用されるため、 ServerPrincName を指定すると呼び出しをより高速に実行できます。

EffectiveOnly

設定されている場合、有効な特権のみがサーバーに表示されます。

ServerSecurityDescriptor

サーバーを識別する SECURITY_DESCRIPTOR へのポインター。 相互認証に必要です。

注釈

次の一覧では、さまざまな Windows オペレーティング システムでの QOS バージョンの可用性を定義します。

• バージョン 1: Windows 2000 以降。
• バージョン 2: Windows XP Service Pack 1 (SP1) 以降。
• バージョン 3: Windows Server 2003 以降。
• バージョン 4: Windows Vista 以降。
• バージョン 5: Windows 8以降。

クライアント側のセキュリティ関数 RpcBindingInqAuthInfoEx と RpcBindingSetAuthInfo では、 RPC_SECURITY_QOS 構造を使用して、バインディング ハンドルのサービスのセキュリティ品質を問い合わせるか、設定します。

RPC では、RPC_C_QOS_CAPABILITIES_LOCAL_MA_HINT ヒントがサポートされています (Windows XP 以前のクライアント エディションではサポートされていません。Windows 2000 以前のサーバー エディションではサポートされていません)。 このヒントは、動的エンドポイントと相互認証が使用される場合にのみ使用されます。 さらに、 ncadg_ プロトコル シーケンスではサポートされていません。 このフラグがncadg_プロトコル シーケンスに使用されている場合、または相互認証を使用しない場合、RPC_S_INVALID_ARGは RpcBindingSetAuthInfoEx 関数呼び出しから返されます。 このフラグは、サービス拒否攻撃を防ぐために設計されています。 このフラグを使用すると、 SERVERPrincName または Sid メンバーで指定されたプリンシパルによって登録されたエンドポイントに対してのみ、RPC ランタイムがエンドポイント マッパーに対してのみ要求されます。 これにより、ローカル コンピューター上の攻撃者が RPC クライアントをだまして、エンドポイント マッパーに登録したスプーフィング エンドポイントに接続することを防ぐことができます。 攻撃はローカルのみであるため (多くのユーザーを持つターミナル サーバー コンピューターなど)、このフラグはローカルで行われた RPC 呼び出しに対してのみ機能します。