Dokumentasi ini AWS CLI hanya untuk Versi 1. Untuk dokumentasi yang terkait dengan Versi 2 AWS CLI, lihat Panduan Pengguna Versi 2.

Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

Gunakan peran IAM dalam AWS CLI

Peran AWS Identity and Access Management (IAM) adalah alat otorisasi yang memungkinkan pengguna mendapatkan izin tambahan (atau berbeda), atau mendapatkan izin untuk melakukan tindakan di akun yang berbeda. AWS

Prasyarat

Untuk menjalankan iam perintah, Anda perlu menginstal dan mengkonfigurasiAWS CLI. Untuk informasi selengkapnya, lihat Instal, perbarui, dan hapus instalan AWS CLI.

Ikhtisar penggunaan peran IAM

Anda dapat mengonfigurasi AWS Command Line Interface (AWS CLI) untuk menggunakan peran IAM dengan menentukan profil untuk peran dalam file. ~/.aws/config

Contoh berikut menunjukkan profil peran bernamamarketingadmin. Jika Anda menjalankan perintah dengan --profile marketingadmin (atau menentukannya dengan variabel lingkungan AWS_PROFILE), akan AWS CLI menggunakan kredensyal yang ditentukan dalam profil terpisah user1 untuk mengambil peran dengan Amazon Resource Name (ARN). arn:aws:iam::123456789012:role/marketingadminrole Anda dapat menjalankan operasi apa pun yang diizinkan oleh izin yang ditetapkan untuk peran tersebut.

[profile marketingadmin]
role_arn = arn:aws:iam::123456789012:role/marketingadminrole
source_profile = user1

Anda kemudian dapat menentukan source_profile yang menunjuk ke profil bernama terpisah yang berisi kredensyal pengguna dengan izin untuk menggunakan peran tersebut. Pada contoh sebelumnya, marketingadmin profil menggunakan kredensyal di profil. user1 Ketika Anda menentukan bahwa AWS CLI perintah adalah untuk menggunakan profilmarketingadmin, AWS CLI secara otomatis mencari kredensyal untuk user1 profil tertaut dan menggunakannya untuk meminta kredensyal sementara untuk peran IAM yang ditentukan. CLI menggunakan AssumeRole operasi sts: di latar belakang untuk mencapai ini. Kredensyal sementara tersebut kemudian digunakan untuk menjalankan perintah yang dimintaAWS CLI. Peran yang ditentukan harus telah melampirkan kebijakan izin IAM yang memungkinkan AWS CLI perintah yang diminta untuk dijalankan.

Untuk menjalankan AWS CLI perintah dari dalam instans Amazon Elastic Compute Cloud (Amazon EC2) atau container Amazon Elastic Container Service (Amazon ECS), Anda dapat menggunakan peran IAM yang dilampirkan ke profil instance atau container. Jika Anda menentukan tidak ada profil atau tidak menyetel variabel lingkungan, peran tersebut akan digunakan secara langsung. Hal ini memungkinkan Anda untuk menghindari menyimpan kunci akses berumur panjang pada instans Anda. Anda juga dapat menggunakan peran instance atau kontainer tersebut hanya untuk mendapatkan kredensyal untuk peran lain. Untuk melakukan ini, Anda menggunakan credential_source (bukansource_profile) untuk menentukan cara menemukan kredensialnya. credential_sourceAtribut mendukung nilai-nilai berikut:

Contoh berikut menunjukkan marketingadminrole peran yang sama yang digunakan dengan mereferensikan profil instans Amazon EC2.

[profile marketingadmin]
role_arn = arn:aws:iam::123456789012:role/marketingadminrole
credential_source = Ec2InstanceMetadata

Ketika Anda memanggil peran, Anda memiliki opsi tambahan yang dapat Anda perlukan, seperti penggunaan otentikasi multi-faktor dan ID Eksternal (digunakan oleh perusahaan pihak ketiga untuk mengakses sumber daya klien mereka). Anda juga dapat menentukan nama sesi peran unik yang dapat lebih mudah diaudit di AWS CloudTrail log.

