Mengonfigurasi Yellowbox untuk provisi pengguna otomatis dengan Microsoft Entra ID

Artikel ini menjelaskan langkah-langkah yang perlu Anda lakukan di Yellowbox dan Microsoft Entra ID untuk mengonfigurasi provisi pengguna otomatis. Saat dikonfigurasi, Microsoft Entra ID secara otomatis memprovisi dan mendeprovisi pengguna dan grup untuk Yellowbox menggunakan layanan provisi Microsoft Entra. Untuk detail penting tentang apa yang dilakukan layanan ini, cara kerjanya, dan pertanyaan yang sering diajukan, lihat Otomatisasi provisi dan deprovisi pengguna ke aplikasi SaaS dengan Microsoft Entra ID.

Kemampuan yang Didukung

  • Membuat pengguna di Yellowbox
  • Menghapus pengguna di Yellowbox saat mereka tidak memerlukan akses lagi
  • Menjaga atribut pengguna tetap sinkron antara Microsoft Entra ID dan Yellowbox

Prasyarat

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

Langkah 1: Rencanakan penyediaan layanan Anda

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

Langkah 2: Konfigurasikan Yellowbox untuk mendukung provisi dengan Microsoft Entra ID

  • Gunakan https://australia-southeast1-yellowbox-f4c6e.cloudfunctions.net/scim sebagai Url Penyewa.
  • Dapatkan Token otorisasi JWT Anda dari yellowbox dengan menghubungi dukungan Yellowbox, jika Anda belum menerima token.

Tambahkan Yellowbox dari galeri aplikasi Microsoft Entra untuk mulai mengelola konfigurasi ke Yellowbox. Jika sebelumnya Anda telah menyiapkan Yellowbox untuk SSO, Anda dapat menggunakan aplikasi yang sama. Namun, kami sarankan Anda membuat aplikasi terpisah saat menguji integrasi pada awalnya. Pelajari selengkapnya tentang cara menambahkan aplikasi dari galeri di sini.

Langkah 4: Tentukan siapa yang berada dalam cakupan provisi

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.

Langkah 5: Mengonfigurasi provisi pengguna otomatis ke Yellowbox

Bagian ini memandu Anda melalui langkah-langkah untuk mengonfigurasi layanan provisi Microsoft Entra untuk membuat, memperbarui, dan menonaktifkan pengguna dan/atau grup di Yellowbox berdasarkan penetapan pengguna dan/atau grup di Microsoft Entra ID.

Mengonfigurasi provisi pengguna otomatis untuk Yellowbox di Microsoft Entra ID

  1. Masuk ke pusat admin Microsoft Entra sebagai setidaknya Cloud Application Administrator.

  2. Telusuri ke aplikasi Entra ID>Enterprise

    Cuplikan layar bilah aplikasi Enterprise.

  3. Dalam daftar aplikasi, pilih Yellowbox.

    Cuplikan layar tautan Yellowbox di daftar Aplikasi.

  4. Pilih tab Provisioning.

    Tangkapan layar dari tab Provisioning.

  5. Pilih + Konfigurasi baru.

    Cuplikan layar konfigurasi baru.

  6. Di bidang URL Penyewa , masukkan URL Penyewa Dan Token Rahasia Yellowbox Anda. Pilih Koneksi Test untuk memastikan Microsoft Entra ID dapat tersambung ke Yellowbox. Jika koneksi gagal, pastikan akun Yellowbox 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. Pilih ikon Edit untuk mengedit properti. Aktifkan email pemberitahuan dan berikan email untuk menerima pemberitahuan karantina. Aktifkan Pencegahan penghapusan yang tidak disengaja. Pilih Terapkan untuk menyimpan perubahan.

    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 Yellowbox di bagian Attribute-Mapping. Atribut yang dipilih sebagai properti Pencocokan digunakan untuk mencocokkan akun pengguna di Yellowbox untuk operasi pembaruan. Jika Anda memilih untuk mengubah atribut target yang cocok, Anda perlu memastikan bahwa YELLOWbox API mendukung pemfilteran pengguna berdasarkan atribut tersebut. Pilih tombol Simpan untuk menerapkan perubahan apa pun.

    Karakteristik Tipe Didukung untuk pemfilteran Diperlukan oleh Yellowbox
    userName string ✓ ✓
    peran[utama sama dengan "Ya"].nilai string ✓
    aktif Boolean ✓
    nama tampilan string ✓
    Id eksternal string ✓

  12. Untuk mengonfigurasi filter cakupan, lihat instruksi yang disediakan di artikel Filter cakupan.

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

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

Langkah 6: Memantau penyebaran 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 .

Sumber daya lainnya

Konten terkait

  • Last updated on