Mengonfigurasi Gtmhub untuk provisi pengguna otomatis dengan ID Microsoft Entra

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

Nota

Saat ini, ketika provisi pengguna otomatis dikonfigurasi, hanya Microsoft Entra yang secara otomatis mendeprovisi pengguna dan grup ke Gtmhub dan memetakan pengguna ke tim masing-masing dengan menggunakan layanan provisi dari Microsoft Entra. Tetapi pada tahun 2021 setelah SSO diaktifkan dengan Gtmhub, pengguna secara otomatis diprovisi ketika mereka masuk melalui SSO dan ditetapkan ke tim masing-masing.

Kemampuan yang Didukung

• Hapus pengguna di Gtmhub saat mereka tidak memerlukan akses lagi.
• Menjaga atribut pengguna tetap sinkron antara MICROSOFT Entra ID dan Gtmhub.
• Memetakan pengguna ke dalam tim mereka secara otomatis dan menyelaraskannya.

Prasyarat

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

• Penyewa Layanan Microsoft Entra.
• Salah satu peran berikut: Administrator Aplikasi, Administrator Aplikasi Cloud, atau Pemilik Aplikasi.
• Akun Enterprise Gtmhub.

Langkah 1: Rencanakan penyediaan dan implementasi Anda.

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

Langkah 2: Mengonfigurasi Gtmhub untuk mendukung pemetaan tim dan deprovisi pengguna dengan ID Microsoft Entra

Untuk menyambungkan aplikasi provisi Anda ke akun Gtmhub, Anda perlu mengeluarkan token SCIM dan mengkompilasi URL penyewa.

Untuk mengeluarkan token SCIM baru:

1. Masuk ke akun Gtmhub Anda. Navigasi ke Pengaturan Konfigurasi Token API.

   

2. Pilih Terbitkan Token dan pilih SCIM. Masukkan nama untuk token dan pilih tombol Buat Token API .

   

3. Setelah token dibuat, Anda dapat menyalin dan menggunakannya di aplikasi provisi Microsoft Entra Anda.

   

Untuk mengkompilasi URL penyewa:

1. URL penyewa Anda harus dalam format berikut:

   https://app.gtmhub.com/api/v1/scim/azure/{account_id}

2. Jika akun Gtmhub Anda terletak di pusat data AS, Anda juga harus menambahkan pusat data ke URL:

   https://app.us.gtmhub.com/api/v1/scim/azure/{account_id}

3. Untuk mendapatkan ID akun, buka Pengaturan lalu pilih tab Token API dan salin ID akun:

Langkah 3: Tambahkan Gtmhub dari galeri aplikasi Microsoft Entra

Tambahkan Gtmhub dari galeri aplikasi Microsoft Entra untuk memulai pengelolaan provisi ke Gtmhub. Jika sebelumnya Anda telah menyiapkan Gtmhub untuk SSO, Anda dapat menggunakan aplikasi yang sama. Namun, kami sarankan 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 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. Saat 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 Gtmhub

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

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

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

2. Telusuri ke aplikasi Entra ID>Enterprise

   

3. Dalam daftar aplikasi, pilih Gtmhub.

   

4. Pilih tab Provisioning.

   

5. Atur Mode Provisi ke Otomatis.

   Tab Penyediaan otomatisProvisioning tab automatic

6. Di bawah bagian Kredensial Admin, masukkan URL Penyewa Gtmhub dan Token Rahasia Anda. Pilih Uji Koneksi untuk memastikan ID Microsoft Entra dapat tersambung ke Gtmhub. Jika koneksi gagal, pastikan akun Gtmhub Anda memiliki izin Admin, lalu coba lagi.

   

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 .

   

8. Pilih Simpan.

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

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

    Atribut	Tipe	Didukung untuk pemfilteran
    userName	string	✓
    Id eksternal	string	✓
    urn:ietf:params:scim:schemas:extension:enterprise:2.0:Pengguna:manajer	Referensi

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

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

    

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

    

14. Saat Anda siap untuk memprovisikan, 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 kemajuan untuk melihat status siklus penyediaan dan sejauh mana 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 tambahan

• Mengelola provisi akun pengguna untuk Aplikasi Perusahaan
• Apa itu akses aplikasi dan single sign-on dengan Microsoft Entra ID?

Konten terkait

• Pelajari cara meninjau log dan mendapatkan laporan tentang aktivitas provisi