All Products
Search
Document Center

Identity as a Service:Domain kustom

Last Updated:Aug 27, 2026

Ganti domain yang dihasilkan sistem pada instans IDaaS EIAM Anda dengan domain milik Anda sendiri untuk 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 xxxx.aliyunidaas.com.

Custom domain

Domain yang Anda miliki dan tambahkan ke instans IDaaS EIAM Anda, misalnya, xxxx.example.com.

Default domain

Domain yang digunakan instans IDaaS EIAM secara default. 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 portal pengguna 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 portal pengguna 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 domain kustom, kami merekomendasikan untuk tetap menjadikan initial domain sebagai default, mengatur domain kustom sebagai default domain, dan mengaktifkan pengalihan otomatis. Jika tidak, pengguna mungkin perlu login ulang selama SSO.

Jika instans memerlukan beberapa domain kustom, 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 domain kustom, kami merekomendasikan untuk tetap menjadikan initial domain sebagai default, mengatur domain kustom sebagai default domain, dan mengaktifkan pengalihan otomatis. Jika tidak, pengguna mungkin perlu login ulang selama SSO.

Jika instans memerlukan beberapa domain kustom, 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 merekomendasikan penggunaan domain tingkat pertama atau 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 trial dan Edisi Perusahaan yang mendukung domain kustom. Coba instans atau tingkatkan instans yang ada.

Catatan

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 kiri, klik Branding > Custom Domains, lalu klik Add Custom Domain Name.

Penting

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.

Protokol domain kustom harus menggunakan HTTPS. Setelah berhasil ditambahkan, pengguna dapat mengakses portal aplikasi IDaaS melalui domain ini.

Penting

Meskipun tim IDaaS EIAM mengamankan instans Anda, serangan Cross-Site Scripting (XSS) yang berhasil pada instans IDaaS EIAM Anda secara teoretis dapat memungkinkan serangan Cross-Site Request Forgery (CSRF) pada subdomain lain di bawah domain induk yang sama. Kami merekomendasikan 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 catatan 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 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.

Konfigurasi 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:

Catatan

Perbandingan ketiga opsi proxy:

  • Alibaba Cloud ESA: Percepatan keamanan tepi. Terbaik untuk skenario yang memerlukan akselerasi CDN dan perlindungan WAF.

  • Alibaba Cloud DCDN: Akselerasi CDN dinamis. Mudah dikonfigurasi. Terbaik untuk skenario penyiapan cepat.

  • Nginx: Proxy yang dikelola sendiri. Fleksibel dan sepenuhnya di bawah kendali Anda. Terbaik 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 kiri, klik Websites > Add Website. Ikuti panduan konsol untuk menyelesaikan konfigurasi Enter Website > Select Location and DNS Setup > Select Plan, lalu klik Buy Now.

Langkah 2: Tambahkan rekaman DNS (akselerasi proxy)

  1. Di bilah navigasi, klik Websites dan klik situs target.

  2. Pilih DNS > Records dan klik Add Record.

Untuk informasi lebih lanjut, lihat Manually add DNS records.

Langkah 3: Konfigurasi sertifikat HTTPS

  1. Di bilah navigasi, klik Websites dan klik situs target.

  2. Pilih Edge Certificates dan klik Upload Custom Certificate.

Untuk informasi lebih lanjut, lihat Configure edge certificates.

Langkah 4: Konfigurasi host back-to-origin

  1. Di bilah navigasi, klik Websites dan klik situs target.

  2. Pilih Rules > Origin Rules dan klik Create Rule.

Untuk informasi lebih lanjut, lihat Customize the origin Host.

Langkah 5: Konfigurasi header permintaan back-to-origin

  1. Di bilah navigasi, klik Websites dan klik situs target.

  2. Pilih Rules > Transform Rules. Di tab Modify request header, pilih Apply to, klik Modify Request Header, pilih Type dan Operation yang berlaku, lalu masukkan Request Header Name dan Enter a request header value.

    1. Rekaman pertama: Type: Static; Action: Add; Header Name: X-IDaaS-Host; Header Value: $remote_addr.

    2. Rekaman kedua: Type: Static; Action: Add; Header Name: X-IDaaS-Proxy-Token; Header Value: Nama domain kustom.

    3. 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 Branding > Custom Domain Name di panel navigasi kiri, temukan domain kustom, lalu klik Actions untuk membuka tab Proxy Configuration.

    Dialog Proxy Configuration menampilkan empat bagian: domain akselerasi dan informasi origin (type: origin domain, port 443, weight 10), konfigurasi HTTPS, back-to-origin HOST (domain type: origin domain), dan header HTTP back-to-origin (tiga header permintaan dan nilainya seperti tercantum di atas). Bagian bawah menampilkan proxy_token (dimulai dengan PTHT) dan statusnya. Klik Test Connection untuk memverifikasi konfigurasi proxy.

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.

