Resource Access Management (RAM) menggunakan protokol OAuth 2.0 dan OAuth 2.1 untuk memungkinkan aplikasi memperoleh akses terotorisasi ke resource Alibaba Cloud atas nama pengguna. Topik ini memberikan ikhtisar mengenai konsep inti, kasus penggunaan, dan cakupan OAuth dari layanan OAuth Alibaba Cloud.
Konsep inti
Concept | Description |
User (resource owner) | Entitas yang memberikan izin kepada aplikasi untuk mengakses resource mereka. Pemilik resource dapat berupa Akun Alibaba Cloud, Pengguna RAM, atau Peran RAM. Catatan Dukungan untuk Peran RAM sebagai pemilik resource tersedia untuk aplikasi OAuth yang dibuat setelah 10 September 2024. Untuk mengaktifkan fitur ini pada aplikasi lama, kirimkan ticket. |
Alibaba Cloud OAuth service | Layanan OAuth Alibaba Cloud bertindak sebagai server otorisasi. Layanan ini mengotentikasi pemilik resource, memperoleh persetujuan mereka, dan menerbitkan token akses ke aplikasi client. |
First-party application | Aplikasi yang dibuat dalam Akun Alibaba Cloud Anda. Pengguna dalam akun yang sama dapat mengakses aplikasi tersebut tanpa langkah otorisasi eksplisit, sedangkan pengguna dari akun Alibaba Cloud lain harus terlebih dahulu menginstal dan mengotorisasi aplikasi tersebut. Anda dapat membuat jenis aplikasi first-party berikut:
|
Third-party application | Aplikasi yang dikembangkan oleh akun Alibaba Cloud berbeda yang Anda instal dan otorisasi untuk mengakses resource Anda. |
Official application | Aplikasi yang diterbitkan oleh layanan Alibaba Cloud yang dapat diinstal oleh semua akun Alibaba Cloud. Karena jenis aplikasi ini bukan milik akun Anda, maka official application merupakan jenis third-party application. |
OAuth scope | Mekanisme untuk membatasi akses aplikasi ke akun pengguna. Aplikasi dapat meminta satu atau beberapa cakupan, dan token akses yang diberikan kepada aplikasi akan dibatasi sesuai cakupan yang diberikan. Cakupan berikut didukung:
|
Token | Kredensial keamanan yang dikeluarkan oleh layanan OAuth yang merepresentasikan otorisasi yang diberikan oleh pengguna.
|
Alibaba Cloud API | API yang dapat dipanggil oleh aplikasi untuk mengakses resource Alibaba Cloud. |
Kasus penggunaan
ID token claims
Saat pengguna memberikan persetujuan untuk cakupan openid, aliuid, dan profile, ID token yang dikembalikan dapat berisi claim berikut.
Claim | Description | Example | Required scope |
exp | Waktu kedaluwarsa token, direpresentasikan sebagai Stempel waktu UNIX. | 1517539523 | openid |
sub | Pengidentifikasi subjek untuk pengguna yang terotentikasi. Ini adalah pengidentifikasi unik dan tidak dapat didaur ulang yang tidak berisi informasi identitas pribadi (PII). Catatan Untuk Peran RAM yang diasumsikan, nilai sub merupakan gabungan dari ID peran dan nama sesi peran ( | 123456789012**** | openid |
aud | Audience token, yaitu client ID dari aplikasi OAuth Anda. | 4567890123456**** | openid |
iss | Penerbit token. Nilainya adalah | https://oauth.aliyun.com | openid |
iat | Waktu penerbitan token, direpresentasikan sebagai Stempel waktu UNIX. | 1517533200 | openid |
aid | ID akun Alibaba Cloud tempat pengguna yang terotentikasi bernaung. | 177242285274**** | aliuid |
uid | ID unik pengguna yang terotentikasi. Nilai yang valid:
| 20124982101502**** | aliuid |
type | Jenis pengguna yang terotentikasi. Nilai yang valid:
| user | profile |
login_name | Nama login Akun Alibaba Cloud. Catatan Claim ini hanya dikembalikan untuk Akun Alibaba Cloud. | Alice | profile |
upn | Nama login Pengguna RAM. Catatan Claim ini hanya dikembalikan untuk Pengguna RAM. | Bob@examplecompany.onaliyun.com | profile |
name | Nama pengguna yang terotentikasi. Nilai yang valid:
Catatan Claim ini hanya dikembalikan untuk Pengguna RAM dan Peran RAM. | Bob | profile |