Tutorial: Mengonfigurasi Atlassian Cloud untuk provisi pengguna otomatis

Artikel
10/25/2023

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

Prasyarat

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

Penyewa Microsoft Entra.
Akun pengguna di ID Microsoft Entra dengan izin untuk mengonfigurasi provisi (misalnya Administrator Aplikasi, Administrator Aplikasi Cloud, Pemilik Aplikasi, atau Administrator Global).
Pastikan Anda adalah admin untuk organisasi Atlassian. Lihat Administrasi organisasi..
Verifikasi satu atau lebih domain dalam organisasi Anda. Lihat Verifikasi domain.
Berlangganan Atlassian Access dari organisasi Anda. Lihat Kebijakan dan fitur keamanan Akses Atlassian.
Penyewa Atlassian Cloud dengan langganan Atlassian Access.
Pastikan Anda adalah admin untuk setidaknya satu situs Jira atau Confluence untuk pengguna yang disinkronkan yang ingin Anda beri akses.

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

Pelajari tentang Cara kerja layanan provisi .
Tentukan siapa yang akan berada dalam cakupan untuk provisi.
Tentukan data apa yang akan dipetakan antara ID Microsoft Entra dan Atlassian Cloud.

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

Navigasikan ke Konsol Admin Atlassian. Pilih organisasi Anda jika Anda memiliki lebih dari satu organisasi.
Pilih Penyedia Identitas Keamanan>.
Pilih direktori Penyedia identitas Anda.
Pilih Siapkan provisi pengguna.
Salin nilai untuk URL dasar SCIM dan kunci API. Anda akan membutuhkannya saat mengonfigurasi Azure.
Simpan konfigurasi SCIM Anda.

Catatan

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

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

Langkah 3: Tambahkan Atlassian Cloud dari galeri aplikasi Microsoft Entra

Tambahkan Atlassian Cloud dari galeri aplikasi Microsoft Entra untuk mulai mengelola provisi ke Atlassian Cloud. Jika Anda sebelumnya telah menyiapkan Atlassian Cloud untuk SSO, maka Anda dapat menggunakan aplikasi yang sama. Namun, Anda disarankan agar membuat aplikasi terpisah ketika 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 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 membutuhkan 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 penetapan pengguna dan/atau grup di ID Microsoft Entra.

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

Masuk ke pusat admin Microsoft Entra sebagai setidaknya Administrator Aplikasi Cloud.
Telusuri aplikasi >Identity>Applications>Enterprise Atlassian Cloud.
Dalam daftar aplikasi, pilih Atlassian Cloud.
Pilih Provisi tab.
Atur Mode Provisi ke Otomatis.
Di bagian Info Masuk Admin, masukkan URL Penyewa dan Token Rahasia yang diambil sebelumnya dari akun Atlassian Cloud Anda. Klik Uji Koneksi ion untuk memastikan MICROSOFT Entra ID dapat tersambung ke Atlassian Cloud. Jika sambungan gagal, pastikan akun Atlassian Cloud Anda memiliki izin Admin, dan coba lagi.
Di bidang Email Pemberitahuan, masukkan alamat email seseorang atau grup yang akan menerima pemberitahuan kesalahan provisi dan centang kotak centang - Kirim pemberitahuan email saat kegagalan terjadi.
Klik Simpan.
Di bawah bagian Pemetaan , pilih Sinkronkan pengguna Microsoft Entra ke Atlassian Cloud.
Tinjau atribut pengguna yang disinkronkan dari ID Microsoft Entra ke Atlassian Cloud di bagian Pemetaan Atribut. Atribut email akan digunakan untuk mencocokkan akun Atlassian Cloud dengan akun Microsoft Entra Anda. Pilih tombol Simpan untuk menerapkan perubahan apa pun.

Atribut Jenis

userName String

active Boolean

name.familyName String

name.givenName String

emails[type eq "work"].value String
Di bawah bagian Pemetaan , pilih Sinkronkan grup Microsoft Entra ke Atlassian Cloud.
Tinjau atribut grup yang disinkronkan dari ID Microsoft Entra ke Atlassian Cloud di bagian Pemetaan Atribut. Atribut nama tampilan akan digunakan untuk mencocokkan grup Atlassian Cloud dengan grup Microsoft Entra Anda. Pilih tombol Simpan untuk menerapkan perubahan apa pun.

Atribut Jenis

displayName String

externalId String

anggota Referensi
Untuk mengonfigurasi filter cakupan, lihat instruksi berikut yang disediakan dalam Tutorial filter cakupan.
Untuk mengaktifkan layanan provisi Microsoft Entra untuk Atlassian Cloud, ubah Status Provisi menjadi Aktif di bagian Pengaturan.
Tentukan pengguna dan/atau grup yang ingin Anda provisi ke Atlassian Cloud dengan memilih nilai yang diinginkan dalam Cakupan di bagian Pengaturan.
Saat Anda siap untuk melakukan provisi, klik Simpan.

Atribut	Jenis
userName	String
active	Boolean
name.familyName	String
name.givenName	String
emails[type eq "work"].value	String

Atribut	Jenis
displayName	String
externalId	String
anggota	Referensi

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 provisi, gunakan sumber daya berikut untuk memantau penyebaran Anda:

Gunakan log provisi untuk menentukan pengguna mana yang telah berhasil atau gagal diprovisi
Periksa bilah kemajuan untuk melihat status siklus provisi dan seberapa dekat dengan penyelesaiannya
Jika konfigurasi provisi tampaknya dalam keadaan buruk, aplikasi akan masuk ke karantina. Pelajari selengkapnya status karantina di sini.

Batasan Konektor

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