Enregistrer des développeurs d'applications

Cette page s'applique à Apigee et à Apigee hybrid.

Consultez la documentation d' Apigee Edge.

Enregistrez et gérez vos développeurs d'applications comme décrit dans les sections suivantes. (l'enregistrement des applications est un processus distinct, comme décrit dans la page Contrôler l'accès à vos API en enregistrant des applications).

Présentation

Apigee offre de nombreux avantages qui dépendent complètement de l'élément qui appelle vos API Par exemple, la sécurité des API, la gestion du trafic et une grande quantité de données d'analyse dépendent de l'élément qui appelle. Comment Apigee sait-il qui appelle vos API ? En lisant les informations uniques de chaque appel d'API, tel qu'un ID d'utilisateur, une clé d'API ou un jeton OAuth. Ces informations uniques verrouillent ou déverrouillent la fonctionnalité que vous créez dans vos proxys d'API, ce qui vous permet de contrôler entièrement l'accès aux API et leur comportement.

C'est la raison pour laquelle les développeurs d'applications doivent s'inscrire afin d'utiliser vos API. Une fois ajoutés, les développeurs enregistrent leurs applications, sélectionnent les API qu'ils souhaitent utiliser et reçoivent les identifiants d'API uniques (clés et secrets du consommateur) nécessaires pour accéder à vos API.

Avertissement : La sécurité des API, la gestion du trafic et les fonctionnalités d'analyse des développeurs/applications reposent sur une configuration correcte du proxy d'API. Par exemple, vous devez ajouter à vos proxys les règles appropriées, telles que la validation des clés API ou des jetons d'accès OAuth, l'application des quotas et la limitation du débit. Ces règles identifient le développeur et l'application qui effectuent l'appel, ce qui active l'application de la sécurité des API, la gestion du trafic spécifique au développeur ou à l'application, la collecte de données d'analyse pour l'API, ainsi que d'autres fonctionnalités. Techniquement, il est possible de développer des API ouvertes qui ne vérifient pas les clés API ni les jetons d'accès, ce qui signifie que vous n'auriez pas besoin d'exiger l'enregistrement des développeurs. Cependant, nous vous déconseillons vivement cette approche, car vous y perdez la sécurité de l'API, le contrôle des performances (que procure une bonne gestion du trafic), l'acquisition des données d'analyse, ainsi que d'autres avantages majeurs offerts par Apigee.

Enregistrer des développeurs d'applications

Enregistrez les développeurs de l'application de l'une des manières suivantes :

• Si vous disposez d'un compte Apigee payant, les développeurs peuvent s'auto-enregistrer via un portail des développeurs. Pour en savoir plus, consultez l'une des sections suivantes suivant le type de portail des développeurs souhaité :
  • Portail intégré : Créer un compte utilisateur sur le portail intégré
  • Drupal 10 : Enregistrer un développeur d'applications
• Les administrateurs peuvent enregistrer des développeurs d'applications à l'aide de l'API.
• En tant qu'administrateur du portail des développeurs, gérez les développeurs directement sur votre portail, comme décrit dans les sections suivantes :
  • Portail intégré : Gérer les utilisateurs pour gérer les comptes utilisateur
    Remarque : Une fois qu'un utilisateur a créé une application sur le portail intégré, comme décrit dans cette section, les informations du compte utilisateur sont synchronisées et mises à disposition sur Apigee sur la page des développeurs. L'enregistrement du développeur d'applications est associé au compte à l'aide de l'adresse e-mail de l'utilisateur. Pour en savoir plus sur l'emplacement de stockage des informations de compte et des applications associées, consultez la section Où les informations de compte de développeur d'applications sont-elles stockées ?.
  • Drupal 10 : Comprendre comment les développeurs d'applications interagissent avec le module Apigee Edge
• En tant qu'administrateur d'organisation, gérez les développeurs à l'aide de l'interface utilisateur ou de l'API d'Apigee, comme décrit dans les sections suivantes.

Remarque : Lorsque les utilisateurs du portail créent une équipe dans le portail intégré, les informations de cette équipe sont stockées sur Apigee. Une adresse e-mail unique est générée automatiquement pour servir de clé primaire utilisée par Apigee afin d'identifier l'équipe de développeurs. Pour en savoir plus, consultez la section Emplacement de stockage des informations de l'équipe de développement (version bêta).

