Migration Ihres Drupal 7-Portals zum integrierten Portal

Sie sehen die Dokumentation zu Apigee Edge.
Zur Apigee X-Dokumentation weitere Informationen

Dieser Abschnitt enthält Anleitungen zur Planung und Durchführung der Migration Ihrer Drupal 7-Portal-Assets zum integrierten Portal.

Schritt 1: Integriertes Portal erstellen

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

So erstellen Sie ein integriertes Portal:

1. Prüfen Sie, ob Sie die entsprechenden Portalrollen zum Verwalten eines integrierten Portals haben.
2. Ein integriertes Portal erstellen

Wenn Sie ein integriertes Portal erstellen, wird eine Reihe von Einstiegsseiten bereitgestellt, die Sie als Ausgangspunkt verwenden können. 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 das integrierte Portal, wie unter Schritte zum Erstellen des Portals beschrieben.

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

Step	Beschreibung
Portalinhalte entwickeln	Dazu gehören konzeptbezogene Informationen und Informationen zu den ersten Schritten. Sie können Seiten erstellen und dann den Seiteninhalt direkt aus Ihrem bestehenden Drupal 7-Portal kopieren und einfügen.
Navigation einrichten	Erstellen Sie die Navigation, die zur Anpassung Ihrer vorhandenen Struktur erforderlich ist.
Design anpassen	Passen Sie mindestens die folgenden Komponenten an Ihre Branding-Anforderungen an: Logos und Favicons Farbpalette sowie Schriftfamilie und ‐stile Hintergrundbild
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 für in Apigee Hybrid integrierte Portale derzeit nicht verfügbar.
Standardsichtbarkeit verwalten	Verwalten Sie die Standardsichtbarkeit für bestimmte Ressourcen.
Content Security Policy konfigurieren	Sie konfigurieren eine Content Security Policy (CSP) für alle Seiten im Portal, um sie vor Cross-Site-Scripting (XSS) und anderen Angriffen mit Codeinjektion zu schützen. Hinweis: Dieses Feature ist derzeit nicht für in Apigee Hybrid integrierte Portale verfügbar.

Schritt 3: Identitätsanbieter konfigurieren

Konfigurieren Sie den Identitätsanbieter auf dem integrierten Portal basierend auf 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) über SAML	Konfigurieren Sie den SAML-Identitätsanbieter (Beta) im integrierten Portal. Hinweise: Tipps zum Einrichten Ihrer benutzerdefinierten Domain finden Sie im Hilfeartikel Benutzerdefinierte Domain mit einem SAML-Identitätsanbieter verwenden. Die Rollenzuordnung von SAML Assertion zu Drupal 7 wird für integrierte Portale nicht unterstützt. Stattdessen müssen Sie den Zugriff auf Ressourcen mithilfe von Zielgruppen steuern. Der SAML-Identitätsanbieter ist derzeit nicht für in Apigee Hybrid integrierte 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, erreichen Sie diese Funktionalität auch mithilfe von Zielgruppen im integrierten Portal.

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 einzelner 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 Ihre Zielgruppen nach den Drupal-Rollen, die sie ersetzen.
• Verwalten Sie die Zugehörigkeit zu Zielgruppen 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

Um mit SmartDocs im integrierten Portal APIs zu veröffentlichen und automatisch eine API-Referenzdokumentation zu generieren, benötigen Sie Zugriff auf die mit der API verknüpfte OpenAPI-Spezifikation.

Obwohl Sie möglicherweise eine OpenAPI-Spezifikation verwendet haben, um SmartDocs in Drupal 7 automatisch zu generieren, wird der Inhalt letztendlich in einem internen Format ohne Verknüpfung mit der ursprünglichen OpenAPI-Spezifikation gespeichert. API-Teams, die Apigee Edge verwenden, speichern OpenAPI-Spezifikationen normalerweise im Apigee Edge-Spezifikationsspeicher.

Veröffentlichen Sie dann eine API in Ihrem Portal. Bereite dich auf Folgendes vor:

• Geben Sie die als Dokumentationsquelle zu verwendende OpenAPI-Spezifikation aus dem Spezifikationsspeicher, Ihrem lokalen Verzeichnis oder einer URL an
• Sichtbarkeit für die Dokumentation festlegen (öffentlich, Authentifizierungsnutzer oder ausgewählte Zielgruppen)
• Konfigurieren Sie bei Bedarf eine Rückruf-URL.
• Fügen Sie der Anzeige in Ihrem API-Katalog bei Bedarf ein Bild hinzu

Schritt 6: Mithilfe von Entwicklerteams die Verantwortung für eine App teilen

Wenn Ihre Entwickler Unternehmens-Apps in Drupal 7 verwenden, um die Verantwortung für eine App mit anderen zu teilen, können sie dieselbe Funktionalität mithilfe von Entwicklerteams im integrierten Portal erreichen.

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

Sie können Ihre Entwickler-Community über die Entwicklerteams informieren und sie ermutigen, ihre Apps zu migrieren, damit diese die Verantwortung übertragen und zur Verwendung der neuen API-Schlüssel übergehen. Anschließend können Sie alle Unternehmensanwendungen und zugehörigen Artefakte mithilfe der Edge APIs entfernen.

Alternativ können Sie Unternehmensanwendungen zu Entwicklerteam-Apps migrieren, wie im folgenden Community-Artikel beschrieben: Unternehmenseigene Apps zu Entwicklerteams migrieren.

Schritt 7: Einführung des integrierten Portals vorbereiten

Bevor Sie das integrierte Portal für die Produktion veröffentlichen, 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: Dieses Feature ist derzeit nicht für in Apigee Hybrid integrierte 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.