# Entenda conexões e permissões OAuth

> Conecte aplicativos com segurança, entenda os acessos solicitados e mantenha o controle das suas permissões na Eqdeal.

- Category: Integrações e agentes de IA
- Type: task
- Audience: All users
- Last reviewed: 2026-08-25
- Canonical HTML: https://tekorax.com/pt-br/help/integrations/oauth-connections/
- Content version: b4ab9c8c9b0c78f6

**A versão curta**

OAuth permite que você conecte um aplicativo ou agente de IA à Eqdeal sem fornecer sua senha da Eqdeal. Você faz login diretamente na Eqdeal, revisa o acesso solicitado e decide se permite.

## O que acontece quando você se conecta

O aplicativo abre a Eqdeal no seu navegador. A Eqdeal confirma quem você é, mostra o nome do aplicativo e explica o que ele quer fazer. Nada é conectado até você escolher Permitir acesso.

1. **Comece pelo aplicativo**
Escolha Conectar, Entrar ou Adicionar Eqdeal dentro do aplicativo ou cliente de IA em que você confia.
2. **Faça login na Eqdeal**
Use e-mail e senha ou continue com o Google. Se você é novo na Eqdeal, pode criar uma conta gratuita sem perder a solicitação de conexão.
3. **Confirme a identidade correta**
Verifique o e-mail da Eqdeal exibido na tela. Use uma conta diferente se o aplicativo deve operar sob outro usuário.
4. **Revise a solicitação**
Leia o nome do aplicativo e cada permissão listada na tela de autorização da Eqdeal.
5. **Permitir ou negar**
Escolha Permitir acesso somente se você reconhecer o aplicativo e os acessos solicitados fizerem sentido. Escolha Negar para voltar sem conectar.

**O login do Google e a autorização na Eqdeal são diferentes**

Continuar com o Google apenas comprova sua identidade para a Eqdeal. Na próxima tela de autorização da Eqdeal, você decide se o aplicativo ou agente externo pode usar seu acesso à Eqdeal.

## Entenda a tela de autorização

**Nome do aplicativo**

Isso identifica o cliente que está solicitando a conexão. Pare se o nome for desconhecido ou diferente do aplicativo de onde você iniciou.

**E-mail conectado**

Este é o usuário da Eqdeal cujas permissões atuais regerão a conexão.

**Permissões solicitadas**

Estas descrevem as categorias de informações que o aplicativo pode ler ou gerenciar após a aprovação.

**Aviso de acesso sensível**

Eqdeal exibe um aviso adicional e pode exigir um novo login quando a solicitação inclui ações societárias de alto impacto.

## Como as permissões realmente funcionam

Uma conexão aprovada ainda precisa passar por duas verificações independentes para cada solicitação. Ter apenas uma nunca é suficiente.

| Permissão | O que controla | Exemplo |
| --- | --- | --- |
| Capacidade OAuth | Se o aplicativo pode solicitar um tipo de ação, como ler empresas ou gerenciar relatórios. | Uma permissão de relatórios não concede gestão da estrutura societária. |
| Seu acesso ao vivo na Eqdeal | Quais empresas, posições de investidor e operações seu usuário logado na Eqdeal pode acessar agora. | O acesso à Empresa A não revela a Empresa B. |

Eqdeal verifica suas permissões em tempo real quando o aplicativo faz uma solicitação. Se seu papel na empresa for reduzido ou removido posteriormente, a conexão não poderá usar o acesso antigo para contornar essa alteração.

### Ler e gerenciar não são a mesma coisa

- **Acesso somente leitura** — permite que o aplicativo recupere informações autorizadas sem alterá-las.
- **Gerencie o acesso** — permite que o aplicativo crie ou atualize registros autorizados específicos e normalmente inclui a leitura relacionada necessária para esse fluxo de trabalho.
- **Ações sensíveis sobre a participação societária** — permanecerão sujeitos a funções empresariais mais rigorosas, autenticação renovada, bloqueios, pré-visualizações, confirmações e outras salvaguardas da Eqdeal quando aplicável.

**A permissão OAuth é um limite, não uma promoção**

Conectar um agente nunca faz de você um administrador da empresa, acionista ou investidor. Ele só pode agir dentro da autoridade que seu usuário Eqdeal já possui.

## Conecte com segurança

- Inicie a conexão pelo aplicativo oficial ou um cliente confiável.
- Confira o nome do aplicativo e seu e-mail da Eqdeal antes de aprovar.
- Prefira o conjunto de permissões menor e útil e reconecte depois se um fluxo de trabalho legítimo precisar de mais.
- Após conectar um agente de IA, primeiro peça para ele listar as empresas e ferramentas disponíveis para você.
- Nomeie explicitamente a empresa pretendida e revise as prévias ou resumos de confirmação antes de fazer alterações.
- Nunca cole sua senha da Eqdeal, senha do Google, código de autorização ou token de acesso em um chat.

## Desconecte ou revogue o acesso

1. Abra o aplicativo conectado ou cliente de IA e encontre suas integrações, conectores ou configurações MCP.
2. Escolha Desconectar, Remover ou Revogar para Eqdeal.
3. Fechar sessões ativas de agentes que ainda possam conter informações previamente retornadas.
4. Reconecte-se somente se ainda reconhecer o aplicativo e precisar das permissões solicitadas.

Se um cliente desconectado ainda parecer capaz de obter novos dados da Eqdeal, entre em contato com [](mailto:) e inclua o nome do aplicativo, seu e-mail da Eqdeal e quando você o desconectou. Nunca envie senhas ou tokens.

## Resolução de problemas

### Vejo o e-mail errado da Eqdeal

Escolha usar uma conta diferente ou cancele a solicitação, saia e reinicie a conexão com o usuário Eqdeal pretendido.

### Ainda não tem uma conta na Eqdeal

Escolha Criar conta. Eqdeal preserva uma solicitação de conexão válida durante o cadastro e retorna você para a autorização em seguida.

### Eqdeal pede para você confirmar sua senha novamente

Isso é esperado para acessos sensíveis. A reautenticação garante que uma sessão recente do navegador sozinha não possa aprovar uma conexão de alto impacto.

### O agente não pode ver uma empresa nem realizar ações

Confirme o usuário ativo da Eqdeal, o papel na empresa, a capacidade solicitada, o status da empresa, a assinatura e qualquer bloqueio temporário do fluxo de trabalho. Reconectar não pode substituir a falta de autoridade na empresa.

### O nome do aplicativo não é familiar

Escolha Negar. Volte para o aplicativo que você pretendia conectar e reinicie pelo fluxo oficial de conexão dele.

### O navegador não retornou para o meu aplicativo

Não aprove repetidamente. Volte ao cliente, verifique se já está conectado e tente novamente uma vez. Se ainda falhar, registre o nome do cliente e o erro antes de contatar o suporte.

## OAuth explicado em linguagem simples

**OAuth** — O processo seguro de autorização usado para conceder acesso limitado sem compartilhar sua senha.

**Capacidade ou escopo** — Uma categoria nomeada de acesso que o aplicativo pode solicitar.

**Consentimento** — Sua aprovação de uma aplicação, recurso e conjunto específicos de capacidades.

**Token** — Uma credencial de curta duração que o aplicativo aprovado usa em vez da sua senha. Trate-a como um segredo.

**Conectando um agente de IA?**

Continue com o [guia de conexão MCP](/pt-br/help/integrations/mcp-agents/) para a configuração específica do agente e as verificações iniciais.
