Confira os acessos do ambiente

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

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.

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, veja a diferença entre esta aba e Conectores.

A página de 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.

    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.

    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.
    

    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.

    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.

    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.