AcceptSecurityContext (General), funkcja

Funkcja AcceptSecurityContext (Ogólne) umożliwia składnikowi serwera aplikacji transportowej ustanowienie kontekstu zabezpieczeń między serwerem a klientem zdalnym. Klient zdalny używa funkcji InitializeSecurityContext (Ogólne), aby rozpocząć proces ustanawiania kontekstu zabezpieczeń. Serwer może wymagać co najmniej jednego tokenu odpowiedzi od klienta zdalnego w celu ukończenia ustanawiania kontekstu zabezpieczeń.

Aby uzyskać informacje o korzystaniu z tej funkcji z określonym dostawcą obsługi zabezpieczeń (SSP), zobacz następujące tematy.

Składnia

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
);

Parametry

phCredential[in, optional]

Dojście do poświadczeń serwera. Serwer wywołuje funkcję AcquireCredentialsHandle (Ogólne) z flagą SECPKG_CRED_INBOUND lub SECPKG_CRED_BOTH ustawioną w celu pobrania tego uchwytu.

[in, out]phContext

Wskaźnik do struktury CtxtHandle. W pierwszym wywołaniu metody AcceptSecurityContext (Ogólne) ten wskaźnik to NULL. W kolejnych wywołaniach phContext jest uchwytem do częściowo sformułowanego kontekstu, który został zwrócony w phNewContext parametru przez pierwsze wywołanie.

[in, optional] pInput

Wskaźnik do struktury SecBufferDesc wygenerowanej przez wywołanie klienta do InitializeSecurityContext (Ogólne), który zawiera deskryptor buforu wejściowego.

W przypadku korzystania z dostawcy SSP Schannel pierwszy bufor musi być typu SECBUFFER_TOKEN i zawierać token zabezpieczający otrzymany od klienta. Drugi bufor powinien być typu SECBUFFER_EMPTY.

W przypadku korzystania z protokołu Negotiate, Kerberos lub NTLM SSPs informacje o powiązaniu kanału można określić, przekazując strukturę secBuffer typu SECBUFFER_CHANNEL_BINDINGS oprócz generowanych przez wywołanie funkcji InitializeSecurityContext (Ogólne). Informacje o powiązaniu kanału dla buforu powiązania kanału można uzyskać, wywołując funkcję QueryContextAttributes (Schannel) w kontekście Schannel klienta używanego do uwierzytelniania.

fContextReq[in]

Flagi bitowe określające atrybuty wymagane przez serwer do ustanowienia kontekstu. Flagi bitowe można łączyć przy użyciu operacji bitowychLUB. Ten parametr może być co najmniej jedną z następujących wartości.

Aby uzyskać informacje o możliwych flagach atrybutów i ich znaczeniach, zobacz Wymagania kontekstowe. Flagi używane dla tego parametru są poprzedzone ASC_REQ, na przykład ASC_REQ_DELEGATE.

Żądane atrybuty mogą nie być obsługiwane przez klienta. Aby uzyskać więcej informacji, zobacz parametr pfContextAttr.

TargetDataRep[in]

Reprezentacja danych, taka jak kolejność bajtów, w obiekcie docelowym. Ten parametr może być SECURITY_NATIVE_DREP lub SECURITY_NETWORK_DREP.

Ten parametr nie jest używany z Schannel ani szyfrowane dostawcy SSP. Jeśli używasz Schannel lub skrótów SSPs, określ zero dla tego parametru.

phNewContext[in, out, optional]

Wskaźnik do struktury CtxtHandle. Przy pierwszym wywołaniu metody AcceptSecurityContext (Ogólne) ten wskaźnik odbiera nowy uchwyt kontekstu. W kolejnych wywołaniach phNewContext może być taki sam jak uchwyt określony w phContext parametru. phNewContext nigdy nie powinna być NULL.

[in, out, optional] pOutput

Wskaźnik do struktury SecBufferDesc, która zawiera deskryptor buforu wyjściowego. Ten bufor jest wysyłany do klienta w celu wprowadzania danych wejściowych do dodatkowych wywołań metody InitializeSecurityContext (Ogólne). Bufor wyjściowy może być generowany nawet wtedy, gdy funkcja zwróci SEC_E_OK. Wszystkie wygenerowane muszą być wysyłane z powrotem do aplikacji klienckiej.

W przypadku korzystania z kanału Schannel na danych wyjściowych ten bufor odbiera token dla kontekstu zabezpieczeń. Token musi zostać wysłany do klienta. Funkcja może również zwrócić bufor typu SECBUFFER_EXTRA. Ponadto obiekt wywołujący musi przekazać bufor typu SECBUFFER_ALERT. Po wygenerowaniu alertu ten bufor zawiera informacje o tym alercie, a funkcja kończy się niepowodzeniem.

