Enregistrer les développeurs d'applis

Vous consultez la documentation Apigee Edge.
Accédez à la documentation Apigee X.

Enregistrez et gérez vos développeurs d'applications comme décrit dans les sections suivantes. (L'enregistrement d'applications est un processus distinct, décrit dans l'article Enregistrer des applications et gérer les clés API).

Introduction

Edge offre de nombreux avantages qui dépendent entièrement de l'identité de l'utilisateur 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 Edge 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.

Enregistrer des développeurs d'applications

Enregistrez des développeurs d'applications à l'aide de l'une des méthodes suivantes :

• Si vous disposez d'un compte Edge payant, les développeurs peuvent s'enregistrer eux-mêmes 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 de développeur sur le portail intégré
  • Drupal 10 : Enregistrer un compte de développeur d'applications
  • Drupal 7 : Ajouter et gérer des comptes utilisateur
• Les administrateurs peuvent inscrire 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érez les comptes de développeur.
  • Drupal 10 : Comment les développeurs d'applications interagissent avec le module Apigee Edge
  • Drupal 7 : Ajouter et gérer des comptes utilisateur
• En tant qu'administrateur d'organisation, gérez les développeurs à l'aide de l'interface utilisateur ou de l'API Edge, comme décrit dans les sections suivantes.

Recommandations pour la gestion des comptes de développeur sur des portails de développeurs

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

Si vous utilisez le portail intégré, c'est le seul moyen de vous assurer que les comptes de développeur sur le portail intégré et Edge restent synchronisés.

Si vous utilisez le portail des développeurs basé sur Drupal, la gestion des comptes de développeur directement sur le portail 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 à l'aide d'Edge, aucun e-mail n'est envoyé au développeur et vous ne pouvez pas définir le mot de passe du développeur 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 du développeur sur le portail sont automatiquement envoyées à Edge.

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

Explorer la page Développeurs

Accédez à la page "Développeurs" et explorez-la à l'aide de l'UI Edge et de la nouvelle UI Edge.

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 Créer.

Afficher et modifier les informations du développeur

Affichez et modifiez les détails du développeur. Pour les organisations ayant activé la monétisation, vous pouvez modifier les attributs personnalisés de monétisation définis dans Configurer les attributs de monétisation.

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 : Gérer les attributs personnalisés d'un développeur Configurer les attributs de monétisation
   Applications	Applications enregistrées par le développeur. Consultez la section Enregistrer des applications.

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

Avec Apigee Edge pour le cloud public, Edge 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 qu'un jeton révoqué peut toujours fonctionner pendant ces trois minutes, jusqu'à ce que sa limite de cache expire.
• 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, y compris les attributs de monétisation décrits dans Configurer les attributs de monétisation.

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.

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

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 Supprimer pour confirmer la suppression.

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

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

Pour synchroniser votre portail des développeurs avec les développeurs d'applications définis sur Edge, reportez-vous aux sections suivantes :

• Drupal 10 : Synchroniser les développeurs avec Apigee Edge
• Drupal 7 : Synchroniser les développeurs d'applications entre le portail et Edge

Regrouper les développeurs au sein d'entreprises

Dans le contexte de la monétisation, une entreprise est un ensemble de développeurs gérés comme une seule entité. Une entreprise peut être n'importe quel regroupement adapté à votre organisation, comme une unité commerciale, une gamme de produits ou une division. Il est utile de regrouper les développeurs dans des entreprises lorsque vous avez besoin d'associer plusieurs développeurs à une même entité juridique. Par exemple, vous devrez peut-être configurer différentes entreprises à des fins de facturation. Toutefois, les développeurs de votre organisation n'ont pas besoin d'être associés à une entreprise. Notez qu'un développeur est toujours une entité unique, identifiée de manière unique par l'élément "email". Si un développeur fait partie d'une entreprise, le nom de l'entreprise s'affiche sur la page "Développeurs".