Mengkonfigurasi dan menggunakan peran

Saat Anda menjalankan perintah menggunakan profil yang menentukan peran IAM, akan AWS CLI menggunakan kredensyal profil sumber untuk memanggil AWS Security Token Service (AWS STS) dan meminta kredensyal sementara untuk peran yang ditentukan. Pengguna di profil sumber harus memiliki izin sts:assume-role untuk memanggil peran dalam profil yang ditentukan. Peran harus memiliki hubungan kepercayaan yang memungkinkan pengguna di profil sumber untuk menggunakan peran tersebut. Proses pengambilan dan kemudian menggunakan kredensyal sementara untuk suatu peran sering disebut sebagai asumsi peran.

Anda dapat membuat peran di IAM dengan izin yang ingin diasumsikan pengguna dengan mengikuti prosedur di bawah Membuat Peran untuk Mendelegasikan Izin ke pengguna IAM di Panduan Pengguna. AWS Identity and Access Management Jika peran dan pengguna profil sumber berada di akun yang sama, Anda dapat memasukkan ID akun Anda sendiri saat mengonfigurasi hubungan kepercayaan peran.

Setelah membuat peran, modifikasi hubungan kepercayaan untuk memungkinkan pengguna untuk mengasumsikan itu.

Contoh berikut menunjukkan kebijakan kepercayaan yang dapat Anda lampirkan ke peran. Kebijakan ini memungkinkan peran diasumsikan oleh setiap pengguna di akun 123456789012, jika administrator akun tersebut secara eksplisit memberikan izin kepada pengguna. sts:AssumeRole

{
  "Version": "2012-10-17",
  "Statement": [
    {
      "Effect": "Allow",
      "Principal": {
        "AWS": "arn:aws:iam::123456789012:root"
      },
      "Action": "sts:AssumeRole"
    }
  ]
}

Kebijakan kepercayaan sebenarnya tidak memberikan izin. Administrator akun harus mendelegasikan izin untuk mengambil peran tersebut kepada pengguna individu dengan melampirkan kebijakan dengan izin yang sesuai. Contoh berikut menunjukkan kebijakan yang dapat Anda lampirkan ke pengguna yang memungkinkan pengguna untuk mengambil marketingadminrole peran saja. Untuk informasi selengkapnya tentang pemberian akses pengguna untuk mengambil peran, lihat Memberikan Izin Pengguna untuk Beralih Peran di Panduan Pengguna IAM.

{
  "Version": "2012-10-17",
  "Statement": [
    {
      "Effect": "Allow",
      "Action": "sts:AssumeRole",
      "Resource": "arn:aws:iam::123456789012:role/marketingadminrole"
    }
  ]
}

Pengguna tidak perlu memiliki izin tambahan untuk menjalankan AWS CLI perintah menggunakan profil peran. Sebaliknya, izin untuk menjalankan perintah berasal dari yang dilampirkan pada peran. Anda melampirkan kebijakan izin ke peran untuk menentukan tindakan mana yang dapat dilakukan terhadap AWS sumber daya yang mana. Untuk informasi selengkapnya tentang melampirkan izin ke peran (yang bekerja secara identik dengan pengguna), lihat Mengubah Izin untuk pengguna IAM di Panduan Pengguna IAM.

Sekarang setelah Anda memiliki profil peran, izin peran, hubungan kepercayaan peran, dan izin pengguna yang dikonfigurasi dengan benar, Anda dapat menggunakan peran di baris perintah dengan menjalankan opsi. --profile Misalnya, berikut ini memanggil ls perintah Amazon S3 menggunakan izin yang dilampirkan pada marketingadmin peran seperti yang ditentukan oleh contoh di awal topik ini.

$ aws s3 ls --profile marketingadmin

Untuk menggunakan peran untuk beberapa panggilan, Anda dapat mengatur variabel AWS_PROFILE lingkungan untuk sesi saat ini dari baris perintah. Sementara variabel lingkungan didefinisikan, Anda tidak perlu menentukan --profile opsi pada setiap perintah.

