struttura RPC_SECURITY_QOS_V5_A (rpcdce.h)

La struttura RPC_SECURITY_QOS_V5 definisce le impostazioni di qualità del servizio di sicurezza della versione 5 in un handle di associazione. Vedere La sezione Osservazioni per la disponibilità delle versioni nelle edizioni di Windows.

Sintassi

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;

Members

Version

Versione della struttura RPC_SECURITY_QOS utilizzata. In questo argomento viene illustrata la versione 5 della struttura RPC_SECURITY_QOS . Per altre versioni, vedere RPC_SECURITY_QOS, RPC_SECURITY_QOS_V2, RPC_SECURITY_QOS_V3 e RPC_SECURITY_QOS_V4 .

Capabilities

Servizi di sicurezza forniti all'applicazione. Le funzionalità sono un set di flag che possono essere combinati usando l'operatore OR bit per bit.

IdentityTracking

Modalità di rilevamento del contesto come uno dei valori seguenti.

ImpersonationType

Livello in cui il processo del server può rappresentare il client.

AdditionalSecurityInfoType

Tipo di credenziali aggiuntive presenti nell'unione u . Sono supportate le costanti seguenti:

u

u.HttpCredentials

Set aggiuntivo di credenziali da passare a RPC, sotto forma di struttura RPC_HTTP_TRANSPORT_CREDENTIALS . Utilizzato quando il membro AdditionalSecurityInfoType è impostato su RPC_C_AUTHN_INFO_TYPE_HTTP.

Sid

Puntatore a un ID di sicurezza (SID). Il SID è un'alternativa al membro ServerPrincName e ne può essere specificato solo uno. Il membro Sid non può essere impostato su null se il provider di sicurezza è SSP SCHANNEL. Alcune sequenze di protocollo usano Sid internamente per la sicurezza e alcuni usano un ServerPrincName. Ad esempio, ncalrpc usa un Sid internamente e se il chiamante conosce sia il SID che il ServerPrincName, una chiamata che usa ncalrpc può essere completata molto più velocemente in alcuni casi se viene passato il SID. Al contrario, le sequenze di protocollo ncacn_ e ncadg_ usano un ServerPrincName internamente e pertanto possono eseguire chiamate più velocemente quando viene specificato ServerPrincName.

EffectiveOnly

Se impostato, solo i privilegi abilitati vengono visualizzati dal server.

ServerSecurityDescriptor

Puntatore al SECURITY_DESCRIPTOR che identifica il server. È necessario per l'autenticazione reciproca.

Commenti

L'elenco seguente definisce la disponibilità delle versioni QOS in vari sistemi operativi Windows:

• Versione 1: Windows 2000 e versioni successive.
• Versione 2: Windows XP con Service Pack 1 (SP1) e versioni successive.
• Versione 3: Windows Server 2003 e versioni successive.
• Versione 4: Windows Vista e versioni successive.
• Versione 5: Windows 8 e versioni successive.

Le funzioni di sicurezza lato client RpcBindingInqAuthInfoEx e RpcBindingSetAuthInfo usano la struttura RPC_SECURITY_QOS per richiedere informazioni o impostare la qualità di sicurezza del servizio per un handle di associazione.

RPC supporta l'hint RPC_C_QOS_CAPABILITIES_LOCAL_MA_HINT (non supportato nelle edizioni client di Windows XP e versioni precedenti, non supportato nelle edizioni server di Windows 2000 e versioni precedenti). Questo hint viene usato solo quando vengono usati endpoint dinamici e autenticazione reciproca. Inoltre, non è supportato per le sequenze di protocolli ncadg_ . Se questo flag viene usato per una sequenza di protocollo ncadg_ o senza usare l'autenticazione reciproca, RPC_S_INVALID_ARG viene restituito dalla chiamata di funzione RpcBindingSetAuthInfoEx . Questo flag è progettato per impedire un attacco Denial of Service. L'uso di questo flag impone al runtime RPC di chiedere solo l'endpoint mapper per gli endpoint registrati dall'entità specificata nei membri ServerPrincName o Sid . Ciò impedisce a un utente malintenzionato nel computer locale di tentare di ingannare il client RPC per connettersi a un endpoint spoof registrato nel mapper dell'endpoint. Si noti che poiché l'attacco è locale (ad esempio da un computer server terminale con molti utenti), il flag funziona anche solo per le chiamate RPC effettuate localmente.

Requisiti

Vedi anche

RPC_BINDING_HANDLE_SECURITY_V1

RPC_HTTP_TRANSPORT_CREDENTIALS

RPC_SECURITY_QOS

RPC_SECURITY_QOS_V2

RPC_SECURITY_QOS_V3

RPC_SECURITY_QOS_V4

RpcBindingInqAuthInfoEx

RpcBindingSetAuthInfoEx