Tutorial: Mengonfigurasi Headspace untuk provisi pengguna otomatis

  • Artikel

Tutorial ini menjelaskan langkah-langkah yang perlu Anda lakukan di Headspace dan ID Microsoft Entra untuk mengonfigurasi provisi pengguna otomatis. Saat dikonfigurasi, MICROSOFT Entra ID secara otomatis memprovisi dan mendeprovisi pengguna ke Headspace 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 Headspace.
  • Hapus pengguna di Headspace saat mereka tidak memerlukan akses lagi.
  • Menjaga atribut pengguna tetap sinkron antara ID Microsoft Entra dan Headspace.
  • Akses menyeluruh ke Headspace (disarankan).

Prasyarat

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

  • Penyewa Microsoft Entra
  • Akun pengguna di MICROSOFT Entra ID dengan izin untuk mengonfigurasi provisi (misalnya, Administrator Aplikasi, Administrator Aplikasi Cloud, Pemilik Aplikasi, atau Administrator Global).
  • Akun administrator dengan Headspace.

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

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

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

Tambahkan Headspace dari galeri aplikasi Microsoft Entra untuk mulai mengelola provisi ke Headspace. Jika sebelumnya Anda telah menyiapkan Headspace untuk SSO, 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. Jika Anda memilih untuk mencakup orang yang akan diprovisi ke aplikasi didasarkan pada penugasan, Anda dapat mengikuti langkah-langkah berikut untuk menetapkan pengguna ke aplikasi. Jika Anda memilih untuk mencakup siapa saja yang akan diprovisi hanya berdasarkan pada atribut pengguna, Anda dapat menggunakan filter cakupan seperti yang dijelaskan di sini.

  • Mulai dari yang kecil. Uji dengan sekelompok kecil pengguna sebelum diluncurkan ke semua orang. Ketika cakupan provisi diatur ke pengguna yang telah ditetapkan, Anda dapat mengontrolnya dengan menetapkan satu atau dua pengguna ke aplikasi. Ketika 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 Headspace

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

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

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

  2. Telusuri aplikasi Identity>Applications>Enterprise

    Screenshot of Enterprise applications blade.

  3. Di daftar aplikasi, pilih Headspace.

    Screenshot of the Headspace link in the Applications list.

  4. Pilih Provisi tab.

    Screenshot of Provisioning tab.

  5. Atur Mode Provisi ke Otomatis.

    Screenshot of Provisioning tab automatic.

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

    Screenshot of Token.

  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.

    Screenshot of Notification Email.

  8. Pilih Simpan.

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

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

    Atribut Jenis Didukung untuk pemfilteran Diperlukan oleh Headspace
    userName String ✓ ✓
    active Boolean ✓
    emails[type eq "work"].value String ✓
    name.givenName String
    name.familyName String
    externalId String ✓
    urn:ietf:params:scim:schemas:extension:enterprise:2.0:User:department
    String

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

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

    Screenshot of Provisioning Status Toggled On.

  13. Tentukan pengguna yang ingin Anda provisikan ke Headspace dengan memilih nilai yang diinginkan dalam Cakupan di bagian Pengaturan.

    Screenshot of Provisioning Scope.

  14. Ketika Anda siap untuk memprovisi, klik Simpan.

    Screenshot of Saving Provisioning Configuration.

Operasi ini dimulai dengan siklus sinkronisasi awal dari semua pengguna 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 atau gagal diprovisi
  • Periksa bilah progres 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

Langkah berikutnya