Mengonfigurasi Atlassian Cloud untuk provisi pengguna otomatis dengan Microsoft Entra ID

Artikel ini menjelaskan langkah-langkah yang perlu Anda lakukan di Atlassian Cloud dan Microsoft Entra ID untuk mengonfigurasi provisi pengguna otomatis. Saat dikonfigurasi, Microsoft Entra ID secara otomatis memprovisi dan mendeprovisi pengguna dan grup untuk Atlassian Cloud menggunakan layanan provisi Microsoft Entra. Untuk detail penting tentang apa yang dilakukan layanan ini, cara kerjanya, dan pertanyaan yang sering diajukan, lihat Otomatisasi penyediaan dan pencabutan pengguna ke aplikasi SaaS dengan Microsoft Entra ID.

Kemampuan yang didukung

  • Menemukan pengguna yang ada di Atlassian Cloud
  • Membuat pengguna di Atlassian Cloud
  • Menghapus pengguna di Atlassian Cloud saat mereka tidak memerlukan akses lagi
  • Menjaga atribut pengguna tetap sinkron antara Microsoft Entra ID dan Atlassian Cloud
  • Memprovisikan grup dan keanggotaan grup di Atlassian Cloud
  • Akses menyeluruh ke Atlassian Cloud (disarankan)

Prasyarat

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

  • Pastikan Anda adalah admin untuk organisasi Atlassian. Lihat Administrasi organisasi..

  • Verifikasi satu atau beberapa domain Anda di organisasi Anda. Lihat Verifikasi domain.

  • Berlangganan Atlassian Access dari organisasi Anda. Lihat Kebijakan dan fitur keamanan Atlassian Access.

  • Tenant Atlassian Cloud dengan berlangganan Atlassian Access.

  • Pastikan Anda adalah admin untuk setidaknya satu situs Jira atau Confluence yang ingin Anda beri akses kepada pengguna yang disinkronkan.

    Nota

    Integrasi ini juga tersedia untuk digunakan dari lingkungan Cloud Pemerintah AS Microsoft Entra. Anda dapat menemukan aplikasi ini di Microsoft Entra Galeri Aplikasi Cloud Pemerintah AS dan mengonfigurasinya dengan cara yang sama seperti yang Anda lakukan dari cloud publik.

Langkah 1: Rencanakan penyediaan layanan Anda

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

Langkah 2: Konfigurasikan Atlassian Cloud untuk mendukung provisi dengan Microsoft Entra ID

  1. Navigasi ke Konsol Admin Atlassian. Pilih organisasi Anda jika Anda memiliki lebih dari satu organisasi.

  2. Pilih Penyedia Identitas untuk Keamanan>.

  3. Pilih direktori Penyedia identitas Anda.

  4. Pilih Siapkan provisi pengguna.

  5. Salin nilai untuk URL dasar SCIM dan kunci API. Anda membutuhkannya saat mengonfigurasi Azure.

  6. Simpan konfigurasi SCIM Anda.

    Nota

    Pastikan Anda menyimpan nilai-nilai ini di tempat yang aman, karena kami tidak akan menunjukkannya kepada Anda lagi.

    Pengguna dan grup secara otomatis disediakan untuk organisasi Anda. Lihat halaman provisi pengguna untuk detail selengkapnya tentang bagaimana pengguna dan grup Anda disinkronkan ke organisasi Anda.

Tambahkan Atlassian Cloud dari galeri aplikasi Microsoft Entra untuk mulai mengelola provisi ke Atlassian Cloud. Jika sebelumnya Anda telah menyiapkan Atlassian Cloud 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 Atlassian Cloud

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

