# Confira os acessos do ambiente

Delimite ambiente, dados e ações antes de configurar uma integração ou autorizar uma tarefa técnica.

Fonte: https://guides.adapta.org/guias/maestro/recursos-do-maestro/integracoes/permissoes/

**TL;DR** · Confirme o recurso, o ambiente e as ações permitidas antes de conectar. Uma instrução de “somente leitura” não reduz tecnicamente uma permissão já concedida. O roteiro abaixo prepara essa decisão; não configura nem testa integrações.

![Gravação do Maestro: na página Conectores, a aba Integrações é aberta e a lista mostra GitHub, Claude Code, AWS assume role, Datadog e AWS EKS, cada um com a descrição do tipo de acesso e um botão Conectar que não é acionado.](https://guides.adapta.org/media/screenshots/maestro/integracoes-permissoes-2026-09-19/maestro-integracoes-aba-fluxo.gif)

*A aba Integrações fica ao lado de Conectores e lista outro tipo de acesso: CLI autenticada e papel de nuvem, não conector de serviço. Ler a lista não conecta nada.*

## Antes de começar

Tenha o responsável técnico por perto quando o trabalho envolver repositórios, nuvem ou clusters. Separe um ambiente de teste e dados fictícios. Não use produção para descobrir o que um botão faz.

Na [visão geral](https://guides.adapta.org/guias/maestro/recursos-do-maestro/integracoes/), veja a diferença entre esta aba e Conectores.

A página de [Conectores](https://guides.adapta.org/guias/maestro/recursos-do-maestro/conectores/) também organiza as quatro formas de credencial usadas nas duas abas (OAuth do serviço, token/API key, CLI autenticada e papel de nuvem). Identifique qual delas a opção escolhida exige antes de responder às perguntas abaixo.

1. **Localize a opção sem iniciar a conexão**

    Abra **Conectores** na lateral e selecione **Integrações**. Leia o nome e a descrição da opção pertinente. Consultar essa lista não exige clicar em **Conectar**.

    A descrição de cada item diz o tipo de acesso que ele monta, e é aí que a diferença entre as duas abas aparece por escrito. O item **GitHub** desta aba é a `gh` CLI autenticada mais uma skill de comandos, e a própria descrição encaminha quem quer tools nativas por OAuth para o conector GitHub, na outra aba. **AWS (assume role)** assume um papel IAM via STS. **AWS EKS** monta o kubeconfig do cluster no boot. São acessos ao ambiente onde o agente roda, não integrações com um serviço isolado.

![Aba Integrações com GitHub, Claude Code, AWS (assume role), Datadog e AWS EKS listados, cada um com a descrição do tipo de acesso.](https://guides.adapta.org/media/screenshots/maestro/integracoes-permissoes-2026-09-19/integracoes-lista-2026-09-19.png)

    *Na aba: **1** Integrações ao lado de Conectores, **2** a descrição, que diz qual acesso o item monta, e **3** Conectar, que este passo não aciona.*

    Registre se o pedido exige essa integração ou apenas a análise de material fornecido. Não escolha uma opção porque ela parece mais poderosa.

2. **Defina o limite com o responsável**

    Antes de configurar, responda:

    - Qual conta, repositório ou ambiente está em escopo?

    - Quais dados podem ser consultados? Quais ficam de fora?

    - A tarefa precisa ler, criar, alterar ou executar algo? Quem autorizou cada ação?

    - Qual resultado comprova conclusão e quando o agente deve parar?

    - Como serão verificadas as permissões reais, além das instruções escritas?

    Não cole tokens, senhas, chaves, arquivos de autenticação ou configurações com segredos no chat, em Skills ou em exemplos. O campo e o destino corretos devem ser confirmados no fluxo autorizado. Armazenamento, criptografia e duração desses acessos exigem confirmação própria, além da presença do campo.

![Compositor do Maestro com as cinco respostas do responsável digitadas: escopo em homologação, dados permitidos e proibidos, somente leitura, resultado que encerra a tarefa e como conferir as permissões reais.](https://guides.adapta.org/media/screenshots/maestro/passos-2026-09-22/ip-limite-2026-09-22.png)

    *Cinco respostas antes de configurar: **1** escopo, dados e tipo de acesso e **2** resultado esperado e conferência das permissões. Sem token, senha ou chave no chat.*

3. **Prepare um pedido sem efeito externo**

    Use o cenário abaixo como exercício de planejamento. Ele é sintético e não representa uma consulta real ao GitHub, Datadog ou AWS.

````
Prepare uma pauta de decisão para uma implantação fictícia.
Use somente o relatório abaixo. Não consulte sistemas externos,
execute comandos, conecte recursos ou altere qualquer ambiente.

RELATÓRIO APROVADO · versão 09/09/2026
Serviço: Portal Aurora, ambiente de homologação.
Testes funcionais: 38 aprovados, 2 reprovados, 40 executados.
Falhas: envio de confirmação e recuperação de senha.
Revisão de segurança: ainda não realizada.
Janela proposta: sexta-feira, sem aprovação do responsável.
Responsáveis e prazo de correção: não informados.

Entregue:
1. Fatos confirmados, com referência ao relatório.
2. Taxa de aprovação dos testes e cálculo.
3. Bloqueios e perguntas para o responsável.
4. Dados mínimos para uma futura consulta autorizada.

Não conclua que o serviço está pronto para produção.
Não invente causas, nomes, prazos ou aprovação.
Não transforme a pauta em autorização de implantação.

````

    **Dica prática:** especifique o que a resposta deve conter e o que não pode concluir. Como Criar Assistentes de IA, aula 4, separa regras, insumos e formato de saída. Neste pedido, o relatório é a fonte; a decisão de implantação continua com o responsável.

![Compositor do Maestro com o pedido de pauta de decisão digitado, usando só o relatório aprovado do Portal Aurora: 38 testes aprovados de 40, duas falhas, revisão de segurança pendente e janela não aprovada.](https://guides.adapta.org/media/screenshots/maestro/passos-2026-09-22/ip-pedido-2026-09-22.png)

    *Pedido sem efeito externo: **1** a proibição de consultar, executar, conectar ou alterar e **2** o relatório aprovado como única fonte.*

4. **Confira o planejamento antes de autorizar ações**

    O gabarito do exercício é **95% de aprovação**: 38 ÷ 40 × 100. Há duas falhas identificadas, revisão de segurança pendente e janela ainda não aprovada.

    A resposta deve pedir responsáveis, critérios de liberação e informações sobre os bloqueios, sem inventar as respostas. Uma futura consulta precisa delimitar ambiente e fontes; não precisa começar com acesso irrestrito.

    Este gabarito confere a análise dos dados fornecidos, não o funcionamento de uma integração. Para declarar uma integração testada, será necessário executar uma tarefa autorizada, conferir sua saída e registrar os efeitos e limites. Essa etapa permanece pendente.

![Compositor do Maestro com a conferência do planejamento digitada: 38 dividido por 40 vezes 100 igual a 95%, duas falhas, revisão pendente, janela não aprovada e a delimitação da consulta futura.](https://guides.adapta.org/media/screenshots/maestro/passos-2026-09-22/ip-confira-2026-09-22.png)

    *Conferir antes de autorizar: **1** o percentual com a conta e **2** o que a resposta precisava pedir sem inventar. A integração, quando vier, começa delimitada.*

## Se aparecer um erro ou uma autorização inesperada

Pare antes de ampliar o acesso. Registre recurso, etapa, horário e mensagem sem segredos. Peça ao responsável a conferência da conta e do ambiente. Não tente outra credencial, instalação ou alteração de permissões como consequência automática de um erro.

Veja outras rotinas nos [casos de uso do Maestro](https://guides.adapta.org/guias/casos-de-uso/por-plataforma/maestro/).