Panduan cepat ini menggunakan Microsoft Entra ID (sebelumnya Azure AD) sebagai contoh penyedia identitas untuk menjelaskan cara mengonfigurasi SSO berbasis peran. Setelah konfigurasi selesai, pengguna dapat masuk menggunakan akun Microsoft Entra ID mereka dan mengasumsikan peran RAM Alibaba Cloud tertentu. Proses ini menyediakan token sementara dari Security Token Service (STS) untuk mengakses sumber daya cloud.
Sebelum mengonfigurasi SSO berbasis peran di lingkungan Anda, pastikan layanan Alibaba Cloud yang ingin Anda gunakan mendukung peran RAM. Untuk informasi selengkapnya, lihat Layanan Alibaba Cloud yang mendukung STS.
Alur konfigurasi
Dalam contoh ini, Microsoft Entra ID berperan sebagai penyedia identitas (IdP), sedangkan Alibaba Cloud RAM berperan sebagai penyedia layanan (SP). Konfigurasi inti menetapkan hubungan kepercayaan bi-directional antara IdP dan SP serta memetakan peran aplikasi di Microsoft Entra ID ke peran RAM di Alibaba Cloud.
Langkah 1: Membuat aplikasi perusahaan di Microsoft Entra ID. Buat aplikasi perusahaan dari galeri aplikasi Microsoft Entra ID menggunakan templat aplikasi Alibaba Cloud Service (Role-based SSO).
Langkah 2: Mengonfigurasi SAML di Microsoft Entra ID. Konfigurasikan SSO berbasis peran Alibaba Cloud sebagai Service Provider SAML tepercaya di Microsoft Entra ID.
Langkah 3: Membuat penyedia identitas di Alibaba Cloud. Konfigurasikan Microsoft Entra ID sebagai Identity Provider SAML tepercaya di Alibaba Cloud RAM.
Langkah 4: Membuat peran RAM di Alibaba Cloud. Buat peran RAM di Alibaba Cloud RAM dengan tipe Trusted Entity diatur ke Identity Provider.
Langkah 5: Membuat peran aplikasi dan menetapkan pengguna di Microsoft Entra ID. Buat dan konfigurasikan peran aplikasi untuk aplikasi SSO berbasis peran Alibaba Cloud di Microsoft Entra ID, lalu tetapkan pengguna uji coba ke aplikasi perusahaan tersebut.
Verifikasi log masuk SSO. Verifikasi bahwa log masuk SSO berbasis peran berhasil.
Persiapan
Diperlukan administrator RAM dengan izin AliyunRAMFullAccess untuk melakukan operasi di Konsol RAM. Untuk informasi selengkapnya tentang cara membuat pengguna RAM dan memberikan izin, lihat Membuat pengguna RAM dan Memberikan izin kepada pengguna RAM.
Diperlukan administrator Microsoft Entra ID dengan peran Global Administrator untuk melakukan operasi di Microsoft Entra ID. Untuk informasi selengkapnya tentang cara membuat pengguna dan memberikan izin di Microsoft Entra ID, lihat Dokumentasi Microsoft Entra ID.
Langkah 1: Membuat aplikasi perusahaan di Microsoft Entra ID
Masuk ke portal Azure sebagai administrator Microsoft Entra ID.
Di pojok kiri atas halaman utama, klik ikon
.Di panel navigasi sebelah kiri, pilih .
Klik New Application.
Cari dan klik Alibaba Cloud Service (Role-based SSO).
Masukkan nama aplikasi dan klik Create.
Contoh ini menggunakan nama aplikasi default
Alibaba Cloud Service (Role-based SSO). Anda juga dapat menggunakan nama aplikasi kustom.
Langkah 2: Mengonfigurasi SAML di Microsoft Entra ID
Di halaman Alibaba Cloud Service (Role-based SSO), di panel navigasi sebelah kiri, pilih .
Klik SAML.
Konfigurasikan informasi SSO.
Di pojok kiri atas halaman, klik Upload Metadata File, pilih file metadata SSO berbasis peran Alibaba Cloud, lalu klik Add.
CatatanAnda dapat memperoleh file metadata dari URL berikut. Buka URL tersebut di jendela browser baru dan simpan file XML metadata ke komputer Anda:
https://signin.alibabacloud.com/saml-role/sp-metadata.xml.Di halaman Basic SAML Configuration, konfigurasikan informasi berikut dan klik Save.
Identifier (Entity ID): Nilai
entityIDsecara otomatis diisi dari file metadata pada langkah sebelumnya.Reply URL (Assertion Consumer Service URL): Nilai
Locationsecara otomatis diisi dari file metadata pada langkah sebelumnya.
Di bagian Attributes & Claims, klik ikon
dan verifikasi bahwa dua klaim berikut ada.
Jika tidak ada, klik Add New Claim dan tambahkan dua klaim tersebut berdasarkan informasi dalam tabel berikut.
Name
Namespace
Source
Source Attribute
Rolehttps://www.aliyun.com/SAML-Role/AttributesAttribute
user.assignedroles
RoleSessionNamehttps://www.aliyun.com/SAML-Role/AttributesAttribute
user.userprincipalname
Di bagian SAML Certificates, klik Download untuk mendapatkan Federation Metadata XML.
Langkah 3: Membuat penyedia identitas di Alibaba Cloud
Masuk ke Konsol RAM sebagai administrator RAM.
Di panel navigasi sebelah kiri, pilih .
Di tab Role-based SSO, klik tab SAML, lalu klik Create Identity Provider.
Di halaman Create Identity Provider, atur Identity Provider Name menjadi
AAD.Klik Upload Metadata dan unggah file Federation Metadata XML yang telah Anda unduh di Langkah 2: Mengonfigurasi SAML di Microsoft Entra ID.
Klik Create Identity Provider.
Klik penyedia identitas yang telah dibuat
AAD. Di bagian Basic Information, cari dan salin ARN penyedia identitas untuk digunakan nanti.
Langkah 4: Membuat peran RAM di Alibaba Cloud
Di panel navigasi sebelah kiri Konsol RAM, pilih .
Di halaman Roles, klik Create Role.
Di pojok kanan atas halaman Create Role, klik Switch Editor.
Tentukan penyedia identitas SAML di editor.
Editor mendukung mode editor visual dan editor skrip. Anda dapat memilih salah satu mode. Contoh ini menggunakan editor visual. Di bagian Principal, pilih tipe entitas tepercaya Identity Provider dan klik Edit. Kemudian, tentukan AAD sebagai penyedia identitas dan atur Identity Provider Type ke SAML.
Di kotak dialog Create Role, masukkan Role Name (AADrole) dan klik OK untuk membuat peran tersebut.
Klik peran RAM yang telah dibuat. Di bagian Basic Information, cari dan salin ARN peran tersebut untuk digunakan nanti.
Anda dapat menambahkan izin ke peran RAM sesuai kebutuhan. Untuk informasi selengkapnya, lihat Memberikan izin kepada peran RAM.
Langkah 5: Membuat peran aplikasi dan menetapkan pengguna di Microsoft Entra ID
Buat peran di Microsoft Entra ID.
Masuk ke portal Azure sebagai administrator.
Di panel navigasi sebelah kiri, pilih .
Klik tab All Applications, lalu klik Alibaba Cloud Service (Role-based SSO).
Di panel navigasi sebelah kiri, pilih .
Klik Create App Role.
Di halaman Create App Role, konfigurasikan informasi peran berikut dan klik Apply.
Display Name: Masukkan
Adminuntuk contoh ini.Allowed Member Types: Pilih Users/Groups + Applications untuk contoh ini.
Value: Masukkan ARN peran RAM dan ARN penyedia identitas, dipisahkan dengan koma (,). Untuk contoh ini, masukkan
acs:ram::187125022722****:role/aadrole,acs:ram::187125022722****:saml-provider/AAD.CatatanUrutan input harus berupa
ARN peran RAM,ARN penyedia identitas. Urutan yang salah menyebabkan log masuk SSO berbasis peran gagal.Description: Masukkan deskripsi.
Pilih Do You Want To Enable This App Role?.
CatatanUntuk membuat beberapa peran di Microsoft Entra ID, ulangi langkah-langkah sebelumnya dan atur nama tampilan serta nilai peran aplikasi yang berbeda.
Tetapkan pengguna ke aplikasi perusahaan dan tentukan peran.
Di panel navigasi sebelah kiri, pilih .
Di daftar Name, klik Alibaba Cloud Service (Role-based SSO).
Di panel navigasi sebelah kiri, pilih .
Di pojok kiri atas, klik Add User/group.
Di halaman Add Assignment, pilih pengguna target dan klik Select.
Pastikan peran yang dipilih adalah Admin. Jika tidak, ubah menjadi Admin. Lalu, klik Assign.
Verifikasi log masuk SSO
SSO berbasis peran hanya mendukung log masuk SSO yang diinisiasi oleh IdP. Oleh karena itu, Anda harus masuk dari Microsoft Entra ID untuk memverifikasi hasilnya.
Dapatkan URL akses pengguna.
Masuk ke portal Azure sebagai administrator.
Di panel navigasi sebelah kiri, pilih .
Di daftar Name, klik Alibaba Cloud Service (Role-based SSO).
Di panel navigasi sebelah kiri, pilih dan dapatkan User Access URL.

