Mengonfigurasi Contentful untuk penyediaan pengguna otomatis dengan Microsoft Entra ID

Artikel ini menjelaskan langkah-langkah yang perlu Anda selesaikan di Contentful dan di ID Microsoft Entra untuk mengonfigurasi provisi pengguna otomatis. Saat dikonfigurasi, MICROSOFT Entra ID secara otomatis memprovisi dan mendeprovisi pengguna dan grup ke Contentful dengan menggunakan layanan provisi Microsoft Entra. Untuk detail penting tentang apa yang dilakukan layanan ini dan cara kerjanya, dan untuk tanya jawab umum, lihat Mengotomatiskan provisi dan deprovisi pengguna ke aplikasi SaaS dengan ID Microsoft Entra.

Kemampuan yang didukung

  • Membuat pengguna di Contentful
  • Menghapus pengguna di Contentful saat mereka tidak memerlukan akses lagi
  • Menjaga atribut pengguna tetap sinkron antara MICROSOFT Entra ID dan Contentful
  • Mengelola grup dan keanggotaan grup di Contentful
  • Akses menyeluruh ke Contentful (disarankan)

Prasyarat

Skenario yang diuraikan dalam artikel ini mengasumsikan bahwa Anda sudah memiliki prasyarat berikut:

Merencanakan penyebaran provisi Anda

  1. Pelajari tentang cara kerja layanan provisi.
  2. Tentukan siapa yang masuk dalam cakupan penyediaan.
  3. Tentukan data apa yang akan dipetakan antara ID Microsoft Entra dan Contentful.

Mengonfigurasi Contentful untuk mendukung provisi dengan MICROSOFT Entra ID

  1. Di Contentful, buat akun Pengguna Layanan . Semua izin provisi untuk Azure disediakan melalui akun ini. Kami menyarankan agar Anda memilih Pemilik sebagai peran organisasi untuk akun ini.

  2. Masuk ke Contentful sebagai Pengguna Layanan.

  3. Di menu sebelah kiri, pilih Pengaturan organisasi>Access Tools>Provisi pengguna.

    Cuplikan layar menu Pengaturan organisasi di Contentful, dengan Provisi pengguna disorot di bawah Alat Akses.

  4. Salin dan simpan URL SCIM. Anda akan memasukkan nilai ini di portal Azure, pada tab Penyediaan aplikasi Contentful Anda.

  5. Pilih Buat token akses pribadi.

    Cuplikan layar memperlihatkan URL SCIM untuk menghasilkan token akses pribadi.

  6. Di jendela modal, masukkan nama untuk token akses pribadi Anda, lalu pilih Buat.

  7. URL SCIM dan token rahasia dihasilkan. Salin dan simpan nilai-nilai ini. Anda akan memasukkan nilai-nilai ini pada tab Penyediaan aplikasi Contentful Anda.

    Cuplikan layar panel Token akses pribadi, dengan C F P A T dan nama tempat penampung token disorot.

Jika Anda memiliki pertanyaan saat mengonfigurasi provisi di konsol admin Contentful, hubungi Dukungan Contentful.

Untuk mengelola provisi ke Contentful, tambahkan Contentful dari galeri aplikasi Microsoft Entra. Jika sebelumnya Anda telah menyiapkan Contentful untuk single sign-on, Anda dapat menggunakan aplikasi yang sama. Namun, kami sarankan Anda membuat aplikasi terpisah untuk menguji integrasi pada awalnya. Pelajari cara menambahkan aplikasi di galeri.

Tentukan siapa yang berada dalam cakupan untuk penyediaan

Layanan provisi Microsoft Entra memungkinkan Anda untuk mencakup siapa yang disediakan berdasarkan penugasan ke aplikasi, atau berdasarkan atribut pengguna atau grup. Jika Anda memilih untuk mencakup siapa yang diprovisikan ke aplikasi Anda berdasarkan penugasan, Anda dapat menggunakan langkah-langkah untuk menetapkan pengguna dan grup ke aplikasi. Jika Anda memilih untuk mencakup siapa yang disediakan hanya berdasarkan atribut pengguna atau grup, Anda dapat menggunakan filter cakupan.

  • Mulai dari yang kecil. Uji dengan sekumpulan kecil pengguna dan grup sebelum diluncurkan ke semua orang. Saat cakupan provisi diatur ke pengguna dan grup yang ditetapkan, Anda dapat mengontrolnya dengan menetapkan satu atau dua pengguna atau grup ke aplikasi. Ketika cakupan diatur ke semua pengguna dan grup, Anda dapat menentukan filter cakupan berbasis atribut.

  • Jika Anda memerlukan peran tambahan, Anda dapat memperbarui manifes aplikasi untuk menambahkan peran baru.

