Criar pares de chaves assimétricas

Este guia demonstra como criar pares de chaves assimétricas para o Media CDN.

Gerar chaves

Linha de comando

É possível gerar uma chave privada e uma pública usando o Python 3 e o OpenSSL 1.1.1 ou mais recente (versões anteriores do OpenSSL não oferecem suporte ao Ed25519).

1. Gere a chave privada.

   openssl genpkey -algorithm ed25519 -outform PEM -out test.private.key
   

   Isso gera uma chave privada codificada em PEM. Mantenha essa chave segura, de preferência usando um sistema de gerenciamento de chaves ou o Secret Manager.

2. Gere a chave pública da chave privada no formato base64 seguro para URL.

   openssl pkey -outform DER -pubout -in test.private.key | tail -c +13 | python3 -c "import base64, sys; print(('%s' % base64.urlsafe_b64encode(sys.stdin.buffer.read()))[2:-1])"
   

   Esse comando gera a chave pública da chave privada, removendo as informações do cabeçalho ASN.1 da chave pública bruta.

Python

import base64

from cryptography.hazmat.primitives import serialization
from cryptography.hazmat.primitives.asymmetric import ed25519


def generate_ed25519_keypair(
    private_key_filename: str = "private.key", public_key_filename: str = "public.pub"
) -> None:
    """Generate Ed25519 Keys Pairs.

    Args:
        private_key_filename(default private.key): private key filename as a string.
        public_key_filename(default public.pub): public key filename as a string

    Returns:

    """
    private_key = ed25519.Ed25519PrivateKey.generate()
    public_key = private_key.public_key()

    private_key_str = private_key.private_bytes(
        encoding=serialization.Encoding.Raw,
        format=serialization.PrivateFormat.Raw,
        encryption_algorithm=serialization.NoEncryption(),
    )
    print("Private Key:\t", base64.urlsafe_b64encode(private_key_str))

    public_key_str = public_key.public_bytes(
        encoding=serialization.Encoding.Raw, format=serialization.PublicFormat.Raw
    )
    print("Public Key:\t", base64.urlsafe_b64encode(public_key_str))

    with open(private_key_filename, "wb") as fp:
        fp.write(base64.urlsafe_b64encode(private_key_str))
        print(f"Private Key is written to:\t{private_key_filename}")

    with open(public_key_filename, "wb") as fp:
        fp.write(base64.urlsafe_b64encode(public_key_str))
        print(f"Public Key is written to:\t{public_key_filename}")

Com a chave nesse formato, agora é possível adicioná-la a um conjunto de chaves. Quando o conjunto de chaves está associado a uma rota como um cdnPolicy.signedRequestKeyset, o Media CDN valida se as solicitações foram assinadas antes de veicular qualquer conteúdo.