Questions fréquentes sur le portail des développeurs Drupal 7

Vous consultez la documentation d'Apigee Edge.
Consultez la documentation Apigee X. en savoir plus

Cette section fournit des réponses aux questions les plus fréquentes, compilées à partir des questions publiées sur les pages de la communauté Apigee et de l'assistance Apigee.

Catégorie Questions fréquentes
Configurer un portail des développeurs Drupal
Gérer l'environnement du portail
Personnaliser l'apparence du portail
Personnaliser l'enregistrement des utilisateurs et des applications
Sauvegarde, récupération et haute disponibilité
Sécuriser le portail
Contrôler l'accès au contenu
Configurer les e-mails et les notifications
Résoudre des problèmes
Accéder au code

Configurer un portail des développeurs Drupal

Comment configurer un portail des développeurs Drupal ?

Depuis le 31 mai 2020, l'hébergement parrainé par Apigee pour les portails basés sur Drupal a pris fin. Pour en savoir plus sur la configuration d'un portail des développeurs existant, consultez la section Créer un portail des développeurs.

Quels sont les navigateurs et les versions de navigateur compatibles avec le portail ?

Consultez la section Logiciels et versions compatibles.

Gérer l'environnement du portail

Comment gérer mon environnement de portail dans le cloud public ?

Apigee utilise Pantheon, un service de gestion de sites Web, pour héberger les versions cloud du portail de services pour les développeurs. Pour en savoir plus, consultez Utiliser Pantheon.

Apigee utilise Acquia, un service de gestion de sites Web, pour héberger les versions cloud du portail des services pour les développeurs dans l'Union européenne (UE). Pour en savoir plus, consultez Travailler avec Acquia.

Pantheon et Acquia fournissent tous deux des outils pour développer, tester et publier votre portail basé sur Drupal dans un environnement sécurisé.

Comment gérer mon environnement de portail dans le cloud privé ?

En tant que client de cloud privé Apigee Edge, vous devez gérer vous-même votre environnement de portail. Pour obtenir des recommandations, consultez l'article Bonnes pratiques concernant le développement et l'environnement de serveur Drupal.

Comment appliquer les mises à jour Apigee à mon portail des développeurs dans le cloud public ?

Pour appliquer les mises à jour d'Apigee au portail des développeurs dans le cloud public:

  • Pantheon: lorsqu'Apigee publie une nouvelle version du portail, un message s'affiche dans le tableau de bord Pantheon. Vous devez rechercher des mises à jour régulièrement et appliquer les mises à jour de sécurité immédiatement. Pour plus d'informations, consultez la section Appliquer une mise à jour d'Apigee à votre portail.

    Remarque: Dans la zone "Status" (État) d'un environnement, accessible depuis l'élément de menu "Status" (État) à gauche du tableau de bord, vous remarquerez peut-être que des mises à jour sont disponibles pour les modules Drupal. Ignorer ces mises à jour. Apigee intègre automatiquement les mises à jour des modules Drupal dans la prochaine version du portail. En autorisant Apigee à mettre à jour les modules Drupal à votre place, Apigee s'assure que ces mises à jour ont été testées par rapport au code le plus récent du portail. Si vous mettez à jour un module Drupal en dehors du cycle de publication normal du portail Apigee, vous risquez de rencontrer des problèmes imprévus.

  • Acquia: régulièrement, Apigee met automatiquement à jour les modules et les thèmes de votre portail à la dernière version. Les mises à jour ne sont effectuées que dans l'environnement de développement et comportent des tags indiquant qu'elles doivent être migrées vers d'autres environnements de portail. Pour en savoir plus, consultez Appliquer des mises à jour de module et de thème au portail.

Comment appliquer les mises à jour Apigee à mon portail des développeurs dans le cloud privé ?

Pour les clients Apigee Edge pour le cloud privé, lorsqu'Apigee publie une nouvelle version du portail, vous pouvez mettre à niveau le portail des développeurs vers la dernière version, comme décrit dans la section Mettre à niveau le portail de services pour les développeurs.

Entre les versions du cloud privé Apigee Edge, vous pouvez recevoir une notification vous informant qu'une nouvelle version de Drupal est disponible. Une nouvelle version peut signifier une version de fonctionnalité, un correctif, une mise à jour de sécurité ou un autre type de mise à jour Drupal. Dans le cas d'une mise à jour de sécurité, vous devez mettre à niveau votre installation Drupal dès que possible pour vous assurer que votre site reste sécurisé. Pour en savoir plus, consultez la section Mettre à niveau la version Drupal d'une installation de cloud privé.

