Ganti domain yang dihasilkan sistem pada instans IDaaS EIAM Anda dengan domain milik Anda sendiri untuk halaman-halaman seperti halaman login dan portal pengguna. Hal ini menjaga konsistensi merek dan memungkinkan Anda mengontrol akses melalui proxy—misalnya, membatasi login hanya dari alamat IP tertentu.
Ikhtisar
Fitur domain kustom memungkinkan Anda mengganti URL halaman IDaaS EIAM—seperti halaman login dan portal pengguna—dengan domain yang Anda miliki, sehingga menjaga konsistensi merek.
Dengan menyiapkan layanan proxy, Anda juga dapat mengontrol siapa yang dapat mengakses IDaaS EIAM. Misalnya, Anda dapat membatasi akses ke portal aplikasi hanya untuk pengguna dari alamat IP tertentu.
Konsep utama
|
Term |
Description |
|
Initial domain |
Domain yang dihasilkan sistem saat Anda membuat instans IDaaS EIAM, dalam format |
|
Custom domain |
Domain yang Anda miliki dan tambahkan ke instans IDaaS EIAM Anda, misalnya |
|
Default domain |
Domain yang digunakan secara default oleh instans IDaaS EIAM. Anda harus memilih antara initial domain atau custom domain. Jika pengalihan otomatis diaktifkan, akses ke initial domain akan mengarahkan pengguna ke default domain. |
Dampak potensial
Menyiapkan domain kustom memengaruhi fitur-fitur berikut. Tinjau dampak ini dan sesuaikan konfigurasi sebelum atau setelah mengaktifkan domain kustom.
|
Affected object |
Feature |
Description |
|
User portal |
Logon page |
URL halaman login mencakup domain. |
|
Application portal |
URL portal aplikasi mencakup domain. |
|
|
DingTalk identity provider - outbound |
QR code logon/Workbench SSO |
Domain callback DingTalk harus selalu menggunakan initial domain. |
|
SSO to the IDaaS application portal or an application |
URL halaman utama aplikasi mencakup domain. |
|
|
WeCom identity provider - inbound |
QR code logon |
Domain yang diakses pengguna (seperti user portal atau akses langsung ke aplikasi kustom, OIDC, atau SAML) harus sesuai dengan domain callback otorisasi WeCom. Jika tidak, pengguna tidak dapat login menggunakan kode QR WeCom. |
|
Webpage authorization logon (Workbench SSO) and sensitive data synchronization |
Domain yang diakses pengguna (seperti user portal atau akses langsung ke aplikasi kustom, OIDC, atau SAML) harus sesuai dengan domain tepercaya WeCom. Jika tidak, pengguna tidak dapat menggunakan login otorisasi halaman web WeCom atau sinkronisasi data sensitif. |
|
|
OIDC application/Custom application |
Authorization endpoint |
Jika instans hanya menggunakan satu custom domain, kami menyarankan agar tetap menjadikan initial domain sebagai default, mengatur custom domain sebagai default domain, dan mengaktifkan pengalihan otomatis. Jika tidak, pengguna mungkin perlu login ulang selama SSO. Jika instans memerlukan beberapa custom domain, authorization endpoint harus sesuai dengan domain halaman login pengguna. Jika tidak, pengguna mungkin perlu login ulang selama SSO. |
|
Logout endpoint |
||
|
SAML application |
IdP metadata URL |
Jika instans hanya menggunakan satu custom domain, kami menyarankan agar tetap menjadikan initial domain sebagai default, mengatur custom domain sebagai default domain, dan mengaktifkan pengalihan otomatis. Jika tidak, pengguna mungkin perlu login ulang selama SSO. Jika instans memerlukan beberapa custom domain, IdP metadata URL harus sesuai dengan domain halaman login pengguna. Jika tidak, pengguna mungkin perlu login ulang selama SSO. |
|
SSO URL |
||
|
WebAuthn |
Register authenticator |
Autentikator WebAuthn hanya berfungsi pada domain tempat ia didaftarkan. Misalnya, jika pengguna mendaftarkan autentikator A1 pada domain A, mereka tidak dapat menggunakan A1 saat login dari domain B — mereka harus mendaftarkan autentikator baru pada domain B. Pengguna dapat memiliki beberapa autentikator untuk domain yang berbeda. |
Prasyarat
|
Item |
Description |
|
Domain |
Domain khusus untuk IDaaS EIAM. Kami menyarankan menggunakan domain tingkat pertama atau domain tingkat kedua. |
|
Permissions to manage DNS records |
Anda perlu menambahkan satu atau dua rekaman DNS di konsol penyedia DNS Anda (misalnya, Alibaba Cloud DNS) untuk memverifikasi kepemilikan domain, lalu mengarahkan domain Anda ke server proxy Nginx Anda. |
|
ICP filing number |
Jika website Anda di-host di Tiongkok daratan, Anda harus menyediakan nomor pendaftaran ICP untuk domain tersebut. |
|
Activate Edge Security Acceleration (ESA) |
Anda harus mengaktifkan layanan ESA. |
|
Permissions to manage the proxy service |
Anda perlu mengonfigurasi sertifikat HTTPS domain, HOST back-to-origin, dan pengaturan lainnya di layanan proxy Anda (misalnya, Alibaba Cloud DCDN atau Alibaba Cloud ESA). |
|
A trial or upgraded instance |
Hanya instans uji coba dan Edisi Perusahaan yang mendukung domain kustom. Coba instans atau tingkatkan instans yang ada. |
Fitur domain kustom itu sendiri tidak dikenai biaya tambahan. Namun, layanan proxy (Alibaba Cloud ESA atau DCDN) ditagih berdasarkan penggunaan. Untuk detail harga, lihat dokumentasi penagihan yang sesuai.
Tambahkan domain kustom
Di panel navigasi sebelah kiri, klik Branding > Custom Domains, lalu klik Add Custom Domain Name.

