Wyświetlasz dokumentację Apigee Edge.
Otwórz dokumentację Apigee X. Informacje
W tej sekcji znajdziesz wskazówki dotyczące planowania i przeprowadzania migracji zasobów portalu Drupal 7 do zintegrowanego portalu.
Krok 1. Utwórz zintegrowany portal
Zanim przekształcisz zasoby portalu Drupal 7, musisz utworzyć zintegrowany portal.
Aby utworzyć zintegrowany portal:
- Upewnij się, że masz odpowiednie role w portalu, aby zarządzać zintegrowanym portalem.
- Utwórz zintegrowany portal.
Podczas tworzenia zintegrowanego portalu otrzymasz zestaw stron początkowych, które możesz wykorzystać jako punkt wyjścia. Strony startowe zawierają treści demonstracyjne, które mogą być inspiracją do tworzenia własnego portalu. Wystarczy, że zastąpisz tekst i obrazy własnymi treściami. Więcej informacji znajdziesz w artykule Informacje o portalu z próbkami.
Krok 2. Utwórz zintegrowany portal
Utwórz zintegrowany portal zgodnie z instrukcjami podanymi w artykule Tworzenie portalu.
Musisz wykonać co najmniej czynności wymienione w tabeli poniżej.
| Krok | Opis |
|---|---|
| Tworzenie treści portalu | Na przykład informacje ogólne i informacje na temat uruchamiania. Możesz tworzyć strony, a potem kopiować i wklejać zawartość strony bezpośrednio z dotychczasowego portalu Drupal 7. |
| Konfigurowanie nawigacji | Utwórz nawigację odpowiadającą Twojej dotychczasowej strukturze. |
| Dostosowywanie motywu | W minimalnym zakresie dostosuj te komponenty do swoich wymagań dotyczących marki: |
| Dodawanie skryptów niestandardowych | W razie potrzeby dodaj do portalu niestandardowy kod JavaScriptu. |
| Konfigurowanie poczty e-mail | Skonfiguruj serwer SMTP i treści powiadomień e-mail. Uwaga: konfiguracja powiadomień e-mail nie jest obecnie dostępna w przypadku portali zintegrowanych hybrydowo z Apigee. |
| Zarządzanie widocznością domyślną | zarządzać domyślną widocznością konkretnych zasobów. |
| Konfigurowanie standardu Content Security Policy | Skonfiguruj standard Content Security Policy (CSP) dla wszystkich stron w portalu, aby chronić się przed atakami typu cross-site scripting (XSS) i innymi atakami polegającymi na wstrzykiwaniu kodu. Uwaga: ta funkcja jest obecnie niedostępna w przypadku hybrydowych portali zintegrowanych z Apigee. |
Krok 3. Skonfiguruj dostawcę tożsamości
Skonfiguruj dostawcę tożsamości w zintegrowanym portalu na podstawie typu uwierzytelniania, jak opisano w poniższej tabeli.
| Uwierzytelnianie | Opis |
|---|---|
| Dostawca tożsamości wbudowany (nazwa użytkownika i hasło) | Skonfiguruj wbudowany dostawcę tożsamości w zintegrowanym portalu. |
| Logowanie jednokrotne (SSO) za pomocą SAML | Skonfiguruj dostawcę tożsamości SAML (wersja beta) w zintegrowanym portalu.
Uwagi:
|
Gdy deweloperzy zalogują się na portal, możesz zarządzać ich kontem w sposób opisany w artykule Zarządzanie kontami deweloperów.
Krok 4. Kontroluj dostęp do zasobów za pomocą list odbiorców
Jeśli w Drupalu 7 używasz ról do kontrolowania dostępu do zbioru zasobów, np. dokumentacji interfejsu API lub tworzenia klucza interfejsu API dla usługi interfejsu API, możesz uzyskać tę samą funkcjonalność, korzystając z odbiorców w zintegrowanym portalu.
Korzystając z list odbiorców, możesz kontrolować dostęp do tych zasobów w zintegrowanym portalu:
- Strony w Twoim portalu
- Opublikowane usługi API
Aby dodać listę odbiorców i zarządzać przypisaniem do niej poszczególnych użytkowników i zespołów programistów, przeczytaj artykuł Zarządzanie listami odbiorców. Gdy nowy użytkownik utworzy konto i zaloguje się w Twoim portalu, musisz go przypisać do co najmniej 1 listy odbiorców, zgodnie z opisem w artykule Zarządzanie przypisaniami do listy odbiorców.
Aby uprościć migrację, zastosuj te wskazówki:
- Nazwy list odbiorców nadaj zgodnie z rolami w Drupal, które zastępują.
- Zarządzaj członkostwem w grupie odbiorców za pomocą zespołów programistów. Deweloperzy tworzą zespoły, aby dzielić się odpowiedzialnością za aplikacje i zarządzać członkostwem w nich.
Krok 5. Opublikuj interfejsy API
Aby publikować interfejsy API i automatycznie generować dokumentację referencyjną interfejsu API za pomocą SmartDocs w zintegrowanym portalu, musisz mieć dostęp do specyfikacji OpenAPI powiązanej z interfejsem API.
Chociaż do automatycznego generowania dokumentów SmartDocs w Drupalu 7 możesz użyć specyfikacji OpenAPI, ostatecznie treści są przechowywane w wewnętrznym formacie bez żadnego powiązania z pierwotną specyfikacją OpenAPI. Zespoły interfejsów API korzystające z Apigee Edge zwykle przechowują specyfikacje OpenAPI w sklepie ze specyfikacjami Apigee Edge.
Następnie opublikuj interfejs API w swoim portalu. Przygotuj się na:
- Podaj specyfikację OpenAPI, której chcesz użyć jako źródła dokumentacji, z repozytorium specyfikacji, katalogu lokalnego lub adresu URL.
- Konfigurowanie widoczności dokumentacji (publiczna, uwierzytelnieni użytkownicy lub wybrane grupy odbiorców)
- W razie potrzeby skonfiguruj adres URL wywołania zwrotnego
- Dodaj obraz do wyświetlania w katalogu interfejsu API (opcjonalnie).
Krok 6. Podziel się odpowiedzialnością za aplikację z zespołami programistów
Jeśli Twoi deweloperzy korzystają z aplikacji firmowych w Drupal 7, aby dzielić się odpowiedzialnością za aplikację, mogą uzyskać tę samą funkcjonalność, korzystając z zespołów deweloperów w zintegrowanym portalu.
Twoi deweloperzy tworzą zespoły deweloperów, aby dzielić się odpowiedzialnością za aplikacje i zarządzać członkostwem w zespole, zgodnie z opisem w artykule Udzielanie dostępu do aplikacji za pomocą zespołów deweloperów (beta).
Możesz poinformować społeczność deweloperów o tym, jak korzystać z zespołów deweloperów, i zachęcić ich do przeniesienia aplikacji na zespoły deweloperów, aby podzielić się odpowiedzialnością i przejść na używanie nowych kluczy interfejsu API. Następnie możesz usunąć wszystkie aplikacje firmowe i powiązane artefakty za pomocą interfejsów Edge API.
Możesz też przenieść aplikacje firmowe do aplikacji zespołu deweloperów, jak opisano w tym artykule społeczności: Przenoszenie aplikacji firmowych do zespołów deweloperów.
Krok 7. Przygotuj się do uruchomienia zintegrowanego portalu
Zanim wdrożysz zintegrowany portal w środowisku produkcyjnym, rozważ wykonanie czynności opisanych w tabeli poniżej.
| Step | Opis |
| Dostosowywanie domeny | Podaj własną nazwę domeny niestandardowej, aby spersonalizować witrynę. Uwaga: ta funkcja jest obecnie niedostępna w przypadku hybrydowych portali zintegrowanych z Apigee. |
| Konfigurowanie śledzenia analityki | skonfigurować śledzenie analityczne za pomocą Google Analytics lub własnej usługi analitycznej. |
| Tworzenie strony wyszukiwania niestandardowej | Utwórz stronę wyszukiwarki niestandardowej i osadz w niej wyszukiwarkę niestandardową Google. |