O pgcrypto é uma extensão do PostgreSQL que adiciona funções de criptografia e hashing, muito utilizada para armazenar dados de forma segura, como senhas, tokens e informações sensíveis. Este guia mostra como habilitar a extensão no seu banco de dados.
Pré-requisitos
- Acesso ao servidor onde o PostgreSQL está instalado
- Usuário com privilégios de superusuário no banco de dados
- Extensão
postgresql-contribinstalada no servidor
Passo 1: Verificar se o pgcrypto está disponível
Antes de habilitar, verifique se a extensão já está disponível na sua instalação do PostgreSQL. No terminal, execute:
psql -U seu_usuario -d seu_banco -c "\dx"
Se o pgcrypto não aparecer na lista, prossiga para o próximo passo.
Passo 2: Instalar o pacote postgresql-contrib (se necessário)
O pgcrypto está incluído no pacote postgresql-contrib. Caso ele não esteja instalado, instale-o no servidor:
No CentOS / AlmaLinux / CloudLinux:
yum install postgresql*-contrib
No Debian / Ubuntu:
apt install postgresql-contrib
Passo 3: Acessar o banco de dados
Abra o cliente psql para o banco onde deseja habilitar o pgcrypto:
psql -U seu_usuario -d seu_banco
Passo 4: Criar a extensão pgcrypto
Dentro do console do PostgreSQL, execute o comando:
CREATE EXTENSION pgcrypto;
Se não houver erros, o pgcrypto foi habilitado com sucesso.
Passo 5: Confirmar a instalação
Para confirmar, rode:
\dx
Você deverá ver algo como:
pgcrypto | 1.3 | public | cryptographic functions
Pronto!
A partir de agora, você pode usar funções como gen_random_uuid(), digest() e crypt() no seu banco de dados PostgreSQL.
