Tutorial: Mengonfigurasi Atea untuk provisi pengguna otomatis

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

Kemampuan yang didukung

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

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 pengguna di Atea dengan izin Admin.

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

Langkah 2: Mengonfigurasi Atea untuk mendukung provisi dengan MICROSOFT Entra ID

Hubungi dukungan Atea untuk mengonfigurasi Atea untuk mendukung provisi dengan ID Microsoft Entra.

Langkah 3: Tambahkan Atea dari galeri aplikasi Microsoft Entra

Tambahkan Atea dari galeri aplikasi Microsoft Entra untuk mulai mengelola provisi ke Atea. Jika sebelumnya Anda telah menyiapkan Atea untuk akses menyeluruh, 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 dan 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 membutuhkan peran tambahan, Anda dapat memperbarui manifes aplikasi untuk menambahkan peran baru.

Langkah 5: Mengonfigurasi provisi pengguna otomatis ke Atea

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

Untuk mengonfigurasi provisi pengguna otomatis untuk Atea di MICROSOFT Entra ID:

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

2. Telusuri aplikasi Identity>Applications>Enterprise

   

3. Dalam daftar aplikasi, pilih Atea.

   

4. Pilih Provisi tab.

   

5. Atur Mode Provisi ke Otomatis.

   

6. Di bagian Info Masuk Admin, pilih Otorisasi. Ini membuka kotak dialog masuk Atea di jendela browser baru.

   

7. Pada dialog masuk Atea, masuk ke penyewa Atea dan verifikasi identitas Anda.

   

8. Setelah menyelesaikan langkah 5 dan 6, klik Uji Koneksi ion untuk memastikan ID Microsoft Entra dapat tersambung ke Atea. Jika koneksi gagal, pastikan akun Atea Anda memiliki izin Admin, lalu coba lagi.

   

9. Di bidang Surel Pemberitahuan, masukkan alamat surel pengguna atau grup yang seharusnya menerima pemberitahuan kesalahan provisi. Lalu pilih kotak centang Kirim pemberitahuan email saat kegagalan terjadi.

   

10. Pilih Simpan.

11. Di bawah bagian Pemetaan , pilih Sinkronkan pengguna Microsoft Entra ke Atea.

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

    Atribut	Jenis	Didukung untuk pemfilteran	Diperlukan oleh LawVu
    userName	String	✓	✓
    active	Boolean		✓
    emails[type eq "work"].value	String		✓
    name.givenName	String
    name.familyName	String
    name.formatted	String		✓
    phoneNumbers[type eq "mobile"].value	String
    lokal	String

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

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

    

15. Tetapkan pengguna dan grup yang ingin Anda provisikan ke Atea dengan memilih nilai yang relevan pada Cakupan di bagian Pengaturan.

    

16. Ketika Anda siap untuk memprovisi, klik Simpan.

    

Operasi ini memulai siklus sinkronisasi awal semua pengguna dan grup 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 Anda mengonfigurasi provisi, gunakan sumber daya berikut untuk memantau penyebaran Anda:

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

Mengubah Log

• 25/10/2022 - Hilangkan nama panggilan atribut pengguna inti.
• 25/10/2022 - Mengubah pemetaan nama atribut pengguna inti.diformat menjadi Join(" ", [givenName], [surname]) -> name.formatted.
• 25/10/2022 - Nama domain semua url konfigurasi OAuth aplikasi Atea diubah menjadi domain milik Atea.

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