Mengonfigurasi XM Fax dan XM SendSecure untuk provisi pengguna otomatis dengan ID Microsoft Entra

Artikel ini menjelaskan langkah-langkah yang perlu Anda lakukan di XM Fax dan XM SendSecure dan MICROSOFT Entra ID untuk mengonfigurasi provisi pengguna otomatis. Saat dikonfigurasi, MICROSOFT Entra ID secara otomatis memprovisi dan mendeprovisi pengguna ke XM Fax dan XM SendSecure 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 XM Fax dan XM SendSecure.
• Hapus pengguna di XM Fax dan XM SendSecure saat mereka tidak memerlukan akses lagi.
• Menjaga atribut pengguna tetap sinkron antara MICROSOFT Entra ID dan XM Fax dan XM SendSecure.
• Akses menyeluruh ke XM Fax dan XM SendSecure (disarankan).

Prasyarat

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

• Klien Microsoft Entra
• Salah satu peran berikut: Administrator Aplikasi, Administrator Aplikasi Cloud, atau Pemilik Aplikasi.
• Akun pengguna di XM Fax dan XM SendSecure dengan izin Admin.

Langkah 1: Rencanakan penyediaan layanan Anda

• Pelajari tentang cara kerja layanan provisi.
• Tentukan siapa yang masuk dalam cakupan penyediaan.
• Tentukan data apa yang akan dipetakan antara ID Microsoft Entra dan XM Fax dan XM SendSecure.

Langkah 2: Mengonfigurasi XM Fax dan XM SendSecure untuk mendukung provisi dengan MICROSOFT Entra ID

Membuat token akses

1. Di akun perusahaan XM Cloud Anda, pilih Nama perusahaan>Token Akses.
2. Buat token akses baru dengan izin Provisi pengguna (menggunakan SCIM).
3. Salin token akses. Anda membutuhkannya sebagai Token Rahasia di ID Microsoft Entra.

URL Penyewa

• Untuk mengonfigurasi layanan provisi Microsoft Entra, Anda memerlukan URL penyewa Anda.

• URL penyewa bergantung pada wilayah, nama akun perusahaan Anda, dan memiliki skema berikut: https://<domain>/api/scim/v2/enterprises/<enterprise_name>/

Contoh:

• https://portal.xmedius.com/api/scim/v2/enterprises/acme/
• https://portal.xmedius.eu/api/scim/v2/enterprises/my_corporation/
• https://portal.xmedius.ca/api/scim/v2/enterprises/another_company/

Langkah 3: Tambahkan XM Fax dan XM SendSecure dari galeri aplikasi Microsoft Entra

Tambahkan XM Fax dan XM SendSecure dari galeri aplikasi Microsoft Entra untuk mulai mengelola provisi ke XM Fax dan XM SendSecure. Jika sebelumnya Anda telah menyiapkan XM Fax dan XM SendSecure untuk SSO, Anda dapat menggunakan aplikasi yang sama. Namun disarankan agar 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 XM Fax dan XM SendSecure

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

Untuk mengonfigurasi provisi pengguna otomatis untuk XM Fax dan XM SendSecure di MICROSOFT Entra ID:

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

2. Telusuri ke aplikasi Entra ID>Enterprise

   

3. Dalam daftar aplikasi, pilih XM Fax dan XM SendSecure.

   

4. Pilih tab Provisioning.

   

5. Atur Modus Penyediaan ke Otomatis.

   

6. Di bawah bagian Info Masuk Admin , masukkan Faks XM dan URL Penyewa XM SendSecure dan Token Rahasia dari Langkah 2. Pilih Uji Koneksi untuk memastikan ID Microsoft Entra dapat tersambung ke XM Fax dan XM SendSecure. Jika koneksi gagal, periksa URL dan token akses sudah benar.

   

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

   

8. Pilih Simpan.

9. Di bawah bagian Pemetaan , pilih Sinkronkan pengguna Microsoft Entra ke XM Fax dan XM SendSecure.

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

    Karakteristik	Tipe	Didukung untuk pemfilteran	Diperlukan oleh XM Fax dan XM SendSecure
    userName	string	✓	✓
    email[tipe sama dengan "kerja"].nilai	string		✓
    aktif	Boolean (tipe data yang hanya memiliki dua nilai: true atau false)
    judul	string
    namaDepan	string
    nama.keluarga	string
    alamat[jenis eq 'kerja'].alamatJalan	string
    alamat[tipe = "kerja"].lokasi	string
    alamat[jenis eq "pekerjaan"].wilayah	string
    alamat[tipe eq "pekerjaan"].kodePos	string
    alamat[tipe sama dengan "pekerjaan"].negara	string
    nomorTelepon[jenis sama dengan "kerja"].nilai	string
    NomorTelepon[tipe eq "seluler"].nilai	string
    nomorTelepon[jenis eq "fax"].nilai	string
    Id eksternal	string		✓
    peran[utama sama dengan "Ya"].nilai	string
    urn:ietf:params:scim:schemas:extension:enterprise:2.0:User:organisasi	string

11. Untuk mengonfigurasi filter cakupan, lihat instruksi berikut yang disediakan dalam artikel Filter cakupan.

12. Untuk mengaktifkan layanan provisi Microsoft Entra untuk XM Fax dan XM SendSecure, ubah Status Provisi menjadi Aktif di bagian Pengaturan .

    

13. Tentukan pengguna yang ingin Anda provisikan ke XM Fax dan XM SendSecure dengan memilih nilai yang diinginkan dalam Cakupan di bagian Pengaturan .

    

14. Setelah Anda siap memprovisi, pilih 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 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

• Mengelola provisi akun pengguna untuk Aplikasi Perusahaan
• Apa itu akses aplikasi dan login tunggal melalui Microsoft Entra ID?

Konten terkait

• Pelajari cara untuk memeriksa log dan mendapatkan laporan tentang aktivitas penyediaan