Vous consultez la documentation d'Apigee Edge.
Accédez à la documentation sur Apigee X. info
Le portail des développeurs est directement prêt à l'emploi pour permettre aux développeurs d'applications de s'inscrire, de se connecter et de gérer les applications qui consommeront vos API.
Les sections suivantes décrivent comment les développeurs d'applications interagissent avec votre portail:
Comment l'enregistrement et la connexion des développeurs d'applications sont suivis dans Edge
L'enregistrement des développeurs et la connexion au portail sont suivis à l'aide de l'attribut personnalisé _apiportal dans Edge.
Lorsqu'un développeur s'enregistre automatiquement, l'attribut personnalisé _apiportal est ajouté à sa configuration, et son état est défini sur unverified pour indiquer qu'il ne s'est pas connecté au portail. Par exemple : {"status":"unverified","portals":{}}.
La première fois que le développeur se connecte à un portail, l'attribut personnalisé _apiportal est mis à jour pour suivre le nom et l'heure d'accès au portail, et définir l'état du développeur sur active. Chaque fois que le développeur se connecte au portail, l'attribut personnalisé est mis à jour pour réinitialiser la valeur lastVisit (au format epoch) pour ce portail. Exemple : {"status":"active","portals":{"myorg-myportal":{"lastVisit":1480972935}}}
Enregistrer un compte de développeur d'applications
Avant que les développeurs d'applications puissent utiliser vos API, ils doivent s'enregistrer en créant un compte.
Lorsqu'un développeur d'applications s'inscrit sur votre portail:
- Les informations sur le développeur de l'application sont créées et stockées sur Edge. Consultez la section Où les informations de compte de développeur sont-elles stockées ?.
- Le développeur d'applications apparaît dans la liste des développeurs d'applications enregistrés. Consultez Explorer la page "Développeurs".
Vous pouvez également enregistrer des développeurs d'applications en leur nom à l'aide de l'interface utilisateur Edge, comme décrit dans la section Enregistrer des développeurs d'applications.
Les nouveaux développeurs d'applications peuvent s'enregistrer eux-mêmes sur votre portail comme suit:
- Accédez au portail.
- Cliquez sur Connexion.
Cliquez sur S'inscrire.
La boîte de dialogue suivante s'affiche.
Saisissez les informations requises (prénom, nom et adresse e-mail).
Cliquez sur Créer.
La boîte de dialogue suivante s'affiche.
Cliquez sur le lien sécurisé de l'e-mail pour ouvrir le portail et établir la session authentifiée.
Se connecter à votre portail
Une fois que les développeurs d'applications se sont enregistrés sur votre portail, ils se connectent à l'aide de la page de connexion.
Chaque fois qu'un développeur d'applications se connecte à un portail, au lieu d'utiliser un secret partagé tel qu'un mot de passe pour l'authentifier, un lien sécurisé est envoyé pour vérifier son identité et établir une session avec le portail.
Les développeurs d'applications peuvent se connecter à votre portail comme suit:
- Accédez au portail.
- Cliquez sur Sign In (Se connecter).
- Saisissez l'adresse e-mail associée au compte.
Cliquez sur Login (Connexion).
La boîte de dialogue suivante s'affiche.
Cliquez sur le lien sécurisé de l'e-mail pour ouvrir le portail et établir la session authentifiée.
Enregistrer des applications
Après s'être connectés au portail, les développeurs d'applications peuvent enregistrer des applications pour utiliser les produits d'API que vous avez publiés, en procédant comme suit:
- Sélectionnez Mes applications dans le menu déroulant des utilisateurs.
- Cliquez sur + App (+ Application) pour créer une application.
- Dans la boîte de dialogue "Créer une application", saisissez un nom et une description pour l'application.
- Cliquez sur Créer.
- Gérez les produits d'API dans l'application, comme décrit ci-dessous.
Gérer les produits d'API dans une application
Les développeurs d'applications peuvent gérer les produits d'API dans leurs applications. Les produits API sont ajoutés à la page d'informations sur l'application. Pour certains produits d'API, l'approbation n'est pas automatique. L'état En attente indique un produit API pour lequel l'accès a été demandé, mais pas encore accordé.
Les développeurs d'applications peuvent gérer les produits d'API dans une application à partir de votre portail, comme suit:
- Sélectionnez Mes applications dans le menu déroulant des utilisateurs.
- Cliquez sur le nom de l'application.
- Cliquez sur Gérer les produits.
Cliquez sur l'option Accès pour activer ou désactiver l'accès à un produit d'API depuis l'application.
Remarque: Si le développeur d'applications désactive l'accès à un produit d'API privé ou interne uniquement, le produit d'API est supprimé de l'application et doit être rajouté manuellement par l'administrateur du portail, comme décrit dans la section Enregistrer des applications et gérer les clés API.
Cliquez sur Demander pour demander l'approbation d'un produit d'API qui n'est pas encore autorisé.
Cliquez sur Enregistrer.
Afficher la clé API d'une application
Les développeurs d'applications peuvent gérer la clé API d'une application à partir de votre portail, comme suit:
- Sélectionnez Mes applications dans le menu déroulant des utilisateurs.
- Cliquez sur le nom de l'application.
- Affichez la clé API dans la section Clés.
- Cliquez sur Afficher le secret pour afficher le secret de la clé API.
- Vérifiez que l'état de la clé API est "Approuvé".
Faire pivoter la clé API d'une application
Un développeur d'application peut faire pivoter la clé API d'une application régulièrement, ou en réponse à une fuite ou une attaque potentielles. Lorsqu'un développeur d'applications fait pivoter une clé API, une autre clé API est créée avec les mêmes droits d'accès aux produits d'API que la clé d'origine. La clé API d'origine est marquée comme obsolète, mais elle reste active pendant la transition. Vous devez désactiver une clé obsolète pour empêcher que ses identifiants soient acceptés, comme décrit dans la section Désactiver une clé API pour une application.
Les développeurs d'applications peuvent effectuer la rotation de la clé API principale d'une application à partir de votre portail, comme suit:
- Sélectionnez Mes applications dans le menu déroulant des utilisateurs.
- Cliquez sur le nom de l'application.
- Dans la section "Clés", placez le curseur sur la clé API actuelle pour afficher le menu d'actions.
- Cliquez sur
pour développer le menu d'actions. - Cliquez sur Effectuer une rotation.
- Cliquez sur Créer dans la boîte de dialogue pour confirmer l'opération.
- Vous pouvez éventuellement désactiver la clé API, comme décrit ci-dessous.
Désactiver une clé API pour une application
Lorsqu'un développeur d'applications effectue une rotation de clé API, comme décrit dans la section précédente, la clé API est marquée comme obsolète, mais elle reste active pendant la transition. Pour empêcher que les identifiants d'une clé obsolète soient acceptés, vous devez la désactiver.
Les développeurs d'applications peuvent désactiver une clé API pour une application à partir de votre portail, comme suit:
- Sélectionnez Mes applications dans le menu déroulant des utilisateurs.
- Cliquez sur le nom de l'application.
- Dans la section "Clés", cliquez sur Historique des clés pour afficher la liste des clés obsolètes.
- Placez le curseur sur la clé API obsolète que vous souhaitez désactiver pour afficher le menu d'actions.
- Cliquez sur pour développer le menu d'actions.
- Cliquez sur Désactiver.
- Cliquez sur Désactiver pour confirmer l'opération.
L'état de la clé passe à "Révoqué".
Modifier les informations sur l'application
Les développeurs d'applications peuvent modifier les détails de l'application comme suit:
- Sélectionnez Mes applications dans le menu déroulant des utilisateurs.
- Cliquez sur le nom de l'application.
- Modifiez les champs "Nom" ou "Description".
- Cliquez sur Enregistrer.
L'application est supprimée et retirée de la liste "Mes applications".
Supprimer une application
Les développeurs d'applications peuvent supprimer une application de votre portail, comme suit:
- Sélectionnez Mes applications dans le menu déroulant des utilisateurs.
- Cliquez sur le nom de l'application.
- Cliquez sur Supprimer en haut à droite de la page.
L'application est supprimée et retirée de la liste "Mes applications".