Bagikan melalui


Mengotomatiskan provisi Pengguna ke Slack dengan MICROSOFT Entra ID

Catatan

Mengintegrasikan dengan Slack dengan aplikasi kustom / BYOA tidak didukung. Menggunakan aplikasi galeri seperti yang dijelaskan dalam artikel ini didukung. Aplikasi galeri telah disesuaikan untuk bekerja dengan server SCIM v1 Slack.

Tujuan dari artikel ini adalah untuk menunjukkan kepada Anda langkah-langkah yang perlu Anda lakukan di Slack dan ID Microsoft Entra untuk memprovisi dan mendeprovisi akun pengguna secara otomatis dari ID Microsoft Entra ke Slack. 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 Slack
  • Menghapus pengguna di Slack saat mereka tidak memerlukan akses lagi
  • Menjaga atribut pengguna tetap sinkron antara ID Microsoft Entra dan Slack
  • Grup provisi dan keanggotaan grup di Slack
  • Masuk tunggal ke Slack (disarankan)

Prasyarat

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

Catatan

Integrasi ini juga tersedia untuk digunakan dari lingkungan Microsoft Entra US Government Cloud. Anda dapat menemukan aplikasi ini di Microsoft Entra US Government Cloud Application Gallery dan mengonfigurasinya dengan cara yang sama seperti yang Anda lakukan dari cloud publik.

Langkah 1: Merencanakan penyebaran provisi 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 Slack.

Tambahkan Slack dari galeri aplikasi Microsoft Entra untuk mulai mengelola provisi ke Slack. Jika sebelumnya Anda telah mengatur Slack 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 3: 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. 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 memerlukan peran tambahan, Anda dapat memperbarui manifes aplikasi untuk menambahkan peran baru.

Langkah 4: Mengonfigurasi provisi pengguna otomatis ke Slack

Bagian ini memandu Anda menyambungkan ID Microsoft Entra ke API provisi akun pengguna Slack, dan mengonfigurasi layanan provisi untuk membuat, memperbarui, dan menonaktifkan akun pengguna yang ditetapkan di Slack berdasarkan penetapan pengguna dan grup di ID Microsoft Entra.

Untuk mengonfigurasi provisi akun pengguna otomatis ke Slack di ID Microsoft Entra:

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

  2. Telusuri ke aplikasi Entra ID>Enterprise

    Bilah aplikasi perusahaan

  3. Dalam daftar aplikasi, pilih Slack.

    Tautan Slack di daftar Aplikasi

  4. Pilih Provisi tab.

    Cuplikan layar opsi Kelola dengan opsi Provisi dipilih.

  5. Atur Mode Provisi ke Otomatis.

    Cuplikan layar daftar tarik-turun Mode Provisi dengan opsi Otomatis ditampilkan.

  6. Di bawah bagian Info Masuk Admin , pilih Otorisasi. Ini membuka dialog otorisasi Slack di jendela browser baru.

    Cuplikan layar memperlihatkan tombol Otorisasi Kredensial Admin.

  7. Di jendela baru, masuk ke Slack menggunakan akun Admin Tim Anda. dalam dialog otorisasi yang dihasilkan, pilih tim Slack yang ingin Anda aktifkan provisi, lalu pilih Otorisasi. Setelah selesai, kembali ke portal Microsoft Azure untuk menyelesaikan konfigurasi provisi.

    Dialog Otorisasi

  8. Pilih Uji Koneksi untuk memastikan ID Microsoft Entra dapat tersambung ke aplikasi Slack Anda. Jika koneksi gagal, pastikan akun Slack Anda memiliki izin Admin Tim dan coba langkah "Otorisasi" lagi.

  9. Di bidang Surel Pemberitahuan, masukkan alamat surel seseorang atau grup penerima pemberitahuan kesalahan provisi dan pilih kotak centang Kirim pemberitahuan surel ketika kegagalan terjadi.

    Email Pemberitahuan

  10. Pilih Simpan.

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

  12. Di bagian Pemetaan Atribut , tinjau atribut pengguna yang disinkronkan dari ID Microsoft Entra ke Slack. Atribut yang dipilih sebagai properti Pencocokan digunakan untuk mencocokkan akun pengguna di Slack untuk operasi pembaruan. Pilih tombol Simpan untuk menerapkan perubahan apa pun.

