Memigrasikan portal Drupal 7 ke portal terintegrasi

Anda sedang melihat dokumentasi Apigee Edge.
Buka dokumentasi Apigee X.
info

Bagian ini memberikan panduan tentang cara merencanakan dan menjalankan migrasi aset portal Drupal 7 ke portal terintegrasi.

Langkah 1: Buat portal terintegrasi

Sebelum memigrasikan aset portal Drupal 7, Anda harus membuat portal terintegrasi.

Untuk membuat portal terintegrasi:

  1. Pastikan Anda memiliki peran portal yang sesuai untuk mengelola portal terintegrasi.
  2. Membuat portal terintegrasi.

Saat Anda membuat portal terintegrasi, serangkaian halaman awal disediakan untuk Anda gunakan sebagai titik awal. Halaman awal berisi konten demo untuk membantu menginspirasi pengembangan portal Anda sendiri saat Anda mengganti teks dan gambar dengan konten unik Anda. Untuk mengetahui informasi selengkapnya, lihat Tentang portal contoh.

Langkah 2: Buat portal terintegrasi

Build portal terintegrasi Anda, seperti yang dijelaskan dalam Langkah-langkah untuk mem-build portal.

Setidaknya, Anda harus melakukan langkah-langkah yang tercantum dalam tabel berikut.

Langkah Deskripsi
Mengembangkan konten portal Seperti informasi konseptual dan informasi memulai.

Anda dapat memilih untuk membuat halaman, lalu menyalin dan menempelkan konten halaman langsung dari portal Drupal 7 yang ada.

Menyiapkan navigasi Buat navigasi yang diperlukan agar cocok dengan struktur yang ada.
Menyesuaikan tema Minimal, sesuaikan komponen berikut agar sesuai dengan persyaratan branding Anda:
Menambahkan skrip kustom Tambahkan kode JavaScript kustom ke portal Anda, sesuai kebutuhan.
Mengonfigurasi email Konfigurasikan server SMTP dan konten notifikasi email.

Catatan: Konfigurasi notifikasi email saat ini tidak tersedia untuk portal terintegrasi Apigee Hybrid.

Mengelola visibilitas default Mengelola visibilitas default untuk resource tertentu.
Mengonfigurasi kebijakan keamanan konten Konfigurasikan kebijakan keamanan konten (CSP) untuk semua halaman di portal Anda guna melindungi dari serangan pembuatan skrip lintas situs (XSS) dan serangan injeksi kode lainnya, jika diinginkan.

Catatan: Saat ini, fitur ini tidak tersedia untuk portal terintegrasi hibrida Apigee.

Langkah 3: Konfigurasikan penyedia identitas

Konfigurasikan penyedia identitas di portal terintegrasi berdasarkan jenis autentikasi, seperti yang diuraikan dalam tabel berikut.

Autentikasi Deskripsi
Penyedia identitas bawaan (nama pengguna/sandi) Konfigurasi penyedia identitas bawaan di portal terintegrasi.
Single Sign-On (SSO) menggunakan SAML Konfigurasikan penyedia identitas SAML (Beta) di portal terintegrasi.

Catatan:

Setelah developer login ke portal, Anda dapat mengelola akun mereka, seperti yang dijelaskan di Mengelola akun developer.

Langkah 4: Kontrol akses ke resource menggunakan audiens

Jika menggunakan peran di Drupal 7 untuk mengontrol akses ke kumpulan resource, seperti dokumentasi API atau pembuatan kunci API untuk produk API, Anda dapat mencapai fungsi yang sama menggunakan audiens di portal terintegrasi.

Secara khusus, Anda dapat mengontrol akses ke resource berikut di portal terintegrasi menggunakan audiens:

  • Halaman di portal Anda
  • Produk API yang dipublikasikan

Untuk menambahkan audiens dan mengelola penetapan pengguna dan tim developer, lihat Mengelola audiens. Saat pengguna baru membuat akun dan login ke portal, Anda harus menetapkannya ke satu atau beberapa audiens, sebagaimana diperlukan, seperti yang dijelaskan dalam Mengelola penetapan untuk audiens.

Untuk menyederhanakan migrasi, Anda dapat mempertimbangkan tips berikut:

  • Beri nama audiens Anda sesuai dengan peran Drupal yang diganti.
  • Kelola keanggotaan audiens menggunakan tim developer. Developer membuat tim untuk berbagi tanggung jawab atas aplikasi mereka dan mengelola keanggotaan tim.

Langkah 5: Publikasikan API Anda

Untuk memublikasikan API dan membuat dokumentasi referensi API secara otomatis menggunakan SmartDocs di portal terintegrasi, Anda memerlukan akses ke Spesifikasi OpenAPI yang terkait dengan API.

Meskipun Anda mungkin telah menggunakan Spesifikasi OpenAPI untuk membuat SmartDocs secara otomatis di Drupal 7, pada akhirnya konten disimpan menggunakan format internal tanpa pengaitan apa pun ke Spesifikasi OpenAPI asli. Tim API yang menggunakan Apigee Edge biasanya menyimpan Spesifikasi OpenAPI di penyimpanan spesifikasi Apigee Edge.

Kemudian, publikasikan API ke portal Anda. Bersiaplah untuk:

  • Tentukan Spesifikasi OpenAPI yang akan digunakan sebagai sumber dokumentasi, dari toko spesifikasi, direktori lokal Anda, atau URL
  • Menyiapkan visibilitas untuk dokumentasi (publik, pengguna autentikasi, atau audiens yang dipilih)
  • Mengonfigurasi URL callback, jika diperlukan
  • Tambahkan gambar ke tampilan di katalog API Anda, jika diinginkan

Langkah 6: Membagikan tanggung jawab untuk aplikasi menggunakan tim developer

Jika developer Anda menggunakan aplikasi perusahaan di Drupal 7 untuk berbagi tanggung jawab atas aplikasi, mereka dapat mencapai fungsi yang sama ini menggunakan tim developer di portal terintegrasi.

Developer Anda membuat tim developer untuk berbagi tanggung jawab atas aplikasi mereka dan mengelola keanggotaan tim, seperti yang dijelaskan dalam Membagikan tanggung jawab atas aplikasi menggunakan tim developer (Beta).

Anda mungkin ingin mengedukasi komunitas developer tentang tim developer dan mendorong mereka untuk memigrasikan aplikasi mereka agar menggunakan tim developer untuk berbagi tanggung jawab dan bertransisi ke penggunaan kunci API baru. Kemudian, Anda dapat menghapus semua aplikasi perusahaan dan artefak terkait menggunakan Edge API.

Atau, Anda dapat memigrasikan aplikasi perusahaan ke aplikasi tim developer, seperti yang dijelaskan dalam artikel komunitas berikut: Memigrasikan aplikasi milik perusahaan ke tim developer.

Langkah 7: Bersiap meluncurkan portal terintegrasi

Sebelum meluncurkan portal terintegrasi ke produksi, pertimbangkan untuk melakukan langkah-langkah yang ditentukan dalam tabel berikut.

Langkah Deskripsi
Menyesuaikan domain Berikan nama domain kustom Anda sendiri untuk mempersonalisasi situs.

Catatan: Saat ini, fitur ini tidak tersedia untuk portal terintegrasi hibrida Apigee.

Mengonfigurasi pelacakan Analytics Konfigurasikan pelacakan analisis menggunakan Google Analytics atau layanan pelacakan analisis kustom Anda sendiri.
Membuat halaman penelusuran kustom Buat halaman penelusuran kustom dan sematkan mesin telusur kustom Google.