Tous les produits
Search

Ce produit

    API Gateway:Appeler une API à l'aide de l'authentification simple (AppCode)

    Centre de documentation

    API Gateway:Appeler une API à l'aide de l'authentification simple (AppCode)

    Dernière mise à jour :Aug 09, 2026

    Alibaba Cloud API Gateway propose plusieurs méthodes d'authentification pour les requêtes client, notamment l'authentification par application Alibaba Cloud, les plug-ins JWT et l'autorisation tierce. Pour l'authentification par application Alibaba Cloud, vous pouvez choisir entre deux méthodes : l'authentification par signature et l'authentification simple (AppCode). Cette rubrique explique comment utiliser l'authentification simple (AppCode).

    Précautions

    L'authentification simple supprime la nécessité de processus de signature complexes. Toutefois, elle transmet le AppCode en texte clair sur le réseau, ce qui engendre un risque de sécurité.

    Important

    Vous devez utiliser HTTPS pour la communication entre le client et API Gateway. Évitez d'utiliser HTTP pour la transmission des données. Étant donné que l'authentification simple transmet l'AppCode en texte clair, l'utilisation du protocole HTTP non chiffré expose l'AppCode à un risque élevé de compromission en cas d'interception des paquets réseau.

    Vue d'ensemble

    • Pour plus d'informations sur l'authentification par signature, consultez Appeler une API à l'aide de l'authentification par signature.

    • L'authentification simple (AppCode) authentifie les clients à l'aide d'un AppCode délivré par API Gateway. Le client inclut l'AppCode dans l'en-tête de la requête ou en tant que paramètre de requête pour l'authentification. Cela permet d'appeler rapidement une API.

      1. Créez une API utilisant l'authentification simple (AppCode).

      2. Créez une application pour obtenir un AppCode.

      3. Autorisez l'application à appeler l'API.

      4. Utilisez l'AppCode délivré par API Gateway pour l'authentification.

    Créer une API pour l'authentification AppCode

    1. Connectez-vous à la console API Gateway. Dans le volet de navigation de gauche, choisissez API Management > API Groups. Sur la page API Groups, cliquez sur Create Group dans le coin supérieur droit.

    2. Sur la page Create Group, sélectionnez votre instance API Gateway dans la liste déroulante Instance, saisissez un Group Name et un BasePath, puis cliquez sur OK.

    3. Dans le volet de navigation de gauche, choisissez API Management > APIs. Sur la page APIs, cliquez sur Create API dans le coin supérieur droit.

    4. Sur la page Create API, dans la section Basic Information, sélectionnez le Group que vous avez créé. Saisissez un API Name. Pour Security Authentication, sélectionnez Alibaba Cloud App. Pour AppCode Authentication, sélectionnez Enable AppCode Authentication (Header) ou Enable AppCode Authentication (Header & Query).

      Le tableau suivant décrit les options d'authentification AppCode.

      Option

      Description

      Enable After Publishing to Alibaba Cloud Marketplace

      Cette option est désactivée par défaut. Si l'API est publiée sur Alibaba Cloud Marketplace, vous pouvez activer cette option pour autoriser l'authentification AppCode dans l'en-tête de la requête.

      Disable AppCode Authentication

      L'authentification AppCode est désactivée. Tous les appels d'API doivent utiliser l'authentification par signature, que l'API soit publiée ou non sur Alibaba Cloud Marketplace.

      Enable AppCode Authentication (Header)

      L'authentification AppCode est activée. L'AppCode ne peut être transmis que dans l'en-tête de la requête, que l'API soit publiée ou non sur Alibaba Cloud Marketplace.

      Enable AppCode Authentication (Header & Query)

      L'authentification AppCode est activée. L'AppCode peut être transmis dans l'en-tête de la requête ou en tant que paramètre de requête, que l'API soit publiée ou non sur Alibaba Cloud Marketplace.

    5. Sélectionnez un Signature Algorithm et cliquez sur Next.

    6. À l'étape Define API Request, configurez la requête API. Pour plus d'informations, consultez Définir une requête API. Ensuite, cliquez sur Next.

    7. À l'étape Define Backend Service, configurez le service backend. Pour plus d'informations, consultez Définir les informations du service backend. Ensuite, cliquez sur Next.

    8. À l'étape Define Response, configurez la réponse. Pour plus d'informations, consultez Définir une réponse. Ensuite, cliquez sur Save.

    Remarque

    • Lorsque vous définissez les paramètres de l'API, vous n'avez pas besoin d'ajouter un paramètre pour l'AppCode.

    • Après avoir créé l'API, vous pouvez la publier dans un environnement pour le débogage.

    Créer une application

    1. Connectez-vous à la console API Gateway. Dans le volet de navigation de gauche, choisissez API Call > Apps. Sur la page Apps, cliquez sur Create App dans le coin supérieur droit.

    2. Dans la boîte de dialogue Create App, saisissez un App Name et cliquez sur OK.

    Remarque

    • Un AppCode est généré automatiquement pour chaque nouvelle application. Pour trouver l'AppCode, accédez à la page Apps et cliquez sur le nom d'une application pour ouvrir sa page App Details.

    • Lorsque les utilisateurs d'Alibaba Cloud Marketplace achètent une API, une application est automatiquement créée pour eux.

    Autoriser une application à utiliser une API AppCode

    1. Connectez-vous à la console API Gateway. Dans le volet de navigation de gauche, choisissez API Management > APIs. Sur la page APIs, recherchez l'API que vous avez créée et, dans la colonne Actions, cliquez sur image puis sur Authorize.

    2. Dans la boîte de dialogue d'autorisation, sélectionnez le Stage et définissez la Authorization Validity Period. Sous Select Apps for Authorization, recherchez la section My Apps et cliquez sur Search pour afficher les applications de votre compte. Sélectionnez l'application souhaitée, cliquez sur Add, puis sur OK.

    Authentification à l'aide d'un AppCode

    Vous pouvez fournir l'AppCode de deux manières : dans l'en-tête de la requête ou en tant que paramètre de requête.

    Méthode 1 : Transmettre l'AppCode dans l'en-tête

    • Ajoutez un paramètre Authorization à l'en-tête de la requête.

    • La valeur du champ Authorization doit commencer par APPCODE, suivie d'un espace et de la valeur de l'AppCode. Format :

      Authorization:APPCODE

      Exemple :

      Authorization:APPCODE 3F2504E04F8911D39A0C0305E82C3301
      Important

      Si le service backend est une fonction HTTP, l'en-tête Authorization n'est pas transmis au service backend. Le paramètre Authorization de la fonction HTTP l'écrase. Par conséquent, nous vous recommandons de transmettre l'AppCode en tant que paramètre de requête.

    Méthode 2 : Transmettre l'AppCode en tant que paramètre de requête

    • Ajoutez un paramètre AppCode à la requête. Le nom du paramètre ne respecte pas la casse. Vous pouvez utiliser appcode, appCode, APPCODE ou APPCode.

    • La valeur du paramètre AppCode correspond à la valeur de votre AppCode.

    Exemple :

    http://?AppCode=3F2504E04F8911D39A0C0305E82C3301