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

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

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

Catégorie Questions fréquentes
Configurer un portail des développeurs Drupal
Gérer l'environnement du portail
Personnaliser l'interface du portail
Personnaliser l'enregistrement des utilisateurs et des applications
Sauvegarde, restauration et haute disponibilité
Sécuriser le portail
Contrôler l'accès aux contenus
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 sponsorisé 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 navigateurs et versions de navigateurs sont compatibles avec le portail ?

Consultez la section Logiciels compatibles 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 dédiés aux développeurs. Pour en savoir plus, consultez la section Utiliser Pantheon.

Apigee utilise Acquia, un service de gestion de sites Web, pour héberger les versions cloud du portail de 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 permettant de développer, de tester et de 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 du cloud privé Apigee Edge, vous devrez gérer vous-même votre environnement de portail. Pour obtenir des recommandations, consultez les bonnes pratiques de développement et d'environnement serveur Drupal.

Comment appliquer les mises à jour d'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 les mises à jour régulièrement et appliquer immédiatement les mises à jour de sécurité. Pour en savoir plus, consultez Appliquer une mise à jour d'Apigee à votre portail.

    Remarque: Dans la zone "État" d'un environnement, accessible depuis l'élément de menu "État" à gauche du tableau de bord, vous pouvez voir que des mises à jour sont disponibles pour les modules Drupal. Ignorez 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 avec le dernier code 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: Apigee met régulièrement à jour automatiquement 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 sont taguées pour indiquer qu'elles doivent être migrées vers d'autres environnements de portail. Pour en savoir plus, consultez la section Appliquer des mises à jour de modules et de thèmes au portail.

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

Pour les clients Apigee Edge for Private Cloud, lorsque Apigee publie une nouvelle version du portail, vous pouvez passer à la dernière version de votre portail des développeurs, comme décrit dans la section Mettre à niveau le portail de services dédiés aux développeurs.

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

Personnaliser l'interface du portail

Comment personnaliser l'apparence du portail ?

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

Remarque: L'implémentation des personnalisations Drupal les plus avancées nécessite une courbe d'apprentissage. Vous pouvez décider de faire appel à un tiers spécialisé dans Drupal pour obtenir l'apparence souhaitée dans les délais souhaités.

Vous trouverez ci-dessous des 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 en fonction de la plate-forme que vous utilisez pour gérer votre portail:

Remarque: Ne modifiez que le contenu du répertoire /sites/all. Si vous modifiez du contenu en dehors du répertoire /sites/all, vous risquez de rencontrer des conflits de fusion lors de l'enregistrement des modifications dans Git.

Pour connaître les bonnes pratiques et obtenir des informations sur l'ajout et la mise à jour de modules personnalisés, consultez les pages Ajouter des modules et des thèmes et Mettre à jour des modules, respectivement, 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 les pages Ajouter des modules et des thèmes et Mettre à jour des modules, respectivement, dans la documentation Drupal.

Remarque: Ne modifiez que le contenu du répertoire /sites/all. Si vous modifiez du contenu en dehors du répertoire /sites/all, vous risquez de rencontrer des conflits de fusion lors de l'enregistrement des modifications dans Git.

Personnaliser l'enregistrement des utilisateurs et des applications

Comment personnaliser la page d'enregistrement des nouveaux utilisateurs ?

Lorsque l'utilisateur s'inscrit pour un compte sur le portail, celui-ci affiche la page d'enregistrement 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 qu'un nom d'entreprise, une adresse postale ou d'autres informations. Pour en savoir plus, consultez les pages suivantes:

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'enregistrement de l'application pour inviter le développeur à fournir des informations supplémentaires, telles qu'un ID client, la plate-forme cible de l'application ou d'autres informations. Pour en savoir plus, consultez les pages suivantes :

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

Les sources suivantes expliquent 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 qui consiste à utiliser les identifiants d'un système de gestion des identités, appelé système d'enregistrement, pour se connecter à un autre système. Par exemple, vous utilisez vos identifiants Google ou Twitter pour vous connecter au portail des développeurs Apigee. Le portail prend en charge la connexion fédérée à l'aide des identifiants de plusieurs fournisseurs courants, y compris GitHub, Google, OpenID et Twitter. Pour en savoir plus, consultez Utiliser des identifiants fédérés sur le portail des développeurs.

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

