Gérer des entreprises et des développeurs à l'aide du portail des développeurs (libre-service)

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

En tant que fournisseur d'API, la gestion des entreprises et des développeurs qui participent à votre écosystème d'API monétisées peut prendre du temps si vous devez tout faire vous-même. Vous devez gérer des profils, tenir à jour des informations bancaires, fiscales et de facturation, attribuer des rôles, etc. Le portail des développeurs permet aux entreprises et aux développeurs eux-mêmes de gérer ces tâches, tout en vous offrant une visibilité complète sur l'écosystème à partir de l'interface utilisateur de gestion et de l'API.

Avant de commencer

Avant d'activer le libre-service dans votre portail des développeurs, assurez-vous de bien comprendre les concepts de base du portail des développeurs et d'effectuer les étapes de configuration clés. Par exemple, il est important de savoir que vous pouvez contrôler si les utilisateurs sont automatiquement activés lors de l'inscription ou s'ils nécessitent votre approbation manuelle. Si ce n'est pas déjà fait, familiarisez-vous avec les sujets du portail des développeurs dans Créer votre portail avec Drupal.

En plus de consulter et d'effectuer la configuration de base de l'environnement du portail des développeurs, consultez et effectuez également les étapes spécifiques à la monétisation suivantes :

À propos du libre-service pour les entreprises et les développeurs dans votre portail des développeurs

Si la monétisation est activée dans votre organisation, en plus de toute configuration du portail des développeurs que vous avez déjà effectuée, votre portail peut être prêt pour le libre-service. Voici quelques exemples de tâches en libre-service que les développeurs peuvent effectuer :

Tâche Informations de configuration
S'inscrire
Créer des entreprises Activer la gestion des entreprises dans le portail
Inviter des développeurs à rejoindre des entreprises (et supprimer des développeurs d'entreprises) Activer la gestion des entreprises dans le portail
Modifier les rôles utilisateur Configurer la monétisation
Gérer leurs propres informations de facturation, fiscales, bancaires et autres informations de profil Configurer la monétisation
Accepter vos conditions d'utilisation Configurer les conditions de monétisation dans le portail des développeurs (facultatif)
Enregistrer de nouvelles applications, sélectionner les packages/forfaits d'API qu'ils souhaitent utiliser et accéder à leurs clés API Configuration de l'enregistrement des applications
Ajouter de l'argent (recharger le solde) aux comptes prépayés Configurer la monétisation
Générer des relevés et des rapports (facturation et revenus) Configurer la monétisation

Exemple d'interactions en libre-service dans le portail des développeurs

Voici des exemples d'interactions en libre-service dans le portail des développeurs :

  • Lorsque les développeurs s'inscrivent sur le portail (en cliquant sur le lien S'inscrire), ils sont automatiquement connectés (sauf si vous souhaitez les approuver manuellement au préalable) et peuvent créer leur propre entreprise. Ils deviennent automatiquement administrateurs de la monétisation de l'entreprise et ils peuvent saisir toutes les informations de profil, de facturation et bancaires de l'entreprise.

  • Lorsque les développeurs naviguent et effectuent des tâches dans le portail des développeurs (acceptation d'invitations, enregistrement d'applications, etc.), ils le font dans le contexte de leur propre compte ou de leur appartenance à une entreprise. Un menu déroulant permet de sélectionner l'entreprise dans laquelle ils souhaitent travailler. Par exemple, si un utilisateur sélectionne une entreprise et enregistre une application, celle-ci appartient à l'entreprise.

    Pour gérer les informations sur l'entreprise (s'ils disposent des droits d'administrateur), les utilisateurs sélectionnent Gérer les entreprises dans le menu déroulant, puis l'entreprise qu'ils souhaitent gérer (ou leur nom d'utilisateur s'ils agissent en tant que développeur autonome).

  • Un administrateur d'entreprise peut également inviter des développeurs à rejoindre son entreprise. (Les développeurs doivent déjà disposer de comptes Apigee.) L'illustration suivante montre le champ "Inviter un utilisateur" dans le portail des développeurs, sur la page Paramètres > Utilisateurs de l'entreprise.

  • Les développeurs invités reçoivent une notification par e-mail concernant l'invitation de l'entreprise. Ils peuvent se connecter au portail pour accepter l'invitation sur leur page "Gérer les entreprises", comme illustré dans la figure suivante.

  • Les administrateurs d'entreprise peuvent annuler les invitations envoyées aux développeurs sur la page Paramètres > Utilisateurs de l'entreprise.
  • Les administrateurs d'entreprise peuvent modifier les rôles des développeurs sur la page Paramètres > Utilisateurs de l'entreprise. Par exemple, ils peuvent faire d'un développeur un administrateur de la monétisation pour lui accorder des droits d'administration sur l'entreprise.

Activer la gestion des entreprises dans le portail

Par défaut, la possibilité de gérer les entreprises est disponible dans le portail si vous utilisez le thème Apigee Responsive. Le menu déroulant "Entreprise" peut être masqué si vous utilisez le paramètre de configuration "Position fixe de la barre de navigation supérieure". Pour vous assurer que le menu déroulant "Gérer les entreprises" est affiché, passez au paramètre "Position statique de la barre de navigation supérieure" comme suit :

  1. Connectez-vous au portail des développeurs en tant qu'administrateur.
  2. Sélectionnez Apparence > Paramètres > Apigee Responsive dans la barre d'administration.
  3. Sélectionnez Composants sous "Paramètres Bootstrap".
  4. Cliquez sur Barre de navigation.
  5. Sélectionnez Statique en haut dans le menu déroulant "Position de la barre de navigation".
  6. Cliquez sur Enregistrer la configuration pour enregistrer les modifications.

Si vous utilisez votre propre thème personnalisé, ajoutez le bloc "Changer d'entreprise" à votre thème en sélectionnant Structure > Blocs dans la barre d'administration, puis en faisant glisser le bloc Changer d'entreprise vers la région souhaitée de la page. Cliquez sur Enregistrer les blocs pour enregistrer la configuration.