pfContextAttr[out]

Wskaźnik do zmiennej, która odbiera zestaw flag bitowych wskazujących atrybuty ustalonego kontekstu. Aby uzyskać opis różnych atrybutów, zobacz Wymagania dotyczące kontekstu. Flagi używane dla tego parametru są poprzedzone ASC_RET, na przykład ASC_RET_DELEGATE.

Nie sprawdzaj atrybutów związanych z zabezpieczeniami, dopóki ostateczne wywołanie funkcji nie zostanie pomyślnie zwrócone. Flagi atrybutów niezwiązane z zabezpieczeniami, takie jak flaga ASC_RET_ALLOCATED_MEMORY, można sprawdzić przed ostatecznym zwróceniem.

[out, optional]ptsTimeStamp

Wskaźnik do struktury sygnatury czasowej, która odbiera czas wygaśnięcia kontekstu. Zalecamy, aby pakiet zabezpieczeń zawsze zwracał tę wartość w czasie lokalnym.

Ten parametr jest ustawiony na stały maksymalny czas. Nie ma czasu wygaśnięcia dla kontekstu zabezpieczeńs lub poświadczeń lub w przypadku korzystania z dostawcy SSP skrótu.

Jest to opcjonalne w przypadku korzystania z dostawcy SSP Schannel. Gdy strona zdalna dostarczyła certyfikat do użycia do uwierzytelniania, ten parametr otrzymuje czas wygaśnięcia dla tego certyfikatu. Jeśli certyfikat nie został dostarczony, zwracana jest maksymalna wartość czasu.

Wartość zwracana

Ta funkcja zwraca jedną z następujących wartości.

Uwagi

Funkcja AcceptSecurityContext (General) jest odpowiednikiem serwera funkcji InitializeSecurityContext (General).

Gdy serwer odbiera żądanie od klienta, serwer używa parametru fContextReq, aby określić, czego wymaga sesji. W ten sposób serwer może określić, że klienci muszą mieć możliwość korzystania z poufnych lub integralności-sprawdzona sesja i może odrzucać klientów, którzy nie mogą spełnić tego zapotrzebowania. Alternatywnie serwer nie może wymagać niczego i niezależnie od tego, co klient może dostarczyć lub wymaga, jest zwracany w parametrze pfContextAttr.

W przypadku pakietu obsługującego uwierzytelnianie wieloeżne, takie jak uwierzytelnianie wzajemne, sekwencja wywołująca jest następująca:

1. Klient przesyła token do serwera.
2. Serwer wywołuje metodę AcceptSecurityContext (Ogólne) po raz pierwszy, co generuje token odpowiedzi, który jest następnie wysyłany do klienta.
3. Klient odbiera token i przekazuje go do elementu InitializeSecurityContext (Ogólne). Jeśli funkcja InitializeSecurityContext (ogólne) zwraca SEC_E_OK, uwierzytelnianie wzajemne zostało ukończone i można rozpocząć bezpieczną sesję. Jeśli funkcja InitializeSecurityContext (Ogólne) zwraca kod błędu, negocjacje wzajemnego uwierzytelniania kończą się. W przeciwnym razie token zabezpieczający zwrócony przez element InitializeSecurityContext (ogólne) jest wysyłany do klienta, a kroki 2 i 3 są powtarzane.
4. Nie należy używać wartości phContext w wywołaniach współbieżnych do acceptSecurityContext (Ogólne). Implementacja dostawców zabezpieczeń nie jest bezpieczna wątkowo.

Parametry fContextReqreq i pfContextAttr to maski bitów reprezentujące różne atrybuty kontekstu. Aby uzyskać opis różnych atrybutów, zobacz Wymagania dotyczące kontekstu.

Obiekt wywołujący jest odpowiedzialny za określenie, czy ostateczne atrybuty kontekstu są wystarczające. Jeśli na przykład zażądano poufności (szyfrowania), ale nie można go ustanowić, niektóre aplikacje mogą zdecydować się na natychmiastowe zamknięcie połączenia. Jeśli nie można ustanowić kontekstu zabezpieczeń , serwer musi zwolnić częściowo utworzony kontekst, wywołując funkcję DeleteSecurityContext. Aby uzyskać informacje o tym, kiedy wywołać funkcję DeleteSecurityContext, zobacz DeleteSecurityContext.

Po ustanowieniu kontekstu zabezpieczeń aplikacja serwera może użyć funkcji QuerySecurityContextToken, aby pobrać dojście do konta użytkownika, do którego został zamapowany certyfikat klienta. Ponadto serwer może użyć funkcji ImpersonateSecurityContext, aby personifikować użytkownika.

Wymagania

Zobacz też

funkcji SSPI

DeleteSecurityContext

InitializeSecurityContext (Ogólne)