Pular para o conteúdo principal

VillageSQL is a drop-in replacement for MySQL with extensions.

All examples on this page work on VillageSQL. Install Now →
A RAND() do MySQL gera números pseudoaleatórios para coisas como embaralhar resultados de consultas. Ela não é criptograficamente segura, o que importa quando você está gerando tokens, salts ou nonces. RANDOM_BYTES() preenche essa lacuna, e a extensão vsql_crypto do VillageSQL adiciona gen_random_bytes() e gen_random_uuid() como parte de uma API de criptografia unificada.

As Funções Aleatórias do MySQL

O MySQL fornece duas funções aleatórias embutidas com propósitos muito diferentes: RAND() — Retorna um float pseudoaleatório entre 0 e 1. Rápida e adequada para aplicações sem exigência de segurança: resultados de consulta aleatorizados, amostragem ponderada, seleção aleatória de linhas. Não é criptograficamente segura.
RANDOM_BYTES(n) — Retorna n bytes aleatórios criptograficamente seguros como VARBINARY. Use-a para tokens, salts, nonces e chaves.

Com o VillageSQL: gen_random_bytes() e gen_random_uuid()

A extensão vsql_crypto do VillageSQL adiciona gen_random_bytes() e gen_random_uuid(), que usam a RAND_bytes() do OpenSSL — a mesma fonte de entropia de RANDOM_BYTES().
O principal motivo para usá-las no lugar das funções embutidas é a consistência: quando você já usa digest(), hmac() ou encrypt() da vsql_crypto, manter todas as operações de criptografia em uma única extensão simplifica atualizações e auditoria.

Gerando dados de teste

Funções aleatórias são úteis para popular tabelas de teste:

Tokens de uso único e códigos de convite

Escolhendo a Função Certa

RANDOM_BYTES() e gen_random_bytes() são funcionalmente equivalentes — as duas retornam a mesma qualidade de aleatoriedade. Se você já usa a vsql_crypto, use gen_random_bytes() para manter a sua superfície de criptografia em um só lugar. Se você só precisa de bytes aleatórios e nada mais, a RANDOM_BYTES() do MySQL funciona bem. Se você precisa de um tipo UUID com variantes ordenáveis (v7) e armazenamento binário, use a extensão vsql_uuid em vez de gen_random_uuid(). Consulte UUIDs no MySQL para a comparação completa.

Perguntas Frequentes

A RAND() é segura para gerar tokens?

Não. RAND() é um gerador de números pseudoaleatórios semeado a partir de um estado previsível. Ela serve para ORDER BY RAND() e usos semelhantes sem exigência de segurança, mas tokens gerados com RAND() podem, em teoria, ser previstos. Use RANDOM_BYTES() ou gen_random_bytes() para qualquer coisa sensível à segurança.

De quantos bytes preciso para um token seguro?

32 bytes (256 bits) é o padrão para tokens de sessão e chaves de API. 16 bytes (128 bits) é o mínimo para segurança prática. Use 32 para ficar seguro.

Posso usar gen_random_bytes() como DEFAULT?

Não. O MySQL em si permite funções não determinísticas em expressões DEFAULT — UUID(), RAND() e NOW() funcionam ali. gen_random_bytes() é rejeitada especificamente porque é uma função de extensão do VillageSQL registrada como não determinística, e o VEF bloqueia essas funções em expressões DEFAULT independentemente do que o MySQL em si permite. Em vez disso, gere o valor em cada instrução INSERT.

Qual é a diferença entre gen_random_uuid() e a UUID_V4() da vsql_uuid?

gen_random_uuid() retorna uma string UUID em VARCHAR. A UUID_V4() da extensão vsql_uuid retorna um tipo UUID nativo com armazenamento binário de 16 bytes. Se você usa UUIDs como chaves primárias, prefira UUID_V4() ou UUID_V7() da vsql_uuid. Use gen_random_uuid() quando precisar de uma string UUID e não quiser instalar uma extensão separada.

Solução de Problemas

Veja também