Migration Ihres Drupal 7-Portals zum integrierten Portal

Sie sehen sich die Dokumentation zu Apigee Edge an.
Sehen Sie sich die Apigee X-Dokumentation an. info

In diesem Abschnitt erfahren Sie, wie Sie die Migration Ihrer Drupal 7-Portal-Assets in das integrierte Portal planen und ausführen.

Schritt 1: Eingebundenes Portal erstellen

Bevor Sie Ihre Drupal 7-Portal-Assets migrieren, müssen Sie ein integriertes Portal erstellen.

So erstellen Sie ein integriertes Portal:

1. Sie benötigen die entsprechenden Portalrollen, um ein integriertes Portal zu verwalten.
2. Erstellen Sie ein integriertes Portal.

Wenn Sie ein integriertes Portal erstellen, erhalten Sie eine Reihe von Startseiten als Ausgangspunkt. Die Startseite umfasst Demoinhalte, um Sie für Ihre eigene Portalentwicklung zu inspirieren, wenn Sie den Text und die Bilder durch Ihren eigenen Inhalt ersetzen. Weitere Informationen finden Sie unter Informationen zum Beispielportal.

Schritt 2: Integriertes Portal erstellen

Erstellen Sie Ihr integriertes Portal wie in Schritte zum Erstellen Ihres Portals beschrieben.

Sie müssen mindestens die in der folgenden Tabelle aufgeführten Schritte ausführen.

Schritt	Beschreibung
Portalinhalte entwickeln	Dazu gehören Konzepte und Informationen zum Einstieg. Sie können Seiten erstellen und den Seiteninhalt dann direkt aus Ihrem vorhandenen Drupal 7-Portal kopieren und einfügen.
Navigation einrichten	Erstellen Sie die Navigation, die zu Ihrer vorhandenen Struktur passt.
Design anpassen	Passen Sie mindestens die folgenden Komponenten an Ihre Brandinganforderungen an: Logos und Favicons Farbpalette und Schriftfamilie und -stile Background image
Benutzerdefinierte Skripts hinzufügen	Fügen Sie Ihrem Portal nach Bedarf benutzerdefinierten JavaScript-Code hinzu.
E-Mails konfigurieren	Konfigurieren Sie Ihren SMTP-Server und den Inhalt von E-Mail-Benachrichtigungen. Hinweis: Die Konfiguration von E-Mail-Benachrichtigungen ist derzeit nicht für integrierte Apigee Hybrid-Portale verfügbar.
Standardsichtbarkeit verwalten	Verwalten Sie die Standardsichtbarkeit für bestimmte Ressourcen.
Content Security Policy konfigurieren	Sie können eine Content Security Policy (CSP) für alle Seiten in Ihrem Portal konfigurieren, um sich vor Cross-Site-Scripting (XSS) und anderen Code-Injection-Angriffen zu schützen. Hinweis: Diese Funktion ist derzeit nicht für integrierte Apigee Hybrid-Portale verfügbar.

Schritt 3: Identitätsanbieter konfigurieren

Konfigurieren Sie den Identitätsanbieter im integrierten Portal entsprechend dem Authentifizierungstyp, wie in der folgenden Tabelle beschrieben.

Authentifizierung	Beschreibung
Integrierter Identitätsanbieter (Nutzername/Passwort)	Konfigurieren Sie den integrierten Identitätsanbieter im integrierten Portal.
Einmalanmeldung (SSO) mit SAML	Konfigurieren Sie den SAML-Identitätsanbieter (Beta) im integrierten Portal. Hinweise: Unter Benutzerdefinierte Domain mit SAML-Identitätsanbieter verwenden finden Sie Tipps zum Einrichten Ihrer benutzerdefinierten Domain. Die Zuordnung von SAML-Bestätigungen zu Drupal 7-Rollen wird für integrierte Portale nicht unterstützt. Stattdessen müssen Sie den Zugriff auf Ressourcen über Zielgruppen steuern. Der SAML-Identitätsanbieter ist derzeit nicht für integrierte Apigee Hybrid-Portale verfügbar.

Nachdem sich Entwickler im Portal angemeldet haben, können Sie ihr Konto wie unter Entwicklerkonten verwalten beschrieben verwalten.

Schritt 4: Zugriff auf Ressourcen mithilfe von Zielgruppen steuern

Wenn Sie in Drupal 7 Rollen verwenden, um den Zugriff auf eine Reihe von Ressourcen zu steuern, z. B. die API-Dokumentation oder die Erstellung von API-Schlüsseln für ein API-Produkt, können Sie diese Funktion auch mit Zielgruppen im integrierten Portal nutzen.