Untuk mengonfigurasi provisi pengguna otomatis untuk Atlassian Cloud di Microsoft Entra ID:

  1. Masuk ke pusat admin Microsoft Entra sebagai minimal seorang Cloud Application Administrator.

  2. Telusuri ke Entra ID>Aplikasi Perusahaan>Atlassian Cloud.

    Bilahan aplikasi enterprise

  3. Dalam daftar aplikasi, pilih Atlassian Cloud.

    Tautan Atlassian Cloud dalam daftar Aplikasi

  4. Pilih tab Penyediaan.

    Cuplikan layar opsi Pengelolaan dengan opsi Pengadaan disebutkan.

  5. Atur Mode Penyiapan ke Otomatis.

    Cuplikan layar daftar dropdown Modus Penyediaan dengan opsi Otomatis ditunjukkan.

  6. Di bawah bagian Info Masuk Admin , masukkan URL Penyewa dan Token Rahasia yang diambil sebelumnya dari akun Atlassian Cloud Anda. Pilih Uji Koneksi untuk memastikan Microsoft Entra ID dapat tersambung ke Atlassian Cloud. Jika koneksi gagal, pastikan akun Atlassian Cloud Anda memiliki izin Admin, lalu coba lagi.

    URL Penyewa + Token

  7. Di bidang Email Pemberitahuan , masukkan alamat email seseorang atau grup yang harus menerima pemberitahuan kesalahan provisi dan centang kotak centang - Kirim pemberitahuan email saat kegagalan terjadi.

    Email Pemberitahuan

  8. Pilih Simpan.

  9. Di bawah bagian Mappings, pilih Sinkronkan pengguna Microsoft Entra ke Atlassian Cloud.

  10. Tinjau atribut pengguna yang disinkronkan dari Microsoft Entra ID ke Atlassian Cloud di bagian Attribute Mapping. Atribut email digunakan untuk mencocokkan akun Atlassian Cloud dengan akun Microsoft Entra Anda. Pilih tombol Simpan untuk menerapkan perubahan apa pun.

    Karakteristik Tipe
    userName string
    aktif Boolean
    nama.keluarga string
    namaDepan string
    email[tipe sama dengan "kerja"].nilai string
  11. Di bawah bagian Mappings, pilih Sinkronkan grup Microsoft Entra ke Atlassian Cloud.

  12. Tinjau atribut grup yang disinkronkan dari Microsoft Entra ID ke Atlassian Cloud di bagian Attribute Mapping. Atribut nama tampilan digunakan untuk mencocokkan grup Atlassian Cloud dengan grup Microsoft Entra Anda. Pilih tombol Simpan untuk menerapkan perubahan apa pun.

    Karakteristik Tipe
    nama tampilan string
    Id eksternal 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 Atlassian Cloud, ubah status Provisioning ke On di bagian Settings.

    Status Penyediaan Dinyalakan

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

    Cakupan Penyediaan

  16. Saat Anda siap untuk memprovisikan, pilih Simpan.

    Menyimpan Konfigurasi Penyediaan

Operasi ini memulai sinkronisasi awal semua pengguna dan/atau grup yang ditentukan dalam Cakupan di bagian Pengaturan . Sinkronisasi awal membutuhkan waktu lebih lama untuk dilakukan daripada sinkronisasi berikutnya, yang terjadi sekitar setiap 40 menit selama layanan provisi Microsoft Entra berjalan.

Langkah 6: 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 kemajuan untuk melihat status siklus provisi 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 .

Batasan Konektor

  • Atlassian Cloud hanya mendukung pembaruan provisi untuk pengguna dengan domain terverifikasi. Perubahan yang dilakukan pada pengguna dari domain yang tidak diverifikasi tidak didorong ke Atlassian Cloud. Pelajari selengkapnya tentang domain terverifikasi Atlassian di sini.
  • Atlassian Cloud tidak mendukung penggantian nama grup hari ini. Ini berarti bahwa setiap perubahan pada displayName grup di Microsoft Entra ID tidak diperbarui dan tercermin di Atlassian Cloud.
  • Nilai atribut pengguna mail di Microsoft Entra ID hanya diisi jika pengguna memiliki kotak Surat Microsoft Exchange. Jika pengguna tidak memilikinya, disarankan untuk memetakan atribut yang diinginkan yang berbeda ke atribut email di Atlassian Cloud.

Riwayat Perubahan

  • 15/06/2020 - Menambahkan dukungan untuk PATCH batch untuk grup.
  • 21/04/2021 - Telah ditambahkan dukungan untuk Penemuan Skema.
  • 14/10/2022 - Batasan Konektor yang Diperbarui.

Sumber daya tambahan