Linux atau macOS

$ export AWS_PROFILE=marketingadmin

Jendela

C:\> setx AWS_PROFILE marketingadmin

Untuk informasi selengkapnya tentang mengonfigurasi pengguna dan peran, lihat Pengguna dan Grup dan Peran di Panduan Pengguna IAM.

Menggunakan otentikasi multi-faktor

Untuk keamanan tambahan, Anda dapat meminta pengguna menyediakan kunci satu kali yang dihasilkan dari perangkat multi-faktor otentikasi (MFA), perangkat U2F, atau aplikasi seluler saat mereka mencoba melakukan panggilan menggunakan profil peran.

Pertama, Anda dapat memilih untuk memodifikasi hubungan kepercayaan pada peran IAM untuk meminta MFA. Ini mencegah siapa pun menggunakan peran tanpa terlebih dahulu mengautentikasi dengan menggunakan MFA. Sebagai contoh, lihat Condition baris dalam contoh berikut. Kebijakan ini memungkinkan pengguna yang diberi nama anika untuk mengambil peran yang dilampirkan kebijakan, tetapi hanya jika mereka mengautentikasi dengan menggunakan MFA.

{
  "Version": "2012-10-17",
  "Statement": [
    {
      "Sid": "",
      "Effect": "Allow",
      "Principal": { "AWS": "arn:aws:iam::123456789012:user/anika" },
      "Action": "sts:AssumeRole",
      "Condition": { "Bool": { "aws:multifactorAuthPresent": true } }
    }
  ]
}

Selanjutnya, tambahkan baris ke profil peran yang menentukan ARN perangkat MFA pengguna. Entri config file contoh berikut menunjukkan dua profil peran yang keduanya menggunakan kunci akses bagi pengguna anika untuk meminta kredensyal sementara untuk peran tersebut. cli-role Pengguna anika memiliki izin untuk mengambil peran, yang diberikan oleh kebijakan kepercayaan peran.

[profile role-without-mfa]
region = us-west-2
role_arn= arn:aws:iam::128716708097:role/cli-role
source_profile=cli-user

[profile role-with-mfa]
region = us-west-2
role_arn= arn:aws:iam::128716708097:role/cli-role
source_profile = cli-user
mfa_serial = arn:aws:iam::128716708097:mfa/cli-user

[profile cli-user]
region = us-west-2
output = json

mfa_serialPengaturan dapat mengambil ARN, seperti yang ditunjukkan, atau nomor seri token MFA perangkat keras.

Profil pertama,role-without-mfa, tidak memerlukan MFA. Namun, karena contoh kebijakan kepercayaan sebelumnya yang dilampirkan pada peran memerlukan MFA, setiap upaya untuk menjalankan perintah dengan profil ini gagal.

$ aws iam list-users --profile role-without-mfa

An error occurred (AccessDenied) when calling the AssumeRole operation: Access denied

Entri profil kedua,role-with-mfa, mengidentifikasi perangkat MFA untuk digunakan. Ketika pengguna mencoba menjalankan AWS CLI perintah dengan profil ini, pengguna AWS CLI meminta pengguna untuk memasukkan kata sandi satu kali (OTP) yang disediakan perangkat MFA. Jika otentikasi MFA berhasil, perintah melakukan operasi yang diminta. OTP tidak ditampilkan di layar.