Personnaliser l'apparence du portail

Comment personnaliser l'apparence du portail ?

Drupal vous permet de créer un portail hautement personnalisé en ajustant le thème Drupal et en ajoutant des modules personnalisés.

Remarque: Les personnalisations Drupal plus avancées nécessitent une courbe d'apprentissage. Vous pouvez décider de faire appel à un tiers disposant de l'expertise de Drupal afin d'obtenir l'apparence souhaitée dans les délais souhaités.

Voici quelques ressources qui vous aideront à personnaliser votre portail avec Drupal:

Comment ajouter des modules et des thèmes personnalisés à mon portail dans le cloud public ?

Vous pouvez étendre les fonctionnalités du portail en ajoutant vos propres modules et thèmes personnalisés.

Pour ajouter des modules et des thèmes personnalisés à votre portail cloud, consultez l'une des sections suivantes selon que vous gérez votre portail avec Patheon ou Acquia:

Remarque: Ne modifiez que le contenu du répertoire /sites/all. Si vous modifiez du contenu qui se trouve en dehors du répertoire /sites/all, vous pouvez rencontrer des conflits de fusion lorsque vous vérifiez les modifications apportées à Git.

Pour connaître les bonnes pratiques et obtenir des informations sur l'ajout et la mise à jour de modules personnalisés, consultez respectivement les sections Ajouter des modules et thèmes et Mettre à jour des modules dans la documentation Drupal.

Comment ajouter des modules et des thèmes personnalisés à mon portail dans le cloud privé ?

Vous pouvez étendre les fonctionnalités du portail en ajoutant vos propres modules et thèmes personnalisés. Pour connaître les bonnes pratiques et obtenir des informations sur l'ajout et la mise à jour de modules personnalisés, consultez respectivement les sections Ajouter des modules et thèmes et Mettre à jour des modules dans la documentation Drupal.

Remarque: Ne modifiez que le contenu du répertoire /sites/all. Si vous modifiez du contenu qui se trouve en dehors du répertoire /sites/all, vous pouvez rencontrer des conflits de fusion lorsque vous vérifiez les modifications apportées à Git.

Personnaliser l'enregistrement des utilisateurs et des applications

Comment personnaliser la page d'inscription des nouveaux utilisateurs ?

Lorsque l'utilisateur crée un compte sur le portail, le portail affiche la page d'inscription par défaut avec les champs "Prénom", "Nom", "Nom d'utilisateur", "Adresse e-mail" et "Mot de passe". En tant que fournisseur d'API, vous pouvez modifier ce formulaire pour inviter l'utilisateur à fournir des informations supplémentaires telles que le nom d'une entreprise, une adresse postale ou d'autres informations. Pour en savoir plus, consultez les articles suivants:

Comment personnaliser la page d'enregistrement de l'application ?

Lorsqu'un développeur d'applications enregistre une application, le portail affiche un formulaire par défaut. En tant que fournisseur d'API, vous pouvez modifier le formulaire d'inscription de l'application pour inviter le développeur à fournir des informations supplémentaires telles qu'un numéro client, la plate-forme cible de l'application ou d'autres informations. Pour en savoir plus, consultez :

Comment utiliser LDAP pour l'authentification sur le portail des développeurs ?

Les sources suivantes décrivent comment utiliser LDAP pour l'authentification:

Communauté Apigee

Documentation Drupal

Comment me connecter au portail à l'aide de mes identifiants Twitter, Google ou GitHub ?

La connexion fédérée est le processus par lequel vous utilisez les informations d'identification d'un système de gestion des identités, appelé système d'enregistrement, pour vous connecter à un autre système. Par exemple, vous pouvez utiliser vos identifiants Google ou Twitter pour vous connecter au portail des développeurs Apigee. Le portail accepte la connexion fédérée à l'aide d'identifiants de plusieurs fournisseurs courants, dont GitHub, Google, OpenID et Twitter. Pour en savoir plus, consultez la section Utiliser des identifiants fédérés sur le portail des développeurs.

Comment appliquer un workflow d'approbation manuelle des clés API ?

Vous pouvez configurer l'approbation manuelle des clés API pour l'enregistrement d'une application lors de la création d'un produit API. Dans ce cas, vous devez approuver manuellement une clé API lorsqu'un développeur d'applications enregistre une application.