Domain kustom dapat memengaruhi login, SSO, dan sinkronisasi data. Untuk menghindari gangguan bisnis, tinjau dampak potensial sebelum melanjutkan.
Langkah 1: Masukkan domain
Masukkan domain kustom Anda, misalnya login.example.com. Domain ini harus unik secara global di seluruh instans IDaaS EIAM. Masukkan hanya domain—tanpa path atau parameter. Domain dapat berisi huruf kecil, angka, tanda hubung (-), dan titik (.), dengan panjang maksimum 128 karakter.

Meskipun tim IDaaS EIAM mengamankan instans Anda, serangan Cross-Site Scripting (XSS) yang berhasil terhadap instans IDaaS EIAM Anda secara teoretis dapat memungkinkan serangan Cross-Site Request Forgery (CSRF) terhadap subdomain lain di bawah domain induk yang sama. Kami menyarankan untuk memblokir permintaan Cross-Origin Resource Sharing (CORS) dari domain kustom atau menggunakan domain induk terpisah sebagai domain kustom Anda.
Langkah 2: Tambahkan rekaman DNS
Buka penyedia DNS Anda, seperti Alibaba Cloud DNS, untuk menambahkan rekaman DNS. Ini memverifikasi kepemilikan domain Anda. Untuk instans IDaaS EIAM dan domain kustom tertentu, tipe catatan, nama, dan nilainya bersifat statis. Jika Anda tidak memiliki izin manajemen DNS, Anda dapat meminta orang lain untuk menambahkan rekaman tersebut.

