Menyiapkan penyediaan pengguna otomatis dengan profil SCIM kustom (beta)

Penyediaan pengguna otomatis dengan profil SCIM kustom adalah fitur beta yang hanya tersedia untuk sejumlah kecil peserta. Jika Anda tidak melihat Penyediaan otomatis di halaman detail aplikasi, berarti fitur ini belum tersedia untuk organisasi Anda.

Anda dapat otomatis menyiapkan dan mengelola akun pengguna di aplikasi SAML kustom atau praintegrasi yang mendukung SCIM 2.0 menggunakan penyediaan pengguna otomatis dengan profil SCIM kustom.

Sebelum memulai

Untuk menyiapkan profil SCIM kustom, Anda harus memiliki:

• Akun Cloud Identity dengan peran administrator super. Untuk mengetahui detailnya, buka Peran administrator standar.
• Aplikasi SAML kustom atau praintegrasi yang disiapkan dan diaktifkan untuk pengguna di konsol Admin Anda

Aplikasi Anda harus memiliki server SCIM yang:

• Mendukung SCIM versi 2.0
• Menggunakan metode HTTP standar, termasuk POST, GET, PATCH dengan penggantian ke PUT, dan DELETE
• Mendukung autentikasi Token Bearer. Autentikasi token OAuth tidak didukung.

Menyiapkan penyediaan pengguna otomatis dengan profil SCIM kustom

1. Di konsol Google Admin, buka Menu Aplikasi Aplikasi seluler dan web.

   Buka Aplikasi web dan seluler

   Anda harus login sebagai administrator super untuk melakukan tugas ini.

2. Klik nama aplikasi SAML Anda.
3. Di bagian Penyediaan otomatis, klik Konfigurasi penyediaan otomatis.
4. Masukkan token pemilik dari aplikasi Anda di Token akses, lalu klik Lanjutkan.
5. Masukkan URL endpoint SCIM dari aplikasi Anda di kolom URL Endpoint, lalu klik Lanjutkan. Google terhubung ke endpoint SCIM Anda untuk otomatis menemukan atribut yang didukung.
6. Petakan atribut Direktori Google Anda ke atribut aplikasi yang sesuai. Jika aplikasi Anda mendukung penemuan skema, tabel akan diisi otomatis dengan atribut yang ditemukan. Untuk memetakan atribut khusus secara manual, klik Tambahkan pemetaan Lanjutkan setelah selesai.
7. (Opsional) Jika Anda tidak menambahkan grup, semua pengguna yang memiliki akses ke aplikasi SAML akan disediakan. Untuk membatasi penyediaan otomatis bagi grup pengguna tertentu:
   • Untuk Grup penelusuran, masukkan satu atau beberapa huruf dari nama grup, pilih nama grup, lalu pilih cakupan.
   • Tambahkan grup lainnya.
   • (Opsional) Untuk menghapus grup, klik Hapus.
     Jika grup memiliki pengguna dari domain sekunder atau dari luar organisasi, penyediaan untuk pengguna tersebut tidak akan dilakukan.
8. Tentukan berapa lama pengguna tetap memiliki akses ke aplikasi setelah aplikasi dinonaktifkan untuk mereka, atau setelah akun Google Workspace mereka ditangguhkan atau dihapus. Anda dapat memilih untuk menangguhkan akun mereka, menghapus akun mereka secara permanen, atau menangguhkan, lalu menghapus akun mereka secara permanen. Anda dapat menetapkan jangka waktu penundaan satu per satu untuk setiap tindakan.
   1. Pilih opsi untuk setiap peristiwa ini sesuai kebutuhan:
      • Saat aplikasi dinonaktifkan untuk pengguna
      • Saat pengguna ditangguhkan dari Google
      • Jika pengguna dihapus dari Google
        Jika Anda menangguhkan akun pengguna, akun tersebut akan ditandai sebagai dinonaktifkan. Jika Anda menghapus akun pengguna secara permanen, akun tersebut akan dihapus secara permanen dari aplikasi. Selalu tetapkan jangka waktu yang lebih lama sebelum menghapus akun pengguna secara permanen. Untuk mengetahui detail tentang penangguhan dan penghapusan, buka Mengedit jangka waktu pencabutan akses.
   2. Klik Lanjutkan.

