Bancos, usuários e permissões no MySQL
Um usuário do MySQL é identificado pelo nome e pelo host de origem da conexão. O servidor autentica esse acesso e confere os privilégios de cada comando, permitindo que você restrinja o Mautic ao próprio banco.
Ficha e sumário da página
- Referência técnica
- MySQL 8.4.13 LTS
- Revisão
- 13 de novembro de 2026
- Conteúdo
- Documentação oficial consultada
Usuário é nome mais host
O host diz de onde a conexão pode vir, por isso 'mautic'@'localhost' e 'mautic'@'%' são dois usuários diferentes, com senhas e privilégios próprios. O % no host aceita conexão de qualquer endereço. Um usuário criado sem host recebe % automaticamente. O manual do MySQL 8.4 registra que os curingas % e _ no host estão obsoletos e podem sair numa versão futura, mas eles continuam aceitos na série 8.4.
O host importa por causa da forma como o app chega ao servidor. Numa VPS com Docker, o Mautic roda num container e o MySQL em outro, ligados por uma rede interna. A conexão do Mautic chega ao MySQL com o endereço interno do container do app, que muda quando o container é recriado. O curinga % permite esse acesso mesmo quando o endereço muda, mas também aceita outras origens que alcancem o servidor. A rede sem porta publicada limita o acesso externo, enquanto os privilégios delimitam as tabelas disponíveis ao app.
A cada conexão, o servidor percorre um caminho fixo até liberar o comando:
Conexão
mysql:3306O Mautic abre a conexão pela rede interna, com o nome do serviço do banco.
Usuário
'mautic'@'%'O servidor procura o par de nome e host no schema de sistema.
Senha
caching_sha2_passwordO plugin de autenticação do usuário confere a senha enviada.
Privilégios
GRANT ALL ON mautic.*Cada comando é conferido contra os privilégios do usuário no banco citado.
Os níveis de privilégio
Um privilégio libera um tipo de comando num alcance determinado. SELECT libera leitura. INSERT, UPDATE e DELETE liberam escrita. CREATE, ALTER, DROP e INDEX liberam mudanças na estrutura das tabelas. O alcance vem da cláusula ON do comando GRANT e tem níveis, do mais amplo ao mais estreito:
ON *.*Global: vale para todos os bancos do servidor, inclusive os criados depois.ON mautic.*Banco: vale para todas as tabelas do banco do Mautic, e só dele.ON mautic.leadsTabela: vale para uma tabela só, como a de contatos.SELECT (email) ON mautic.leadsColuna: vale para colunas escolhidas de uma tabela.
Os apps desta stack precisam do nível de banco. O Mautic e o WordPress criam e alteram as próprias tabelas na instalação e em cada atualização de versão, por isso o usuário do app recebe todos os privilégios no próprio banco, com GRANT ALL ON mautic.*. Quando esse é o único acesso concedido, o usuário não pode ler as tabelas do WordPress nem as tabelas administrativas do schema mysql. Privilégios globais ou papéis adicionais precisam ser considerados ao conferir essa separação.
O usuário root tem privilégios globais, inclusive o de criar usuários e dar privilégios a eles. Ele serve para administrar o servidor. Um app conectado como root consegue apagar qualquer banco do servidor, então o root fica fora da configuração dos apps.
Papéis no MySQL 8.4
Desde a série 8.0, o MySQL tem papéis, criados com CREATE ROLE. Um papel é um conjunto nomeado de privilégios que você concede a vários usuários de uma vez. Um papel de leitura com SELECT no banco do Mautic, por exemplo, pode ir para o usuário de uma ferramenta de relatório e para o de um painel de métricas. Uma mudança no papel alcança os dois usuários.
O papel concedido a um usuário só vale na sessão quando está ativo. O comando SET ROLE ativa o papel na sessão atual. O SET DEFAULT ROLE faz o servidor ativá-lo em cada conexão nova daquele usuário. Um papel concedido e não ativado explica o acesso negado de um usuário que recebeu o papel e ainda não consegue ler a tabela.
Autenticação na série 8.4
Cada usuário tem um plugin de autenticação, que define como a senha é conferida. O caching_sha2_password é o plugin padrão do MySQL 8.4 e guarda a senha com SHA-256. O plugin antigo, mysql_native_password, foi marcado como obsoleto na série 8.0 e vem desligado a partir do MySQL 8.4.0. Um usuário ainda associado a ele recebe erro se o plugin continuar desligado. Você pode migrar esse usuário para caching_sha2_password com um cliente compatível. A opção mysql_native_password=ON reativa temporariamente o plugin antigo.
Essa mudança aparece na atualização da série 8.0 para a 8.4. A série 5.7 precisa passar pela 8.0, pois a atualização direta para a 8.4 não é suportada. Mesmo quando o servidor inicia, um app com driver incompatível com o plugin configurado pode receber erro de autenticação com a senha correta. A saída duradoura é atualizar o driver do app e recriar a senha do usuário no plugin atual, com ALTER USER, deixando o plugin antigo desligado.
O que a imagem oficial cria
A imagem oficial do MySQL no Docker cria usuários na primeira inicialização de um volume vazio. MYSQL_ROOT_PASSWORD define a senha do root. MYSQL_DATABASE cria um banco. MYSQL_USER com MYSQL_PASSWORD cria um usuário com todos os privilégios nesse banco. Essas variáveis só agem quando a pasta do banco está vazia: com o volume já criado, mudar a senha no arquivo .env não altera a senha guardada no servidor, que muda com ALTER USER.
Com o Mautic e o WordPress no mesmo servidor, cada app ganha o próprio banco e o próprio usuário. A imagem cria só o primeiro par pelas variáveis. O segundo sai de um script SQL na pasta /docker-entrypoint-initdb.d, que a imagem executa na mesma primeira inicialização, ou de um CREATE USER seguido de GRANT feito pelo root. As variáveis estão descritas na referência de variáveis de ambiente do MySQL.