> ## Documentation Index
> Fetch the complete documentation index at: https://docs.acrity.io/llms.txt
> Use this file to discover all available pages before exploring further.
# Aplicativos conectados
> Instale e gerencie integrações oficiais com provedores de código, PM e colaboração.
Aplicativos conectados são integrações autorizadas por OAuth ou por um app oficial do provedor. Eles simplificam a conexão de repositórios e reduzem a necessidade de tokens manuais. Instalar um deles é um repasse de autorização: você nunca registra ou cria um app por conta própria—a Acrity fornece o app, e você aprova o acesso necessário no provedor.
Use `Console > Aplicativos conectados` para instalar, reautorizar, desconectar e consultar provedores conectados ao workspace.
## Quando usar
Use aplicativos conectados quando:
* o provedor oferece OAuth ou app oficial compatível;
* você quer evitar tokens manuais de longa duração;
* múltiplos repositórios serão conectados a partir da mesma instalação;
* a organização quer controlar permissões pelo próprio provedor;
* você precisa reconectar repositórios depois de mudanças de permissão.
Use `Console > Credenciais` quando um provedor ou caso de uso exigir credencial manual.
## Provedores comuns
| Provedor | Uso típico |
| ------------ | ------------------------------------------------------------------------------------ |
| GitHub | Repositórios, pull requests, permissões via GitHub App ou autorização conectada. |
| GitLab | Repositórios e merge requests em ambientes compatíveis. |
| Bitbucket | Repositórios e pull requests em workspaces Bitbucket. |
| Azure DevOps | Repositórios e pull requests em organizações Azure DevOps. |
| Jira | Gerenciamento de tarefas, campos de PM e comentários associados ao fluxo de revisão. |
| Linear | Issues e contexto de produto para equipes que usam Linear. |
| ClickUp | Tarefas e contexto de produto para equipes que usam ClickUp. |
## Instalar um aplicativo
Instalar um aplicativo conectado é um repasse de autorização OAuth/app. Você escolhe um provedor, a Acrity o envia a esse provedor para entrar e aprovar o acesso, você seleciona a quais repositórios o app pode acessar e o provedor o traz de volta ao Console. Você nunca registra ou cria um app no provedor por conta própria—você apenas autoriza o app que a Acrity já publica.
```mermaid theme={null}
flowchart LR
A[Escolher um provedor
em Aplicativos conectados] --> B[Autorizar no provedor]
B --> C[Selecionar repositórios
para conceder acesso]
C --> D[Aprovar e retornar
ao Console]
```
Acesse `Console > Aplicativos conectados`.
Selecione o provedor que você quer conectar ao workspace.
A Acrity redireciona você para o provedor. Entre e confirme a organização, o workspace ou a instalação correta.
No provedor, escolha a quais repositórios o app pode acessar. Você concede acesso ao app—não há nada a registrar.
Aprove as permissões solicitadas. O provedor traz você de volta ao Console; confirme se a instalação aparece como ativa.
Após a aprovação, use a lista de repositórios autorizados para conectar os projetos desejados (consulte [Conectar repositórios a partir de uma instalação](#conectar-repositórios-a-partir-de-uma-instalação)).
## Reautorizar
Reautorize uma instalação quando:
* o provedor indicar permissão insuficiente;
* a organização mudou políticas de acesso;
* um administrador removeu permissões no provedor;
* novos repositórios não aparecem na lista;
* o Console exibir alerta de aplicativo inválido ou revogado.
Reautorizar executa o mesmo repasse de autorização da instalação: a Acrity envia você de volta ao provedor para reaprovar o acesso e ajustar a quais repositórios o app pode acessar. Você não registra nada.
1. Acesse `Console > Aplicativos conectados`.
2. Abra a instalação do provedor.
3. Escolha `Reautorizar`.
4. No provedor, aprove as permissões solicitadas e atualize o acesso aos repositórios conforme necessário.
5. Volte ao Console e confirme o status.
## Conectar repositórios a partir de uma instalação
Depois que o aplicativo estiver ativo:
1. Acesse `Console > Aplicativos conectados`.
2. Abra a instalação do provedor.
3. Revise os repositórios que o app foi autorizado a acessar no provedor.
4. Selecione os repositórios desejados.
5. Confirme a conexão.
6. Complete as configurações em `Console > Repositórios`.
## Desconectar uma instalação
Desconectar remove o vínculo da Acrity com a instalação selecionada.
Antes de desconectar:
* revise repositórios que dependem da instalação;
* confirme se existe credencial ou conector alternativo;
* avise Admins de workspace;
* revise webhooks ou permissões mantidas no provedor.
Repositórios que dependem da instalação podem deixar de receber revisões até serem reconectados por outro método.
## Aplicativos conectados vs credenciais
| Opção | Melhor quando | Observação |
| -------------------- | ------------------------------------------------------------------------------ | ---------------------------------------------------- |
| Aplicativo conectado | O provedor oferece instalação OAuth ou app oficial. | Preferível para gestão centralizada e reautorização. |
| Credencial manual | O caso de uso exige token, senha, app password ou chave específica. | Use escopo mínimo e revise validade periodicamente. |
| Conector local | O VCS é privado, self-hosted ou deve ser acessado a partir da rede do cliente. | O acesso ao VCS é mediado por um componente local. |
## Problemas comuns
| Sintoma | O que verificar |
| ---------------------------------- | --------------------------------------------------------------------------------- |
| A instalação aparece como inválida | Reautorize o aplicativo e confirme permissões no provedor. |
| Repositório não aparece | Verifique se o repositório foi selecionado/autorizado no provedor. |
| O provedor mostra erro de callback | Confirme se está usando o ambiente correto da Acrity e o app correto no provedor. |
| Não consigo desconectar | Verifique sua função no workspace e pendências de repositórios associados. |
| Permissões insuficientes | Peça a um administrador do provedor para conceder os acessos mínimos necessários. |
## Segurança
A Acrity solicita apenas permissões necessárias para executar os fluxos habilitados. Tokens e credenciais associados a aplicativos conectados seguem a política descrita em `Segurança > Credenciais e tokens`.