# Conexão Oracle via DBeaver

Este guia descreve como conectar ao banco de dados Oracle usando o DBeaver, através do proxy seguro do DataDike PAM. Todo o tráfego é auditado automaticamente pelo componente Magnus.

{% hint style="info" %}
Pré-requisitos: Acesso ao DataDike PAM | Ativo Oracle cadastrado no PAM | Autorização criada para o ativo | Conta configurada no ativo
{% endhint %}

## Método 1 — DB Client via Proxy (Recomendado)

O DBeaver instalado na sua máquina conecta ao Oracle através do proxy Magnus do PAM. Todo tráfego é auditado automaticamente.

### Passo a passo

1. Acesse a interface web do DataDike PAM e navegue até a seção **Bancos de Dados**
2. Localize o ativo Oracle ao qual você tem autorização de acesso
3. Clique no ativo e selecione a opção **Cliente DB**
4. O PAM exibirá as informações do proxy Magnus: host, porta, SID/Service Name e credenciais
5. Abra o **DBeaver** e crie uma nova conexão Oracle com os dados fornecidos:
6. No campo **Host**, informe o endereço proxy do PAM
7. No campo **Porta**, use a porta indicada (geralmente 1521)
8. Preencha o **SID / Service Name** conforme exibido
9. Use suas **credenciais do DataDike PAM** (não as do banco diretamente)
10. Clique em **Testar Conexão** para validar e depois em **Concluir**

{% hint style="info" %}
Atenção — Charset: O modo thin do Magnus suporta apenas charset UTF-8 para Oracle. Se o seu banco usa charset non-UTF-8, consulte o administrador do PAM para usar o driver OCI (Oracle Instant Client v21+).
{% endhint %}

## Método 2 — RemoteApp (sem instalação local)

O DBeaver Community já está disponível por padrão na página de Aplicação Remota do PAM. Ele roda no servidor e as credenciais são preenchidas automaticamente — nenhum software precisa ser instalado na sua máquina.

1. Localize o ativo Oracle na seção Bancos de Dados e clique sobre ele
2. Selecione a opção **RemoteApp**
3. Na lista de aplicações, clique em **DBeaver Community** (disponível por padrão)
4. O DBeaver abrirá remotamente com as credenciais do Oracle preenchidas automaticamente
5. Utilize o DBeaver normalmente — todas as sessões ficam registradas no PAM

{% hint style="info" %}
Ideal para acessos pontuais ou em máquinas sem permissão de instalação de software.
{% endhint %}

## Método 3 — Assistente DB

Gera informações de conexão criptografadas para usar no DBeaver ou qualquer outro cliente. Útil quando o PAM Client não está instalado na máquina.

1. Localize o ativo Oracle na seção Bancos de Dados e clique sobre ele
2. Selecione a opção **Assistente DB**
3. Copie as informações geradas: IP/Host, Porta, Usuário e Token de acesso
4. Abra o DBeaver e crie uma nova conexão Oracle usando esses dados
5. Conecte — a conexão passará pelo PAM com criptografia e auditoria completa

## Erros comuns

### ORA-12514 — Listener não reconhece o serviço

Verifique o SID ou Service Name com o administrador do banco. O valor deve ser exatamente igual ao registrado no listener Oracle.

### ORA-01017 — Credenciais inválidas

Confirme que está usando as credenciais do DataDike PAM e não as do banco Oracle diretamente. Verifique também se a conta está configurada corretamente no ativo.

### ORA-12541 — Sem listener

O banco de dados pode estar fora do ar ou a porta está bloqueada por firewall. Verifique com o administrador se o serviço Oracle está ativo e se a porta 1521 está liberada.

### Ativo Oracle não aparece para o usuário

Verifique os seguintes pontos: regra de autorização (Asset Permission) criada para o ativo, usuário incluído na regra, ativo pertence ao nó autorizado e conta de ativo configurada.

Auditoria: Sim — todas as queries são registradas pelo Magnus