Dokumen berikut memberikan petunjuk untuk menambahkan rekaman DNS dengan penyedia tertentu:
Langkah 3: Masukkan nomor pendaftaran ICP
Sesuai dengan Administrative Measures on Internet Information Services, jika website Anda di-host di Tiongkok daratan, Anda harus menyediakan nomor pendaftaran ICP entitas atau website. Untuk mematuhi peraturan lokal, penyediaan nomor pendaftaran ICP bersifat wajib bagi semua instans IDaaS EIAM di wilayah Alibaba Cloud dalam Tiongkok daratan yang menggunakan fitur domain kustom. Nomor pendaftaran tersebut ditampilkan di halaman login instans.
Langkah 4: Selesaikan proses
Setelah memastikan informasi sudah benar, klik Added untuk menambahkan domain kustom. Anda juga harus menyelesaikan konfigurasi proxy sebelum domain kustom dapat digunakan.
Konfigurasikan layanan proxy
Saat pengguna atau aplikasi mengakses IDaaS EIAM melalui domain kustom, layanan proxy Anda meneruskan permintaan tersebut. Anda bertanggung jawab untuk memastikan ketersediaan tinggi proxy tersebut. Pilih salah satu opsi proxy berikut berdasarkan kebutuhan Anda:
Perbandingan ketiga opsi proxy:
-
Alibaba Cloud ESA: Percepatan keamanan tepi. Paling cocok untuk skenario yang memerlukan akselerasi CDN dan perlindungan WAF.
-
Alibaba Cloud DCDN: Akselerasi CDN dinamis. Mudah dikonfigurasi. Paling cocok untuk skenario penyiapan cepat.
-
Nginx: Proxy yang dikelola sendiri. Fleksibel dan sepenuhnya di bawah kendali Anda. Paling cocok untuk skenario yang sudah menggunakan infrastruktur Nginx.
Untuk penyiapan cepat dan sederhana, kami merekomendasikan Alibaba Cloud DCDN. Untuk akselerasi CDN dan perlindungan WAF, gunakan Alibaba Cloud ESA. Untuk infrastruktur Nginx yang sudah ada yang memerlukan kontrol penuh, gunakan Nginx.
Alibaba Cloud ESA (Edge Security Acceleration)
Langkah 1: Tambahkan situs ESA
Buka konsol Alibaba Cloud ESA. Di panel navigasi sebelah kiri, klik . Ikuti wizard konsol untuk menyelesaikan konfigurasi , lalu klik Buy Now.
Langkah 2: Tambahkan rekaman DNS (akselerasi proxy)
-
Di bilah navigasi, klik dan klik situs target.
-
Pilih dan klik Add Record.
Untuk informasi selengkapnya, lihat Menambahkan rekaman DNS secara manual.
Langkah 3: Konfigurasikan sertifikat HTTPS
-
Di bilah navigasi, klik dan klik situs target.
-
Pilih dan klik Upload Custom Certificate.
Untuk informasi lebih lanjut, lihat Configure edge certificates.
Langkah 4: Konfigurasikan host back-to-origin
-
Di bilah navigasi, klik dan klik situs target.
-
Pilih dan klik Create Rule.
Untuk informasi lebih lanjut, lihat Customize the origin Host.
Langkah 5: Konfigurasikan header permintaan back-to-origin
-
Di bilah navigasi, klik dan klik situs target.
-
Pilih . Di tab Modify request header, pilih Apply to, klik Modify Request Header, pilih Type dan Operation sumber daya yang berlaku, lalu masukkan Request Header Name dan Enter a request header value.
-
Rekaman pertama: Type: Static; Action: Add; Header Name: X-IDaaS-Host; Header Value: $remote_addr.
-
Rekaman kedua: Type: Static; Action: Add; Header Name: X-IDaaS-Proxy-Token; Header Value: Nama domain kustom.
-
Rekaman ketiga: Type: Dynamic; Action: Add; Header Name: X-IDaaS_Client-IP; Header Value: proxy_token dari konfigurasi proxy.
Untuk menemukan nilai yang diperlukan, buka konsol IDaaS EIAM, klik di panel navigasi sebelah kiri, temukan domain kustom, lalu klik Actions untuk membuka tab Proxy Configuration.

-
Untuk informasi lebih lanjut, lihat Modify outgoing request headers.
Alibaba Cloud DCDN
Langkah 1: Tambahkan domain
Tambahkan domain di halaman Domain Names di konsol Alibaba Cloud DCDN.

