Bagikan melalui


Tutorial: Mengonfigurasi Oneflow untuk provisi pengguna otomatis

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

Kemampuan yang didukung

  • Buat pengguna di Oneflow.
  • Hapus pengguna di Oneflow saat mereka tidak memerlukan akses lagi.
  • Menjaga atribut pengguna tetap sinkron antara MICROSOFT Entra ID dan Oneflow.
  • Memprovisikan grup dan keanggotaan grup di Oneflow.
  • Akses menyeluruh ke Oneflow (disarankan).

Prasyarat

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

Langkah 1: Merencanakan penyebaran provisi Anda

  1. Pelajari tentang Cara kerja layanan provisi .
  2. Tentukan siapa yang akan berada dalam cakupan untuk provisi.
  3. Tentukan data apa yang akan dipetakan antara ID Microsoft Entra dan Oneflow.

Langkah 2: Mengonfigurasi Oneflow untuk mendukung provisi dengan ID Microsoft Entra

Gunakan informasi berikut untuk Langkah 5-6.

  • URL Penyewa: https://api.oneflow.com/scim/v1/

  • Token Rahasia: Token SCIM oneflow berfungsi sebagai token rahasia dalam provisi. Ikuti langkah-langkah yang disediakan dalam tutorial ini untuk menghasilkan token SCIM Oneflow.

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

Langkah 4 : Tentukan siapa yang akan berada dalam cakupan provisi

Layanan provisi Microsoft Entra memungkinkan Anda untuk mencakup siapa yang akan disediakan berdasarkan penugasan ke aplikasi dan atau berdasarkan atribut pengguna /grup. Jika Anda memilih untuk mencakup siapa saja yang akan diprovisi ke aplikasi berdasarkan penugasan, Anda dapat mengikuti langkah-langkah berikut untuk menetapkan pengguna dan grup ke aplikasi. Jika Anda memilih untuk mencakup siapa saja yang akan diprovisikan hanya berdasarkan pada atribut pengguna atau grup, Anda dapat menggunakan filter cakupan seperti yang dijelaskan di sini.

  • Mulai dari yang kecil. Lakukan pengujian pada set kecil pengguna dan grup sebelum meluncurkan ke semua orang. Saat cakupan provisi diatur ke pengguna dan grup yang telah 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 lebih banyak peran, Anda dapat memperbarui manifes aplikasi untuk menambahkan peran baru.

Langkah 5: Mengonfigurasi provisi pengguna otomatis ke Oneflow

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

