Migrer votre portail Drupal 7 vers le portail intégré

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

Cette section fournit des conseils sur la planification et l'exécution de la migration des éléments de votre portail Drupal 7 vers le portail intégré.

Étape 1: Créez un portail intégré

Avant de migrer les éléments de votre portail Drupal 7, vous devez créer un portail intégré.

Pour créer un portail intégré:

1. Vérifiez que vous disposez des rôles de portail appropriés pour gérer un portail intégré.
2. Créer un portail intégré

Lorsque vous créez un portail intégré, un ensemble de pages de démarrage vous est fourni et que vous pouvez utiliser comme point de départ. Les pages de démarrage incluent des vidéos de démonstration qui vous aident à développer votre propre portail à mesure que vous remplacez le texte et les images par votre propre contenu. Pour en savoir plus, consultez À propos de l'exemple de portail.

Étape 2: Créez votre portail intégré

Créez votre portail intégré, comme indiqué dans la section Étapes de création de votre portail.

Vous devrez au minimum effectuer les étapes décrites dans le tableau suivant.

Step	Description
Développer le contenu du portail	(informations conceptuelles et de démarrage, par exemple). Vous pouvez choisir de créer des pages, puis de copier et coller le contenu de ces pages directement depuis votre portail Drupal 7 existant.
Configurer la navigation	Créez la navigation nécessaire pour qu'elle corresponde à votre structure existante.
Personnaliser votre thème	Personnalisez au minimum les composants suivants pour qu'ils correspondent à vos exigences de branding: Logos et favicons Palette de couleurs, famille et styles de polices Image de fond
Ajouter des scripts personnalisés	Ajoutez un code JavaScript personnalisé à votre portail, si nécessaire.
Configurer la messagerie	Configurez votre serveur SMTP et le contenu des notifications par e-mail. Remarque: La configuration des notifications par e-mail n'est pas disponible pour les portails intégrés Apigee Hybrid pour le moment.
Gérer la visibilité par défaut	Gérez la visibilité par défaut pour des ressources spécifiques.
Configurer une stratégie de sécurité du contenu	Si vous le souhaitez, configurez une stratégie de sécurité du contenu (CSP) pour toutes les pages de votre portail afin de vous protéger contre les attaques de type script intersites (XSS) et autres injections de code. Remarque: Cette fonctionnalité n'est pas disponible pour les portails intégrés Apigee hybrid pour le moment.

Étape 3: Configurer le fournisseur d'identité

Configurez le fournisseur d'identité sur le portail intégré en fonction du type d'authentification, comme indiqué dans le tableau suivant.

Authentification	Description
Fournisseur d'identité intégré (nom d'utilisateur/mot de passe)	Configurez le fournisseur d'identité intégré sur le portail intégré.
Authentification unique (SSO) à l'aide de SAML	Configurez le fournisseur d'identité SAML (bêta) sur le portail intégré. Remarques : Pour obtenir des conseils sur la configuration d'un domaine personnalisé, consultez Utiliser un domaine personnalisé avec un fournisseur d'identité SAML. Le mappage de rôles d'assertion SAML vers Drupal 7 n'est pas pris en charge pour les portails intégrés. À la place, vous devrez contrôler l'accès aux ressources à l'aide des audiences. Le fournisseur d'identité SAML n'est pas disponible pour les portails intégrés Apigee hybrid pour le moment.

Une fois que les développeurs se sont connectés au portail, vous pouvez gérer leur compte, comme décrit dans Gérer les comptes de développeur.

Étape 4: Contrôler l'accès aux ressources à l'aide des audiences

Si vous utilisez des rôles dans Drupal 7 pour contrôler l'accès à un ensemble de ressources, comme la documentation de l'API ou la création de clés API pour un produit d'API, vous pouvez obtenir cette même fonctionnalité en utilisant les audiences sur le portail intégré.

Plus précisément, vous pouvez contrôler l'accès aux ressources suivantes sur le portail intégré à l'aide des audiences:

• Pages de votre portail
• Produits d'API publiés

Pour ajouter une audience et gérer les attributions d'utilisateurs et d'équipes de développeurs individuelles, consultez Gérer les audiences. Lorsqu'un nouvel utilisateur crée un compte et se connecte à votre portail, vous devez l'affecter à une ou plusieurs audiences, selon les besoins, comme décrit dans Gérer les attributions d'une audience.

Pour simplifier la migration, nous vous conseillons de suivre les conseils suivants:

• Nommez vos audiences d'après les rôles Drupal qu'elles remplacent.
• Gérez les membres d'audiences en faisant appel à des équipes de développeurs. Les développeurs créent des équipes afin de partager la responsabilité de leurs applications et de gérer les membres des équipes.

Étape 5: Publiez vos API

Pour publier des API et générer automatiquement une documentation de référence d'API à l'aide de SmartDocs sur le portail intégré, vous devez avoir accès à la spécification OpenAPI associée à l'API.

Même si vous avez peut-être utilisé une spécification OpenAPI pour générer automatiquement les SmartDocs dans Drupal 7, le contenu est finalement stocké dans un format interne sans aucune association à la spécification OpenAPI d'origine. Les équipes API utilisant Apigee Edge stockent généralement les spécifications OpenAPI dans le magasin de spécifications Apigee Edge.

Ensuite, publiez une API sur votre portail. Préparez-vous à:

• Spécifiez la spécification OpenAPI à utiliser comme source de documentation à partir du magasin de spécifications, de votre répertoire local ou d'une URL
• Configurer la visibilité de la documentation (publique, authentification pour les utilisateurs ou audiences sélectionnées)
• Configurer une URL de rappel, si nécessaire
• Ajoutez une image à l'écran de votre catalogue d'API, si vous le souhaitez

Étape 6: Partagez la responsabilité d'une application avec les équipes de développeurs

Si vos développeurs utilisent des applications d'entreprise dans Drupal 7 pour partager la responsabilité d'une application, ils peuvent obtenir cette même fonctionnalité en faisant appel à des équipes de développeurs sur le portail intégré.

Vos développeurs créent des équipes de développeurs qui se partagent la responsabilité de leurs applications et gèrent les membres des équipes, comme décrit dans Partager la responsabilité d'une application avec les équipes de développeurs (bêta).

Vous pouvez informer votre communauté de développeurs sur les équipes de développeurs et les encourager à migrer leurs applications afin qu'elles utilisent des équipes de développeurs pour partager les responsabilités et passer à l'utilisation des nouvelles clés API. Vous pourrez ensuite supprimer toutes les applications de l'entreprise et les artefacts associés à l'aide des API Edge.

Vous pouvez également migrer des applications d'entreprise vers les applications d'une équipe de développeurs, comme décrit dans l'article de la communauté Migrer des applications appartenant à l'entreprise vers des équipes de développeurs.

Étape 7: Préparez le lancement de votre portail intégré

Avant de lancer votre portail intégré en production, envisagez de suivre les étapes définies dans le tableau suivant.

Step	Description
Personnaliser votre domaine	Indiquez votre propre nom de domaine personnalisé pour personnaliser votre site. Remarque: Cette fonctionnalité n'est pas disponible pour les portails intégrés Apigee hybrid pour le moment.
Configurer le suivi des données analytiques	Configurez le suivi des données analytiques à l'aide de Google Analytics ou de votre propre service.
Créer une page de recherche personnalisée	Créez une page de recherche personnalisée et intégrez un moteur de recherche personnalisé Google.