Pour obtenir des recommandations sur l'application d'un workflow pour l'approbation manuelle des clés API, consultez l'article de la communauté suivant: Quel est le meilleur moyen d'appliquer un workflow d'approbation manuelle des clés API dans le portail de développement ?

Sauvegarde, récupération et haute disponibilité

Comment sauvegarder et restaurer mon portail dans le cloud public ?

La procédure de sauvegarde d'un portail dans le cloud public varie selon que vous utilisez Pantheon ou Acquia pour gérer votre portail:

Comment sauvegarder et restaurer mon portail dans le cloud privé ?

Vous sauvegardez et restaurez le portail dans le cloud privé à l'aide des commandes Postgres pg_dump et pg_restore. Pour en savoir plus, consultez Sauvegarder le portail.

Comment puis-je garantir la haute disponibilité du portail des développeurs dans mon cloud public ?

Les outils de gestion Pantheon et Acquia Drupal garantissent une disponibilité de 99,5% pour les portails qu'ils hébergent. Pour en savoir plus, consultez :

Comment puis-je garantir la haute disponibilité du portail des développeurs dans mon cloud privé ?

Il n'existe pas d'approche universelle pour garantir une haute disponibilité du portail des développeurs. Il est vivement recommandé de demander l'aide d'une personne experte dans les domaines suivants:

  • Mettre en place des systèmes de fichiers et des bases de données dans une configuration de haute disponibilité
  • Développement de portail Drupal 7

Si vous avez besoin d'aide, contactez l'équipe chargée de la réussite des clients Apigee. Consultez également les articles suivants de la communauté:

Sécuriser le portail

Comment configurer la sécurité du portail ?

Drupal propose également de nombreuses fonctionnalités de sécurité que vous devez connaître lorsque vous créez votre portail. Pour en savoir plus, consultez la section Sécuriser votre portail.

Comment configurer le portail pour qu'il utilise TLS/HTTPS ?

Le protocole TLS (Transport Layer Security), dont le prédécesseur est SSL, est la technologie de sécurité standard permettant d'établir une liaison chiffrée entre un serveur Web et un client Web, tel qu'un navigateur ou une application. Un lien chiffré garantit que toutes les données transmises entre le serveur Web et le client restent privées. Pour en savoir plus sur la configuration de TLS avec le portail, consultez Utiliser TLS sur le portail.

Comment appliquer les correctifs de sécurité Drupal ?

Pour les clients de cloud public Apigee Edge:

  • Pantheon: lorsqu'Apigee publie une nouvelle version du portail, un message s'affiche dans le tableau de bord Pantheon. Vous devez rechercher des mises à jour régulièrement et appliquer les mises à jour de sécurité immédiatement. Pour plus d'informations, consultez la section Appliquer une mise à jour d'Apigee à votre portail.
  • Acquia: régulièrement, Apigee met automatiquement à jour les modules et les thèmes de votre portail vers la dernière version. Les mises à jour ne sont effectuées que dans l'environnement de développement et comportent des tags indiquant qu'elles doivent être migrées vers d'autres environnements de portail. Pour en savoir plus, consultez la section Appliquer des mises à jour de module et de thème au portail.

Pour les clients d'Apigee Edge pour Private Cloud, vous recevrez une notification vous informant qu'une nouvelle version de Drupal est disponible. Une nouvelle version peut signifier une version de fonctionnalité, un correctif, une mise à jour de sécurité ou un autre type de mise à jour Drupal. Dans le cas d'une mise à jour de sécurité, vous devez mettre à niveau votre installation Drupal dès que possible pour vous assurer que votre site reste sécurisé. Pour en savoir plus, consultez la section Mettre à niveau la version Drupal d'une installation de cloud privé.

Comment m'inscrire aux mises à jour de sécurité ?

Inscrivez-vous pour recevoir les mises à jour de Drupal et d'Apigee:

Pour les clients de cloud public, vous pouvez également vous enregistrer auprès de votre hébergeur de site Web Drupal:

  • Les utilisateurs Pantheon peuvent s'abonner aux notifications de statut spécifiques à Pantheon à l'adresse http://status.getpantheon.com. Cliquez sur S'abonner aux mises à jour pour vous inscrire.
  • Les utilisateurs Acquia peuvent s'abonner aux mises à jour d'état spécifiques à Acquia, comme décrit dans la section S'abonner aux mises à jour d'état.

