SPNs (nomes da entidade de serviço) em conexões de cliente (OLE DB) no 'SQL Server Native Client
Aplica-se a: SQL Server
Banco de Dados
SQL do Azure Instância Gerenciada de SQL
do Azure PDW (Sistema de Plataforma de Análise) do Azure Synapse Analytics
Este artigo descreve as propriedades do OLE DB e as funções de membro que dão suporte a SPNs (nomes da entidade de serviço) em aplicativos clientes. Para obter mais informações sobre SPNs em aplicativos cliente, confira Suporte do SPN (Nome da entidade de serviço) em conexões do cliente. Para ver um exemplo, confira Autenticação Kerberos integrada (OLE DB).
Palavras-chave da cadeia de caracteres de inicialização do provedor
As palavras-chave da cadeia de caracteres de inicialização de provedor a seguir dão suporte a SPNs em aplicativos OLE DB. Na tabela a seguir, os valores na coluna de palavra-chave são usados para a cadeia de caracteres do provedor de IDBInitialize::Initialize. Os valores na coluna de descrição são usados em cadeias de inicialização na conexão usando o ADO ou IDataInitialize::GetDataSource.
Palavra-chave | Descrição | Valor |
---|---|---|
ServerSPN | SPN do servidor | O SPN do servidor. O valor padrão é uma cadeia de caracteres vazia, o que faz com que o Driver do OLE DB para SQL Server use o SPN padrão gerado pelo provedor. |
FailoverPartnerSPN | SPN do parceiro de failover: | O SPN do parceiro de failover. O valor padrão é uma cadeia de caracteres vazia, o que faz com que o Driver do OLE DB para SQL Server use o SPN padrão gerado pelo provedor. |
Propriedades de inicialização da fonte de dados
As propriedades a seguir no conjunto de propriedades DBPROPSET_SQLSERVERDBINIT permitem que os aplicativos especifiquem ou leiam SPNs.
Nome | Type | Uso |
---|---|---|
SSPROP_INIT_SERVERSPN | VT_BSTR, leitura/gravação | Especifica o SPN do servidor. O valor padrão é uma cadeia de caracteres vazia, o que faz com que o Driver do OLE DB para SQL Server use o SPN padrão gerado pelo provedor. |
SSPROP_INIT_FAILOVERPARTNERSPN | VT_BSTR, leitura/gravação | Especifica o SPN para o parceiro de failover. O valor padrão é uma cadeia de caracteres vazia, o que faz com que o Driver do OLE DB para SQL Server use o SPN padrão gerado pelo provedor. |
SSPROP_INIT_DISCOVEREDSERVERSPN | VT_BSTR, somente leitura | Usado para consultar o SPN do servidor de uma conexão. (Versão 18.6.3 ou posterior) |
Propriedades de fonte de dados
As propriedades a seguir do conjunto de propriedades DBPROPSET_SQLSERVERDATASOURCEINFO permitem que os aplicativos descubram o método de autenticação.
Nome | Type | Uso |
---|---|---|
SSPROP_INTEGRATEDAUTHENTICATIONMETHOD | VT_BSTR, 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 Driver do OLE DB para SQL Server. Veja a seguir os valores possíveis: "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. Se uma conexão foi aberta e não for possível determinar o método de autenticação, VT_EMPTY será retornado. Essa propriedade só pode ser lida quando uma fonte de dados tiver sido inicializada. Se você tentar ler a propriedade antes da inicialização da fonte de dados, IDBProperties::GetProperies retornará DB_S_ERRORSOCCURRED ou DB_E_ERRORSOCCURRED, conforme apropriado, e DBPROPSTATUS_NOTSUPPORTED será definido em DBPROPSET_PROPERTIESINERROR para essa propriedade. Esse comportamento está de acordo com a especificação principal do OLE DB. |
SSPROP_MUTUALLYAUTHENTICATED | VT_BOOL, somente leitura | Retorna VARIANT_TRUE se os servidores da conexão forem autenticados mutuamente. Caso contrário, retorna VARIANT_FALSE. Essa propriedade só pode ser lida quando uma fonte de dados tiver sido inicializada. Se houver uma tentativa de ler a propriedade antes da inicialização da fonte de dados, IDBProperties::GetProperies retornará DB_S_ERRORSOCCURRED ou DB_E_ERRORSOCCURRED, conforme apropriado, e DBPROPSTATUS_NOTSUPPORTED será definido em DBPROPSET_PROPERTIESINERROR para essa propriedade. Esse comportamento está de acordo com a especificação principal do OLE DB Se esse atributo for consultado para uma conexão que não usou a Autenticação do Windows, será retornado VARIANT_FALSE. |
Suporte de API do OLE DB para SPNs
A tabela a seguir descreve o as funções do membro OLE DB que dá suporte a SPNs em conexões do cliente:
Função de membro | DESCRIÇÃO |
---|---|
IDataInitialize::GetDataSource | pwszInitializationString pode conter as novas palavras-chave ServerSPN e FailoverPartnerSPN. |
IDataInitialize::GetInitializationString | Se SSPROP_INIT_SERVERSPN e SSPROP_INIT_FAILOVERPARTNERSPN tiverem valores não padrão, eles serão incluídos na cadeia de caracteres de inicialização por meio dos valores de palavra-chave ppwszInitString para ServerSPN e FailoverPartnerSPN. Caso contrário, essas palavras-chave não serão incluídas na cadeia de inicialização. |
IDBInitialize::Initialize | Se o aviso for habilitado pela definição de DBPROP_INIT_PROMPT nas propriedades de inicialização da fonte de dados, a caixa de diálogo Logon no OLE DB será exibida. Isto permite que os SPNs sejam inseridos no servidor principal e no seu parceiro de failover. Se a cadeia de caracteres do provedor em DPPROP_INIT_PROVIDERSTRING estiver definida, ela reconhecerá as novas palavras-chave ServerSPN e FailoverPartnerSPN e usará seus valores, caso estejam presentes, para inicializar SSPROP_INIT_SERVER_SPN e SSPROP_INIT_FAILOVER_PARTNER_SPN. IDBProperties::SetProperties pode ser chamada para definir as propriedades SSPROP_INIT_SERVER_SPN e SSPROP_INIT_FAILOVER_PARTNER_SPN antes de IDBInitialize::Initialize ser chamado. Essa é uma alternativa ao uso de uma cadeia de caracteres de provedor. Se uma propriedade for definida em mais de um local, um valor definido programaticamente terá precedência sobre um conjunto de valor na cadeia de caracteres de provedor. Um valor definido na cadeia de inicialização tem precedência sobre um valor definido em uma caixa de diálogo de login. Se a mesma palavra-chave aparecer mais de uma vez na cadeia de caracteres de provedor, o valor da primeira ocorrência terá precedência. |
IDBProperties::GetProperties | IDBProperties::GetProperties pode ser chamado para obter os valores das novas propriedades de inicialização da fonte de dados SSPROP_INIT_SERVERSPN e SSPROP_INIT_FAILOVERPARTNERSPN, e das novas propriedades da fonte de dados SSPROP_AUTHENTICATIONMETHOD e SSPROP_MUTUALLYAUTHENTICATED. |
IDBProperties::GetPropertyInfo | IdbProperties::GetPropertyInfo incluirá as novas propriedades de inicialização da fonte de dados SSPROP_INIT_SERVERSPN e SSPROP_INIT_FAILOVERPARTNERSPN, ou as novas propriedades da fonte de dados SSPROP_AUTHENTICATION_METHOD e SSPROP_MUTUALLYAUTHENTICATED. |
IDBProperties::SetProperties | IDBProperties::SetProperties pode ser chamado para definir os valores das novas propriedades de inicialização da fonte de dados SSPROP_INITSERVERSPN e SSPROP_INIT_FAILOVERPARTNERSPN. Essas propriedades podem ser definidas a qualquer momento, mas se a fonte de dados já estiver aberta, o erro a seguir será retornado:DB_E_ERRORSOCCURRED, "Operação de várias etapas do OLE DB gerou erros. Verifique todos os valores de status do OLE DB, se disponíveis. Não foram executados trabalhos." |