Function Compute:Configurar autenticação JWT para um nome de domínio personalizado

Etapa 1: Abrir as configurações do nome de domínio personalizado

1. Faça login no console do Function Compute. No painel de navegação à esquerda, escolha Advanced Features > Custom Domains.

2. Na barra de navegação superior, selecione a região onde reside seu nome de domínio personalizado.

3. Na página Custom Domains, clique em o nome de domínio que deseja configurar.

4. No canto superior direito, clique em Modify.

Etapa 2: Ativar a autenticação JWT

Na página Modify Custom Domain Name, defina Authentication Method como JWT Authentication.

Etapa 3: Configurar o JWKS

A autenticação JWT exige um JWKS válido contendo sua chave pública. Gere um usando ferramentas online como mkjwk.org. Caso já possua uma chave privada no formato PEM, utilize uma ferramenta como jwx para convertê-la ao formato JWKS.

Para gerar um JWKS no mkjwk.org: defina Key Use, Algorithm e Show X.509, depois clique em Generate. A ferramenta produz duas chaves:

• ① Chave privada — use-a em seu código para assinar (emitir) tokens JWT. Mantenha-a confidencial.

• ② Chave pública — cole-a no array keys no console do Function Compute.

O JWKS colado no console segue esta estrutura:

{
    "keys": [
        {
            "alg": "RS256",
            "e": "AQAB",
            "kty": "RSA",
            "n": "u1LWgoomekdOMfB1lEe96OHehd4XRNCbZRm96RqwOYTTc28Sc_U5wKV2umDzolfoI682ct2BNnRRahYgZPhbOCzHYM6i8sRXjz9Ghx3QHw9zrYACtArwQxrTFiejbfzDPGdPrMQg7T8wjtLtkSyDmCzeXpbIdwmxuLyt_ahLfHelr94kEksMDa42V4Fi5bMW4cCLjlEKzBEHGmFdT8UbLPCvpgsM84JK63e5ifdeI9NdadbC8ZMiR--dFCujT7AgRRyMzxgdn2l-nZJ2ZaYzbLUtAW5_U2kfRVkDNa8d1g__2V5zjU6nfLJ1S2MoXMgRgDPeHpEehZVu2kNaSFvDUQ",
            "use": "sig"
        }
    ]
}

Etapa 4: Configurar a localização do token JWT

Na seção JWT Token Configuration, defina a Read Position (Header, Cookie, Query Parameters ou Form Parameters) e o nome do parâmetro onde o Function Compute deve buscar o token.

Se você definir a Read Position como Header, especifique um valor para Remove Prefix. O Function Compute remove esse prefixo antes de analisar o token. Por exemplo, se o prefixo for definido como Bearer, um cabeçalho de solicitação Authorization: Bearer <token> fará com que o Function Compute extraia e valide apenas <token>.

Etapa 5: Configurar o encaminhamento de claims (opcional)

Na seção JWT Claim Conversion, mapeie as claims do JWT para parâmetros da função. Para cada mapeamento, especifique:

• Mapping Parameter Position — para onde encaminhar a claim (Header, Cookie, Query Parameters ou Form Parameters)

• O nome original da claim no token

• O nome do parâmetro passado para a função

Etapa 6: Salvar a configuração

Clique em Save.

Gerar um token de teste

1. Instale o módulo PyJWT. Consulte PyJWT.

2. Execute o script Python abaixo localmente para gerar um token. Substitua o placeholder da chave privada pela chave privada X.509 PEM obtida na etapa de geração do JWKS.

import jwt
import time

private_key = """
-----BEGIN PRIVATE KEY-----
<Your X.509 PEM private key>
-----END PRIVATE KEY-----
"""

headers = {
    "alg": "RS256",
    "typ": "JWT"
}

payload = {
    "sub": "1234567890",
    "name": "John Snow",
    "iat": int(time.time()),              # Token issuance time
    "exp": int(time.time()) + 60 * 60,   # Token expires in 1 hour
}

encoded = jwt.encode(payload=payload, key=private_key.encode(), headers=headers)
print("Generated token: %s" % encoded)

Testar com o Postman

1. No console do Function Compute, acesse Advanced Features > Custom Domains. Copie seu nome de domínio personalizado e cole-o no campo URL do Postman.

2. Adicione um cabeçalho de solicitação correspondente às suas configurações de JWT Token Configuration. Por exemplo, se o nome do parâmetro for Authentication e o prefixo for Bearer:

   Importante

   Certifique-se de que a formatação do JWT no cabeçalho da solicitação esteja alinhada com as configurações de Remove Prefix. Em caso de divergência, será retornado o erro invalid or expired jwt.

   Parâmetro	Valor	Descrição
   Key	Authentication	Nome do parâmetro configurado em JWT Token Configuration
   Value	Bearer <your-jwt-token>	Prefixo configurado, seguido de espaço e do token gerado na etapa anterior

3. Clique em Send e verifique a resposta.

Se o encaminhamento de claims estiver configurado, a resposta confirmará que a claim foi passada para a função. Por exemplo, nametofunction representa o nome do parâmetro encaminhado a partir do mapeamento de claims.