> ## Documentation Index
> Fetch the complete documentation index at: https://docs.saninternet.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Administração do Banco de Dados

> Liga e desliga a ferramenta que abre os bancos de dados pelo navegador, escolhe qual é ela, phpMyAdmin ou Adminer, e define para onde apontam os links do painel.

**Caminho no painel:** menu da esquerda > Configuração > cartão **Ferramentas** >
**Administração do Banco de Dados**

![Tela Administração do Banco de Dados: a caixa Sim, o seletor do cliente e o campo URL de acesso customizada](https://mintcdn.com/san-internet/uqy6kUqe17ldMjVV/keyhelp-admin/imagens/ferramentas-banco-de-dados.png?fit=max\&auto=format\&n=uqy6kUqe17ldMjVV\&q=85\&s=af097a1f452ae03b5aa87519b4591af6)

1. Ajuste os campos.
2. Clique em **Salvar**.

| Campo | Vem com | O que faz |
| - | - | - |
| **O cliente de administração de banco de dados está ativado** | marcado | liga ou desliga a ferramenta para o servidor inteiro |
| **Cliente de administração de banco de dados** | **phpMyAdmin 5.2.3** | a ferramenta. A outra opção é **Adminer 6.0.1** |
| **URL de acesso customizada** | vazio | um endereço de ferramenta que não é a deste servidor, para os links do painel |

## Onde a ferramenta fica

No menu da esquerda, **FERRAMENTAS** > **Interface Web do Banco de Dados** abre a
ferramenta numa aba nova, no endereço `/db/` do servidor. O mesmo item existe no
menu do cliente. Como entrar nela, e o bloqueio por senha errada, está em
[Interface Web do Banco de Dados](/keyhelp-admin/interface-web-do-banco-de-dados).

**Conferido: o endereço abre para qualquer navegador, sem sessão do painel.** Quem
chega nele vê a tela de entrada da ferramenta, que pede o usuário e a senha **do
banco de dados**. A barreira é essa senha, e não o login do painel. A ferramenta
responde por quatro endereços iguais: `/db/`, `/phpmyadmin/`, `/pma/` e
`/db-administration/`.

> [!NOTE]
>
> **Um teste feito com `curl` recebe acesso proibido, e o navegador não**
>
> O phpMyAdmin instalado pelo painel recusa, com **403**, programas que se
> apresentam como `curl`, `wget`, `python` e outros robôs. Medido: o mesmo
> endereço respondeu 403 para o `curl` e 200 para um navegador. Quem testar de
> linha de comando pode achar que o endereço está fechado, e não está.

## Desligar

**Conferido, desmarcando e salvando.** Vale na hora, e o painel responde *"As
configurações foram atualizadas."*

* o item **Interface Web do Banco de Dados** some do menu do administrador e do menu do cliente
* os quatro endereços passam a responder **403**, acesso proibido

Marcar de novo e salvar devolve tudo, também na hora. Conferido pela data dos
arquivos: entre a configuração do servidor web e as pastas das duas ferramentas,
**só as pastas das ferramentas mudaram**. Desligar tira do ar a ferramenta de
navegador, e não os bancos de dados.

## Trocar para o Adminer

**Conferido, ida e volta.** A troca é aplicada pela tarefa de fundo do minuto
seguinte, e o painel responde *"As configurações foram atualizadas. As alterações
terão efeito em alguns instantes."* Depois dela, o mesmo `/db/` passou a abrir a
tela de entrada do **Adminer**, também pedindo usuário e senha. A volta para o
phpMyAdmin funcionou igual.

## Entrar sem digitar senha, pela tela do cliente

Na área do cliente, em **Banco de dados**, cada banco da lista tem o ícone
**Interface Web do Banco de Dados**, o símbolo de banco de dados entre o lápis e a
lixeira. Ele abre a ferramenta numa aba nova, **já logada**.

**Medido com as duas ferramentas**, num banco criado para o teste:

| O quê | phpMyAdmin | Adminer |
| - | - | - |
| Pede senha | não | não |
| Entra como | um usuário temporário que o painel cria no servidor de banco, `_keyhelp_auto_login_` e um código | o mesmo tipo de usuário temporário |
| Enxerga | **só aquele banco**, com todas as permissões sobre ele | **só aquele banco** |

O usuário do banco, o que o cliente criou com senha, não é usado nessa entrada.
**Sair** da ferramenta volta para a tela de login dela, e não para o painel.

> [!WARNING]
>
> **Cada clique deixa mais um usuário no servidor de banco**
>
> Medido: três cliques no ícone criaram três usuários temporários, cada um com
> todas as permissões sobre o banco, e **sair da ferramenta não apagou nenhum**. O
> painel anota cada um numa tabela própria, com a hora da criação. Nenhum registro
> das tarefas de fundo fala em apagá-los.
>
> A tabela do painel guarda só o banco, o nome do usuário temporário e a hora, e
> não a senha dele.
>
> **Apagar o banco não apaga esses usuários, e eles herdam o próximo banco com o
> mesmo nome.** Medido: o banco e o usuário dele sumiram na hora, e os três
> temporários continuaram, com todas as permissões gravadas **para o nome do banco
> apagado**. O servidor de banco guarda permissão pelo nome, e o painel reaproveita
> o nome: com a conta sem nenhum banco, o banco criado em seguida nasceu com o
> mesmo nome, e **as permissões dos três passaram a valer para ele**, um banco que
> nenhum deles abriu.
>
> O que se mediu é a permissão gravada. A senha desses usuários não fica na tabela
> do painel nem aparece para o cliente, e ninguém entrou com eles.
>
> **O painel remove esses usuários sozinho, depois de um tempo, sem registrar.**
> Medido: os três continuavam **1 hora e 7 minutos** depois de criados, mesmo
> rodando na hora, em **Intervalos de Manutenção**, as tarefas de limpeza, de
> espaço em disco e de estatísticas; **3 horas e 25 minutos** depois, tinham sumido
> do servidor de banco e da tabela do painel. Sair do painel e **Voltar ao
> administrador** não os apagam: um usuário novo continuou lá depois dos dois.

## URL de acesso customizada

**Conferido com um endereço inventado.** A mudança vale na hora, sem a tarefa do
minuto, e troca o link **Interface Web do Banco de Dados** do menu do
administrador e do menu do cliente. **O painel não confere se o endereço existe.**
A ferramenta do próprio servidor continua respondendo em `/db/`: só os links
mudam.

Para voltar, apague o campo e clique em **Salvar**.

## O que pode dar errado

| Sintoma | Causa | O que fazer |
| - | - | - |
| **O item Interface Web do Banco de Dados sumiu do menu** | a ferramenta foi desligada nesta tela | marcar a primeira caixa e salvar |
| `/db/` responde acesso proibido no navegador | a ferramenta está desligada | marcar a primeira caixa e salvar |
| `/db/` responde acesso proibido para um script, e abre no navegador | o phpMyAdmin recusa programas como `curl` e `wget` | testar pelo navegador |
| O link do menu leva a um endereço que não abre | a **URL de acesso customizada** aponta para um lugar que não responde | apagar o campo e salvar |
| Troquei a ferramenta e o `/db/` ainda abre a antiga | a troca espera a tarefa de fundo do minuto seguinte | esperar um minuto e abrir de novo |
| O servidor de banco tem vários usuários `_keyhelp_auto_login_` | cada clique do cliente no ícone do banco cria um, e cada entrada do administrador pelo **Status do Sistema** cria outro, este com permissão em todos os bancos; eles só somem horas depois | são do painel, e ele mesmo os remove. Enquanto não somem, os de banco apagado têm permissão para o nome dele, e o do administrador, para todos |

## Ver também

* [Interface Web do Banco de Dados](/keyhelp-admin/interface-web-do-banco-de-dados), o item do menu que abre a ferramenta, e a entrada do administrador sem senha
* [Servidor do Banco de Dados](/keyhelp-admin/servidor-do-banco-de-dados), os ajustes do próprio servidor de banco
* [Webmail (configuração)](/keyhelp-admin/config-webmail), a outra ferramenta de navegador deste cartão, com os mesmos três primeiros campos


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.