Mengonfigurasi provisi pengguna otomatis ke Contentful

Bagian ini memandu Anda melalui langkah-langkah untuk menyiapkan layanan provisi Microsoft Entra untuk membuat, memperbarui, dan menonaktifkan pengguna dan grup dalam aplikasi pengujian berdasarkan penetapan pengguna atau grup di ID Microsoft Entra.

Mengonfigurasi provisi pengguna otomatis untuk Contentful di MICROSOFT Entra ID

  1. Masuk ke pusat admin Microsoft Entra dengan peran minimal sebagai administrator aplikasi cloud.

  2. Telusuri ke Entra ID>Aplikasi Perusahaan.

    Cuplikan layar yang memperlihatkan menu Aplikasi perusahaan di portal Microsoft Azure, dengan Semua aplikasi disorot.

  3. Dalam daftar aplikasi, pilih Contentful.

    Cuplikan layar yang memperlihatkan 20 hasil pertama yang dikembalikan dalam daftar Aplikasi.

  4. Pilih tab Provisioning.

    Cuplikan layar tab Penyediaan disorot di bagian Kelola di menu sebelah kiri.

  5. Pilih + Konfigurasi baru.

    Tangkapan layar tab Penyediaan otomatis.

  6. Di dalam bidang URL Penyewa, masukkan URL Penyewa Contentful dan Token Rahasia Anda. Pilih Uji Koneksi untuk memastikan Microsoft Entra ID dapat terhubung ke Contentful. Jika koneksi gagal, pastikan akun Contentful Anda memiliki izin admin yang diperlukan, lalu coba lagi.

    Cuplikan layar pengujian koneksi provisioning.

  7. Pilih Buat untuk membuat konfigurasi Anda.

  8. Pilih Properti di halaman Gambaran Umum .

  9. Di bidang Email Pemberitahuan masukkan alamat email seseorang yang harusnya menerima pemberitahuan kesalahan provisi dan pilih Kirim pemberitahuan email ketika kegagalan terjadi pada kotak centangnya.

    Cuplikan layar properti Provisi.

  10. Pilih Pemetaan Atribut di panel kiri dan pilih pengguna.

  11. Tinjau atribut pengguna yang disinkronkan dari Microsoft Entra ID ke Contentful di bagian Attribute-Mapping. Atribut yang dipilih sebagai properti Pencocokan digunakan untuk mencocokkan akun pengguna di Contentful untuk operasi pembaruan. Jika Anda memilih untuk mengubah atribut target yang cocok, Anda perlu memastikan bahwa CONTENTFUL API mendukung pemfilteran pengguna berdasarkan atribut tersebut. Pilih tombol Simpan untuk menerapkan perubahan apa pun.

    Karakteristik Tipe Didukung untuk pemfilteran
    userName string
    namaDepan string
    nama.keluarga string
  12. Di bagian Pemetaan Atribut , tinjau atribut grup yang disinkronkan dari ID Microsoft Entra ke Contentful. Atribut yang dipilih sebagai properti Pencocokan digunakan untuk mencocokkan grup di Contentful untuk operasi pembaruan. Pilih tombol Simpan untuk menerapkan perubahan apa pun.

    Karakteristik Tipe Didukung untuk pemfilteran
    nama tampilan string
    anggota Referensi
  13. Untuk mengonfigurasi filter cakupan, lihat instruksi yang disediakan di artikel Filter cakupan.

  14. Gunakan provisi sesuai permintaan untuk memvalidasi sinkronisasi dengan sejumlah kecil pengguna sebelum menyebarkan lebih luas di organisasi Anda.

  15. Saat Anda siap untuk memprovisikan, pilih Mulai Provisi dari halaman Gambaran Umum .

Memantau penerapan Anda

Setelah Anda mengonfigurasi penyediaan, gunakan sumber daya berikut untuk memantau penyebaran Anda.

  1. Gunakan log provisi untuk menentukan pengguna mana yang berhasil disediakan atau tidak berhasil
  2. Periksa bilah progres untuk melihat status siklus penyediaan dan seberapa dekat penyelesaiannya
  3. Jika konfigurasi provisi tampaknya dalam keadaan tidak sehat, aplikasi masuk ke karantina. Pelajari lebih lanjut tentang status karantina penyediaan aplikasi di artikel status karantina .