Conector microsoft Graph do Wiki do Azure DevOps

  • Artigo

O conector microsoft Graph do Wiki do Azure DevOps permite que a sua organização indexe wikis na respetiva instância do serviço Azure DevOps. Depois de configurar o conector, os utilizadores finais podem procurar wikis de projetos e wikis de código do Azure DevOps no Microsoft Search e Microsoft 365 Copilot.

Este artigo destina-se a qualquer pessoa que configure, execute e monitorize um conector do Microsoft Graph do Azure DevOps Wiki. Complementa o processo de configuração geral e mostra instruções que se aplicam apenas ao conector microsoft Graph do Wiki do Azure DevOps.

Observação

Leia o artigo Setup for your Graph connector (Configuração do conector do Graph ) para compreender as instruções gerais de configuração dos conectores do Graph.

Importante

O conector do Microsoft Graph wiki do Azure DevOps suporta apenas o serviço cloud do Azure DevOps. Azure DevOps Server 2019, TFS 2018, TFS 2017, TFS 2015 e TFS 2013 não são suportados por este conector.

Antes de começar

Tem de ser o administrador de pesquisa do inquilino do Microsoft 365 da sua organização, bem como o administrador da instância do Azure DevOps da sua organização.

Para permitir que o conector se ligue à sua organização do Azure DevOps, tem de ativar o acesso de aplicações de terceiros através do OAuth. Veja a documentação do Azure DevOps para gerir políticas de segurança para saber mais.

Acesso a aplicações de terceiros através do OAuth

Precisa das seguintes permissões concedidas à conta de utilizador cujas credenciais são utilizadas durante a configuração do conector:

Nome da permissão Tipo de permissão Necessário para
Ver informações ao nível do projeto Permissão do projeto Pesquisar Itens de Trabalho do Azure DevOps. Esta permissão é obrigatória para os projetos que precisam de ser indexados.

Importante

A conta de utilizador tem de ter o nível de acesso Básico . Para saber mais sobre os níveis de acesso no Azure DevOps, leia os níveis de acesso suportados.

Passo 1: Adicionar um conector do Microsoft Graph no Centro de administração do Microsoft 365

Adicionar o conector do Microsoft Graph wiki do Azure DevOps

Siga as instruções de configuração gerais.

Passo 2: atribuir um nome à ligação

Siga as instruções de configuração gerais.

Passo 3: Configurar as definições de ligação

Para autenticar e sincronizar conteúdos do Azure DevOps, escolha um dos dois métodos suportados:

Importante

  • Microsoft Entra ID OAuth está em pré-visualização e disponível para clientes selecionados. Este é o mecanismo OAuth recomendado.
  • O OAuth do Azure DevOps é o mecanismo de autenticação legado e não está a ser investido ativamente.

Microsoft Entra ID OAuth (Pré-visualização)

Certifique-se de que a sua Organização do ADO está ligada ao Microsoft Entra

O conector do Azure DevOps Graph indexa apenas conteúdo de uma organização do ADO ligada a Microsoft Entra do seu inquilino. Para garantir que a sua organização do ADO está ligada a Microsoft Entra conta, utilize os seguintes passos.

  1. Navegue para o Azure DevOps e selecione a organização necessária.
  2. Selecione Organization settings.
  3. No painel de navegação esquerdo, selecione Microsoft Entra por baixo do cabeçalho "Geral".
  4. Certifique-se de que a organização está ligada à conta Microsoft Entra do seu inquilino.

Criar uma aplicação no Microsoft Entra ID

  1. Aceda à portal do Azure e inicie sessão com as credenciais de administrador do inquilino.
  2. Navegue para Microsoft Entra ID ->Manage ->Registros de aplicativo no painel de navegação e selecione Novo registo.
  3. Forneça um nome para a aplicação e selecione Registar.
  4. Anote o ID da Aplicação (cliente). Este ID é utilizado para conceder à aplicação Microsoft Entra acesso a projetos na organização do ADO.
  5. Abra as permissões da API no painel de navegação e selecione Adicionar uma permissão.
  6. Selecione Azure DevOps e, em seguida , Permissões delegadas.
  7. Procure as seguintes permissões e selecione Adicionar permissões.
    a. Identidade (leitura)
    b. Código (leitura)
    c. Elegibilidades (leitura)
    d. Projeto e Equipa (leitura)
    e. Gráfico (leitura)
    f. Gestão memberEntitlement (leitura)
    g. Wiki (leitura)
  8. Selecione Conceder consentimento do administrador para [TenantName] e confirme ao selecionar Sim.
  9. Verifique se as permissões estão no estado "Concedido".
  10. Abra a Autenticação a partir do painel de navegação. Selecione e selecione Add a platformWeb. Adicione um dos seguintes URIs em "URIs de Redirecionamento":
    • Para O M365 Enterprise: https://gcs.office.com/v1.0/admin/oauth/callback
    • Para o M365 Administração Pública: https://gcsgcc.office.com/v1.0/admin/oauth/callback
  11. Em Concessão implícita e fluxos híbridos, marcar a opção para ID tokens (used for implicit and hybrid flows) e clique em Configurar.
  12. No painel de navegação, selecione Certificados e segredos em Gerir.
  13. Selecione Novo Segredo do cliente e selecione um período de expiração para o segredo. Copie o segredo gerado (Valor) e guarde-o porque não é apresentado novamente.
  14. Utilize este Segredo do cliente e o ID da aplicação para configurar o conector.

Conceder à aplicação Microsoft Entra acesso a projetos na organização do ADO

