generateKeyPair

Gera um par de chaves RSA.

Sintaxe

string, string generateKeyPair ( string algoritmo, table opcoes [, function callback ] )

Parâmetros

Nome	Tipo	Padrão	Descrição
algoritmo	string	—	Único valor aceito: "rsa", sem diferenciar maiúsculas de minúsculas.
opcoes	table	—	Precisa conter size, o tamanho da chave em bits. Mínimo de 256.
callback	function	—	Se informada, recebe as duas chaves e generateKeyPair devolve true.

Retorno

Dois valores, nesta ordem:

Posição	Descrição
1	Chave privada.
2	Chave pública.

Em caso de falha devolve apenas false, com o motivo no console de debug.

Cuidado

A chave privada vem primeiro. Inverter a ordem das duas variáveis publica sua chave privada, então confira essa linha com atenção.

As duas chaves são strings binárias. Para gravá-las em um arquivo ou em um banco, passe antes por encodeString("base64", chave).

Gerar uma chave é uma operação demorada e o servidor fica parado enquanto ela acontece — com 2048 bits isso pode levar segundos. Gere o par uma única vez, guarde e reutilize; nunca gere dentro de um timer ou a cada requisição.

Exemplo

local privada, publica = generateKeyPair("rsa", { size = 2048 })

if not privada then
    outputDebugString("não foi possível gerar o par de chaves", 1)
    return
end

-- quem tem a chave pública cifra
local cifrado = encodeString("rsa", "mensagem", { key = publica })

-- só quem tem a chave privada consegue abrir
local aberto = decodeString("rsa", cifrado, { key = privada })

Nota

RSA só cifra mensagens curtas — bem menores que o tamanho da chave. Para conteúdos maiores, cifre o conteúdo com aes128 e use RSA apenas para proteger a chave AES.

Veja também

• md5 — Calcula o hash MD5 de uma string.
• sha256 — Calcula o hash SHA-256 de uma string.
• hash — Calcula o hash de uma string com o algoritmo escolhido.
• teaEncode — Cifra uma string com XTEA e devolve o resultado em Base64.
• teaDecode — Desfaz um teaEncode.
• encodeString — Codifica ou cifra uma string com o algoritmo escolhido.
• decodeString — Desfaz um encodeString.