Função AcceptSecurityContext (CredSSP)

A função AcceptSecurityContext (CredSSP) permite que o componente de servidor de um aplicativo de transporte estabeleça um contexto de segurança entre o servidor e um cliente remoto. O cliente remoto chama a função InitializeSecurityContext (CredSSP) para iniciar o processo de estabelecimento de um contexto de segurança. O servidor pode exigir um ou mais tokens de resposta do cliente remoto para concluir o estabelecimento do contexto de segurança.

Sintaxe

SECURITY_STATUS SEC_ENTRY AcceptSecurityContext(
  _In_opt_    PCredHandle    phCredential,
  _In_opt_    PCtxtHandle    phContext,
  _In_opt_    PSecBufferDesc pInput,
  _In_        unsigned long  fContextReq,
  _In_        unsigned long  TargetDataRep,
  _Inout_opt_ PCtxtHandle    phNewContext,
  _Inout_opt_ PSecBufferDesc pOutput,
  _Out_       unsigned long  *pfContextAttr,
  _Out_opt_   PTimeStamp     ptsExpiry
);

Parâmetros

phCredencial[in, optional]

Um identificador para as credenciais do servidor. Para recuperar esse identificador, o servidor chama a função AcquireCredentialsHandle (CredSSP) com o SECPKG_CRED_INBOUND ou SECPKG_CRED_BOTH sinalizador definido.

phContexto[in, optional]

Um ponteiro para um CtxtHandle estrutura. Na primeira chamada para AcceptSecurityContext (CredSSP), esse ponteiro é NULL. Em chamadas subsequentes, phContext especifica o contexto parcialmente formado retornado no parâmetro phNewContext pela primeira chamada.

pEntrada[in, optional]

Um ponteiro para uma estrutura de SecBufferDesc gerada por uma chamada de cliente para InitializeSecurityContext (CredSSP). A estrutura contém o descritor de buffer de entrada.

O primeiro buffer deve ser do tipo SECBUFFER_TOKEN e conter o token de segurança recebido do cliente. O segundo buffer deve ser do tipo SECBUFFER_EMPTY.

fContextReq[in]

-Sinalizadores de bits que especificam os atributos exigidos pelo servidor para estabelecer o contexto. Os sinalizadores de bits podem ser combinados usando operações bitwise-OU. Este parâmetro pode ser um ou mais dos seguintes valores.

Para possíveis sinalizadores de atributos e seus significados, consulte Requisitos de contexto. Os sinalizadores usados para este parâmetro são prefixados com ASC_REQ, por exemplo, ASC_REQ_DELEGATE.

Os atributos solicitados podem não ser suportados pelo cliente. Para obter mais informações, consulte o parâmetro pfContextAttr.

[in] TargetDataRep

A representação de dados, como ordem de bytes, no destino. Este parâmetro pode ser SECURITY_NATIVE_DREP ou SECURITY_NETWORK_DREP.

phNewContexto[in, out, optional]

Um ponteiro para um CtxtHandle estrutura. Na primeira chamada para AcceptSecurityContext (CredSSP), esse ponteiro recebe o novo identificador de contexto. Em chamadas subsequentes, phNewContext pode ser o mesmo que o identificador especificado no parâmetro phContext.

pSaída[in, out, optional]

Um ponteiro para um SecBufferDesc estrutura que contém o descritor de buffer de saída. Esse buffer é enviado ao cliente para entrada em chamadas adicionais para InitializeSecurityContext (CredSSP). Um buffer de saída pode ser gerado mesmo se a função retornar SEC_E_OK. Qualquer buffer gerado deve ser enviado de volta para o aplicativo cliente.

Na saída, esse buffer recebe um token para o contexto de segurança. O token deve ser enviado para o cliente. A função também pode retornar um buffer do tipo SECBUFFER_EXTRA.

pfContextAttr[out]

Um ponteiro para um conjunto de sinalizadores de bits que indicam os atributos do contexto estabelecido. Para obter uma descrição dos vários atributos, consulte Requisitos de contexto. Os sinalizadores usados para este parâmetro são prefixados com ASC_RET, por exemplo, ASC_RET_DELEGATE.

Não verifique se há atributos relacionados à segurança até que a chamada de função final retorne com êxito. Os sinalizadores de atributos não relacionados à segurança, como o sinalizador ASC_RET_ALLOCATED_MEMORY, podem ser verificados antes do retorno final.

ptsExpiração[out, optional]

Um ponteiro para um TimeStamp estrutura que recebe o tempo de expiração do contexto. Recomendamos que o pacote de segurança sempre retorne esse valor no horário local.

Valor de retorno

Esta função retorna um dos seguintes valores.

Comentários

A função AcceptSecurityContext (CredSSP) é a contraparte do servidor para a função InitializeSecurityContext (CredSSP).

Quando o servidor recebe uma solicitação de um cliente, ele usa o parâmetro fContextReq para especificar o que requer da sessão. Desta forma, um servidor pode exigir que os clientes sejam capazes de usar uma integridade confidencial ou sessão verificada; Ele pode rejeitar clientes que não podem atender a essa demanda. Alternativamente, um servidor não pode exigir nada; tudo o que o cliente requer ou pode fornecer é retornado no pfContextAttr parâmetro.

Os parâmetros fContextReq e pfContextAttr são máscaras de bits que representam vários atributos de contexto. Para obter uma descrição dos vários atributos, consulte Requisitos de contexto.

O chamador é responsável por determinar se os atributos de contexto finais são suficientes. Por exemplo, se a confidencialidade (criptografia) foi solicitada, mas não pôde ser estabelecida, alguns aplicativos podem optar por desligar a conexão imediatamente. Se o contexto de segurança não puder ser estabelecido, o servidor deverá liberar o contexto parcialmente criado chamando a função DeleteSecurityContext. Para obter informações sobre quando chamar o função de DeleteSecurityContext, consulte DeleteSecurityContext.

Depois que o contexto de segurança tiver sido estabelecido, o aplicativo de servidor poderá usar a função QuerySecurityContextToken do para recuperar um identificador para a conta de usuário para a qual o certificado do cliente foi mapeado. Além disso, o servidor pode usar a função ImpersonateSecurityContext para representar o usuário.

Requerimentos

Ver também

• Funções SSPI
• DeleteSecurityContext
• InitializeSecurityContext (CredSSP)