Funzione AcceptSecurityContext (Digest)

La funzione AcceptSecurityContext (Digest) consente al componente server di un'applicazione di trasporto di stabilire un contesto di sicurezza tra il server e un client remoto. Il client remoto usa la funzione InitializeSecurityContext (Digest) per avviare il processo di definizione di un contesto di sicurezza. Il server può richiedere uno o più token di risposta dal client remoto per completare la definizione del contesto di sicurezza.

Sintassi

SECURITY_STATUS SEC_Entry AcceptSecurityContext(
  _In_opt_    PCredHandle    phCredential,
  _Inout_opt_ PCtxtHandle    phContext,
  _In_opt_    PSecBufferDesc pInput,
  _In_        ULONG          fContextReq,
  _In_        ULONG          TargetDataRep,
  _Inout_opt_ PCtxtHandle    phNewContext,
  _Inout_opt_ PSecBufferDesc pOutput,
  _Out_       PULONG         pfContextAttr,
  _Out_opt_   PTimeStamp     ptsExpiry
);

Parametri

phCredential [in, optional]

Handle per le credenziali del server. Il server chiama la funzione AcquireCredentialsHandle (Digest) con il flag SECPKG_CRED_INBOUND o SECPKG_CRED_BOTH impostato per recuperare l'handle.

phContext [in, out, optional]

Puntatore a una struttura CtxtHandle . Nella prima chiamata a AcceptSecurityContext (Digest), questo puntatore è NULL. Nelle chiamate successive, phContext è l'handle del contesto parzialmente formato restituito nel parametro phNewContext dalla prima chiamata.

pInput [in, optional]

Puntatore a una struttura SecBufferDesc generata da una chiamata client a InitializeSecurityContext (Digest) che contiene il descrittore del buffer di input.

La tabella seguente illustra la configurazione del buffer per Digest HTTP. Il primo buffer deve essere di tipo SECBUFFER_TOKEN e il resto deve essere di tipo SECBUFFER_PKG_PARAMS. SASL richiede solo buffer zero.

fContextReq [in]

Flag di bit che specificano gli attributi richiesti dal server per stabilire il contesto. I flag di bit possono essere combinati usando operazioni OR bit per bit. Questo parametro può essere uno o più dei valori seguenti.

Per i possibili flag di attributo e i relativi significati, vedere Requisiti di contesto. I flag usati per questo parametro sono preceduti da ASC_REQ, ad esempio ASC_REQ_DELEGATE.

Gli attributi richiesti potrebbero non essere supportati dal client. Per altre informazioni, vedere il parametro pfContextAttr .

TargetDataRep [in]

Rappresentazione dei dati, ad esempio l'ordinamento dei byte, nella destinazione. Questo parametro può essere SECURITY_NATIVE_DREP o SECURITY_NETWORK_DREP.

Questo parametro non viene usato con digest SSP. Quando si usa Il provider di servizi condivisi digest, specificare zero per questo parametro.

phNewContext [in, out, optional]

Puntatore a una struttura CtxtHandle . Nella prima chiamata a AcceptSecurityContext (Digest), questo puntatore riceve il nuovo handle di contesto. Nelle chiamate successive, phNewContext può essere uguale all'handle specificato nel parametro phContext. phNewContext non deve mai essere NULL.

pOutput [in, out, optional]

Puntatore a una struttura SecBufferDesc che contiene il descrittore del buffer di output. Questo buffer viene inviato al client per l'input in chiamate aggiuntive a InitializeSecurityContext (Digest).This buffer is sent to the client for input into additional calls to InitializeSecurityContext (Digest). È possibile generare un buffer di output anche se la funzione restituisce SEC_E_OK. Qualsiasi buffer generato deve essere inviato di nuovo all'applicazione client.

pfContextAttr [out]

Puntatore a una variabile che riceve un set di flag di bit che indicano gli attributi del contesto stabilito. Per una descrizione dei vari attributi, vedere Requisiti di contesto. I flag usati per questo parametro sono preceduti da ASC_RET, ad esempio ASC_RET_DELEGATE.

Non verificare la presenza di attributi correlati alla sicurezza fino a quando la chiamata di funzione finale non viene restituita correttamente. I flag di attributo non correlati alla sicurezza, ad esempio il flag ASC_RET_ALLOCATED_MEMORY, possono essere controllati prima della restituzione finale.

ptsTimeStamp [out, optional]

Puntatore a una struttura TimeStamp che riceve l'ora di scadenza del contesto. È consigliabile che il pacchetto di sicurezza restituisca sempre questo valore nell'ora locale.

Questo parametro è impostato su un tempo massimo costante. Non è prevista alcuna scadenza per il contestodi sicurezza del digest o le credenziali o quando si usa il provider di servizi condivisi digest.

Valore restituito

Questa funzione restituisce uno dei valori seguenti:

Osservazioni:

La funzione AcceptSecurityContext (Digest) è la controparte server della funzione InitializeSecurityContext (Digest).

Quando il server riceve una richiesta da un client, il server usa il parametro fContextReq per specificare ciò che richiede della sessione. In questo modo, un server può specificare che i client devono essere in grado di usare una sessione riservata o controllata dall'integrità e possono rifiutare i client che non possono soddisfare tale richiesta. In alternativa, un server non può richiedere nulla e qualsiasi elemento che il client possa fornire o richiedere venga restituito nel parametro pfContextAttr .

Per un pacchetto che supporta l'autenticazione a più fasi, ad esempio l'autenticazione reciproca, la sequenza chiamante è la seguente:

1. Il client trasmette un token al server.
2. Il server chiama AcceptSecurityContext (Digest) la prima volta, che genera un token di risposta che viene quindi inviato al client.
3. Il client riceve il token e lo passa a InitializeSecurityContext (Digest).The client receive the token and pass it to InitializeSecurityContext (Digest). Se InitializeSecurityContext (Digest) restituisce SEC_E_OK, l'autenticazione reciproca è stata completata e può iniziare una sessione sicura. Se InitializeSecurityContext (Digest) restituisce un codice di errore, la negoziazione di autenticazione reciproca termina. In caso contrario, il token di sicurezza restituito da InitializeSecurityContext (Digest) viene inviato al client e i passaggi 2 e 3 vengono ripetuti.
4. Non usare il valore phContext nelle chiamate simultanee a AcceptSecurityContext (Digest).Do not use the phContext value in concurrent calls to AcceptSecurityContext (Digest). L'implementazione nei provider di sicurezza non è thread-safe.

I parametri fContextReq e pfContextAttr sono maschera di bit che rappresentano vari attributi di contesto. Per una descrizione dei vari attributi, vedere Requisiti di contesto.

Il chiamante è responsabile della determinazione se gli attributi di contesto finali sono sufficienti. Se, ad esempio, è stata richiesta la riservatezza (crittografia), ma non è stato possibile stabilire, alcune applicazioni possono scegliere di arrestare immediatamente la connessione. Se non è possibile stabilire il contesto di sicurezza, il server deve liberare il contesto parzialmente creato chiamando la funzione DeleteSecurityContext . Per informazioni su quando chiamare la funzione DeleteSecurityContext, vedere DeleteSecurityContext.

Dopo aver stabilito il contesto di sicurezza, l'applicazione server può usare la funzione QuerySecurityContextToken per recuperare un handle per l'account utente a cui è stato eseguito il mapping del certificato client. Inoltre, il server può usare la funzione ImpersonateSecurityContext per rappresentare l'utente.

Requisiti

Vedi anche

Funzioni SSPI

DeleteSecurityContext

InitializeSecurityContext (Digest)