Comment empêcher l'énumération des noms d'utilisateur ?

L'énumération du nom d'utilisateur fait référence à une méthode permettant aux pirates informatiques d'identifier les noms d'utilisateur existants à l'aide du formulaire "Mot de passe oublié", qui indique par défaut si le mot de passe spécifié existe ou non. Les pirates informatiques peuvent continuer à essayer des noms d'utilisateur jusqu'à ce qu'ils trouvent un utilisateur valide. Pour empêcher l'énumération des noms d'utilisateur, installez le module de prévention d'énumération des noms d'utilisateur.

Comment activer l'authentification à deux facteurs ?

N'activez pas l'authentification à deux facteurs sur Apigee Edge si vous publiez vos API via un portail des développeurs Apigee. Sinon, le portail des développeurs ne pourra pas communiquer avec Edge.

Comment les identifiants Edge sont-ils stockés et chiffrés dans le portail Drupal ?

Les sources suivantes fournissent des détails sur la manière dont les identifiants Edge sont stockés et chiffrés dans le portail Drupal:

Communauté Apigee:

Contrôler l'accès au contenu

Comment contrôler l'accès au contenu sur le portail ?

Les sources suivantes décrivent comment contrôler l'accès au contenu du portail:

Communauté Apigee:

Documentation Drupal:

Comment contrôler l'accès aux produits d'API par rôle ?

Les sources suivantes décrivent comment contrôler l'accès aux produits d'API par rôle:

Configurer les e-mails et les notifications

Comment spécifier un serveur de messagerie SMTP pour le portail ?

Le portail des développeurs nécessite la configuration d'un serveur SMTP pour envoyer des e-mails. Une fois le serveur SMTP configuré, tous les e-mails envoyés par le portail des développeurs utilisent le serveur SMTP. Ces e-mails incluent ceux envoyés aux nouveaux développeurs, ceux envoyés aux développeurs qui perdent leur mot de passe et ceux envoyés aux développeurs dont les comptes sont bloqués. Pour en savoir plus, consultez Configurer la messagerie électronique.

Comment envoyer un e-mail lorsqu'un développeur enregistre une application (ou qu'un autre événement se produit) ?

Les règles Drupal vous permettent de définir des actions du portail en réponse à certains événements. Ces règles permettent généralement de générer des e-mails en réponse à un événement. Le portail permet de générer des e-mails pour des événements prédéfinis, par exemple lorsqu'un nouveau développeur enregistre un compte. Vous pouvez toutefois ajouter vos propres règles pour générer des e-mails. Par exemple, vous pouvez générer un e-mail lorsque le développeur ajoute, supprime ou modifie une application. Pour en savoir plus, consultez Générer un e-mail lorsqu'un événement se produit.

Comment personnaliser les e-mails envoyés à partir du portail ?

Vous pouvez configurer diverses notifications par e-mail envoyées en réponse à des activités particulières telles que l'enregistrement, la suppression, le blocage et le déblocage de comptes de développeur. Pour en savoir plus, consultez Configurer et mettre en forme les notifications par e-mail.

Comment puis-je éviter le spam sur le portail ?

Pour éviter le spam sur le portail, vous pouvez ajouter un captcha à la page de connexion et à d'autres pages en activant les modules CAPTCHA et reCAPTCHA de Drupal. Pour en savoir plus, consultez les pages suivantes:

Résoudre des problèmes

Comment puis-je afficher les fichiers journaux du portail ?

Sélectionnez Rapports dans le menu Drupal pour afficher une liste de journaux et d'autres rapports. Par exemple, sélectionnez Rapports > Messages de journal récents pour afficher un tableau des messages de journal récents.

Vidéo:regardez une courte vidéo pour en savoir plus sur les rapports de journal et les paramètres de débogage.

Accéder au code

Comment accéder au code source du portail des développeurs Drupal 7 ?

Pour les sites hébergés sur Pantheon ou Acquia, vous pouvez accéder au code source du portail des développeurs Drupal 7 via le tableau de bord de votre site d'hébergement, comme décrit dans les sections suivantes:

Vous pouvez accéder directement au dépôt de code source de Drupal 7 à l'adresse suivante: https://github.com/apigee/drupal7-drops. Les sites Pantheon et Acquia utilisent tous deux ce référentiel pour leur code source en amont.