$ aws iam list-users --profile role-with-mfa
Enter MFA code for arn:aws:iam::123456789012:mfa/cli-user:
{
    "Users": [
        {
            ...

Peran lintas akun dan ID eksternal

Anda dapat mengaktifkan pengguna untuk menggunakan peran yang dimiliki oleh akun yang berbeda dengan mengonfigurasi peran sebagai peran lintas akun. Selama pembuatan peran, setel tipe peran ke AWSAkun lain, seperti yang dijelaskan dalam Membuat Peran untuk Mendelegasikan Izin ke pengguna IAM. Secara opsional, pilih Memerlukan MFA. Memerlukan MFA mengkonfigurasi kondisi yang sesuai dalam hubungan kepercayaan, seperti yang dijelaskan dalam. Menggunakan otentikasi multi-faktor

Jika Anda menggunakan ID eksternal untuk memberikan kontrol tambahan atas siapa yang dapat menggunakan peran di seluruh akun, Anda juga harus menambahkan external_id parameter ke profil peran. Anda biasanya menggunakan ini hanya ketika akun lain dikendalikan oleh seseorang di luar perusahaan atau organisasi Anda.

[profile crossaccountrole]
role_arn = arn:aws:iam::234567890123:role/SomeRole
source_profile = default
mfa_serial = arn:aws:iam::123456789012:mfa/saanvi
external_id = 123456

Menentukan nama sesi peran untuk audit yang lebih mudah

Ketika banyak individu berbagi peran, audit menjadi lebih dari sebuah tantangan. Anda ingin mengaitkan setiap operasi yang dipanggil dengan individu yang memanggil tindakan. Namun, ketika individu menggunakan peran, asumsi peran oleh individu adalah tindakan terpisah dari pemanggilan operasi, dan Anda harus mengkorelasikan keduanya secara manual.

Anda dapat menyederhanakan ini dengan menentukan nama sesi peran unik saat pengguna mengambil peran. Anda melakukan ini dengan menambahkan role_session_name parameter ke setiap profil bernama dalam config file yang menentukan peran. role_session_nameNilai diteruskan ke AssumeRole operasi dan menjadi bagian dari ARN untuk sesi peran. Ini juga termasuk dalam AWS CloudTrail log untuk semua operasi yang dicatat.

Misalnya, Anda dapat membuat profil berbasis peran sebagai berikut.

[profile namedsessionrole]
role_arn = arn:aws:iam::234567890123:role/SomeRole
source_profile = default
role_session_name = Session_Maria_Garcia

Hal ini mengakibatkan sesi peran memiliki ARN berikut.

arn:aws:iam::234567890123:assumed-role/SomeRole/Session_Maria_Garcia

Selain itu, semua AWS CloudTrail log menyertakan nama sesi peran dalam informasi yang diambil untuk setiap operasi.

Asumsikan peran dengan identitas web

Anda dapat mengonfigurasi profil untuk menunjukkan bahwa AWS CLI harus mengambil peran menggunakan federasi identitas web dan Open ID Connect (OIDC). Saat Anda menentukan ini di profil, secara AWS CLI otomatis membuat AWS STS AssumeRoleWithWebIdentity panggilan yang sesuai untuk Anda.

Untuk mengambil dan menggunakan kredensyal sementara menggunakan federasi identitas web, Anda dapat menentukan nilai konfigurasi berikut di profil bersama.

Berikut ini adalah contoh dari jumlah minimal konfigurasi yang diperlukan untuk mengkonfigurasi peran asumsi dengan profil identitas web.

# In ~/.aws/config

[profile web-identity]
role_arn=arn:aws:iam:123456789012:role/RoleNameToAssume
web_identity_token_file=/path/to/a/token

Anda juga dapat menyediakan konfigurasi ini dengan menggunakan variabel lingkungan.

Membersihkan kredensyal yang di-cache

Saat Anda menggunakan peran, kredensyal sementara akan disimpan di AWS CLI cache secara lokal hingga mereka kedaluwarsa. Lain kali Anda mencoba menggunakannya, AWS CLI upaya untuk memperbaruinya atas nama Anda.

Jika kredensyal sementara peran Anda dicabut, kredensialnya tidak diperbarui secara otomatis, dan upaya untuk menggunakannya gagal. Namun, Anda dapat menghapus cache untuk memaksa AWS CLI untuk mengambil kredensyal baru.

Linux atau macOS

$ rm -r ~/.aws/cli/cache

Jendela

C:\> del /s /q %UserProfile%\.aws\cli\cache