Recommandations pour la gestion des comptes utilisateur sur les portails des développeurs

Apigee vous recommande de gérer les comptes utilisateur directement sur votre portail des développeurs.

Si vous utilisez le portail intégré, c'est le seul moyen de s'assurer que les comptes utilisateur du portail intégré et Apigee restent synchronisés.

Si vous utilisez le portail des développeurs basé sur Drupal, la gestion des comptes utilisateur directement sur le portail des développeurs offre les avantages suivants :

• Lorsque vous ajoutez un développeur via l'interface d'administration du portail, vous pouvez définir son mot de passe pour le portail et déclencher l'envoi d'un e-mail automatique au développeur.

  Lorsque vous ajoutez ou modifiez un développeur avec Apigee, aucun e-mail n'est envoyé au développeur et vous ne pouvez pas définir son mot de passe sur le portail. Par conséquent, le développeur doit réinitialiser son mot de passe de portail avant de pouvoir s'y connecter.

• Toutes les modifications apportées au compte de développeur sur le portail sont automatiquement envoyées à Apigee.

Si vous décidez de gérer des comptes utilisateur basés sur Drupal à l'aide d'Apigee, vous devez synchroniser les développeurs d'applications entre le portail et Apigee.

Explorer la page Développeurs

Accédez à la page "Développeurs" et explorez-la à l'aide de l'interface utilisateur d'Apigee.

Remarque : Pour les portails intégrés, les comptes utilisateur sont gérés comme décrit dans la section Gérer les utilisateurs. Lorsqu'un développeur crée une application sur le portail intégré, comme décrit dans la section Enregistrer des applications, un enregistrement de développeur distinct est créé pour effectuer le suivi des applications associées au compte utilisateur. Il est accessible sur la page "Développeurs". L'enregistrement de développeur est associé à l'aide de l'adresse e-mail de l'utilisateur.

Pour accéder à la page Développeurs, procédez comme suit :

• Si vous utilisez la page https://console.cloud.google.com/apigee : sélectionnez Distribution > Développeurs.
• Si vous utilisez l'interface utilisateur Apigee classique : sélectionnez Publier > Développeurs.

La page Développeurs vous permet d'effectuer les opérations suivantes :

• Ajouter un développeur
• Afficher et modifier les détails du développeur, y compris ce qui suit :
• Gérer les attributs utilisateur personnalisés
• Activer ou désactiver un développeur
• Exporter des données de publication
• Supprimer un développeur
• Effectuer une recherche dans la liste des développeurs

Ajouter un développeur

Pour ajouter un développeur, procédez comme suit :

1. Accéder à la page "Développeurs".
2. Cliquez sur + Développeur.
3. Saisissez les détails concernant le développeur, y compris ses prénom, nom, adresse e-mail et nom d'utilisateur.
4. Cliquez sur Create (Créer).

Consultez également la page Gérer des comptes utilisateur.

Afficher et modifier les informations du développeur

Affichez et modifiez les détails du développeur.

Pour afficher et modifier les détails d'un développeur, procédez comme suit :

1. Accéder à la page "Développeurs".
2. Cliquez sur la ligne du développeur que vous souhaitez afficher et modifier pour ouvrir ses informations détaillées.
3. Les informations suivantes s'affichent dans la section Détails. Si nécessaire, modifiez les informations du développeur.

   Détails	Description
   Détails	Prénom et nom, nom d'utilisateur et adresse e-mail du développeur ; état de l'enregistrement et durée ; ID du développeur. Pour modifier les informations du développeur, cliquez dans l'un des champs suivants : Prénom Nom E-mail Nom d'utilisateur Modifiez le contenu et appuyez sur Entrée pour confirmer la modification.
   Attributs personnalisés	Attributs personnalisés définis pour le développeur. Configurez les attributs personnalisés, si nécessaire. Pour en savoir plus, consultez la section Gérer les attributs personnalisés d'un développeur.
   Applications	Applications enregistrées par le développeur. Consultez la page Contrôler l'accès à vos API en enregistrant des applications.

4. Le champ État vous permet d'activer ou de désactiver le développeur.
   Pour en savoir plus, consultez la section Activer et désactiver un développeur.

