View a markdown version of this page

Configurar a autenticação OAuth 2.0 para o Confluence - Amazon Bedrock
Etapa 1: registrar um aplicativo OAuth 2.0 (3LO)Etapa 2: autorizar o aplicativoEtapa 3: trocar o código por tokensEtapa 4: Criar o segredo do Secrets ManagerEtapa 5: conceder permissão à função de serviço para atualizar o segredoPróximas etapas

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

Configurar a autenticação OAuth 2.0 para o Confluence

A autenticação OAuth 2.0 (OAUTH2) é autenticada com um aplicativo Atlassian OAuth 2.0 de três pernas (3LO). Você registra um aplicativo no console do desenvolvedor da Atlassian, conclui um fluxo de autorização único para obter um token de atualização e armazena as credenciais em. AWS No momento do rastreamento, o Amazon Bedrock usa o token de atualização para gerar automaticamente tokens de acesso de curta duração.

Importante

O OAuth 2.0 não oferece suporte ao controle de acesso em nível de documento (ACLs). Para filtrar os resultados da consulta pelas permissões do usuário, use a autenticação básica. Consulte Configurar a autenticação básica para o Confluence.

Etapa 1: registrar um aplicativo OAuth 2.0 (3LO)

  1. Faça login no console do desenvolvedor da Atlassian.

  2. Escolha Criar e, em seguida, integração com OAuth 2.0.

  3. Insira um nome para o aplicativo (por exemplo,bedrock-confluence-connector) e escolha Criar.

  4. Na página de permissões do aplicativo, adicione a API Confluence. Configure os seguintes escopos granulares (ou os escopos clássicos equivalentes se seu aplicativo os usar):

    • read:content:confluence

    • read:content-details:confluence

    • read:space:confluence

    • read:space-details:confluence

    • read:user:confluence

    • read:attachment:confluence

    • read:page:confluence— necessário para enumeração de páginas

    • read:blogpost:confluence— obrigatório se você rastrear postagens de blog

    • read:custom-content:confluence— necessário se o seu espaço de trabalho contiver conteúdo personalizado

    Adicione offline_access a permissão da API Autorização — Identidade do usuário. offline_accessé o que faz com que a Atlassian emita um token de atualização.

  5. Na página Autorização, defina o URL de retorno de chamada como um URL que você controla, onde você pode capturar o código de autorização na Etapa 3 (por exemplo,https://localhost:8080/callback).

  6. Na página Configurações, copie o ID do cliente e o segredo. Esses são os confluenceAppKey confluenceAppSecret e.

Etapa 2: autorizar o aplicativo

Abra o URL a seguir em um navegador, substituindo os espaços reservados pelos seus valores. Faça login com o usuário Atlassian cujo acesso o conector deve usar; o usuário deve ter acesso ao conteúdo do Confluence que você deseja rastrear.

https://auth.atlassian.com/authorize?
audience=api.atlassian.com&
client_id=your-client-id&
scope=read:content:confluence%20read:content-details:confluence%20read:space:confluence%20read:space-details:confluence%20read:user:confluence%20read:attachment:confluence%20read:page:confluence%20read:blogpost:confluence%20read:custom-content:confluence%20offline_access&
redirect_uri=https://localhost:8080/callback&
response_type=code&
prompt=consent

Aprove a solicitação de consentimento. A Atlassian redireciona para sua URL de retorno de chamada com um parâmetro de consulta. code Copie esse código de autorização.

Etapa 3: trocar o código por tokens

Troque o código de autorização por um token de acesso e um token de atualização. Em um terminal, execute:

curl -X POST https://auth.atlassian.com/oauth/token \
  -H "Content-Type: application/json" \
  -d '{
    "grant_type": "authorization_code",
    "client_id": "your-client-id",
    "client_secret": "your-client-secret",
    "code": "authorization-code-from-step-2",
    "redirect_uri": "https://localhost:8080/callback"
  }'

A resposta contém access_token refresh_token e. Registre os dois valores. O token de atualização não expira desde que seja usado regularmente.

Etapa 4: Criar o segredo do Secrets Manager

Armazene as credenciais em um AWS Secrets Manager segredo com os seguintes pares de valores-chave:

{
    "confluenceAppKey": "your-client-id",
    "confluenceAppSecret": "your-client-secret",
    "confluenceAccessToken": "your-access-token",
    "confluenceRefreshToken": "your-refresh-token",
    "hostUrl": "https://your-instance.atlassian.net"
}

Crie o segredo com o AWS Command Line Interface:

aws secretsmanager create-secret \
  --name bedrock-confluence-oauth2-creds \
  --secret-string file://secret.json

Registre o ARN secreto da resposta. Você o usa como fonte de dadossecretArn.

Etapa 5: conceder permissão à função de serviço para atualizar o segredo

Os tokens de acesso da Atlassian expiram após 60 minutos. O Amazon Bedrock usa o token de atualização para criar um novo token de acesso e gravar o novo valor no mesmo segredo. Adicione secretsmanager:PutSecretValue o segredo à política de permissões da função de serviço da sua base de conhecimento:

{
    "Effect": "Allow",
    "Action": "secretsmanager:PutSecretValue",
    "Resource": "arn:aws:secretsmanager:region:account-id:secret:bedrock-confluence-oauth2-creds-*"
}

Sem essa permissão, o conector não pode manter o token de acesso rotacionado e as sincronizações subsequentes falham.

Próximas etapas

Depois de armazenar o segredo, crie a fonte de dados com authType definido comoOAUTH2. Consulte Conecte uma fonte de dados do Confluence.