Enregistrer les développeurs d'applis

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

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'é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 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 les développeurs de l'application de l'une des manières suivantes :

• Si vous disposez d'un compte Edge 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 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 des 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 Edge ou de l'API, 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 s'assurer que les comptes de développeur restent synchronisés entre le portail et Edge.

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 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 du développeur sur le portail sont automatiquement envoyées à Edge.

Si vous décidez de gérer des comptes de développeur 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'interface utilisateur Edge et de l'interface utilisateur Classic 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 pour lesquelles la monétisation est activée, 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 les sections suivantes : 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 2.0. Cela signifie qu'un jeton révoqué peut toujours fonctionner pendant trois minutes au maximum, jusqu'à l'expiration de sa limite de cache.
• 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 :

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 avec Edge ne sont pas propagées au portail. Vous devez vous connecter au portail en tant qu' administrateur du portail et synchroniser le portail avec Edge pour que ces modifications apparaissent sur le portail.

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

Avec la monétisation, une entreprise est un ensemble de développeurs gérés en tant qu'entité unique. Une entreprise peut être n'importe quel regroupement adapté à votre organisation, tel qu'une unité commerciale, une gamme de produits ou une division. Le regroupement des développeurs au sein d'entreprises est utile lorsque vous devez associer plusieurs développeurs à une seule 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 d'e-mail. 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 la section Gérer les entreprises et développeurs.

Configurer les attributs de monétisation

Lorsque vous modifiez un développeur à l'aide de l'interface utilisateur 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. Initialement, 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 lorsqu'il utilise le produit d'API. Le développeur doit conserver une réserve prépayée suffisante pour acheter le produit d'API. POSTPAID : le développeur est facturé mensuellement (via une facture) pour l'utilisation de produits d'API. Le développeur paie pour l'utilisation des produits d'API conformément aux conditions de paiement définies par le ou les forfaits inclus sur la facture. BOTH : prend en charge les deux types de facturation. La valeur par défaut est "PREPAID". Consultez la section Configurer les types de facturation prépayée et post-payée à 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éveloppeur est un regroupement de développeurs ou d'entreprises présentant des caractéristiques similaires. Pour en savoir plus, consultez la section 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 la section Regrouper les développeurs au sein d'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	Indique 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 regroupé avec une entreprise et qu'il souhaite s'abonner à un plan tarifaire publié.
Autofacturation	MINT_HAS_SELF_BILLING	Indique si les factures d'autofacturation sont activées. Si cette option est activée (true), la monétisation génère une facture d'autofacturation au lieu d'une déclaration de partage des revenus. Une facture d'autofacturation est un document financier qui indique le montant dû au développeur. Il sert de facture au fournisseur d'API pour le compte 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 nombre maximal de 3 caractères avant la décimale et 4 caractères après la décimale.

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, si nécessaire.