-
Accelerated Domain Name: Domain kustom Anda.
-
Origin Info:
-
Atur Origin Type ke Origin Domain.
-
Masukkan initial domain instans IDaaS EIAM Anda (tanpa awalan
https://). -
Pilih port 443.
-
Setelah menambahkan domain, salin rekaman CNAME dari DCDN dan tambahkan ke pengaturan penyedia DNS Anda. Untuk informasi lebih lanjut, lihat Configure a CNAME record.
Langkah 2: Konfigurasikan sertifikat HTTPS
Di konsol Alibaba Cloud DCDN, buka halaman Domain Names, buka domain details page, lalu konfigurasikan sertifikat HTTPS di pengaturan HTTPS. Untuk informasi lebih lanjut, lihat Configure an HTTPS certificate.

Langkah 3: Aktifkan HOST back-to-origin
Masih di halaman detail domain, buka pengaturan Back-to-origin Configuration dan aktifkan Origin Host.

Atur Domain Type ke Origin Domain. Ini secara otomatis memilih initial domain instans IDaaS EIAM.

Langkah 4: Tambahkan header HTTP back-to-origin
Masih di halaman detail domain, buka pengaturan Back-to-origin Configuration dan klik Custom Back-to-Origin HTTPS Header untuk menambahkan informasi IP, Host, dan Token. Header ini membantu mencegah pemalsuan alamat IP dan meningkatkan keamanan akses.

Konfigurasi Nginx
Langkah 1: Instal Nginx
Instal dari sumber
# Unduh paket instalasi
wget http://nginx.org/download/nginx-1.18.0.tar.gz
# Ekstrak arsip
tar -zxvf nginx-1.18.0.tar.gz
cd nginx-1.18.0
# Konfigurasi dan tentukan direktori instalasi Nginx
./configure --prefix=/usr/local/nginx
# Kompilasi dan instal
make && make install
# Verifikasi instalasi
cd /usr/local/nginx/sbin
./nginx -t
Instalasi yang berhasil mengembalikan output berikut:
nginx: the configuration file /usr/local/nginx//conf/nginx.conf syntax is ok
nginx: configuration file /usr/local/nginx//conf/nginx.conf test is successful
CentOS/AlmaLinux/RHEL
# Instal repositori EPEL (diperlukan untuk beberapa sistem)
sudo yum install epel-release -y
# Instal Nginx
sudo yum install nginx -y
# Jalankan layanan Nginx
sudo systemctl start nginx
# Aktifkan auto-start saat boot
sudo systemctl enable nginx
# Periksa status layanan
sudo systemctl status nginx
Ubuntu/Debian
# Perbarui daftar paket
sudo apt update
# Instal Nginx
sudo apt install nginx -y
# Jalankan layanan Nginx
sudo systemctl start nginx
# Aktifkan auto-start saat boot
sudo systemctl enable nginx
# Periksa status layanan
sudo systemctl status nginx
Langkah 2: Modifikasi konfigurasi Nginx
-
Cari path file konfigurasi Nginx.
nginx -t -
Konfigurasikan proxy domain.
-
Edit blok server dalam blok http file
nginx.conf. -
Konfigurasikan reverse proxy untuk meneruskan permintaan dari domain kustom Anda, seperti
www.example.com, ke domain IDaaS*****.aliyunidaas.com.server { # Dengarkan port HTTPS dan aktifkan SSL listen 443 ssl; # Konfigurasikan domain yang akan diteruskan (domain kustom Anda) server_name www.example.com; location / { # Target reverse proxy (domain instans IDaaS) proxy_pass https://*****.aliyunidaas.com; } }
-
-
Arahkan HTTP ke HTTPS.
Arahkan trafik HTTP untuk domain kustom Anda ke HTTPS untuk meningkatkan keamanan dan SEO.
# Blok server HTTP (mendengarkan port 80) server { listen 80; server_name www.example.com; # Arahkan permintaan HTTP ke HTTPS location / { return 301 https://$host$request_uri; } } -
Konfigurasikan sertifikat SSL.
-
Siapkan file sertifikat Anda dan unggah ke server Nginx.
-
Edit file konfigurasi Nginx.
server { # Blok server HTTPS (mendengarkan port 443) listen 443 ssl; server_name www.example.com; # Path sertifikat SSL (ganti dengan path aktual Anda) ssl_certificate /usr/local/nginx/ssl/www.example.com.crt; ssl_certificate_key /usr/local/nginx/ssl/www.example.com.key; # Konfigurasi SSL (opsional untuk optimasi) ssl_protocols TLSv1.2 TLSv1.3; ssl_ciphers HIGH:!aNULL:!MD5; }
-
-
Konfigurasikan header permintaan back-to-origin IDaaS.

-
Edit blok server dalam blok http file
nginx.conf. -
Atur header permintaan back-to-origin menggunakan
proxy_set_header.# Konfigurasikan header permintaan back-to-origin IDaaS location / { proxy_pass https://***.aliyunidaas.com; # Teruskan alamat IP asli klien proxy_set_header X-IDaas-Client-IP $remote_addr; # Teruskan header host (konfirmasi nilai host yang diharapkan oleh layanan target) proxy_set_header X-IDaas-Host eiam-idaas.idpsso.net; # Token autentikasi proxy (dapatkan token proxy dari konsol IDaaS) proxy_set_header X-IDaas-Proxy-Token PTC<your-proxy-token>; # Pertahankan header Host asli (opsional) proxy_set_header Host $host; }
-
Langkah 3: Restart Nginx
Instalasi dari sumber
sudo /usr/local/nginx/sbin/nginx -s reload
CentOS/AlmaLinux/RHEL
sudo service nginx restart
Ubuntu/Debian
sudo systemctl restart nginx
Verifikasi konfigurasi proxy
Di konsol IDaaS EIAM, klik di panel navigasi sebelah kiri. Temukan domain kustom, klik Actions, lalu klik Proxy Configuration. Beralih ke tab untuk proxy yang telah Anda konfigurasi dan klik Test Connection untuk mensimulasikan akses ke domain kustom dari instans IDaaS EIAM. Karena domain itu sendiri mungkin memiliki kebijakan akses (misalnya, hanya mengizinkan IP jaringan kantor), hasil pengujian hanya untuk referensi. Kami menyarankan melakukan pengujian dari lingkungan pengguna yang disimulasikan untuk hasil yang paling andal.

Setelah pengujian berhasil, tinjau dan sesuaikan konfigurasi terkait berdasarkan dampak potensial, lalu berikan domain kustom kepada pengguna Anda. Jika pengguna terus menggunakan initial domain, aktifkan pengalihan otomatis.
Status domain
Karena domain dapat memiliki kebijakan akses sendiri (seperti hanya mengizinkan akses dari IP jaringan kantor), IDaaS EIAM tidak dapat memastikan apakah domain kustom beroperasi dengan benar. Status ketersediaan hanya menunjukkan bahwa fitur domain kustom diaktifkan untuk instans tersebut; tidak menjamin bahwa domain tersebut dapat diakses. Anda harus memverifikasi bahwa domain kustom beroperasi dengan benar.

Ubah default domain
Default domain memiliki dua tujuan:
-
Saat fitur Automatic Redirect diaktifkan, pengguna atau aplikasi yang mengakses initial domain akan diarahkan secara otomatis ke default domain.
-
Ini ditampilkan di beberapa tempat di Konsol, seperti URL portal pengguna dan URL logon.

Jika Anda memilih custom domain sebagai default domain dan mengaktifkan pengalihan otomatis, Anda harus mengubah default domain secara manual jika custom domain menjadi tidak tersedia (misalnya, jika instans kedaluwarsa). Jika tidak, pengguna atau aplikasi Anda mungkin tidak dapat mengakses instans tersebut.
Aktifkan pengalihan otomatis
Pengalihan otomatis meneruskan pengguna dan aplikasi dari initial domain instans ke default domain. Mengakses domain kustom tidak memicu pengalihan. Jika Anda hanya menggunakan satu domain kustom, atur sebagai default domain dan aktifkan pengalihan otomatis. Hal ini memungkinkan pengguna melakukan SSO secara mulus, baik mereka mengakses initial domain maupun domain kustom—tidak diperlukan perubahan konfigurasi SSO.
Jika Anda tidak mengaktifkan pengalihan otomatis atau memerlukan beberapa domain kustom, Anda harus menyesuaikan konfigurasi SSO aplikasi dan lainnya (lihat Dampak potensial). Jika tidak, pengguna mungkin perlu login ulang selama SSO atau tidak dapat login menggunakan kode QR WeCom.
Hapus domain kustom
Sebelum menghapus domain kustom, periksa apakah domain tersebut masih digunakan (misalnya, dalam konfigurasi SSO penyedia identitas atau aplikasi). Waktu penggunaan terakhir yang ditampilkan di dialog konfirmasi hanya untuk referensi—ini juga mencerminkan penggunaan terakhir proxy_token, yang dapat Anda verifikasi langsung di konfigurasi proxy Anda.
Di konsol IDaaS EIAM, klik di panel navigasi sebelah kiri. Temukan domain kustom, klik Actions, lalu klik Delete.

Setelah dihapus, domain kustom tidak dapat lagi mengakses instans IDaaS EIAM. Hapus konfigurasi terkait dari penyedia DNS dan layanan proxy Anda untuk mencegah pengalihan domain yang salah.