All Products
Search
Document Center

Alibaba Cloud CLI:Konfigurasikan kredensial OAuth untuk Alibaba Cloud CLI

Last Updated:Jun 03, 2026

Masuk sekali melalui browser agar Alibaba Cloud CLI dapat memperoleh kredensial sementara untuk memanggil API layanan cloud. CLI secara otomatis merefresh dan memutar token—tidak perlu menyimpan atau mengelola pasangan AccessKey jangka panjang secara lokal. Ini merupakan metode autentikasi yang direkomendasikan untuk lingkungan pengembangan lokal. Topik ini mencakup prasyarat, alur konfigurasi, verifikasi kredensial, serta cara kerja manajemen siklus hidup token.

Prasyarat

Persyaratan lingkungan

  • Alibaba Cloud CLI versi 3.3.0 atau lebih baru. Jalankan aliyun version untuk memeriksa versi yang terinstal. Jika versi Anda lebih lama dari 3.3.0, lihat Instal atau perbarui CLI untuk melakukan upgrade sebelum melanjutkan.

  • Akun yang dapat masuk ke console: Akun Alibaba Cloud (akun root), RAM user, atau pengguna perusahaan melalui SSO. Jika Anda menggunakan RAM user, pastikan logon console diaktifkan. Untuk informasi selengkapnya, lihat Aktifkan logon console.

  • Lingkungan lokal dengan browser grafis. Lingkungan terminal saja (seperti sesi SSH remote tanpa X11 forwarding) tidak mendukung konfigurasi kredensial OAuth.

Persiapan administrator (sekali saja)

Sebelum pengguna mana pun di organisasi Anda dapat menggunakan kredensial OAuth, administrator RAM harus menyelesaikan persiapan berikut. Setelah persiapan awal ini, penambahan pengguna baru hanya memerlukan Langkah 2.

  1. Instal aplikasi CLI (sekali saja): Masuk ke RAM console. Di panel navigasi kiri, pilih Integrations > OAuth (Preview). Beralih ke tab Third-party Application. Jika aplikasi official-cli tidak terdaftar, klik Provision Official Application dan pilih Official CLI.

  2. Tetapkan identitas: Buka halaman detail aplikasi official-cli dan beralih ke tab Assignments. Klik Create Assignment untuk menambahkan RAM user atau role yang perlu menggunakan Alibaba Cloud CLI.

    RAM application assignment page

Untuk petunjuk lengkap, lihat Instal aplikasi CLI dan Tetapkan identitas.

Konfigurasikan kredensial

Penting

Kredensial OAuth harus dikonfigurasi melalui perintah interaktif aliyun configure --mode OAuth, yang akan menjalankan alur masuk berbasis browser. Perintah aliyun configure set hanya menulis parameter dan tidak memicu proses masuk.

  1. Jalankan perintah berikut. Ganti <ProfileName> dengan nama pilihan Anda (misalnya, OAuthProfile):

    aliyun configure --mode OAuth --profile <ProfileName>
  2. Pilih situs masuk saat diminta memasukkan OAuth Site Type:

    aliyun configure --profile OAuthProfile --mode OAuth
    Configuring profile 'OAuthProfile' in 'OAuth' authenticate mode...
    OAuth Site Type (CN: 0 or INTL: 1, default: CN): 
    • Masukkan 0 atau CN untuk situs China (aliyun.com).

    • Masukkan 1 atau INTL untuk situs Internasional (alibabacloud.com).

    • Tekan Enter untuk menerima nilai default (CN).

  3. Selesaikan proses masuk melalui browser. Jendela browser akan terbuka secara otomatis. Masuk dengan kredensial RAM user Anda. Jika browser tidak terbuka, salin SignIn URL dari terminal dan tempelkan secara manual ke browser:

    Please open the following URL in your browser to authorize:
    https://signin.aliyun.com/oauth2/v1/auth?...
  4. Otorisasi aplikasi. Pada halaman otorisasi di browser, klik Authorize. Setelah otorisasi berhasil, browser akan menampilkan Authorization successful. You can close this window.

  5. Tetapkan region dan bahasa default:

    Default Region Id []: cn-shanghai
    Default Language [zh|en] en: en

    Untuk daftar region yang tersedia, lihat Region dan titik akhir. Beberapa layanan tidak mendukung akses lintas-region. Tetapkan region default ke region tempat sumber daya Anda berada.

  6. Saat terminal menampilkan Configure Done beserta pesan selamat datang, konfigurasi telah selesai.

Catatan

Setelah konfigurasi berhasil, profil baru tersebut secara otomatis menjadi profil aktif. Untuk beralih ke profil lain, jalankan aliyun configure switch --profile <ProfileName>.

Siklus hidup token

Kredensial OAuth terdiri dari tiga lapisan token. CLI mengelola pembaruan secara otomatis—tidak diperlukan intervensi manual selama penggunaan normal:

  • Token Security Token Service (STS)—kredensial sementara untuk panggilan API

  • Token akses OAuth—token berumur pendek untuk memperoleh token STS

  • Token penyegaran OAuth—token berumur panjang untuk memperbarui token akses

Catatan

Setiap kali token berhasil diperbarui, token lama akan dibatalkan. File konfigurasi (~/.aliyun/config.json) diperbarui secara otomatis.

Hapus kredensial

Jalankan perintah berikut untuk menghapus profil OAuth tertentu:

aliyun configure delete --profile <ProfileName>

Perintah ini menghapus:

  • Entri profil dari ~/.aliyun/config.json, beserta semua token OAuth dan token STS yang disimpan secara lokal untuk profil tersebut.

  • Hal ini tidak memengaruhi otorisasi aplikasi OAuth di RAM console. Tidak diperlukan tindakan administrator.

FAQ

Browser tidak terbuka selama otorisasi

CLI mencetak URL masuk di terminal. Salin dan buka secara manual. Jika halaman gagal dimuat, periksa:

  • Apakah port lokal 12345–12349 tersedia (CLI mendengarkan salah satu port ini untuk callback otorisasi).

  • Konektivitas jaringan ke signin.aliyun.com (situs China) atau signin.alibabacloud.com (situs Internasional).

Error: The API call is not authorized / You are not allowed to do this action.

Administrator belum menginstal aplikasi CLI atau belum menetapkan identitas Anda. Minta administrator RAM Anda untuk menyelesaikan Persiapan administrator yang dijelaskan di bagian Prasyarat.

Dapatkah saya beralih dari AccessKey ke OAuth tanpa menghapus profil yang sudah ada?

Ya. Buat profil OAuth baru—profil yang sudah ada tetap dipertahankan. Anda dapat beralih di antara profil tersebut kapan saja menggunakan aliyun configure switch --profile <profile-name>.

Apakah OAuth mendukung masuk sebagai RAM role?

Ya. Gunakan salah satu pendekatan berikut:

  • Masuk melalui role-based SSO dari penyedia identitas (IdP) Anda. Hal ini memerlukan konfigurasi role SSO terlebih dahulu.

  • Masuk terlebih dahulu sebagai RAM user, lalu ganti identitas ke RAM role target di console.

Lakukan langkah-langkah ini sebelum menjalankan aliyun configure --mode OAuth, sehingga CLI mendeteksi identitas Anda saat ini sebagai RAM role selama langkah otorisasi browser.