Function Compute:Configurer l'authentification JWT pour un nom de domaine personnalisé

Étape 1 : Ouvrir les paramètres du nom de domaine personnalisé

1. Connectez-vous à la console Function Compute. Dans le volet de navigation de gauche, choisissez Advanced Features > Custom Domains.

2. Dans la barre de navigation supérieure, sélectionnez la région où réside votre nom de domaine personnalisé.

3. Sur la page Custom Domains, cliquez sur le nom de domaine que vous souhaitez configurer.

4. Dans le coin supérieur droit, cliquez sur Modify.

Étape 2 : Activer l'authentification JWT

Sur la page Modify Custom Domain Name, définissez Authentication Method sur JWT Authentication.

Étape 3 : Configurer le JWKS

L'authentification JWT nécessite un JWKS valide contenant votre clé publique. Vous pouvez en générer un à l'aide d'un outil en ligne tel que mkjwk.org. Si vous disposez d'une clé privée au format PEM, utilisez un outil comme jwx pour la convertir au format JWKS.

Pour générer un JWKS sur mkjwk.org : définissez Key Use, Algorithm et Show X.509, puis cliquez sur Generate. L'outil produit deux clés :

• ① Clé privée — utilisez-la dans votre code pour signer (émettre) les jetons JWT. Gardez-la confidentielle.

• ② Clé publique — collez-la dans le tableau keys de la console Function Compute.

Le JWKS que vous collez dans la console suit cette structure :

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

Étape 4 : Configurer l'emplacement du jeton JWT

Dans la section JWT Token Configuration, définissez Read Position (Header, Cookie, Query Parameters ou Form Parameters) et le nom du paramètre où Function Compute doit rechercher le jeton.

Si vous définissez Read Position sur Header, spécifiez une valeur pour Remove Prefix. Function Compute supprime ce préfixe avant d'analyser le jeton. Par exemple, si vous définissez le préfixe sur Bearer, un en-tête de requête Authorization: Bearer <token> amène Function Compute à extraire et valider <token>.

Étape 5 : Configurer la transmission des revendications (facultatif)

Dans la section JWT Claim Conversion, mappez les revendications JWT aux paramètres de la fonction. Pour chaque mappage, spécifiez :

• Mapping Parameter Position — emplacement vers lequel transmettre la revendication (Header, Cookie, Query Parameters ou Form Parameters)

• Le nom d'origine de la revendication dans le jeton

• Le nom du paramètre transmis à la fonction

Étape 6 : Enregistrer la configuration

Cliquez sur Save.

Générer un jeton de test

1. Installez le module PyJWT. Consultez PyJWT.

2. Exécutez le script Python suivant localement pour générer un jeton. Remplacez l'espace réservé de la clé privée par la clé privée X.509 PEM issue de l'étape de génération du 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)

Tester avec Postman

1. Dans la console Function Compute, accédez à Advanced Features > Custom Domains. Copiez votre nom de domaine personnalisé et collez-le dans le champ URL de Postman.

2. Ajoutez un en-tête de requête correspondant à vos paramètres JWT Token Configuration. Par exemple, si le nom du paramètre est Authentication et le préfixe est Bearer :

   Important

   Assurez-vous que le formatage du JWT dans l'en-tête de la requête correspond aux paramètres Remove Prefix configurés. En cas de divergence, une erreur invalid or expired jwt est renvoyée.

   Paramètre	Valeur	Description
   Key	Authentication	Le nom du paramètre configuré dans JWT Token Configuration
   Value	Bearer <your-jwt-token>	Le préfixe configuré, un espace et le jeton généré à l'étape précédente

3. Cliquez sur Send et vérifiez la réponse.

Si la transmission des revendications est configurée, la réponse confirme que la revendication a été transmise à la fonction. Par exemple, nametofunction est le nom du paramètre transmis issu du mappage des revendications.