Tem de fornecer à aplicação Microsoft Entra o acesso necessário aos projetos que precisam de ser indexados através dos seguintes passos:

  1. Navegue para o Azure DevOps e selecione a organização necessária.
  2. Selecione Organization settings.
  3. No painel de navegação esquerdo, selecione Users por baixo do cabeçalho "Geral".
  4. Selecione Add users.
  5. Copie o ID da Aplicação (cliente) obtido da aplicação para "Utilizadores ou Principais de Serviço".
  6. Conceda o Basic nível de acesso e selecione os projetos para permitir o acesso ao índice. Adicione também ao Project Reader grupo do Azure DevOps (ou equivalente) para garantir o acesso. Desselize a opção para enviar um convite por e-mail aos utilizadores.

Azure DevOps OAuth

Para ligar à instância do Azure DevOps, precisa do ID da Aplicação da organização do Azure DevOps e do segredo do cliente para a autenticação OAuth.

Registrar um aplicativo

Registe uma aplicação no Azure DevOps para que a aplicação Microsoft Search e o Microsoft 365 Copilot possam aceder à instância. Para registar a aplicação, visite a ligação para registar a aplicação. Para saber mais, veja a documentação do Azure DevOps sobre como registar uma aplicação.

A tabela seguinte fornece orientações sobre como preencher o formulário de registo de aplicações:

Campos obrigatórios Descrição Valor recomendado
Nome da empresa O nome da sua empresa. Utilize um valor adequado.
Nome do aplicativo Um valor exclusivo que identifica a aplicação que está a autorizar. Microsoft Search.
Site da aplicação O URL da aplicação que pede acesso à instância do Azure DevOps durante a configuração do conector. (obrigatório). Para Microsoft 365 Enterprise: https:// gcs.office.com/,
Para o Microsoft 365 Administração Pública: https:// gcsgcc.office.com/
URL de chamada de retorno de autorização Um URL de chamada de retorno necessário para o qual o servidor de autorização redireciona. Para Microsoft 365 Enterprise: https:// gcs.office.com/v1.0/admin/oauth/callback,
Para o Microsoft 365 Government: https:// gcsgcc.office.com/v1.0/admin/oauth/callback
Âmbitos autorizados O âmbito de acesso da aplicação Selecione os seguintes âmbitos: Identidade (leitura), Código (leitura), Elegibilidade (leitura), Projeto e Equipa (leitura), Gráfico (leitura), Gestão de Direitos de Membro (leitura), Wiki (leitura).

Importante

Os âmbitos autorizados selecionados para a aplicação devem corresponder exatamente aos âmbitos listados acima. Se estiverem selecionados mais ou menos âmbitos, a autorização falhará.

Ao registar a aplicação, obtém o ID da Aplicação e o Segredo do Cliente que são utilizados para configurar o conector.

Para revogar o acesso a qualquer aplicação registada no Azure DevOps, aceda a Definições de utilizador na parte superior direita da instância do Azure DevOps. Selecione Perfil e, em seguida, selecione Autorizações na secção Segurança do painel lateral. Paire o cursor sobre uma aplicação OAuth autorizada para ver o botão Revogar no canto dos detalhes da aplicação.

Definições de ligação

Depois de registar a aplicação Microsoft Search e Microsoft 365 Copilot com o Azure DevOps, pode concluir o passo de definições de ligação. Introduza o ID da Aplicação e o segredo do cliente.

Definições da Aplicação de Ligação.

Configurar dados: selecionar organização, projetos e campos

Neste passo, vai especificar o âmbito dos dados que pretende indexar com o conector microsoft Graph do Wiki do Azure DevOps.

Como primeiro passo, escolhe a organização à qual pretende indexar, de todas as organizações às quais tem acesso. Em seguida, pode escolher a ligação para indexar toda a organização ou projetos específicos na organização selecionada.

Se optar por indexar toda a organização, os wikis em todos os projetos na organização são indexados. Os novos projetos e wikis são indexados durante a próxima pesquisa depois de serem criados.

Se optar por indexar projetos individuais, apenas os wikis nos projetos selecionados são indexados.

Passo 4: Gerir permissões de pesquisa

O conector do Microsoft Graph do Wiki do Azure DevOps suporta permissões de pesquisa visíveis para Todos. Com a opção Todos , os dados indexados são apresentados nos resultados da pesquisa para todos os utilizadores.

Passo 5: Atribuir etiquetas de propriedade

Siga as instruções de configuração gerais.

Passo 6: Gerir o esquema

Siga as instruções de configuração gerais.

Passo 7: escolher as definições de atualização

O conector do Microsoft Graph wiki do Azure DevOps suporta agendas de atualização para pesquisas completas e incrementais. A agenda recomendada é de uma hora para uma pesquisa incremental e uma semana para uma pesquisa completa.

Passo 8: rever a ligação

Siga as instruções de configuração gerais.

Passo 9: Configurar a página de resultados da pesquisa

Depois de publicar a ligação, tem de personalizar a página de resultados da pesquisa com verticais e tipos de resultados. Para saber mais sobre como personalizar os resultados da pesquisa, reveja como gerir verticais e tipos de resultados.

Também pode utilizar o esquema de resultados de exemplo para o conector microsoft Graph do Wiki do Azure DevOps. Basta copiar e colar o JSON do esquema de resultados para começar.

Solução de problemas

Depois de publicar a ligação, pode rever a status no separador Origens de dados no centro de administração. Para saber como fazer atualizações e eliminações, consulte Gerir o conector. Pode encontrar passos de resolução de problemas frequentemente vistos aqui.

Se tiver problemas ou quiser fornecer comentários, contacte o [Microsoft Graph | Suporte (https://developer.microsoft.com/en-us/graph/support).