Mengelola pengguna
Artikel ini menjelaskan cara menambahkan, memperbarui, dan menghapus pengguna Azure Databricks.
Untuk gambaran umum model identitas Azure Databricks, lihat Identitas Azure Databricks.
Untuk mengelola akses bagi pengguna, lihat Autentikasi dan kontrol akses.
Ikhtisar manajemen pengguna
Untuk mengelola pengguna di Azure Databricks, Anda harus menjadi admin akun atau admin ruang kerja.
Admin akun dapat menambahkan pengguna ke akun dan menetapkan peran admin kepada mereka. Mereka juga dapat menetapkan pengguna ke ruang kerja dan mengonfigurasi akses data untuk mereka di seluruh ruang kerja, selama ruang kerja tersebut menggunakan federasi identitas.
Admin ruang kerja dapat menambahkan pengguna ke ruang kerja Azure Databricks, menetapkan peran admin ruang kerja untuk mereka, dan mengelola akses ke objek dan fungsionalitas di ruang kerja, seperti kemampuan untuk membuat kluster atau mengakses lingkungan berbasis persona tertentu. Menambahkan pengguna ke ruang kerja Azure Databricks juga menambahkannya ke akun.
Admin ruang kerja adalah anggota
adminsgrup di ruang kerja, yang merupakan grup khusus yang tidak dapat dihapus.Pengguna dengan peran Kontributor atau Pemilik bawaan pada sumber daya ruang kerja di Azure secara otomatis diberi peran admin ruang kerja saat mereka mengklik Luncurkan Ruang Kerja di portal Azure. Untuk informasi selengkapnya, lihat Apa itu admin ruang kerja?.
Penting
Jika akun Anda dibuat setelah 9 November 2023, federasi identitas diaktifkan di semua ruang kerja baru secara default, dan tidak dapat dinonaktifkan.
Menyinkronkan pengguna ke akun Azure Databricks Anda dari penyewa ID Microsoft Entra (sebelumnya Azure Active Directory) Anda
Admin akun dapat menyinkronkan pengguna dari penyewa MICROSOFT Entra ID (sebelumnya Azure Active Directory) ke akun Azure Databricks Anda menggunakan konektor provisi SCIM.
Penting
Jika Anda sudah memiliki konektor SCIM yang menyinkronkan identitas langsung ke ruang kerja, Anda harus menonaktifkan konektor SCIM tersebut saat konektor SCIM tingkat akun diaktifkan. Lihat Memigrasikan provisi SCIM tingkat ruang kerja ke tingkat akun.
Untuk petunjuknya, lihat Memprovisikan identitas ke akun Azure Databricks Anda menggunakan ID Microsoft Entra.
Mengelola pengguna di akun Anda
Admin akun dapat menambahkan pengguna ke akun Azure Databricks Anda menggunakan konsol akun. Pengguna di akun Azure Databricks tidak memiliki akses default ke ruang kerja, data, atau sumber daya komputasi.
Menambahkan pengguna ke akun Anda menggunakan konsol akun
- Sebagai admin akun, masuk ke konsol akun.
- Di bar samping, klik Manajemen pengguna.
- Pada tab Pengguna, klik Tambahkan Pengguna.
- Masukkan nama dan alamat email untuk pengguna.
- Klik Tambahkan Pengguna.
Catatan
Pengguna tidak boleh memiliki lebih dari 50 akun Azure Databricks.
Untuk memberi pengguna akses ke ruang kerja, Anda harus menambahkan mereka ke ruang kerja. Lihat Mengelola pengguna di ruang kerja Anda.
Menetapkan peran admin akun kepada pengguna
- Sebagai admin akun, masuk ke konsol akun.
- Di bar samping, klik Manajemen pengguna.
- Temukan dan klik nama pengguna.
- Pada tab Peran , aktifkan Admin akun atau admin Marketplace.
Menetapkan pengguna ke ruang kerja menggunakan konsol akun
Untuk menambahkan pengguna ke ruang kerja menggunakan konsol akun, ruang kerja harus diaktifkan untuk federasi identitas. Admin ruang kerja juga dapat menetapkan pengguna ke ruang kerja menggunakan halaman pengaturan admin ruang kerja. Lihat Menetapkan pengguna ke ruang kerja menggunakan halaman pengaturan admin ruang kerja.
- Sebagai admin akun, masuk ke konsol akun.
- Di bar samping, klik Ruang Kerja.
- Klik nama ruang kerja Anda.
- Pada tab Izin, klik Tambahkan izin.
- Cari dan pilih pengguna, tetapkan tingkat izin (ruang kerja Pengguna atau Admin), dan klik Simpan.
Menghapus pengguna dari ruang kerja menggunakan konsol akun
Untuk menghapus pengguna dari ruang kerja menggunakan konsol akun, ruang kerja harus diaktifkan untuk federasi identitas. Saat pengguna dihapus dari ruang kerja, pengguna tidak dapat lagi mengakses ruang kerja, namun izin dipertahankan pada pengguna. Jika pengguna kemudian ditambahkan kembali ke ruang kerja, mereka mendapatkan kembali izin sebelumnya.
- Sebagai admin akun, masuk ke konsol akun
- Di bar samping, klik Ruang Kerja.
- Klik nama ruang kerja Anda.
- Pada tab Izin, temukan pengguna.
Klik menu kebab di ujung kanan baris pengguna dan pilih Hapus.- Di dialog konfirmasi, klik Hapus.
Menonaktifkan pengguna di akun Azure Databricks Anda
Admin akun dapat menonaktifkan pengguna di seluruh akun Azure Databricks. Pengguna yang dinonaktifkan tidak dapat masuk ke akun atau ruang kerja Azure Databricks. Namun, semua izin pengguna dan objek ruang kerja tetap tidak berubah. Saat pengguna dinonaktifkan, hal berikut ini benar:
- Pengguna tidak dapat masuk ke akun atau ruang kerja mereka dari metode apa pun.
- Aplikasi atau skrip yang menggunakan token yang dihasilkan oleh pengguna tidak dapat lagi mengakses API Databricks. Token tetap ada tetapi tidak dapat digunakan untuk mengautentikasi saat pengguna dinonaktifkan.
- Notebook yang dimiliki oleh pengguna tetap ada.
- Kluster yang dimiliki oleh pengguna tetap berjalan.
- Pekerjaan terjadwal yang dibuat oleh pengguna harus ditetapkan ke pemilik baru untuk mencegahnya gagal.
Saat pengguna diaktifkan kembali, mereka dapat masuk ke Azure Databricks dengan izin yang sama. Databricks merekomendasikan untuk menonaktifkan pengguna dari akun alih-alih menghapusnya karena menghapus pengguna adalah tindakan yang merusak.
Anda tidak dapat menonaktifkan pengguna menggunakan konsol akun. Sebagai gantinya, gunakan API Pengguna Akun. Lihat Menonaktifkan pengguna di akun Azure Databricks Anda menggunakan API.
Menghapus pengguna dari akun Azure Databricks Anda
Admin akun dapat menghapus pengguna dari akun Azure Databricks. Admin ruang kerja tidak bisa. Saat Anda menghapus pengguna dari akun, pengguna tersebut juga dihapus dari ruang kerjanya.
Penting
Saat Anda menghapus pengguna dari akun, pengguna tersebut juga dihapus dari ruang kerja mereka, terlepas dari apakah federasi identitas telah diaktifkan atau tidak. Kami menyarankan agar Anda tidak menghapus pengguna tingkat akun kecuali Anda ingin mereka kehilangan akses ke semua ruang kerja di akun. Waspadai konsekuensi berikut dari menghapus pengguna:
- Aplikasi atau skrip yang menggunakan token yang dihasilkan oleh pengguna tidak dapat lagi mengakses API Databricks
- Pekerjaan yang dimiliki oleh pengguna gagal
- Kluster yang dimiliki oleh pengguna berhenti
- Kueri atau dasbor yang dibuat oleh pengguna dan dibagikan menggunakan info masuk Jalankan sebagai Pemilik harus ditetapkan ke pemilik baru untuk mencegah berbagi gagal
Saat pengguna dihapus dari akun, pengguna tidak dapat lagi mengakses akun atau ruang kerja mereka, namun izin dipertahankan pada pengguna. Jika pengguna kemudian ditambahkan kembali ke akun, mereka mendapatkan kembali izin sebelumnya.
Untuk menghapus pengguna menggunakan konsol akun, lakukan hal berikut:
- Sebagai admin akun, masuk ke konsol akun.
- Di bar samping, klik Manajemen pengguna.
- Temukan dan klik nama pengguna.
- Pada tab Informasi Pengguna, klikmenu kebab di sudut kanan atas dan pilih Hapus.
- Pada dialog konfirmasi, klik Konfirmasi penghapusan.
Jika Anda menghapus pengguna menggunakan konsol akun, Anda harus memastikan bahwa Anda juga menghapus pengguna menggunakan konektor penyediaan SCIM atau aplikasi API SCIM yang telah disiapkan untuk akun tersebut. Jika tidak, provisi SCIM menambahkan pengguna kembali saat berikutnya disinkronkan. Lihat Menyinkronkan pengguna dan grup dari ID Microsoft Entra.
Untuk menghapus pengguna dari akun Azure Databricks menggunakan API SCIM, Anda harus menjadi admin akun. Lihat Memprovisikan identitas ke akun Azure Databricks Anda dan API Grup Akun.
Mengelola pengguna di ruang kerja Anda
Admin ruang kerja dapat menambahkan dan mengelola pengguna menggunakan halaman pengaturan admin ruang kerja.
Menetapkan pengguna ke ruang kerja menggunakan halaman pengaturan admin ruang kerja
Untuk menambahkan pengguna ke ruang kerja menggunakan halaman pengaturan admin ruang kerja, lakukan hal berikut:
Sebagai admin ruang kerja, masuk ke ruang kerja Azure Databricks.
Klik nama pengguna Anda di bilah atas ruang kerja Azure Databricks dan pilih Pengaturan.
Klik tab Identitas dan akses .
Di samping Pengguna, klik Kelola.
Klik Tambahkan Pengguna.
Pilih pengguna yang sudah ada untuk ditetapkan ke ruang kerja atau klik Tambahkan baru untuk membuat pengguna baru.
Anda dapat menambahkan pengguna mana pun yang termasuk dalam penyewa MICROSOFT Entra ID (sebelumnya Azure Active Directory) dari ruang kerja Azure Databricks Anda.
Klik Tambahkan.
Catatan
Jika ruang kerja Anda tidak diaktifkan untuk federasi identitas, Anda hanya melihat opsi untuk menambahkan pengguna baru ke ruang kerja. Jika Anda menambahkan pengguna yang berbagi nama pengguna (alamat email) dengan pengguna akun yang sudah ada, pengguna tersebut akan digabungkan.
Menetapkan peran admin ruang kerja kepada pengguna menggunakan halaman pengaturan admin ruang kerja
Untuk menetapkan peran admin ruang kerja menggunakan halaman pengaturan admin ruang kerja, lakukan hal berikut:
- Sebagai admin ruang kerja, masuk ke ruang kerja Azure Databricks.
- Klik nama pengguna Anda di bilah atas ruang kerja Azure Databricks dan pilih Pengaturan.
- Klik tab Identitas dan akses .
- Di samping Pengguna, klik Kelola.
- Pilih pengguna .
- Klik tab Hak.
- Klik tombol di samping Akses admin.
Untuk menghapus peran admin ruang kerja dari pengguna ruang kerja, lakukan langkah yang sama, tetapi hapus tombol Akses admin.
Menonaktifkan pengguna di ruang kerja Azure Databricks Anda
Admin ruang kerja dapat menonaktifkan pengguna di ruang kerja Azure Databricks. Pengguna yang dinonaktifkan tidak dapat masuk ke ruang kerja atau mengaksesnya dari API Azure Databricks, namun semua izin pengguna dan objek ruang kerja tetap tidak berubah. Saat pengguna dinonaktifkan:
- Pengguna tidak dapat masuk ke ruang kerja dari metode apa pun.
- Status pengguna ditampilkan sebagai Tidak Aktif di halaman pengaturan admin ruang kerja.
- Aplikasi atau skrip yang menggunakan token yang dihasilkan oleh pengguna tidak dapat lagi mengakses API Databricks. Token tetap ada tetapi tidak dapat digunakan untuk mengautentikasi saat pengguna dinonaktifkan.
- Notebook yang dimiliki oleh pengguna tetap ada.
- Kluster yang dimiliki oleh pengguna tetap berjalan.
- Pekerjaan terjadwal yang dibuat oleh pengguna harus ditetapkan ke pemilik baru untuk mencegahnya gagal.
Saat pengguna diaktifkan kembali, mereka dapat masuk ke ruang kerja dengan izin yang sama. Databricks merekomendasikan untuk menonaktifkan pengguna alih-alih menghapusnya karena menghapus pengguna adalah tindakan yang merusak. Anda tidak dapat menonaktifkan pengguna menggunakan halaman pengaturan admin ruang kerja. Sebagai gantinya, gunakan API Pengguna Ruang Kerja. Lihat Menonaktifkan pengguna di ruang kerja Azure Databricks Anda menggunakan API.
Menghapus pengguna dari ruang kerja menggunakan halaman pengaturan admin ruang kerja
Saat pengguna dihapus dari ruang kerja, pengguna tidak dapat lagi mengakses ruang kerja, namun izin dipertahankan pada pengguna. Jika pengguna kemudian ditambahkan kembali ke ruang kerja, mereka mendapatkan kembali izin sebelumnya.
- Sebagai admin ruang kerja, masuk ke ruang kerja Azure Databricks.
- Klik nama pengguna Anda di bilah atas ruang kerja Azure Databricks dan pilih Pengaturan.
- Klik tab Identitas dan akses .
- Di samping Pengguna, klik Kelola.
- Temukan menu pengguna dan kebab di ujung kanan baris pengguna dan pilih Hapus.
- Klik Hapus untuk mengonfirmasi.
Mengelola pengguna menggunakan API
Admin akun dan admin ruang kerja dapat mengelola pengguna di akun Dan ruang kerja Azure Databricks menggunakan API Databricks.
Mengelola pengguna di akun menggunakan API
Admin dapat menambahkan dan mengelola pengguna di akun Azure Databricks menggunakan API Pengguna Akun. Admin akun dan admin ruang kerja memanggil API menggunakan URL titik akhir yang berbeda:
- Admin akun menggunakan
{account-domain}/api/2.0/accounts/{account_id}/scim/v2/. - Admin ruang kerja menggunakan
{workspace-domain}/api/2.0/account/scim/v2/.
Untuk detailnya, lihat API Pengguna Akun.
Menonaktifkan pengguna di akun Azure Databricks Anda menggunakan API
Admin akun dapat mengubah status pengguna untuk menonaktifkan pengguna menggunakan API Pengguna Akun. Contohnya:
curl --netrc -X PATCH \
https://${DATABRICKS_HOST}/api/2.0/accounts/{account_id}/scim/v2/Users/{id} \
--header 'Content-type: application/scim+json' \
--data @update-user.json \
| jq .
update-user.json:
{
"schemas": [ "urn:ietf:params:scim:api:messages:2.0:PatchOp" ],
"Operations": [
{
"op": "replace",
"path": "active",
"value": [
{
"value": "false"
}
]
}
]
}
Status pengguna yang dinonaktifkan diberi label Tidak Aktif di konsol akun.
Saat Anda menonaktifkan pengguna dari akun, pengguna tersebut juga dinonaktifkan dari ruang kerja mereka.
Mengelola pengguna di ruang kerja menggunakan API
Admin akun dan ruang kerja dapat menggunakan WORKspace Assignment API untuk menetapkan pengguna ke ruang kerja yang diaktifkan untuk federasi identitas. API Penugasan Ruang Kerja didukung melalui akun dan ruang kerja Azure Databricks.
- Admin akun menggunakan
{account-domain}/api/2.0/accounts/{account_id}/workspaces/{workspace_id}/permissionassignments. - Admin ruang kerja menggunakan
{workspace-domain}/api/2.0/preview/permissionassignments/principals/{user_id}.
Lihat API Penetapan Ruang Kerja.
Jika ruang kerja Anda tidak diaktifkan untuk federasi identitas, admin ruang kerja dapat menggunakan API tingkat ruang kerja untuk menetapkan pengguna ke ruang kerja mereka. Lihat API Pengguna Ruang Kerja.
Menonaktifkan pengguna di ruang kerja Azure Databricks Anda menggunakan API
Admin ruang kerja dapat mengubah status pengguna untuk menonaktifkan pengguna menggunakan API Pengguna Ruang Kerja. Contohnya:
curl --netrc -X PATCH \
https://<databricks-instance>/api/2.0/preview/scim/v2/Users/<user-id> \
--header 'Content-type: application/scim+json' \
--data @update-user.json \
| jq .
update-user.json:
{
"schemas": [ "urn:ietf:params:scim:api:messages:2.0:PatchOp" ],
"Operations": [
{
"op": "replace",
"path": "active",
"value": [
{
"value": "false"
}
]
}
]
}
Status pengguna yang dinonaktifkan diberi label Tidak Aktif di halaman pengaturan admin ruang kerja.
Saran dan Komentar
Segera hadir: Sepanjang tahun 2024 kami akan menghentikan penggunaan GitHub Issues sebagai mekanisme umpan balik untuk konten dan menggantinya dengan sistem umpan balik baru. Untuk mengetahui informasi selengkapnya, lihat: https://aka.ms/ContentUserFeedback.
Kirim dan lihat umpan balik untuk