Atur Business Type menjadi Dynamic Route for CDN (DCDN) dan Acceleration Region menjadi Chinese Mainland Only.

  • Accelerated Domain Name: Domain kustom Anda.

  • Origin Info:

    • Atur Origin Type menjadi 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: Konfigurasi sertifikat HTTPS

Di konsol Alibaba Cloud DCDN, buka halaman Domain Names, buka domain details page, lalu konfigurasi sertifikat HTTPS di pengaturan HTTPS. Untuk informasi lebih lanjut, lihat Configure an HTTPS certificate.

Di panel navigasi kiri, pilih HTTPS, temukan bagian HTTPS Certificate, lalu klik Modify.

Langkah 3: Aktifkan back-to-origin HOST

Masih di halaman detail domain, buka pengaturan Back-to-origin Configuration dan aktifkan Origin Host.

Atur Domain Type menjadi 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.

Klik tab Custom Back-to-Origin HTTP Header, klik Add, lalu tambahkan parameter header HTTP back-to-origin berikut: X-IDaaS-Client-IP, X-IDaaS-Host, dan X-IDaaS-Proxy-Token.

Konfigurasi Nginx

Langkah 1: Instal Nginx

Instal dari source

# 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 
Catatan

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

  1. Temukan path file konfigurasi Nginx.

    nginx -t
  2. Konfigurasi proxy domain.

    1. Edit blok server dalam blok http file nginx.conf.

    2. 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;
      
          # Konfigurasi domain yang akan diteruskan (domain kustom Anda)
          server_name www.example.com;
      
          location / {
              # Target reverse proxy (domain instans IDaaS)
              proxy_pass https://*****.aliyunidaas.com;
      
          }
      }
      
  3. 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;
        }
    }
  4. Konfigurasi sertifikat SSL.

    1. Siapkan file sertifikat Anda dan unggah ke server Nginx.

    2. 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;
      
      }
      
  5. Konfigurasi header permintaan back-to-origin IDaaS.

    1. Edit blok server dalam blok http file nginx.conf.

    2. Atur header permintaan back-to-origin menggunakan proxy_set_header.

          # Konfigurasi header permintaan back-to-origin IDaaS
          location / {
              proxy_pass https://***.aliyunidaas.com;
      
              # Kirim alamat IP asli klien
              proxy_set_header X-IDaas-Client-IP $remote_addr;
      
              # Kirim 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 source

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 Branding > Custom Domain Name di panel navigasi 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 sebagai referensi. Kami merekomendasikan pengujian dari lingkungan pengguna simulasi untuk hasil yang paling andal.

Di dialog Proxy Configuration, bagian Add Back-to-Origin HTTP Headers memerlukan tiga header kustom:

  • X-IDaaS-Client-IP, nilai: $remote_addr

  • X-IDaaS-Host, nilai: domain kustom yang sesuai

  • X-IDaaS-Proxy-Token, nilai: diperoleh dari area proxy_token di bagian bawah dialog

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 domain default

Domain default memiliki dua tujuan:

  • Saat fitur Automatic Redirect diaktifkan, pengguna atau aplikasi yang mengakses initial domain secara otomatis dialihkan ke domain default.

  • Hal ini ditampilkan di beberapa tempat di konsol, seperti URL portal pengguna dan URL logon.

Di bagian Redirect Configuration, klik Modify Default Domain untuk mengubah domain default. Sebelum mengaktifkan Automatic Redirect, sesuaikan terlebih dahulu konfigurasi SSO.

Penting

Jika Anda memilih domain kustom sebagai domain default dan mengaktifkan pengalihan otomatis, Anda harus mengubah secara manual domain default jika domain kustom 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 domain default. Mengakses domain kustom tidak memicu pengalihan. Jika Anda hanya menggunakan satu domain kustom, atur sebagai domain default 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 dan lainnya pada aplikasi (lihat Dampak potensial). Jika tidak, pengguna mungkin perlu login ulang selama SSO atau tidak dapat login menggunakan kode QR WeCom.

Hapus domain kustom

Penting

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 sebagai referensi—ini juga mencerminkan penggunaan terakhir proxy_token, yang dapat Anda verifikasi langsung di konfigurasi proxy Anda.

Di konsol IDaaS EIAM, klik Branding > Custom Domain Name di panel navigasi kiri. Temukan domain kustom, klik Actions, lalu klik Delete.

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