Mengonfigurasi TerraTrue untuk provisi pengguna otomatis

Artikel ini menjelaskan langkah-langkah yang perlu Anda lakukan di TERraTrue dan ID Microsoft Entra untuk mengonfigurasi provisi pengguna otomatis. Saat dikonfigurasi, MICROSOFT Entra ID secara otomatis memprovisi dan mendeprovisi pengguna dan grup ke TerraTrue 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

• Buat pengguna di TerraTrue.
• Hapus pengguna di TerraTrue saat mereka tidak memerlukan akses lagi.
• Menjaga atribut pengguna tetap sinkron antara MICROSOFT Entra ID dan TerraTrue.
• Akses menyeluruh ke TerraTrue.

Prasyarat

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

• penyewa akun Microsoft Entra.
• Salah satu peran berikut: Administrator Aplikasi, Administrator Aplikasi Cloud, atau Pemilik Aplikasi.
• Penyewa TerraTrue.
• Akun pengguna di TerraTrue dengan izin Admin.

Langkah 1: Rencanakan pengaturan penyiapan sistem Anda

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

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

1. Di TerraTrue, buka Pengaturan Organisasi> Autentikasi > SCIM atau kunjungihttps://launch.terratrue.com/settings/auth/scim.

2. Selanjutnya, aktifkan tombol "Konfigurasi SCIM" dan pilih "Salin Kunci API" untuk menyalin Kunci API SCIM.

   

Langkah 3: Tambahkan TerraTrue dari galeri aplikasi Microsoft Entra

Tambahkan TerraTrue dari galeri aplikasi Microsoft Entra untuk memulai mengelola provisi ke TerraTrue. Jika sebelumnya Anda telah menyiapkan TerraTrue untuk SSO, Anda dapat menggunakan aplikasi yang sama. Namun, kami sarankan 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 menentukan cakupan siapa yang diberi hak akses 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 TerraTrue

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

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

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

2. Telusuri ke Identity>Aplikasi>Aplikasi Perusahaan

   

3. Dalam daftar aplikasi, pilih TerraTrue.

   

4. Pilih tab Pensediaan.

   

5. Atur Modus Penyediaan ke Otomatis.

   Tab Penyediaan otomatisProvisioning tab automatic

6. Di bagian Kredensial Admin, masukkan URL Penyewa TerraTrue dan Token Rahasia Anda. Pilih Uji Koneksi untuk memastikan ID Microsoft Entra dapat tersambung ke TerraTrue. Jika koneksi gagal, pastikan akun TerraTrue 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 TerraTrue.

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

    Atribut	Tipe	Didukung untuk pemfilteran	Dibutuhkan oleh TerraTrue
    userName	string	✓	✓
    aktif	Boolean (tipe data yang hanya memiliki dua nilai: true atau false)
    namaDepan	string
    nama.keluarga	string
    nama.terformat	string

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

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

    

13. Tentukan pengguna dan/atau grup yang ingin Anda provisikan ke TerraTrue dengan memilih nilai yang diinginkan pada Cakupan di bagian Pengaturan.

    

14. Setelah Anda siap memprovisi, pilih 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 dilakukan daripada siklus berikutnya, yang terjadi sekitar setiap 40 menit selama layanan provisi Microsoft Entra berjalan.

Langkah 6: Memantau penyebaran Anda

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

Pemecahan Masalah dan Tips

Hubungi hello@terratrue.com untuk membantu memastikan bahwa penyediaan Anda berfungsi dengan benar.

TerraTrue memberikan riwayat revisi semua perubahan pada akun pengguna yang dapat dilihat oleh administrator TerraTrue mana pun pada tautan di bawah ini. Semua perubahan pengguna yang dilakukan sebagai akibat dari provisi SCIM ditampilkan dengan kolom Actor menjadi "Pengguna Sistem Scim".

https://launch.terratrue.com/settings/history

Terakhir, TerraTrue menetapkan Nama Tampilan pengguna berdasarkan nama depan dan nama belakang yang diterima selama sinkronisasi pengguna pertama. Perubahan selanjutnya pada Nama Tampilan pengguna mungkin dilakukan oleh administrator dari dalam TerraTrue di bagian Pengaturan Organisasi Pengguna pada tautan di bawah ini:

https://launch.terratrue.com/settings/users

Sumber daya lainnya

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

Konten terkait

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