Apigee conserve les entités suivantes en cache pendant au moins 180 secondes après l'accès aux entités.

• Jetons d'accès OAuth. Cela signifie que l'élément ExpiresIn de la règle OAuth v2 ne pourra pas faire expirer un jeton d'accès en moins de 180 secondes.
• Entités du service de gestion des clés (KMS) (Applications, développeurs, produits d'API).
• Attributs personnalisés sur les jetons OAuth et les entités KMS.

Gérer les attributs personnalisés d'un développeur

Ajoutez jusqu'à 18 attributs personnalisés pour chaque développeur.

Pour gérer les attributs personnalisés, procédez comme suit :

1. Accéder à la page "Développeurs".
2. Cliquez sur la ligne du développeur pour lequel vous souhaitez gérer les attributs personnalisés afin d'ouvrir les informations le concernant.
3. Cliquez sur + dans la section Attributs personnalisés.
4. Saisissez le nom et la valeur de l'attribut.
5. Cliquez sur .
6. Pour supprimer un attribut personnalisé, placez votre curseur sur l'attribut et cliquez sur dans le menu d'actions.

Activer et désactiver un développeur

Lorsqu'un développeur d'applications s'enregistre automatiquement sur votre portail, vous pouvez décider s'il est actif ou inactif par défaut.

Lorsqu'un développeur est inactif, il peut toujours se connecter au portail des développeurs et créer des applications, mais aucune des clés API correspondantes ne fonctionnera. Les applications du développeur conservent leur état d'approbation, tout comme les clés API, même si elles ne sont pas valides tant que le développeur est inactif.

Remarque : Lorsque vous désactivez un développeur, la mise à jour de tous les processeurs de messages peut prendre quelques minutes. Durant ce laps de temps, il se peut que certains appels émis par l'application du développeur aboutissent.

Pour activer ou désactiver un développeur, procédez comme suit :

1. Accéder à la page "Développeurs".
2. Cliquez sur la ligne correspondant au développeur que vous souhaitez activer ou désactiver pour ouvrir les détails associés.
3. Dans la section "Détails", basculez le champ État sur Actif ou Inactif selon les besoins.
4. Répétez cette procédure si le développeur figure dans plusieurs organisations.

Exporter des données de publication

Exportez les données de publication suivantes sous forme de fichier CSV (valeurs séparées par une virgule) :

• Détails du développeur
• Informations détaillées sur le développeur, l'application et l'API

Pour exporter des données de publication :

1. Accéder à la page "Développeurs".
2. Cliquez sur Exporter le fichier CSV….
3. Dans le menu déroulant, sélectionnez Développeurs ou Développeurs, Applications et Produits.

Les données de publication sélectionnées sont téléchargées en tant que fichier CSV.

Supprimer un développeur

Avertissement : La suppression d'un développeur entraîne la suppression totale du développeur, ainsi que ses éléments associés (tels que les applications et les clés API), de votre organisation. Pour éviter de supprimer définitivement les développeurs et leurs éléments, envisagez plutôt de désactiver les développeurs.

Pour supprimer un développeur, procédez comme suit :

1. Accéder à la page "Développeurs".
2. Placez le curseur sur la ligne correspondant au développeur que vous souhaitez supprimer pour afficher le menu des actions.
3. Cliquez sur .
4. Cliquez sur Delete (Supprimer) pour confirmer la suppression.

Synchroniser les développeurs d'applications entre le portail et Apigee

Si vous utilisez un portail des développeurs basé sur Drupal pour publier vos API, les modifications apportées aux développeurs d'applications avec Apigee ne sont pas propagées au portail. Vous devez vous connecter au portail en tant qu'administrateur et le synchroniser avec Apigee pour que ces modifications apparaissent sur le portail.

Remarque : Si vous utilisez le portail des développeurs basé sur Drupal, Apigee vous recommande de gérer les développeurs d'applications directement sur votre portail sans utiliser Apigee. Consultez la section Recommandations pour la gestion des comptes utilisateur sur les portails des développeurs.

Pour synchroniser votre portail des développeurs avec les développeurs d'applications définis sur Apigee, reportez-vous à la section suivante :

Drupal 10 : Synchroniser les développeurs avec Apigee

Gérer les développeurs à l'aide de l'API

Gérez les développeurs à l'aide des API de développeur.