Bagikan melalui

Mengonfigurasi Cleanmail Swiss untuk provisi pengguna otomatis

  • Artikel

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

Kemampuan yang didukung

  • Membuat pengguna di Cleanmail
  • Menghapus pengguna di Cleanmail Swiss saat mereka tidak memerlukan akses lagi
  • Menjaga atribut pengguna tetap sinkron antara MICROSOFT Entra ID dan Cleanmail
  • Akses menyeluruh ke Cleanmail Swiss (disarankan).

Prasyarat

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

Langkah 1: Rencanakan penyediaan dan penerapan Anda

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

Langkah 2: Mengonfigurasi Cleanmail Swiss untuk mendukung provisi dengan MICROSOFT Entra ID

Hubungi Dukungan Cleanmail Swiss untuk mengonfigurasi Cleanmail Swiss agar mendukung provisi dengan ID Microsoft Entra.

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

Langkah 4: Tentukan siapa yang berada dalam cakupan provisi

Layanan provisi Microsoft Entra memungkinkan Anda untuk menentukan pengguna yang diprovisi berdasarkan penugasan ke aplikasi atau berdasarkan atribut pengguna. Jika Anda memilih untuk menentukan siapa yang akan diprovisikan ke aplikasi Anda berdasarkan tugas yang diberikan, Anda dapat menggunakan langkah-langkah berikut untuk menambah pengguna ke aplikasi. Jika Anda memilih untuk mencakup siapa yang disediakan hanya berdasarkan atribut pengguna, Anda dapat menggunakan filter cakupan seperti yang dijelaskan di sini.

  • Mulai dari yang kecil. Uji dengan sekumpulan kecil pengguna sebelum diluncurkan ke semua orang. Saat cakupan provisi diatur ke pengguna yang ditetapkan, Anda dapat mengontrolnya dengan menetapkan satu atau dua pengguna ke instans aplikasi. Saat cakupan diatur ke semua pengguna, 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 Cleanmail Swiss

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

Untuk mengonfigurasi provisi pengguna otomatis untuk Cleanmail Swiss di ID Microsoft Entra:

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

  2. Telusuri Identitas>Aplikasi>aplikasi perusahaan

    Cuplikan layar bilah aplikasi Perusahaan.

  3. Dalam daftar aplikasi, pilih Cleanmail.

    Cuplikan layar tautan Cleanmail Swiss dalam daftar Aplikasi.

  4. Pilih tab Provisioning.

    Cuplikan layar tab Penyediaan.

  5. Atur Mode Provisi ke Otomatis.

    Cuplikan layar tab Penyediaan secara otomatis.

  6. Di bagian Kredensial Admin, masukkan URL Penyewa Cleanmail Swiss Anda sebagai https://cloud.cleanmail.ch/api/v3/scim2 dan Token Rahasia terkait yang diperoleh dari Langkah 2. Klik Uji Koneksi untuk memastikan ID Microsoft Entra dapat tersambung ke Cleanmail. Jika koneksi gagal, pastikan akun Cleanmail Swiss Anda memiliki izin Admin, lalu coba lagi.

    Cuplikan layar token.

  7. Di bidang Email Pemberitahuan, masukkan alamat email seseorang atau grup yang harus menerima pemberitahuan kesalahan provisi dan pilih kotak centang Kirim pemberitahuan email saat kegagalan terjadi.

    Cuplikan layar email pemberitahuan.

  8. Pilih Simpan.

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

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

    Atribut Jenis Didukung untuk pemfilteran Diperlukan oleh Cleanmail
    userName Tali ✓ ✓
    aktif Boolean ✓
    nama.namaDepan String
    nama.namaKeluarga String
    externalId string

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

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

    Cuplikan layar status provisi yang diaktifkan.

  13. Tentukan pengguna yang ingin Anda sediakan ke Cleanmail Swiss dengan memilih nilai yang diinginkan dalam Cakupan di bagian Pengaturan.

    Cuplikan layar cakupan provisi.

  14. Saat Anda siap untuk memprovisikan, klik Simpan.

    Cuplikan layar dari konfigurasi penyimpanan provisi.

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

Langkah 6: Memantau penyebaran Anda

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

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

Sumber daya lainnya

Langkah berikutnya