Insbesondere können Sie mithilfe von Zielgruppen den Zugriff auf die folgenden Ressourcen im integrierten Portal steuern:

• Seiten auf dem Portal
• Veröffentlichte API-Produkte

Informationen zum Hinzufügen einer Zielgruppe und zum Verwalten der Zuweisungen für einzelne Nutzer und Entwicklerteams finden Sie unter Zielgruppen verwalten. Wenn ein neuer Nutzer ein Konto erstellt und sich in Ihrem Portal anmeldet, müssen Sie ihm bei Bedarf eine oder mehrere Zielgruppen zuweisen, wie unter Zuweisungen für eine Zielgruppe verwalten beschrieben.

Beachten Sie die folgenden Tipps, um die Migration zu vereinfachen:

• Benennen Sie die Zielgruppen nach den Drupal-Rollen, die sie ersetzen.
• Verwalten Sie die Zielgruppenmitgliedschaft mithilfe von Entwicklerteams. Entwickler erstellen Teams, um die Verantwortung für ihre Apps zu teilen und die Teammitgliedschaft zu verwalten.

Schritt 5: APIs veröffentlichen

Wenn Sie APIs veröffentlichen und mit SmartDocs im integrierten Portal automatisch API-Referenzdokumentationen generieren möchten, benötigen Sie Zugriff auf die OpenAPI-Spezifikation, die mit der API verknüpft ist.

Auch wenn Sie möglicherweise eine OpenAPI-Spezifikation verwendet haben, um die SmartDocs in Drupal 7 automatisch zu generieren, werden die Inhalte letztendlich in einem internen Format gespeichert, ohne dass eine Verknüpfung mit der ursprünglichen OpenAPI-Spezifikation besteht. API-Teams, die Apigee Edge verwenden, speichern OpenAPI-Spezifikationen in der Apigee Edge-Speicherdatei für Spezifikationen.

Veröffentlichen Sie dann eine API in Ihrem Portal. Seien Sie auf Folgendes vorbereitet:

• Geben Sie die OpenAPI-Spezifikation an, die als Dokumentationsquelle verwendet werden soll, aus dem Spezifikationsspeicher, Ihrem lokalen Verzeichnis oder einer URL.
• Sichtbarkeit der Dokumentation festlegen (öffentlich, authentifizierte Nutzer oder ausgewählte Zielgruppen)
• Callback-URL konfigurieren (falls erforderlich)
• Fügen Sie dem Display in Ihrem API-Katalog ein Bild hinzu, falls gewünscht.

Schritt 6: Verantwortung für eine App mit Entwicklerteams teilen

Wenn Ihre Entwickler Unternehmensanwendungen in Drupal 7 verwenden, um die Verantwortung für eine App zu teilen, können sie diese Funktion auch mit Entwicklerteams im integrierten Portal nutzen.

Ihre Entwickler erstellen Entwicklerteams, um die Verantwortung für ihre Apps zu teilen und die Teammitgliedschaft zu verwalten, wie unter Verantwortung für eine App mit Entwicklerteams teilen (Beta) beschrieben.

Sie können Ihre Entwickler-Community über Entwicklerteams informieren und sie dazu anregen, ihre Apps zu migrieren, um Entwicklerteams zur gemeinsamen Verantwortungsübernahme zu verwenden und auf die neuen API-Schlüssel umzustellen. Anschließend können Sie alle Unternehmens-Apps und zugehörigen Artefakte mithilfe der Edge APIs entfernen.

Alternativ können Sie Unternehmens-Apps zu Entwicklerteam-Apps migrieren, wie im folgenden Communityartikel beschrieben: Unternehmenseigene Apps zu Entwicklerteams migrieren.

Schritt 7: Einführung des integrierten Portals vorbereiten

Bevor Sie Ihr integriertes Portal in der Produktionsumgebung starten, sollten Sie die in der folgenden Tabelle beschriebenen Schritte ausführen.

Step	Beschreibung
Domain personalisieren	Geben Sie Ihren eigenen benutzerdefinierten Domainnamen an, um Ihre Website zu personalisieren. Hinweis: Diese Funktion ist derzeit nicht für integrierte Apigee Hybrid-Portale verfügbar.
Analytics-Tracking konfigurieren	Konfigurieren Sie das Analytics-Tracking mit Google Analytics oder Ihrem eigenen benutzerdefinierten Analytics-Tracking-Dienst.
Benutzerdefinierte Suchseite erstellen	Erstellen Sie eine benutzerdefinierte Suchseite und betten Sie eine benutzerdefinierte Suchmaschine von Google ein.