Tutorial: Mengonfigurasi Provisi Freshservice untuk provisi pengguna otomatis

Tutorial ini menjelaskan langkah-langkah yang perlu Anda lakukan di Provisi Freshservice dan ID Microsoft Entra untuk mengonfigurasi provisi pengguna otomatis. Saat dikonfigurasi, MICROSOFT Entra ID secara otomatis memprovisikan dan mendeprovisi pengguna ke Provisi Freshservice 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

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

Prasyarat

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

• Penyewa Microsoft Entra
• Salah satu peran berikut: Administrator Aplikasi, Administrator Aplikasi Cloud, atau Pemilik Aplikasi.
• Akun Freshservice dengan izin Admin Organisasi.

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 Provisi Freshservice.

Langkah 2: Mengonfigurasi Provisi Freshservice untuk mendukung provisi dengan ID Microsoft Entra

1. Di akun Freshservice Anda, instal aplikasi Azure Provisioning (SCIM) dari marketplace dengan menavigasi ke Admin Freshservice>Aplikasi>Dapatkan Aplikasi.
2. Di layar konfigurasi, sediakan Domain Freshservice Anda (misalnya acme.freshservice.com) dan kunci API Admin Organisasi.
3. Klik Lanjutkan.
4. Sorot dan salin Token Pembawa. Nilai ini akan dimasukkan di bidang Token Rahasia di tab Provisi aplikasi Provisi Freshservice Anda.
5. Pilih Instal untuk menyelesaikan penginstalan.
6. URL Penyewa adalah https://scim.freshservice.com/scim/v2. Nilai ini akan dimasukkan di bidang URL Penyewa di tab Provisi aplikasi Provisi Freshservice Anda.

Langkah 3: Menambahkan Provisi Freshservice dari galeri aplikasi Microsoft Entra

Tambahkan Provisi Freshservice dari galeri aplikasi Microsoft Entra untuk mulai mengelola provisi ke Provisi Freshservice. 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. Jika Anda memilih untuk mencakup orang yang akan diprovisi ke aplikasi didasarkan pada penugasan, Anda dapat mengikuti langkah-langkah berikut untuk menetapkan pengguna ke aplikasi. Jika Anda memilih untuk mencakup siapa saja yang akan diprovisi hanya berdasarkan pada atribut pengguna, 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.

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

Langkah 5: Mengonfigurasi provisi pengguna otomatis ke Provisi Freshservice

Bagian ini memandu Anda melalui langkah-langkah untuk mengonfigurasi layanan provisi Microsoft Entra untuk membuat, memperbarui, dan menonaktifkan pengguna di Provisi Freshservice berdasarkan penugasan pengguna di ID Microsoft Entra.

Untuk mengonfigurasi provisi pengguna otomatis untuk Provisi Freshservice di ID Microsoft Entra

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

2. Telusuri aplikasi Identity>Applications>Enterprise

   

3. Dalam daftar aplikasi, pilih Provisi Freshservice.

   

4. Pilih Provisi tab.

   

5. Atur Mode Provisi ke Otomatis.

   

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

   

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.

   

8. Pilih Simpan.

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

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

    Atribut	Jenis	Didukung untuk pemfilteran
    userName	String	✓
    active	Boolean
    emails[type eq "work"].value	String
    displayName	String
    name.givenName	String
    name.familyName	String
    phoneNumbers[type eq "work"].value	String
    phoneNumbers[type eq "mobile"].value	String
    addresses[type eq "work"].formatted	String
    lokal	String
    title	String
    zona waktu	String
    externalId	String
    urn:ietf:params:scim:schemas:extension:enterprise:2.0:User:department	String
    urn:ietf:params:scim:schemas:extension:enterprise:2.0:User:manager	Referensi
    urn:ietf:params:scim:schemas:extension:freshservice:2.0:User:isAgent	String

Catatan

Atribut ekstensi kustom dapat ditambahkan ke skema Anda untuk memenuhi kebutuhan aplikasi dengan mengikuti langkah di bawah ini:

• Di bawah Pemetaan, pilih Provisikan pengguna Microsoft Entra.
• Di bagian bawah halaman, pilih Perlihatkan opsi lanjutan.
• Pilih Edit daftar atribut untuk Freshservice.
• Di bagian bawah daftar atribut, masukkan informasi tentang atribut kustom di bidang yang disediakan. Namespace layanan urn atribut kustom harus mengikuti pola seperti yang ditunjukkan pada contoh di bawah ini. CustomAttribute dapat dikustomisasi sesuai persyaratan aplikasi Anda, misalnya: urn:ietf:params:scim:schemas:extension:freshservice:2.0:User:isAgent.
• Tipe data yang sesuai harus dipilih untuk atribut kustom dan klik Simpan.
• Arahkan kembali ke layar pemetaan default dan klik Tambahkan Pemetaan Baru. Atribut kustom akan muncul dalam daftar dropdown Atribut Target.

10. Untuk mengonfigurasi filter cakupan, lihat instruksi berikut yang disediakan dalam Tutorial filter cakupan.

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

    

12. Tentukan pengguna yang ingin Anda provisikan ke Provisi Freshservice dengan memilih nilai yang diinginkan di Cakupan pada bagian Pengaturan.

    

13. Saat Anda siap untuk melakukan provisi, klik Simpan.

    

Operasi ini dimulai dengan siklus sinkronisasi awal dari semua pengguna 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:

1. Gunakan log provisi untuk menentukan pengguna mana yang telah berhasil atau gagal diprovisi
2. Periksa bilah kemajuan untuk melihat status siklus provisi dan seberapa dekat dengan penyelesaiannya
3. Jika konfigurasi provisi tampaknya dalam keadaan buruk, aplikasi akan masuk ke karantina. Pelajari selengkapnya status karantina di sini.

Sumber Daya Tambahan:

• Mengelola provisi akun pengguna untuk Aplikasi Perusahaan
• Apa itu akses aplikasi dan akses menyeluruh dengan MICROSOFT Entra ID?

Langkah berikutnya

• Mempelajari cara mengulas log dan mendapatkan laporan tentang aktivitas provisi