Pour en savoir plus sur la gestion des entreprises et des développeurs pour la monétisation, consultez Gérer les entreprises et les développeurs.

Configurer les attributs de monétisation

Lorsque vous modifiez un développeur à l'aide de l'UI ou que vous créez ou modifiez un développeur à l'aide de l'API, vous pouvez configurer les propriétés de monétisation définies dans le tableau suivant. Au départ, vous configurez les propriétés de monétisation pour l'organisation lorsque vous modifiez le profil de l'organisation.

Nom du champ	Nom de l'attribut personnalisé	Description
Adresse	MINT_DEVELOPER_ADDRESS	Adresse du développeur, y compris les champs suivants : adresse (lignes 1 et 2), ville, État, code postal et pays.
Profil de facturation	MINT_BILLING_PROFILE	Cycle de facturation de votre organisation. Les valeurs valides sont les suivantes : PRORATED : la facturation est basée sur le nombre de jours d'utilisation d'un produit d'API au cours d'un mois calendaire. CALENDAR_MONTH : la facturation est mensuelle.
Type de facturation	MINT_BILLING_TYPE	Modèle de paiement du développeur utilisé pour la facturation. Les valeurs possibles sont les suivantes : PRÉPAYÉ : le développeur paie à l'avance l'utilisation d'un produit d'API. Les fonds sont déduits du solde du développeur lorsque le produit d'API est utilisé. Le développeur doit disposer d'une réserve prépayée suffisante pour acheter le produit d'API. POSTPAID : le développeur est facturé mensuellement (par le biais d'une facture) pour l'utilisation des produits d'API. Le développeur paie pour l'utilisation des produits d'API en fonction des conditions de paiement définies par le ou les plans inclus dans la facture. BOTH : compatible avec les deux types de facturation. La valeur par défaut est "PREPAID". Consultez Configurer les types de facturation avec prépaiement et post-paiement à l'aide de l'API.
Catégorie	MINT_DEVELOPER_CATEGORY	Catégorie de développeur à laquelle vous souhaitez ajouter le développeur. Une catégorie de développeurs est un regroupement de développeurs ou d'entreprises présentant des caractéristiques similaires. Pour en savoir plus, consultez Gérer les catégories de développeurs.
ID de l'entreprise	MINT_COMPANY_ID	ID de l'entreprise, le cas échéant. Pour en savoir plus, consultez Regrouper des développeurs dans des entreprises.
Type de développeur	MINT_DEVELOPER_TYPE	Cette propriété n'est pas utilisée par Apigee. Type de développeur. Les valeurs valides sont TRUSTED ou UNTRUSTED.
Est un courtier	MINT_IS_BROKER	Indicateur qui précise si les revenus sont basés sur le montant net.
Nom légal	MINT_DEVELOPER_LEGAL_NAME	Nom légal du développeur qui sera utilisé dans tous les rapports. Remarque : Cet attribut est obligatoire si le développeur n'est pas associé à une entreprise et souhaite s'abonner à un forfait publié.
Autofacturation	MINT_HAS_SELF_BILLING	Indicateur qui spécifie si les factures auto-émises sont activées. Si cette option est activée (true), la monétisation génère une facture autofacturée au lieu d'un relevé de partage des revenus. Une facture autofacturée est un document financier qui détaille le montant dû au développeur. Il sert de facture au fournisseur d'API au nom du développeur.
Numéro d'autorisation d'exonération fiscale	MINT_TAX_EXEMPT_AUTH_NO	Numéro d'exonération fiscale du gouvernement, le cas échéant.
Taux de taxe	MINT_APPROX_TAX_RATE	Taux de taxe approximatif pour le développeur. Spécifiez une valeur décimale avec un maximum de trois caractères avant la virgule et quatre caractères après la virgule.

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

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

Lorsque vous créez et mettez à jour un développeur à l'aide de l'API, vous pouvez configurer les attributs de monétisation décrits dans Configurer les attributs de monétisation, selon vos besoins.