Tutorial: Mengonfigurasi Airtable untuk provisi pengguna otomatis

Artikel
03/25/2024

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

Prasyarat

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

Penyewa Microsoft Entra.
Salah satu peran berikut: Administrator Aplikasi, Administrator Aplikasi Cloud, atau Pemilik Aplikasi.
Penyewa Airtable.
Akun pengguna di Airtable dengan izin Admin.

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 Airtable.

Langkah 2: Buat Token Akses Pribadi airtable untuk mengotorisasi provisi dengan ID Microsoft Entra.

Masuk ke Hub Pengembang Airtable sebagai pengguna Admin, lalu navigasikan ke https://airtable.com/create/tokens.
Pilih "Token Akses Pribadi" dari bilah navigasi sebelah kiri.
Buat token baru dengan nama yang mudah diingat seperti "AzureAdScimProvisioning".
Tambahkan cakupan "enterprise.scim.usersAndGroups:manage".
Pilih "Buat Token" dan salin token yang dihasilkan untuk digunakan pada Langkah 5 di bawah ini.

Langkah 3: Tambahkan Airtable dari galeri aplikasi Microsoft Entra

Tambahkan Airtable dari galeri aplikasi Microsoft Entra untuk mulai mengelola provisi ke Airtable. Jika sebelumnya Anda telah menyiapkan Airtable untuk SSO, Anda dapat menggunakan aplikasi yang sama. Namun, sebaiknya Anda membuat aplikasi terpisah saat 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 memerlukan lebih banyak peran, Anda dapat memperbarui manifes aplikasi untuk menambahkan peran baru.

Langkah 5: Mengonfigurasi provisi pengguna otomatis ke Airtable

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

Untuk mengonfigurasi provisi pengguna otomatis untuk Airtable di MICROSOFT Entra ID:

Masuk ke pusat admin Microsoft Entra sebagai setidaknya Administrator Aplikasi Cloud.
Telusuri aplikasi Identity>Applications>Enterprise
Dalam daftar aplikasi, pilih Airtable.
Pilih Provisi tab.
Atur Mode Provisi ke Otomatis.
Di bawah bagian Info Masuk Admin,
1. Masukkan https://airtable.com/scim/v2 sebagai URL Penyewa Airtable.
2. Masukkan Token Akses Pribadi yang dibuat pada Langkah 2 di atas sebagai Token Rahasia.
Klik Uji Koneksi ion untuk memastikan ID Microsoft Entra dapat tersambung ke Airtable. Jika koneksi gagal, pastikan akun Airtable Anda memiliki izin Admin dan token akses pribadi Anda memiliki cakupan yang sesuai yang diterapkan dan coba lagi.
Di bidang Surel Pemberitahuan, masukkan alamat surel seseorang atau grup penerima pemberitahuan kesalahan provisi dan pilih kotak centang Kirim pemberitahuan surel ketika kegagalan terjadi.
Pilih Simpan.
Di bawah bagian Pemetaan , pilih Sinkronkan pengguna Microsoft Entra ke Airtable.

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

Atribut	Jenis	Didukung untuk pemfilteran	Diperlukan oleh Airtable
userName	String	✓	✓
active	Boolean
displayName	String
title	String
emails[type eq "work"].value	String
preferredLanguage	String
name.givenName	String		✓
name.familyName	String		✓
name.formatted	String
addresses[type eq "work"].formatted	String
addresses[type eq "work"].streetAddress	String
addresses[type eq "work"].locality	String
addresses[type eq "work"].region	String
addresses[type eq "work"].postalCode	String
addresses[type eq "work"].country	String
phoneNumbers[type eq "work"].value	String
phoneNumbers[type eq "mobile"].value	String
phoneNumbers[type eq "fax"].value	String
externalId	String
nickName	String
urn:ietf:params:scim:schemas:extension:enterprise:2.0:User:employeeNumber	String
urn:ietf:params:scim:schemas:extension:enterprise:2.0:User:department	String
urn:ietf:params:scim:schemas:extension:enterprise:2.0:User:manager.value	String
addresses[type eq "home"].formatted	String
addresses[type eq "home"].streetAddress	String
addresses[type eq "home"].locality	String
addresses[type eq "home"].region	String
addresses[type eq "home"].postalCode	String
addresses[type eq "home"].country	String
addresses[type eq "other"].formatted	String
addresses[type eq "other"].streetAddress	String
addresses[type eq "other"].locality	String
addresses[type eq "other"].region	String
addresses[type eq "other"].postalCode	String
addresses[type eq "other"].country	String
emails[type eq "home"].value	String
emails[type eq "other"].value	String
lokal	String
nama.honorificPrefix	String
name.honorificSuffix	String
nama.middleName	String
name.familyName	String
phoneNumbers[type eq "home"].value	String
phoneNumbers[type eq "other"].value	String
phoneNumbers[type eq "pager"].value	String
zona waktu	String
urn:ietf:params:scim:schemas:extension:enterprise:2.0:User:costCenter	String
urn:ietf:params:scim:schemas:extension:enterprise:2.0:User:division	String
urn:ietf:params:scim:schemas:extension:enterprise:2.0:User:organization	String
userType	String

Di bawah bagian Pemetaan , pilih Sinkronkan grup Microsoft Entra ke Airtable.
Tinjau atribut grup yang disinkronkan dari MICROSOFT Entra ID ke Airtable di bagian Pemetaan Atribut. Atribut yang dipilih sebagai properti Pencocokan digunakan untuk mencocokkan grup di Airtable untuk operasi pembaruan. Pilih tombol Simpan untuk menerapkan perubahan apa pun.

Atribut Jenis Didukung untuk pemfilteran Diperlukan oleh Airtable

displayName String ✓ ✓

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

Atribut	Jenis	Didukung untuk pemfilteran	Diperlukan oleh Airtable
displayName	String	✓	✓
anggota	Referensi

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 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 progres untuk melihat status siklus provisi dan seberapa lama penyelesaiannya
Jika konfigurasi provisi tampaknya dalam keadaan tidak sehat, aplikasi masuk ke karantina. Pelajari selengkapnya status karantina di sini.

Sumber daya lainnya

Langkah berikutnya

Mempelajari cara mengulas log dan mendapatkan laporan tentang aktivitas provisi

Bagikan melalui