Partilhar via


SPNs (Nomes da Entidade de Serviço) em conexões de cliente (ODBC)

Este tópico descreve atributos e funções ODBC que dão suporte a SPNs (nomes de entidades de serviço) em aplicativos cliente. Para obter mais informações sobre SPNs em aplicativos cliente, consulte Suporte a SPN (Nome da entidade de serviço) em conexões com o cliente e Obter autenticação Kerberos mútua.

Palavras-chave de cadeia de conexão

As palavras-chave de cadeia de conexão a seguir permitem que aplicativos cliente especifiquem um SPN.

Palavra-chave

Valor

ServerSPN

O SPN do servidor. O valor padrão é uma cadeia de caracteres vazia, que faz com que o SQL Server Native Client use o SPN padrão gerado pelo driver.

FailoverPartnerSPN

O SPN do parceiro de failover. O valor padrão é uma cadeia de caracteres vazia, que faz com que o SQL Server Native Client use o SPN padrão gerado pelo driver.

Atributos de conexão

Os atributos de conexão a seguir permitem que aplicativos cliente especifiquem um SPN e consultem o método de autenticação.

Nome

Tipo

Uso

SQL_COPT_SS_SERVER_SPN

SQL_COPT_SS_FAILOVER_PARTNER_SPN

SQLTCHAR, leitura/gravação

Especifica o SPN do servidor. O valor padrão é uma cadeia de caracteres vazia, que faz com que o SQL Server Native Client use o SPN padrão gerado pelo driver.

Esse atributo só poderá ser consultado depois que for definido por meio de programação ou depois que uma conexão for aberta. Se for feita uma tentativa de consultar esse atributo em uma conexão que não esteja aberta e o atributo não tiver sido definido por meio de programação, SQL_ERROR será retornado e um registro de diagnóstico será registrado com SQLState 08003 e uma mensagem informando que a conexão não está aberta.

Se for feita uma tentativa de definir esse atributo quando uma conexão estiver aberta, SQL_ERROR será retornado e um registro de diagnóstico será registrado com SQLState HY011 e uma mensagem informando que a operação não é válida no momento.

SQL_COPT_SS_INTEGRATED_AUTHENTICATION_METHOD

SQLTCHAR, somente leitura

Retorna o método de autenticação usado para a conexão. O valor retornado ao aplicativo é o valor que o Windows retorna ao SQL Server Native Client. Os valores possíveis são:

  • "NTLM", que é retornado quando uma conexão é aberta usando a autenticação NTLM.

  • "Kerberos", que é retornado quando uma conexão é aberta usando a autenticação Kerberos.

Esse atributo só pode ser lido para uma conexão aberta que usou a Autenticação do Windows. Se for feita uma tentativa de lê-lo antes da abertura de uma conexão, SQL_ERROR será retornado e um erro será registrado com SQLState 08003 e uma mensagem que informa que a conexão não está aberta.

Se esse atributo for consultado em uma conexão que não usou a Autenticação do Windows, será retornado SQL_ERROR e um erro será registrado com SQLState HY092 e a mensagem de identificador de atributo/opção inválido (SQL_COPT_SS_INTEGRATED_AUTHENTICATION_METHOD só está disponível para conexões confiáveis).

Se o método de autenticação não puder ser determinado, SQL_ERROR será retornado e um erro será registrado com SQLState HY000 e uma mensagem de erro geral.

SQL_COPT_SS_MUTUALLY_AUTHENTICATED

SQLSMALLINT, somente leitura

Retornará SQL_TRUE se o servidor na conexão tiver sido autenticado mutuamente; caso contrário, retornará SQL_FALSE.

Esse atributo só pode ser lido para uma conexão aberta. Se for feita uma tentativa de lê-lo antes da abertura de uma conexão, SQL_ERROR será retornado e um erro será registrado com SQLState 08003 e uma mensagem que informa que a conexão não está aberta.

Se esse atributo for consultado para uma conexão que não usou a Autenticação do Windows, será retornado SQL_FALSE.

Suporte de funções ODBC para especificação de SPNs

As seguintes funções ODBC oferecem suporte a aplicativos cliente e SPNs:

Consulte também

Conceitos

SQL Server Native Client (ODBC)