Pengguna uji coba (ssotest01@example.onmicrosoft.com) memperoleh User Access URL dari administrator, memasukkan URL tersebut di browser, dan masuk dengan akun mereka. Setelah berhasil masuk, pengguna akan diarahkan ke Konsol Manajemen Alibaba Cloud. Peran RAM yang ditentukan (
aadrole) ditampilkan sebelum nama akun.
Referensi
Untuk informasi selengkapnya, lihat topik-topik berikut:
Untuk mempelajari tentang SSO Alibaba Cloud, lihat Ikhtisar SSO.
Untuk mempelajari cara kerja SSO berbasis pengguna Alibaba Cloud, lihat Ikhtisar SSO berbasis pengguna.
Untuk contoh cara mengonfigurasi SSO berbasis pengguna Alibaba Cloud, lihat Contoh SSO berbasis pengguna dengan Microsoft Entra ID.
Untuk mempelajari cara kerja SSO berbasis peran berbasis SAML Alibaba Cloud, lihat Ikhtisar SSO berbasis peran berbasis SAML.
Untuk contoh lanjutan cara mengonfigurasi SSO berbasis peran berbasis SAML Alibaba Cloud, lihat Contoh SSO berbasis peran dengan Microsoft Entra ID.
Untuk memecahkan masalah umum SSO, lihat FAQ SSO.