Vous pouvez configurer l'approbation manuelle des clés API pour l'enregistrement d'applications lorsque vous créez un produit d'API. Dans ce cas, vous devez approuver manuellement une clé API lorsqu'un développeur d'application 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: Quelle est la meilleure façon d'appliquer un workflow pour l'approbation manuelle des clés API dans le portail de développement ?

Sauvegarde, restauration 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 la section Sauvegarder le portail.

Comment garantir une haute disponibilité pour le portail des développeurs dans mon cloud public ?

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

Comment assurer une haute disponibilité pour le portail des développeurs dans mon cloud privé ?

Il n'existe pas d'approche universelle pour garantir la haute disponibilité du portail pour les développeurs. Nous vous recommandons vivement de demander l'aide d'une personne spécialisée dans les domaines suivants:

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

Contactez l'équipe Apigee chargée de la réussite client si vous avez besoin d'aide. Consultez également les articles de la communauté suivants:

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 Sécuriser votre portail.

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

TLS (Transport Layer Security, dont SSL est le prédécesseur) est la technologie de sécurité standard permettant d'établir un lien chiffré 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 Apigee Edge Public Cloud:

  • Pantheon: lorsqu'Apigee publie une nouvelle version du portail, un message s'affiche dans le tableau de bord Pantheon. Vous devez rechercher les mises à jour régulièrement et appliquer immédiatement les mises à jour de sécurité. Pour en savoir plus, consultez Appliquer une mise à jour d'Apigee à votre portail.
  • Acquia: Apigee met régulièrement à jour automatiquement 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 sont taguées pour indiquer 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.

Si vous êtes client Apigee Edge pour un cloud privé, vous recevrez une notification vous informant qu'une nouvelle version de Drupal est disponible. Une nouvelle version peut désigner une version de fonctionnalité, un correctif, une mise à jour de sécurité ou un autre type de mise à jour de Drupal. En cas de mise à jour de sécurité, vous devez mettre à niveau votre installation de 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 des informations sur Drupal et Apigee:

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

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

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

L'énumération des noms d'utilisateur désigne une méthode utilisée par les pirates informatiques pour identifier les noms d'utilisateur existants à l'aide du formulaire de récupération de mot de passe, 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 de l'é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 à l'aide d'un portail des développeurs Apigee. Sinon, le portail pour les 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 informations sur la façon dont les identifiants Edge sont stockés et chiffrés dans le portail Drupal:

Communauté Apigee :

Contrôler l'accès aux contenus

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

Les sources suivantes expliquent 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 expliquent comment contrôler l'accès aux produits 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 vous oblige à configurer un serveur SMTP pour envoyer des e-mails. Une fois le serveur SMTP configuré, tous les e-mails envoyés par le portail pour les développeurs utilisent le serveur SMTP. Ces e-mails incluent ceux envoyés aux nouveaux développeurs, aux développeurs qui ont perdu leur mot de passe et aux développeurs dont le compte est bloqué. Pour en savoir plus, consultez Configurer l'envoi d'e-mails.

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. Les règles sont couramment utilisées pour générer des e-mails en réponse à un événement. Le portail est compatible avec la génération d'e-mails pour des événements prédéfinis, par exemple lorsqu'un nouveau développeur enregistre un compte. Toutefois, vous pouvez 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 la section Générer un e-mail lorsqu'un événement se produit.

Comment personnaliser les e-mails envoyés depuis le portail ?

Vous pouvez configurer différentes 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 la section Configurer et mettre en forme les notifications par e-mail.

Comment é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 Drupal CAPTCHA et reCAPTCHA. Pour en savoir plus, consultez les sections suivantes :

Résoudre des problèmes

Comment consulter les fichiers journaux du portail ?

Sélectionnez Rapports dans le menu Drupal pour afficher la liste des 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 https://github.com/apigee/drupal7-drops. Les sites Pantheon et Acquia utilisent ce dépôt pour leur code source en amont.