Gerar Confluence token

Para se conectar a uma base de dados de conhecimento Knowledge Hub, você deve fornecer suas credenciais para NiCE Professional Services ou inseri-las em Knowledge Hub você mesmo. Esta página descreve como gerar essas credenciais, também chamadas de tokens OAuth. Você deve tratar os tokens OAuth como senhas. Certifique-se de armazená-los em um local seguro. Se você perdê-los, terá que regenerá-los.

Esse método é um esforço do desenvolvedor. Requer conhecimento de Python e privilégiosde administrador da Atlassian.

Complete cada uma dessas tarefas na ordem indicada.

Instalar o Python

Conclua esta tarefa se você ainda não tiver o Python instalado em seu computador.

  1. Instale Python Caixa com seta indicando navegação para site externo..

  2. Execute o instalador. Marque a caixa Adicionar python.exe ao CAMINHOe clique em Instalar agora.

Configurar autenticação

Use esse método para integração básica com Confluence. Para criar um token de API, faça o seguinte:

  1. Navegue até a página Configurações da conta Atlassian Caixa com seta indicando navegação para site externo..

  2. Selecione a gujia Segurança.

  3. Na página API Tokens, selecione Criar API token.

  4. Na caixa de diálogo Criar API token:

    • Digite um nome para o token.

    • Especifique o tempo de expiração do token.

    • Selecione Criar.

    O sistema gera um token de API.

    Observação: API tokens podem ser válidos por até um ano. Certifique-se de renová-los antes que expirem para evitar interrupções.

  5. Copie o token e armazene-o em um local seguro.

    Observação: você não poderá exibir o token novamente depois de fechar a caixa de diálogo.

Configurar OAuth autenticação

Para configurar OAuth autenticação, siga estas etapas para habilitar o acesso seguro e limitado ao Confluence usando um método de login seguro chamado OAuth 2.0.

  1. Acesse o Atlassian Developer Console Caixa com seta indicando navegação para site externo. e faça login com sua conta Atlassian.

  2. Crie ou selecione seu aplicativo:

    • Se você não tiver um aplicativo criado:

      • Selecione Criar.

      • No menu suspenso, escolha OAuth 2.0 (3LO) como o tipo de aplicativo.

      • Insira um nome e uma descrição para o seu aplicativo.

      • Selecione Criar para finalizar.

    • Se você já tem um aplicativo:

      • Selecione o aplicativo na lista Meus aplicativos.

  3. Vá para a página Visão geral do aplicativo, no painel de navegação esquerdo, selecione Permissões.

    • Em Confluence API, selecione Adicionare escolha Configurar.

    • Habilite os escopos necessários:

      • Nos escopos Clássico, selecione Editar e habilite todas as permissões de leitura.

      • Para escopos Granular, selecione Editar e habilite todas as permissões de leitura.

    • Selecione Salvar para aplicar as configurações de escopo.

  4. No painel de navegação esquerdo, selecione Autorização.

    • Em OAuth 2.0 (3LO), selecione Adicionar.

    • No campo URL de retorno de chamada digite:

      • https://us-west-2.console.aws.amazon.com/appflow/oauth

    • Selecione Salvar alterações.

  5. No painel de navegação esquerdo, selecione Configurações.

  6. Vá para a seção Detalhes da autenticação e copie a ID do cliente e a Chave secreta.

Configurar o acesso de usuários e grupos

Esta seção explica como adicionar usuários, atribuir acesso a produtos e gerenciar associações a grupos no Atlassian Admin Console para garantir o acesso adequado a Confluence.

  1. Para adicionar usuários:

    • Acesse o Atlassian Admin Console Caixa com seta indicando navegação para site externo..

    • No painel de navegação esquerdo, selecione Diretórioe escolha Usuários.

    • Selecione Convidar usuários.

    • Digite os endereços de e-mail dos usuários que você quer convidar.

    • Em Acesso ao produto, selecione Confluence para conceder acesso ao site.

    • Selecione Enviar convite.

    Observação: Os usuários devem aceitar o convite para ativar suas contas.

  2. Depois que os usuários forem adicionados, atribua as funções de produto apropriadas para controlar seu nível de acesso. Para atribuir acesso ao produto:

    • Na lista Usuários, selecione o nome do usuário.

    • Na página de perfil do usuário, selecione a guia Acesso ao produto.
      Observação: Certifique-se de que Confluence esteja selecionado.

    • Atribua a função apropriada com base nas responsabilidades do usuário. Por exemplo, usuário, administrador e assim por diante.

  3. Para adicionar usuários a grupos

    • No painel de navegação esquerdo, selecione Diretórioe escolha Grupos.

    • Selecione o grupo que deseja gerenciar.

    • Selecione Adicionar membros.

    • Pesquise os usuários por nome ou endereço de e-mail.

    • Selecione os usuários e confirme a adição.

    O acesso baseado em grupo simplifica o gerenciamento de permissões em vários espaços e produtos.

  4. As associações de grupo ajudam a gerenciar permissões e níveis de acesso com eficiência. Os Grupos recomendados são os seguintes:

    Nome do GRUPO

    PROPÓSITO
    confluence-admins-servion11 Acesso de administrador
    confluence-usuário-acesso-admins-servion11 Gerenciar o acesso do usuário

    confluência-usuários-servion11

    		Acesso geral do usuário
    administradores da organização Administrador no nível da organização

Gere tokens OAuth usando Python

Use o script Python de este arquivo TXT para gerar tokens de autenticação para acessar o API. Antes de executar o script, certifique-se de substituir os valores de espaço reservado para client_id e client_secret por suas credenciais reais.

Observação: verifique se os URIs de redirecionamento correspondem ao configurado no Developer Console.

Configurar Permissões no nível do espaço no Confluence

As permissões de nível de espaço em Confluence permitem controlar quem pode visualizar, editar ou administrar conteúdo em um espaço específico. Siga estas etapas para configurar permissões para um espaço:

  1. Faça login no seu espaço Confluence usando suas credenciais.

  2. No painel de navegação esquerdo, localize e clique no espaço que deseja gerenciar.

  3. Dentro do espaço, clique em Configurações do espaço.

  4. Role até a seção Acesso ao espaço e clique em Usuários. Isso abre a interface onde você pode adicionar ou remover permissões para um usuário ou grupo de usuários.

  5. Clique em Editar e ative o acesso Exibir.

  6. Depois de atribuir as permissões apropriadas, clique em Salvar.

Expiração do token de acesso

Se o token de acesso tiver expirado, você não poderá fazer chamadas de API. Para corrigir isso, acesse o AtlassianDeveloper Console Caixa com seta indicando navegação para site externo. e gere um novo token.