Compartilhar via


Propriedades do ponto de conexão de serviço

Os atributos da classe serviceConnectionPoint são suficientes para a maioria dos serviços. Os Serviços de Domínio Active Directory não definem como os atributos são usados, portanto, os clientes do serviço devem ser capazes de interpretar e usar os dados em seus SCPs de serviço. Os serviços que devem publicar dados adicionais sobre si mesmos podem estender o esquema do Active Directory criando uma subclasse da classe serviceConnectionPoint , dando à subclasse um nome distinto. Para obter mais informações sobre extensões de esquema, consulte Estendendo o esquema.

Os atributos mais importantes de um SCP são palavras-chave, serviceDNSName, serviceDNSNameType, serviceClassName e serviceBindingInformation. Os aplicativos cliente pesquisam valores de palavras-chave no diretório para localizar seu SCP. Quando o SCP é encontrado, os clientes podem ler outros atributos para recuperar dados de serviço.

Atributo Descrição
Keywords
O atributo keywords pode conter vários valores de cadeia de caracteres que identificam seu serviço. Esse atributo está incluído no Catálogo Global, o que significa que os clientes em qualquer domínio de uma floresta corporativa podem pesquisar palavras-chave associadas ao seu serviço no Catálogo Global. Esse atributo também é indexado, o que melhora o desempenho da consulta. O instalador que cria o SCP define os valores do atributo de palavras-chave . Normalmente, esses valores não são modificados pelo serviço ativo.
As palavras-chave exatas que você deve incluir em seu SCP dependem de como os clientes pesquisam seu serviço. As melhores palavras-chave a serem usadas são cadeias de caracteres GUID porque os GUIDs são garantidos como exclusivos em uma floresta. Use o formato de cadeia de caracteres GUID retornado pela função UuidToString na biblioteca RPC. Você também pode incluir nomes legíveis por humanos, se os clientes puderem usá-los para procurar seu serviço. As palavras-chave em um SCP devem incluir cadeias de caracteres GUID e/ou nomes que identifiquem os seguintes dados sobre seu serviço:
  • Sua empresa ou organização: por exemplo, Fabrikam.
  • O produto ou serviço: por exemplo, SQL Server. Isso permite que os aplicativos cliente localizem SCPs para serviços desse tipo.
  • A versão específica do produto ou serviço, como 7.5.
  • Para SCPs que publicam um conjunto específico de dados ou recursos para um tipo de serviço, inclua uma cadeia de caracteres GUID ou um nome que identifique a instância específica. Por exemplo, um serviço de banco de dados poderia publicar um SCP para um banco de dados específico. Nesse caso, o SCP incluiria um GUID de produto para identificar o serviço e outro GUID para identificar o banco de dados.

serviceDNSName e serviceDNSNameType
Os aplicativos cliente usam os atributos serviceDNSName e serviceDNSNameType para determinar o computador host do serviço. O valor serviceDNSNameType indica o tipo de nome DNS especificado por serviceDNSName geralmente "A" se serviceDNSName contiver um nome de host ou "SRV" se serviceDNSName contiver um nome de registro SRV.
O valor serviceDNSName é normalmente o nome DNS do computador host do serviço. O instalador do serviço pode chamar a função GetComputerNameEx para obter o nome DNS do computador local.
Para serviços que têm registros SRV DNS, serviceDNSName pode ser o nome do registro SRV. Um aplicativo cliente usa as APIs DNS para recuperar todos os registros SRV que correspondem a esse nome. Em seguida, o cliente recupera o nome de host DNS de um dos registros SRV. Essa técnica é útil para serviços replicados porque os registros SRV também incluem dados que permitem que o cliente selecione a melhor réplica.
serviceBindingInformation
Uma propriedade de vários valores que contém valores de cadeia de caracteres que armazenam dados necessários para vincular a um serviço. Essa propriedade é indexada e replicada para o Catálogo Global.
O conteúdo de serviceBindingInformation é específico para o serviço que publicou o SCP, os clientes devem interpretar os dados de vinculação. No caso mais comum, os dados de associação consistem em um número de porta no computador host do serviço.
serviceClassName
Uma propriedade de valor único que identifica a classe de serviço representada pelo SCP. Esta é uma cadeia de caracteres descritiva específica para o serviço que publicou o SCP; por exemplo, SqlServer. Para serviços que oferecem suporte à autenticação mútua, os clientes podem usar essa propriedade, juntamente com o nome DNS do computador host do serviço, para formar um nome principal de serviço. Para obter mais informações, consulte Autenticação mútua usando Kerberos.