Como soluciono problemas de conexão entre a instância do Confluence Cloud e minha base de conhecimento do Amazon Bedrock?

Resolução

Você pode receber a seguinte mensagem de erro de conexão durante o processo de configuração ou ingestão de dados:

"There was an issue when connecting to your data source. Please check your data source credentials in Secrets Manager to ensure they are correct and provide the necessary permissions."

Verificar o URL da instância do Confluence Cloud

Ao conectar sua instância do Confluence ao Amazon Bedrock, certifique-se de que o URL da instância do Confluence esteja correto. O Amazon Bedrock é compatível somente com URLs do Confluence que terminam com .atlassian.net. O Amazon Bedrock não aceita domínios personalizados.

Configurar corretamente o método de autenticação

O Amazon Bedrock é compatível com os tipos de autenticação básica e OAuth 2.0 para conexões do Confluence Cloud.

Autenticação básica

Para configurar a autenticação básica, crie um token de API. Para mais informações, consulte Manage API tokens for your Atlassian account (Gerenciar tokens de API da sua conta Atlassian) no site da Atlassian.

Observação: por padrão, os tokens da API Atlassian expiram após 1 ano.

Em seguida, crie um segredo do AWS Secrets Manager para armazenar suas credenciais.

Autenticação com OAuth 2.0

Para configurar o OAuth 2.0, consulte OAuth 2.0 Configuration for Confluence (Configuração do OAuth 2.0 para Confluence) no site da Atlassian.

Em seguida, crie um segredo do Secrets Manager para armazenar as seguintes credenciais:

• confluenceAppKey
• confluenceAppSecret
• confluenceAccessToken
• confluenceRefreshToken

Verificar as permissões do perfil do IAM

Anexe uma política para fornecer permissões para o perfil do AWS Identity and Access Management (AWS IAM) que você associou à base de conhecimento para acessar sua fonte de dados do Confluence.

Confirmar se os segredos podem acessar o Amazon Bedrock

Conclua as etapas a seguir:

1. Abra o console do Secrets Manager.
2. Selecione o segredo.
3. Confirme se o nome do recurso da Amazon (ARN) está no formato arn:aws:secretsmanager:REGION:account-id:secret:amazonbedrock-name.
   Observação: substitua REGION pela sua região da AWS, account-id pelo ID da sua conta da AWS e name pelo nome do seu segredo.

Testar o acesso ao token da API

Para testar o acesso ao token, execute o seguinte comando curl em uma instância do Amazon Elastic Compute Cloud (Amazon EC2):

curl -v https://yourcompany.atlassian.net --user your-email@example.com:your-api-token

Observação: substitua yourcompany pelo nome da sua empresa, seu-email@exemplo.com pelo e-mail da sua empresa e your-api-token pelo token da API. Se você compartilhar a saída com o AWS Support, substitua your-api-token por REDACTED.

Se o comando curl der certo, o código de status HTTP 200 OK estará no cabeçalho da resposta e haverá conteúdo da instância do Confluence no corpo da resposta. Além disso, não há mensagens de erro "401 Unauthorized" ou tempo limite de conexão.

Remover listas de permissões de IP no Confluence

O Amazon Bedrock não é compatível com listas de permissões de IP ou VPNs. Se você adicionou uma lista de permissões de IP no Confluence, remova-a para que a conexão de rede não falhe.

Se a configuração da sua rede exigir uma lista de permissões de IP, use o Web Crawler fornecido pelo Amazon Bedrock.

Para obter informações sobre como manter sua base de conhecimento segura, consulte Segurança no Amazon Bedrock.

Configurar destinos de log para monitorar problemas

Para monitorar e solucionar problemas de ingestão, configure o Amazon CloudWatch Logs ou o Amazon S3 como destino de log.