Anda sedang melihat dokumentasi Apigee Edge.
Buka
dokumentasi Apigee X. info
Bagian ini berisi panduan tentang cara merencanakan dan menjalankan migrasi aset portal Drupal 7 Anda ke portal terintegrasi.
Langkah 1: Buat portal terintegrasi
Sebelum memigrasikan aset portal Drupal 7, Anda harus membuat portal terintegrasi.
Untuk membuat portal terintegrasi:
- Pastikan Anda memiliki peran portal yang sesuai untuk mengelola portal terintegrasi.
- Buat portal terintegrasi.
Saat membuat portal terintegrasi, kami menyediakan sekumpulan halaman awal untuk digunakan 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 informasi selengkapnya, lihat Tentang portal contoh.
Langkah 2: Buat portal terintegrasi Anda
Buat portal terintegrasi, seperti yang dijelaskan di Langkah-langkah membangun portal.
Setidaknya, Anda perlu melakukan langkah-langkah yang tercantum dalam tabel berikut.
| Langkah | Deskripsi |
|---|---|
| Mengembangkan konten portal | Seperti informasi konseptual dan informasi untuk memulai. Anda dapat memilih untuk membuat halaman, lalu menyalin dan menempelkan konten halaman secara langsung dari portal Drupal 7 yang sudah ada. |
| Menyiapkan navigasi | Buat navigasi yang diperlukan agar sesuai dengan struktur yang ada. |
| Menyesuaikan tema | Setidaknya, sesuaikan komponen berikut agar cocok 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 hybrid Apigee. |
| Mengelola visibilitas default | Mengelola visibilitas default untuk resource tertentu. |
| Mengonfigurasi kebijakan keamanan konten | Konfigurasikan kebijakan keamanan konten (CSP) untuk semua halaman di portal Anda agar terlindung dari pembuatan skrip lintas situs (XSS) dan serangan injeksi kode lainnya, jika diinginkan.
Catatan: Saat ini, fitur ini tidak tersedia untuk portal terintegrasi Apigee Hybrid. |
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 Anda menggunakan peran di Drupal 7 untuk mengontrol akses ke sekumpulan resource, seperti dokumentasi API atau pembuatan kunci API untuk produk API, Anda dapat memperoleh fungsi yang sama ini menggunakan audience di portal terintegrasi.
Secara khusus, Anda dapat mengontrol akses ke referensi berikut di portal terintegrasi menggunakan audiens:
- Halaman di portal Anda
- Produk API yang dipublikasikan
Untuk menambahkan audiens dan mengelola masing-masing tugas pengguna dan tim developer, lihat Mengelola audiens. Saat pengguna baru membuat akun dan login ke portal, Anda perlu 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 peran Drupal yang mereka ganti.
- Kelola keanggotaan audiens menggunakan tim developer. Developer membentuk tim untuk berbagi tanggung jawab atas aplikasi mereka dan mengelola keanggotaan tim.
Langkah 5: Memublikasikan API
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 sudah menggunakan Spesifikasi OpenAPI untuk membuat SmartDocs secara otomatis di Drupal 7, pada akhirnya konten akan disimpan menggunakan format internal tanpa ada kaitannya dengan 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:
- Menetapkan Spesifikasi OpenAPI untuk digunakan sebagai sumber dokumentasi, dari penyimpanan spesifikasi, direktori lokal, atau URL
- Menyiapkan visibilitas untuk dokumentasi (publik, pengguna autentikasi, atau audiens yang dipilih)
- Mengonfigurasi URL callback, jika diperlukan
- Tambahkan gambar ke tampilan dalam katalog API Anda, jika diinginkan
Langkah 6: Membagikan tanggung jawab atas aplikasi menggunakan tim developer
Jika developer menggunakan aplikasi perusahaan di Drupal 7 untuk berbagi tanggung jawab atas sebuah aplikasi, mereka dapat memperoleh 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 Berbagi tanggung jawab atas aplikasi menggunakan tim developer (Beta).
Anda mungkin ingin mengedukasi komunitas developer mengenai tim developer dan mendorong mereka untuk memigrasikan aplikasi agar menggunakan tim developer untuk berbagi tanggung jawab dan beralih menggunakan 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: Bersiaplah untuk meluncurkan portal terintegrasi
Sebelum meluncurkan portal terintegrasi ke produksi, pertimbangkan untuk melakukan langkah-langkah yang ditentukan dalam tabel berikut.
| Langkah | Deskripsi |
| Menyesuaikan domain Anda | Berikan nama domain kustom Anda sendiri untuk mempersonalisasi situs. Catatan: Saat ini, fitur ini tidak tersedia untuk portal terintegrasi Apigee Hybrid. |
| Mengonfigurasi pelacakan analisis | Konfigurasikan pelacakan analisis menggunakan Google Analytics atau layanan pelacakan analisis kustom Anda sendiri. |
| Membuat halaman penelusuran kustom | Buat halaman penelusuran khusus dan sematkan mesin telusur khusus Google. |