Ir para o conteúdo
Promovaweb

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
  1. Usuário é nome mais host
  2. Os níveis de privilégio
  3. Papéis no MySQL 8.4
  4. Autenticação na série 8.4
  5. O que a imagem oficial cria

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:

  1. Conexão

    mysql:3306

    O Mautic abre a conexão pela rede interna, com o nome do serviço do banco.

  2. Usuário

    'mautic'@'%'

    O servidor procura o par de nome e host no schema de sistema.

  3. Senha

    caching_sha2_password

    O plugin de autenticação do usuário confere a senha enviada.

  4. Privilégios

    GRANT ALL ON mautic.*

    Cada comando é conferido contra os privilégios do usuário no banco citado.

O caminho de uma conexão do Mautic até a primeira consulta no MySQL 8.4: identificação, autenticação, sessão e conferência de privilégios a cada comando.

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.

StayCloud

Uma VPS para desenvolver com agentes

Servidor da StayCloud em São Paulo, com acesso root e disco NVMe, para deixar seus agentes de IA rodando o dia todo.

Montar minha VPS

Link de parceiro da Promovaweb.