Atribut Jenis
aktif Boolean
Id eksternal string
nama tampilan string
nama.keluarga string
namaDepan string
judul string
email[tipe sama dengan "kerja"].nilai string
userName string
nama panggilan string
alamat[type eq "untyped"].streetAddress string
alamat[tipe eq "untyped"].lokasi string
alamat[tipe eq "tidak bertipe"].wilayah string
addresses[type eq "untyped"].kodePos string
alamat[tipe eq "tidak terdefinisi"].negara string
NomorTelepon[tipe eq "seluler"].nilai string
nomorTelepon[jenis sama dengan "kerja"].nilai string
peran[primer mis. "Benar"].nilai string
lokal string
nama.honorificPrefix string
photos[tipe sama dengan "photo"].nilai string
profilUrl string
zona waktu string
tipe pengguna string
bahasa pilihan string
guci:scim:schemas:extension:enterprise:1.0.department string
guci:scim:schemas:extension:enterprise:1.0.manager Referensi
guci:scim:schemas:extension:enterprise:1.0.employeeJumlah string
guci:scim:schemas:extension:enterprise:1.0.department string
guci:scim:schemas:extension:enterprise:1.0.organization string
guci:scim:schemas:extension:enterprise:1.0.division string
  1. Di bawah bagian Pemetaan , pilih Sinkronkan grup Microsoft Entra ke Slack.

  2. Di bagian Pemetaan Atribut , tinjau atribut grup yang disinkronkan dari ID Microsoft Entra ke Slack. Atribut yang dipilih sebagai properti Pencocokan digunakan untuk mencocokkan grup di Slack untuk operasi pembaruan. Pilih tombol Simpan untuk menerapkan perubahan apa pun.

    Atribut Jenis
    nama tampilan string
    anggota Referensi
  3. Untuk mengonfigurasi filter cakupan, lihat instruksi berikut yang disediakan dalam artikel Filter cakupan.

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

    Status Provisi Diaktifkan

  5. Tentukan pengguna dan/atau grup yang ingin Anda provisi ke Slack dengan memilih nilai yang diinginkan dalam Cakupan di bagian Pengaturan.

    Cakupan Provisi

  6. Setelah Anda siap memprovisi, pilih Simpan.

    Menyimpan Konfigurasi Provisi

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 5: Memantau penyebaran Anda

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

Tips Pemecahan Masalah

  • Saat mengonfigurasi atribut displayName Slack, ketahuilah perilaku berikut:

    • Nilai tidak sepenuhnya unik (seperti dua pengguna dapat memiliki nama tampilan yang sama)

    • Mendukung karakter non-Bahasa Inggris, spasi, kapitalisasi.

    • Tanda baca yang diizinkan mencakup titik, garis bawah, tanda hubung, apostrof, tanda kurung siku (misalnya, ( [ { } ] )), dan pemisah (misalnya, , / ;).

    • properti displayName tidak boleh memiliki karakter '@'. Jika '@' disertakan, Anda mungkin menemukan peristiwa yang dilewatkan pada log provisi dengan deskripsi "AttributeValidationFailed."

    • Hanya pembaruan jika kedua pengaturan ini dikonfigurasi di tempat kerja/organisasi Slack - Sinkronisasi profil diaktifkan dan Pengguna tidak dapat mengubah nama tampilan mereka.

  • Atribut userName Slack harus di bawah 21 karakter dan memiliki nilai yang unik.

  • Slack hanya memungkinkan pencocokan dengan atribut userName dan email.

  • Kode kesalahan umum didokumentasikan dalam dokumentasi resmi Slack - https://api.slack.com/scim#errors

Log Perubahan 

  • 16/06/2020 - Atribut DisplayName yang dimodifikasi hanya akan diperbarui selama pembuatan pengguna baru.

Sumber Daya Lainnya