Introdução
Para habilitar Kody a realizar code reviews automáticos no Bitbucket Cloud, você precisa gerar um Token de API. Esse token permite que Kody acesse seus repositórios, pull requests, webhooks, issues, pipelines etc., com as permissões específicas listadas abaixo.Gerando o Token de API no Bitbucket
- Acesse diretamente a página de tokens API do Atlassian (ou, no seu perfil Atlassian, navegue até Security → API tokens).
- Clique em Create API token with scopes.
- Dê um nome ao token (por exemplo
kody_code_review) e defina uma data de expiração. - Se solicitado, selecione Bitbucket como aplicativo.
- Selecione todos os escopos necessários (veja abaixo).
- Revise suas escolhas e clique em Create token.
- Copie o token imediatamente e armazene-o com segurança — após a criação você não poderá visualizá-lo novamente.
Escopos Necessários para Kody
O token deve incluir todos os seguintes escopos para funcionalidade completa com Kody:⚠️ Certifique-se de conceder apenas essas permissões necessárias; evite conceder mais do que o necessário para reduzir o risco de segurança.
Adicionando o Token ao Kody
- Uma vez que o token for gerado com todos os escopos necessários, cole-o na tela de configuração de integração/automação do Kody ao habilitar a integração com Bitbucket.
- Certifique-se de que o token tem
admin:repository:bitbucket(ou equivalente) se Kody precisar configurar webhooks ou ouvir eventos de pull request.
Notas Importantes
- O token será exibido apenas uma vez após a criação. Salve-o com segurança, pois você não poderá visualizá-lo novamente.
- Defina uma data de expiração se possível, para limitar o tempo de vida do token.
- Se o token for comprometido, revogue-o imediatamente e crie um novo.
- Audite periodicamente os tokens e seus escopos para confirmar que ainda são necessários e válidos.
- Verifique se o seu plano/conta do Bitbucket permite todos os escopos acima; alguns escopos (projeto, workspace, admin) podem depender da assinatura/permissões.