Tutorial: Mengonfigurasi Postman untuk provisi pengguna otomatis

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

• Membuat pengguna di Postman.
• Hapus pengguna di Postman saat mereka tidak memerlukan akses lagi.
• Menjaga atribut pengguna tetap sinkron antara MICROSOFT Entra ID dan Postman.
• Memprovisikan grup dan keanggotaan grup di Postman.
• Akses menyeluruh ke Postman (disarankan ).

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.
• Penyewa Postman pada paket Enterprise.
• Akun pengguna di Postman 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 MICROSOFT Entra ID dan Postman.

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

Sebelum mulai mengonfigurasi Postman untuk mendukung provisi dengan MICROSOFT Entra ID, Anda harus membuat token API SCIM dalam Postman Admin Console.

Catatan

Anda dapat mengunjungi halaman Gambaran umum provisi SCIM Postman, untuk merujuk Aktifkan provisi SCIM di langkah-langkah Postman .

1. Buka Konsol Admin Postman dengan masuk ke akun Postman Anda.

2. Setelah Anda masuk, klik Tim di sisi kanan dan klik Tim Pengaturan.

3. Pilih Autentikasi di bar samping lalu aktifkan tombol provisi SCIM.

   

4. Anda akan menerima pesan pop up yang menanyakan apakah Anda ingin Mengaktifkan Provisi SCIM, klik Aktifkan untuk mengaktifkan provisi SCIM.

   

5. Untuk Menghasilkan Kunci API SCIM, lakukan langkah-langkah berikut:

   1. Pilih Buat Kunci API SCIM di bagian provisi SCIM.

      

   2. Masukkan nama kunci dan klik Buat.

   3. Salin kunci API baru Anda untuk digunakan nanti dan klik Selesai.

   Catatan

   Anda dapat mengunjungi kembali halaman ini untuk mengelola kunci API SCIM Anda. Jika Anda meregenerasi kunci API yang ada, Anda akan memiliki opsi untuk menjaga kunci pertama tetap aktif saat Anda beralih.

   Catatan

   Untuk terus mengaktifkan provisi SCIM, lihat Mengonfigurasi SCIM dengan ID Microsoft Entra. Untuk informasi lebih lanjut atau bantuan mengonfigurasi SCIM, hubungi dukungan Postman.

Langkah 3: Tambahkan Postman dari galeri aplikasi Microsoft Entra

Tambahkan Postman dari galeri aplikasi Microsoft Entra untuk mulai mengelola provisi ke Postman. Jika sebelumnya Anda telah menyiapkan Postman 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 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 /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 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 lebih banyak peran, Anda dapat memperbarui manifes aplikasi untuk menambahkan peran baru.

Langkah 5: Mengonfigurasi provisi pengguna otomatis ke Postman

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

   

4. Pilih Provisi tab.

   

5. Atur Mode Provisi ke Otomatis.

   

6. Di bawah bagian Info Masuk Admin, masukkan https://api.getpostman.com/scim/v2/ sebagai URL Penyewa Postman dan kunci API SCIM Anda sebagai Token Rahasia. Klik Uji Koneksi ion untuk memastikan MICROSOFT Entra ID dapat tersambung ke Postman. Jika koneksi gagal, pastikan akun Postman 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 Postman.

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

    Atribut	Jenis	Didukung untuk pemfilteran	Diperlukan oleh Postman
    userName	String	✓	✓
    active	Boolean		✓
    name.givenName	String		✓
    name.familyName	String		✓

11. Di bawah bagian Pemetaan , pilih Sinkronkan grup Microsoft Entra ke Postman.

12. Tinjau atribut grup yang disinkronkan dari ID Microsoft Entra ke Postman di bagian Pemetaan Atribut. Atribut yang dipilih sebagai properti Pencocokan digunakan untuk mencocokkan grup di Postman untuk operasi pembaruan. Pilih tombol Simpan untuk menerapkan perubahan apa pun.

    Atribut	Jenis	Didukung untuk pemfilteran	Diperlukan oleh Postman
    displayName	String	✓	✓
    anggota	Referensi

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

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

    

15. Tentukan pengguna dan/atau grup yang ingin Anda provisikan ke Postman dengan memilih nilai yang diinginkan dalam 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 dilakukan 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 tidak sehat, aplikasi masuk ke karantina. Pelajari selengkapnya status karantina di sini.

Sumber daya lainnya

• Mengelola provisi akun pengguna untuk Aplikasi Perusahaan.
• Apa itu akses aplikasi dan akses menyeluruh dengan MICROSOFT Entra ID?.

Langkah berikutnya

• Pelajari cara meninjau log dan mendapatkan laporan tentang aktivitas provisi.