:Integrasikan dengan WeCom

Langkah 1: Buat aplikasi

1. Buat aplikasi di WeCom.

   1. Buat aplikasi mandiri di WeCom

      Login ke Konsol admin WeCom. Di bagian App Management > App, buat self-built application.

   2. Konfigurasikan informasi aplikasi

      Unggah App Logo, masukkan App Name dan App Description (Optional), lalu pilih cakupan Visible To sesuai kebutuhan Anda. Cakupan visibilitas ini menentukan kontak yang dapat diakses oleh IDaaS EIAM untuk sinkronisasi data dan login. Kemudian, kembali ke halaman manajemen aplikasi.

   3. Lihat aplikasi yang telah dibuat

      Kembali ke halaman manajemen aplikasi. Aplikasi yang Anda buat muncul di bagian Self-built.

2. Buat penyedia identitas di IDaaS EIAM.

   1. Mulai proses integrasi WeCom di Konsol IDaaS EIAM

      Login ke Konsol Alibaba Cloud IDaaS dan pilih instans IDaaS EIAM Anda. Di panel navigasi, pilih IdPs, lalu klik Other IdPs > WeCom untuk memulai integrasi.

      Penting

      Jika tidak tersedia titik akhir khusus untuk instans saat ini, Anda harus menambahkannya terlebih dahulu. Untuk informasi selengkapnya, lihat Tambahkan titik akhir khusus.

   2. Masukkan informasi dasar

      Masukkan Display Name dan Enterprise ID sesuai petunjuk.

      • Display Name: Nama ini mungkin terlihat oleh pengguna saat mereka login atau menggunakan IDaaS EIAM.

      • Enterprise ID: Login ke Konsol admin WeCom. Dapatkan Enterprise ID dari halaman My Enterprise > Enterprise.

   3. Masukkan informasi aplikasi

      Masukkan AgentId dan Secret.

      1. Di Konsol admin WeCom, buka halaman Application Management > Applications dan buka halaman detail aplikasi mandiri Anda untuk mendapatkan informasi tersebut.

      2. Di halaman detail aplikasi, klik View di bagian Secret.

      3. Di kotak dialog, konfirmasi permintaan tersebut. Anda kemudian dapat mengambil secret dari WeCom Team message sesuai petunjuk.

   4. Masukkan informasi pengembangan

      Catatan

      Langkah-langkah berikut menggunakan contoh nama domain yang disediakan sendiri. Jika Anda memilih untuk menggunakan nama domain kustom, buka Branding > Custom Domain Name > Add Custom Domain Name di instans IDaaS EIAM Anda untuk menyelesaikan konfigurasi.

      1. Trusted Domain Name.

         Domain Name Type memengaruhi kemampuan WeCom yang dapat Anda gunakan dan cara informasi pengembangan dihasilkan. Perbedaannya adalah sebagai berikut:

         Kategori	Self-provided domain name	Custom domain name
         Perbedaan fitur	Hanya mendukung sinkronisasi data non-sensitif dan login QR code.	Mendukung sinkronisasi data sensitif dan login otorisasi web (SSO dari halaman web WeCom) selain fitur yang didukung oleh self-provided domain name.
         Perbedaan konfigurasi	Anda harus menyiapkan nama domain khusus sebagai nama domain tepercaya. Pemiliknya harus sesuai dengan entitas terotentikasi di WeCom. Domain ini tidak memiliki logika bisnis di IDaaS EIAM. Alamat lain dalam informasi pengembangan dihasilkan secara default.	Pilih nama domain kustom yang tersedia dan pemiliknya sesuai dengan entitas terotentikasi di WeCom. Domain ini digunakan oleh fitur WeCom dan harus stabil. Alamat lain dalam informasi pengembangan dihasilkan berdasarkan nama domain kustom yang dipilih.

         1. Di halaman detail aplikasi di Konsol admin WeCom, klik Set trusted domain.

         2. Masukkan nama domain tepercaya untuk fungsi otorisasi web OAuth2 aplikasi.

            Catatan

            WeCom mensyaratkan bahwa nama domain tepercaya yang dikonfigurasi harus sesuai dengan entitas perusahaan dan tidak bergantung pada protokol atau path URL.

         3. Setelah verifikasi, ikuti petunjuk WeCom untuk menyelesaikan autentikasi kepemilikan domain.

      2. Enterprise Trusted IP. Klik daftar drop-down dan pilih titik akhir jaringan khusus.

         1. Anda harus menggunakan egress publik khusus dari titik akhir jaringan agar instans IDaaS EIAM Anda dapat mengakses WeCom dari alamat IP Anda. Untuk informasi selengkapnya, lihat Konfigurasikan alamat IP egress publik khusus.

         2. Di halaman konfigurasi IDaaS EIAM, pilih titik akhir jaringan dan lihat Dedicated Outbound Public IP Address.

         3. Alamat IP publik yang tersedia untuk instans akan ditampilkan. Klik Copy All IP Addresses.

         4. Di pengaturan aplikasi Anda di Konsol admin WeCom, konfigurasikan alamat IP yang disalin sebagai Enterprise Trusted IP.

         Penting

         Semua API WeCom yang digunakan oleh IDaaS EIAM dipanggil melalui alamat IP tepercaya. Jika alamat IP tepercaya dikonfigurasi salah atau tidak tersedia, semua fitur termasuk sinkronisasi data dan login QR code akan terpengaruh. Karena logika verifikasi WeCom untuk alamat IP tepercaya tidak didokumentasikan secara publik, Anda sebaiknya mempertahankan metode login lain untuk IDaaS EIAM, seperti username/password atau kode SMS.

      3. Authorization callback domain

         1. Di halaman konfigurasi Bind WeCom - Inbound, salin authorization callback domain.

         2. Di pengaturan aplikasi Anda di Konsol admin WeCom, klik Configuration untuk WeCom Login Authorization.

         3. Di bagian Webpage, klik Set authorization callback domain. Tempel authorization callback domain yang Anda salin dari halaman konfigurasi IDaaS EIAM.

            Catatan

            Jika Domain Name Type adalah Custom domain name, Anda juga harus mengatur URL homepage aplikasi (halaman web) di halaman detail aplikasi. Ini adalah alamat yang dituju pengguna setelah SSO dari halaman web WeCom.

      Setelah menyelesaikan konfigurasi ini, klik Next untuk melanjutkan ke langkah Assign Permissions.

Kelola penyedia identitas WeCom

Setelah integrasi selesai, Anda akan diarahkan ke halaman IdPs, tempat Anda dapat mengelola fungsi penyedia identitas tersebut.

Catatan penting