Definir configurações Atlassian para o conector de conteúdo externo Atlassian Confluence Cloud

  • Versão de lançamento: Yokohama
  • Atualizado 28 de fev. de 2025
  • 3 min. de leitura

    • Registre uma aplicação OAuth 2.0 no console do desenvolvedor Atlassian e crie uma chave de API em Atlassian Administration para permitir que o conector de conteúdo externo Atlassian Confluence Cloud rasteje espaços e acesse permissões no sistema de origem Atlassian Confluence Cloud.

    Antes de Iniciar

    Você precisa das seguintes credenciais e permissões para as aplicações de gestão Atlassian da sua organização:
    Atlassian portal Credenciais e permissões necessárias
    Atlassian Console do desenvolvedor (https://developer.atlassian.com/console/myapps/)
    • Credenciais de login
    • Permissão para exibir configurações de aplicações registradas
    • Permissão para registrar uma nova aplicação
    • Permissão para definir escopos granulares da API do Confluence para uma aplicação
    • Permissão para definir a URL de retorno de chamada do OAuth 2.0 para uma aplicação
    Atlassian Administration (https://admin.atlassian.com/)
    • Credenciais de login
    • Permissão para criar uma nova chave de API de administrador

    Função necessária: administrador

    Por Que e Quando Desempenhar Esta Tarefa

    O conector de conteúdo externo Atlassian Confluence Cloud recupera conteúdo do seu sistema de origem Atlassian Confluence Cloud usando a API do Confluence.

    Para permitir que o conector acesse seu sistema de origem Atlassian Confluence Cloud por meio da API do Confluence, você deve configurar uma integração OAuth 2.0 no console do desenvolvedor Atlassian e uma chave de API em Atlassian Administration. Seu administrador de pesquisa pode usar configurações copiadas da integração do OAuth 2.0 e a chave de API para configurar o conector de conteúdo externo Atlassian Confluence Cloud para a conexão apropriada com o sistema de origem Atlassian Confluence Cloud.

    Procedimento

    1. No console do desenvolvedor Atlassian, registre uma nova integração OAuth 2.0 para o conector de conteúdo externo Atlassian Confluence Cloud, executando as etapas a seguir.
      1. Faça login no Atlassian Console do desenvolvedor em https://developer.atlassian.com/console/myapps/.
      2. Na seção Meus apps, selecione Criar > Integração com OAuth 2.0.
        Crie o botão e o item de menu de integração do OAuth 2.0 na tela Atlassian Meus apps do console do desenvolvedor.
      3. Insira um nome para a integração do OAuth 2.0, selecione a opção para concordar com os termos de desenvolvedor de Atlassiane selecione Criar.
        Nome da integração do OAuth 2.0 (3LO), Atlassian opção de termos do desenvolvedor e botão Criar no console do desenvolvedor Atlassian.

        Por exemplo, você pode inserir o conector de conteúdo externo do Confluence Cloud como o nome da integração do OAuth 2.0.

      4. Navegue até a tela Permissões da integração do OAuth 2.0 e selecione Adicionar na linha da API do Confluence.
        Botão Adicionar API do Confluence na Atlassian tela Permissões do console do desenvolvedor.
      5. Na linha API do Confluence, selecione Configurar.
        Configure o botão da API do Confluence no console de permissões Atlassian.
      6. Na guia Escopos granulares, selecione Editar escopos e selecione as opções para cada um dos seguintes escopos:
        • leitura: anexo: confluência
        • ler:blogpublicar:confluence
        • leitura: detalhes do conteúdo: confluência
        • leitura:content.metadata:confluence
        • leitura:pasta:confluência
        • leitura:grupo:confluência
        • leitura:página:confluência
        • leitura:espaço:confluência
        • leitura:usuário:confluência
        Botão Editar escopos na Atlassian tela Permissões do console do desenvolvedor.
      7. Selecione Save (Salvar).
        Botão Salvar na caixa de diálogo Editar API do Confluence do Atlassian do console do desenvolvedor.
      8. Navegue até a tela Autorização da integração do OAuth 2.0 e selecione Adicionar na linha do tipo de autorização OAuth 2.0 (3LO).
        Adicione o botão de autorização do OAuth 2.0 (3LO) na Atlassian tela Autorização do console do desenvolvedor.
      9. Insira http://<instance-name> .service-now.com/oauth_redirect.do como a URL de retorno de chamada, substituindo com o nome da instância Now Platform® e selecione Salvar mudanças .
        Campo URL de retorno de chamada e botão Salvar mudanças na tela Autorização do console Atlassian do desenvolvedor.
      10. Navegue até a tela Configurações da integração do OAuth 2.0 e registre os valores de ID de cliente e segredo em um local seguro.
        Campos de ID de cliente e Segredo na tela Configurações do console do desenvolvedor Atlassian.
        Importante:
        Seus administradores Pesquisa com IA precisam desses valores de ID de cliente e segredo ao configurar o conector de conteúdo externo Atlassian Confluence Cloud.
    2. Em Atlassian Administration, crie uma nova chave de API de administrador executando as etapas a seguir.
      1. Faça login em Atlassian Administration em https://admin.atlassian.com/.
      2. Selecione Configurações na lista de guias.
        Atlassian Administration Guia Configurações do console.
      3. Selecione Chaves de APIe Criar chave de API.
        Botão Criar chave de API na tela Chaves de API da seção Configurações do console Atlassian Administration.
      4. Insira um nome e uma data de expiração para sua nova chave de API.
        Campo de nome da chave de API, campo de data de expiração e botão Criar na caixa de diálogo do console Atlassian Administration.

        Por exemplo, você pode inserir o conector de conteúdo externo do Confluence Cloud como o nome da sua chave de API e definir sua data de expiração para um ano no futuro.

      5. Selecione Criar.
      6. Registre o valor da chave de API em um local seguro.
        Chave de API na caixa de diálogo do console Atlassian Administration.
        Importante:
        Seus administradores Pesquisa com IA precisam do valor da chave de API ao configurar o conector de conteúdo externo Atlassian Confluence Cloud.
      7. Clique em Done (Concluído).
    3. Em sua instância Now Platform, altere o Atlassian Confluence Cloud URL de redirecionamento do Provedor OAuth 2.0 executando as etapas a seguir.
      1. Selecione “Tudo”.
      2. No campo Filtro, insira oauth_entity.list.
      3. Edite o Atlassian Confluence Cloud registro de entidade do provedor OAuth 2.0.
      4. Defina a URL de redirecionamento do registro da entidade como http://<instance-name> .service-now.com/oauth_redirect.do , substituindo com o nome da sua instância Now Platform .
      5. Selecione Atualizar.

    O que Fazer Depois

    Forneça os seguintes itens ao administrador Pesquisa com IA :
    • Os valores de ID de cliente e segredo da integração do OAuth 2.0 que você registrou na etapa 1.j.
    • O valor da chave de API que você registrou na etapa 2.f.

    O administrador Pesquisa com IA precisa desses itens para criar um conector de conteúdo externo Atlassian Confluence Cloud para recuperar documentos e acessar permissões da sua instância Atlassian Confluence Cloud.

    Para obter detalhes sobre como criar um conector de conteúdo externo Atlassian Confluence Cloud, consulte Criar um conector de conteúdo externo e Configurações de conexão para o conector de conteúdo externo Atlassian Confluence Cloud.