Bagikan melalui

Mengonfigurasi Asana untuk provisi pengguna otomatis dengan MICROSOFT Entra ID

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

Prasyarat

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

  • Penyewa Asana dengan paket Enterprise atau lebih tinggi diaktifkan
  • Akun pengguna di Asana dengan izin admin

Nota

Integrasi provisi Microsoft Entra bergantung pada API Asana, yang tersedia untuk Asana.

Langkah 1: Rencanakan penyediaan dan implementasi Anda.

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

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

Petunjuk / Saran

Untuk mengaktifkan akses menyeluruh berbasis SAML untuk Asana, ikuti instruksi yang diberikan. Single sign-on dapat dikonfigurasi secara independen dari penyediaan otomatis, meskipun kedua fitur ini bersifat komplementer.

Hasilkan token Akun Layanan di Asana

  1. Masuk ke Asana dengan menggunakan akun admin Anda.

  2. Pilih foto profil dari bilah atas, dan pilih Konsol Admin.

  3. Pilih tab Aplikasi dari dengan konsol admin Anda.

  4. Pilih Akun layanan.

  5. Pilih Tambahkan Akun Layanan dan lakukan langkah-langkah berikut.

    Cuplikan layar Token Akun Layanan.

    1. Perbarui Nama dan Deskripsi sesuai kebutuhan.
    2. Di bawah bagian Cakupan izin , pilih Izin terlingkup dan Provisi pengguna (SCIM). Pastikan cakupan izin berikut dipilih:
      • Pengguna: Baca
      • Pengguna: Membuat dan memodifikasi
      • Teams: Membaca
      • Teams: Buat dan Ubah
    3. Pilih Simpan Perubahan.

  6. Salin token.

Tambahkan Asana dari galeri aplikasi Microsoft Entra untuk mulai manajemen penyediaan ke Asana. Jika sebelumnya Anda telah menyiapkan Asana untuk SSO, Anda dapat menggunakan aplikasi yang sama. Namun disarankan agar 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 Asana

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

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

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

  2. Telusuri ke aplikasi Entra ID>Enterprise

    Cuplikan layar panel aplikasi Enterprise.

  3. Dalam daftar aplikasi, pilih Asana.

    Cuplikan layar tautan Asana di daftar Aplikasi.

  4. Pilih tab Penyediaan.

    Cuplikan layar tab Penyediaan.

  5. Atur Mode Penyediaan ke Otomatis.

    Cuplikan layar tab Penyediaan otomatis.

  6. Di bagian Info Masuk Admin , masukkan URL Penyewa Asana dan Token Rahasia Yang disediakan oleh Asana. Pilih Uji Koneksi untuk memastikan ID Microsoft Entra dapat tersambung ke Asana. Jika koneksi gagal, hubungi Asana untuk memeriksa penyiapan akun Anda.

    Cuplikan layar token.

  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 .

    Cuplikan layar email pemberitahuan.

  8. Pilih Simpan.

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

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

    Atribut Tipe Didukung untuk pemfilteran Diperlukan oleh Asana
    userName string ✓ ✓
    aktif Boolean (tipe data yang hanya memiliki dua nilai: true atau false)
    nama.terformat string
    judul string
    urn:ietf:params:scim:schemas:extension:enterprise:2.0:User:departemen string
    urn:ietf:params:scim:schemas:extension:enterprise:2.0:Pengguna:manajer Referensi
    alamat[tipe eq "kerja"].negara string
    alamat[jenis eq "pekerjaan"].wilayah string
    alamat[type eq "kerja"].lokasi string
    nomorTelepon[jenis eq "kerja"].nilai string
    urn:ietf:params:scim:schemas:extension:enterprise:2.0:Pengguna:NomorKaryawan string
    urn:ietf:params:scim:schemas:extension:enterprise:2.0:User:costCenter string
    urn:ietf:params:scim:schemas:extension:enterprise:2.0:User:organisasi string
    urn:ietf:params:scim:schemas:extension:enterprise:2.0:Pengguna:divisi string

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

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

    Atribut Tipe Didukung untuk pemfilteran Diperlukan oleh Asana
    nama tampilan string ✓ ✓
    anggota Referensi

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

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

    Cuplikan layar status Provisioning diaktifkan.

  15. Tentukan pengguna dan grup yang ingin Anda provisikan ke Asana dengan memilih nilai yang sesuai dalam Cakupan di bagian Pengaturan .

    Cuplikan layar cakupan Penyediaan.

  16. Saat Anda siap untuk memprovisikan, pilih Simpan.

    Cuplikan layar 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 dijalankan 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 .

Riwayat Perubahan

  • 11/06/2021 - Menghentikan dukungan untuk externalId, name.givenName, dan name.familyName. Menambahkan dukungan untuk preferredLanguage, label, dan urn:ietf:params:scim:schemas:extension:enterprise:2.0:User:department. Diaktifkan Provisi Grup.
  • 23/05/2023 - Menghilangkan dukungan untuk preferredLanguage. Menambahkan dukungan untuk urn:ietf:params:scim:schemas:extension:enterprise:2.0:User:manager.
  • 09/07/2023 - Menambahkan dukungan untuk alamat[type eq "work"].locality, alamat[type eq "work"].region, alamat[type eq "work"].country, nomorTelepon[type eq "work"].value, urn:ietf:params:scim:schemas:extension:enterprise:2.0:User:employeeNumber, urn:ietf:params:scim:schemas:extension:enterprise:2.0:User:costCenter, urn:ietf:params:scim:schemas:extension:enterprise:2.0:User:organization dan urn:ietf:params:scim:schemas:extension:enterprise:2.0:User:division.

Sumber daya lainnya

Konten terkait