Vous consultez la documentation d'Apigee Edge.
Accédez à la documentation sur Apigee X. info
Cette section explique comment planifier et exécuter la migration des composants de votre portail Drupal 7 vers le portail intégré.
Étape 1: Créer un portail intégré
Avant de migrer les composants de votre portail Drupal 7, vous devez créer un portail intégré.
Pour créer un portail intégré:
- Assurez-vous de disposer des rôles de portail appropriés pour gérer un portail intégré.
- Créez un portail intégré.
Lorsque vous créez un portail intégré, un ensemble de pages de démarrage vous est fourni 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 la section À propos de l'exemple de portail.
Étape 2: Créer votre portail intégré
Créez votre portail intégré, comme décrit dans la section Étapes à suivre pour créer votre portail.
Vous devez au minimum suivre les étapes indiquées dans le tableau suivant.
| Étape | Description |
|---|---|
| Développer le contenu du portail | comme des informations conceptuelles et de démarrage. Vous pouvez choisir de créer des pages, puis de copier-coller le contenu de la page directement depuis votre portail Drupal 7 existant. |
| Configurer la navigation | Créez la navigation requise pour qu'elle corresponde à votre structure existante. |
| Personnaliser votre thème | Personnalisez au minimum les composants suivants pour qu'ils correspondent à vos exigences en matière de branding: |
| Ajouter des scripts personnalisés | Ajoutez du 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 règle de sécurité du contenu (CSP) pour toutes les pages de votre portail afin de vous protéger contre les attaques par script intersites (XSS) et autres attaques d'injection de code.
Remarque: Pour le moment, cette fonctionnalité n'est pas disponible pour les portails intégrés Apigee hybrid. |
É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 (version bêta) sur le portail intégré.
Remarques :
|
Une fois que les développeurs se sont connectés au portail, vous pouvez gérer leur compte, comme décrit dans la section Gérer les comptes de développeur.
Étape 4: Contrôler l'accès aux ressources à l'aide d'audiences
Si vous utilisez des rôles dans Drupal 7 pour contrôler l'accès à un ensemble de ressources, telles que la documentation de l'API ou la création d'une clé API pour un produit d'API, vous pouvez obtenir la même fonctionnalité à l'aide d'audiences sur le portail intégré.
Plus précisément, vous pouvez contrôler l'accès à la ressource suivante sur le portail intégré à l'aide d'audiences:
- Pages de votre portail
- Produits API publiés
Pour ajouter une audience et gérer les attributions aux utilisateurs individuels et aux équipes de développeurs, consultez Gérer les audiences. Lorsqu'un nouvel utilisateur crée un compte et se connecte à votre portail, vous devez l'attribuer à une ou plusieurs audiences, comme décrit dans la section Gérer les attributions pour une audience.
Pour simplifier la migration, vous pouvez suivre les conseils suivants:
- Nommez vos audiences d'après les rôles Drupal qu'elles remplacent.
- Gérez l'appartenance à l'audience à l'aide d'équipes de développeurs. Les développeurs créent des équipes pour partager la responsabilité de leurs applications et gérer leur appartenance.
Étape 5: Publiez vos API
Pour publier des API et générer automatiquement une documentation de référence à l'aide de SmartDocs sur le portail intégré, vous devez avoir accès à la spécification OpenAPI associée à l'API.
Bien que vous ayez pu utiliser 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 d'API qui utilisent 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, utilisateurs authentifiés ou audiences sélectionnées)
- Configurer une URL de rappel, si nécessaire
- Ajouter une image à l'affichage dans votre catalogue d'API, si vous le souhaitez
Étape 6: Partager la responsabilité d'une application à l'aide d'é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 la même fonctionnalité à l'aide d'équipes de développeurs sur le portail intégré.
Vos développeurs créent des équipes de développeurs pour partager la responsabilité de leurs applications et gérer l'appartenance à l'équipe, comme décrit dans Partager la responsabilité d'une application à l'aide d'équipes de développeurs (bêta).
Vous pouvez sensibiliser votre communauté de développeurs aux équipes de développeurs et les encourager à migrer leurs applications vers des équipes de développeurs pour partager les responsabilités et passer aux nouvelles clés API. Vous pouvez 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 des applications d'équipe de développeurs, comme décrit dans l'article de la communauté Migrer des applications appartenant à une 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 | Spécifiez votre propre nom de domaine personnalisé pour personnaliser votre site. Remarque: Pour le moment, cette fonctionnalité n'est pas disponible pour les portails intégrés Apigee hybrid. |
| 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. |