Untuk mengonfigurasi provisi pengguna otomatis untuk Oneflow di ID Microsoft Entra:

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

  2. Telusuri aplikasi Identity>Applications>Enterprise

    Cuplikan layar bilah aplikasi Enterprise.

  3. Dalam daftar aplikasi, pilih Oneflow.

    Cuplikan layar tautan Oneflow di daftar Aplikasi.

  4. Pilih Provisi tab.

    Cuplikan layar tab Provisi.

  5. Atur Mode Provisi ke Otomatis.

    Cuplikan layar tab Provisi otomatis.

  6. Di bawah bagian Info Masuk Admin, masukkan URL Penyewa Oneflow dan Token Rahasia Anda. Klik Uji Koneksi ion untuk memastikan ID Microsoft Entra dapat tersambung ke Oneflow. Jika koneksi gagal, pastikan akun Oneflow Anda memiliki izin Admin, lalu coba lagi.

    Cuplikan layar Token.

  7. Di bidang Surel Pemberitahuan, masukkan alamat surel seseorang atau grup penerima pemberitahuan kesalahan provisi dan pilih kotak centang Kirim pemberitahuan surel ketika kegagalan terjadi.

    Cuplikan layar Email Pemberitahuan

  8. Pilih Simpan.

  9. Di bawah bagian Pemetaan , pilih Sinkronkan pengguna Microsoft Entra ke Oneflow.

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

    Atribut Jenis Didukung untuk pemfilteran Diperlukan oleh Oneflow
    userName String
    active Boolean
    externalId String
    emails[type eq "work"].value String
    name.givenName String
    name.familyName String
    phoneNumbers[type eq "work"].value String
    urn:ietf:params:scim:schemas:extension:enterprise:2.0:User:department String
    urn:ietf:params:scim:schemas:extension:enterprise:2.0:User:employeeNumber String
    nickName String
    title String
    profileUrl String
    displayName String
    addresses[type eq "work"].streetAddress String
    addresses[type eq "work"].locality String
    addresses[type eq "work"].region String
    addresses[type eq "work"].postalCode String
    addresses[type eq "work"].country String
    urn:ietf:params:scim:schemas:extension:enterprise:2.0:User:costCenter String
    urn:ietf:params:scim:schemas:extension:enterprise:2.0:User:division String
    urn:ietf:params:scim:schemas:extension:enterprise:2.0:User:organization String
    urn:ietf:params:scim:schemas:extension:ws1b:2.0:User:adSourceAnchor String
    urn:ietf:params:scim:schemas:extension:ws1b:2.0:User:customAttribute1 String
    urn:ietf:params:scim:schemas:extension:ws1b:2.0:User:customAttribute2 String
    urn:ietf:params:scim:schemas:extension:ws1b:2.0:User:customAttribute3 String
    urn:ietf:params:scim:schemas:extension:ws1b:2.0:User:customAttribute4 String
    urn:ietf:params:scim:schemas:extension:ws1b:2.0:User:customAttribute5 String
    urn:ietf:params:scim:schemas:extension:ws1b:2.0:User:distinguishedName String
    urn:ietf:params:scim:schemas:extension:ws1b:2.0:User:domain String
    urn:ietf:params:scim:schemas:extension:ws1b:2.0:User:userPrincipalName String
  11. Di bawah bagian Pemetaan , pilih Sinkronkan grup Microsoft Entra ke Oneflow.

  12. Tinjau atribut grup yang disinkronkan dari ID Microsoft Entra ke Oneflow di bagian Pemetaan Atribut. Atribut yang dipilih sebagai properti Pencocokan digunakan untuk mencocokkan grup di Oneflow untuk operasi pembaruan. Pilih tombol Simpan untuk menerapkan perubahan apa pun.

    Atribut Jenis Didukung untuk pemfilteran Diperlukan oleh Oneflow
    displayName String
    externalId String
    anggota Referensi
  13. Untuk mengonfigurasi filter cakupan, lihat instruksi berikut yang disediakan dalam Tutorial filter cakupan.

  14. Untuk mengaktifkan layanan provisi Microsoft Entra untuk Oneflow, ubah Status Provisi menjadi Aktif di bagian Pengaturan.

    Cuplikan layar Status Provisi Diaktifkan.

  15. Tentukan pengguna dan/atau grup yang ingin Anda provisikan ke Oneflow dengan memilih nilai yang diinginkan dalam Cakupan di bagian Pengaturan.

    Cuplikan layar Cakupan Provisi.

  16. Ketika Anda siap untuk memprovisi, klik Simpan.

    Cuplikan layar Konfigurasi Provisi Penyimpanan.

Operasi ini memulai siklus sinkronisasi awal semua pengguna dan grup yang ditentukan dalam Cakupan di bagian Pengaturan. Siklus awal membutuhkan waktu lebih lama untuk dilakukan daripada siklus berikutnya, yang terjadi sekitar setiap 40 menit selama layanan provisi Microsoft Entra berjalan.

Langkah 6: Memantau penyebaran Anda

Setelah Anda mengonfigurasi provisi, gunakan sumber daya berikut untuk memantau penyebaran Anda:

  • Gunakan log provisi untuk menentukan pengguna mana yang telah berhasil atau gagal diprovisi
  • Periksa bilah progres untuk melihat status siklus provisi dan seberapa lama penyelesaiannya
  • Jika konfigurasi provisi tampaknya dalam keadaan tidak sehat, aplikasi masuk ke karantina. Pelajari selengkapnya status karantina di sini.

Sumber daya lainnya

Langkah berikutnya