9. Uji koneksi:

   1. Untuk Pengguna Direktori Google, telusuri dan pilih pengguna yang tidak memiliki akun di aplikasi Anda.

   2. Klik Test.
      

      Google membuat akun untuk pengguna di aplikasi Anda, memperbaruinya, lalu menghapusnya. Setiap operasi menampilkan Berhasil, Gagal, atau Tidak dijalankan. Untuk operasi yang gagal, tinjau kode HTTP, jenis error SCIM, dan detail Lihat respons mentah dari aplikasi Anda.
      

      Catatan: Jika aplikasi Anda tidak menampilkan 201 Created untuk pengguna baru, misalnya karena pengguna sudah ada, Create User akan gagal dan Google akan melewati operasi update dan penghapusan. Jika Delete User gagal, hapus akun pengujian di aplikasi Anda secara manual.

10. Klik Selesai.
    Anda dapat mengklik Selesai meskipun pengujian gagal, dan mengujinya lagi nanti. Langkah ini menyimpan konfigurasi, tetapi tidak mengaktifkan penyediaan otomatis. Untuk mengaktifkannya, buka halaman detail aplikasi Anda Penyediaan otomatis, lalu setel tombol ke Aktif.
    Catatan: Setelan ini dinonaktifkan jika aplikasi Anda tidak diaktifkan untuk pengguna mana pun. Klik User access, lalu aktifkan aplikasi untuk mengaktifkan penyediaan otomatis.

Mengedit informasi penyediaan

Menonaktifkan penyediaan otomatis & menghapus informasi konfigurasi

Anda dapat menonaktifkan penyediaan otomatis untuk aplikasi tanpa kehilangan informasi konfigurasi. Atau, Anda dapat menonaktifkan penyediaan otomatis dan menghapus semua informasi konfigurasi.

Meninjau informasi penggunaan

• Setelah mengaktifkan penyediaan otomatis, Anda dapat meninjau informasi penggunaan. Untuk mengetahui detailnya, buka Memantau penyediaan pengguna otomatis.
• Anda dapat meninjau informasi penggunaan berikut selama 30 hari terakhir:

Peristiwa log admin	Deskripsi
Pengguna Dibuat dengan Penyediaan Otomatis	Pengguna yang dibuat oleh penyediaan otomatis
Pengguna yang Dibuat dengan Penyediaan Otomatis Diperbarui	Pengguna yang diperbarui oleh penyediaan otomatis
Pengguna yang Dibuat dengan Penyediaan Otomatis Ditangguhkan	Pengguna yang ditangguhkan oleh penyediaan otomatis
Penangguhan Pengguna yang Dibuat dengan Penyediaan Otomatis Dibatalkan	Pengguna diaktifkan kembali melalui penyediaan otomatis
Pengguna yang Dibuat dengan Penyediaaan Otomatis Dihapus Secara Permanen	Pengguna yang dihapus oleh penyediaan otomatis
Kegagalan	Permintaan yang gagal

Jika penyediaan otomatis berhenti berfungsi

Penyediaan otomatis akan berhenti berfungsi jika Google tidak dapat lagi terhubung ke aplikasi Anda. Misalnya, token pemilik mungkin telah habis masa berlakunya atau dicabut, atau URL SCIM aplikasi mungkin telah berubah. Untuk memperbaikinya, perbarui token atau URL:

1. Di konsol Google Admin, buka Menu Aplikasi Aplikasi seluler dan web.

   Buka Aplikasi web dan seluler

   Anda harus login sebagai administrator super untuk melakukan tugas ini.

2. Klik nama aplikasi SAML Anda.
3. Klik Penyediaan otomatis.
4. Untuk memperbarui token pemilik:
   1. Untuk Otorisasi aplikasi, klik Otorisasi ulang.
   2. Untuk Token akses, tempel token pemilik baru dari aplikasi Anda.
   3. Klik Otorisasi ulang.
5. Untuk memperbarui URL dasar SCIM, klik Edit untuk URL Endpoint, masukkan URL baru, lalu klik Perbarui.
6. (Opsional) Untuk memverifikasi koneksi, klik Test untuk Test connection.

Untuk mengetahui detail tentang alasan lain dari penyediaan otomatis mungkin berhenti berfungsi, lihat dokumentasi aplikasi.