View a markdown version of this page

AWS STS contoh menggunakan Tools for PowerShell V5 - Alat AWS untuk PowerShell (versi 5)

Versi 5 (V5) Alat AWS untuk PowerShell telah dirilis!

Untuk informasi tentang mengubah perubahan dan memigrasikan aplikasi Anda, lihat topik https://docs.aws.amazon.com/powershell/v5/userguide/migrating-v5.html migrasi.

Orange button with text "Click here for details".

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

AWS STS contoh menggunakan Tools for PowerShell V5

Contoh kode berikut menunjukkan cara melakukan tindakan dan menerapkan skenario umum dengan menggunakan Alat AWS untuk PowerShell V5 dengan AWS STS.

Tindakan merupakan kutipan kode dari program yang lebih besar dan harus dijalankan dalam konteks. Sementara tindakan menunjukkan cara memanggil fungsi layanan individual, Anda dapat melihat tindakan dalam konteks dalam skenario terkait.

Setiap contoh menyertakan tautan ke kode sumber lengkap, di mana Anda dapat menemukan instruksi tentang cara mengatur dan menjalankan kode dalam konteks.

Tindakan

Contoh kode berikut menunjukkan cara menggunakanConvert-STSAuthorizationMessage.

Alat untuk PowerShell V5

Contoh 1: Mendekode informasi tambahan yang terkandung dalam konten pesan terkodekan yang disediakan yang dikembalikan sebagai tanggapan atas permintaan. Informasi tambahan dikodekan karena rincian status otorisasi dapat merupakan informasi istimewa yang tidak boleh dilihat oleh pengguna yang meminta tindakan tersebut.

Convert-STSAuthorizationMessage -EncodedMessage "...encoded message..."

Contoh kode berikut menunjukkan cara menggunakanGet-STSFederationToken.

Alat untuk PowerShell V5

Contoh 1: Meminta token federasi yang valid selama satu jam menggunakan “Bob” sebagai nama pengguna federasi. Nama ini dapat digunakan untuk mereferensikan nama pengguna federasi dalam kebijakan berbasis sumber daya (seperti kebijakan bucket Amazon S3). Kebijakan IAM yang disediakan, dalam format JSON, digunakan untuk menguraikan izin yang tersedia untuk pengguna IAM. Kebijakan yang disediakan tidak dapat memberikan lebih banyak izin daripada yang diberikan kepada pengguna yang meminta, dengan izin akhir untuk pengguna federasi menjadi kumpulan yang paling membatasi berdasarkan persimpangan kebijakan yang dilewati dan kebijakan pengguna IAM.

Get-STSFederationToken -Name "Bob" -Policy "...JSON policy..." -DurationInSeconds 3600

Contoh kode berikut menunjukkan cara menggunakanGet-STSSessionToken.

Alat untuk PowerShell V5

Contoh 1: Mengembalikan Amazon.RuntimeAWSCredentials instance yang berisi kredenSIAL sementara yang valid untuk jangka waktu yang ditetapkan. KredenSIAL yang digunakan untuk meminta kredenSIAL sementara disimpulkan dari default shell saat ini. Untuk menentukan kredenSIAL lainnya, gunakan SecretKey parameter - ProfileName atau - AccessKey /-.

Get-STSSessionToken

Output:

AccessKeyId Expiration SecretAccessKey SessionToken ----------- ---------- --------------- ------------ EXAMPLEACCESSKEYID 2/16/2015 9:12:28 PM examplesecretaccesskey... SamPleTokeN.....

Contoh 2: Mengembalikan Amazon.RuntimeAWSCredentials instance yang berisi kredenSIAL sementara yang valid selama satu jam. KredenSIAL yang digunakan untuk membuat permintaan diperoleh dari profil yang ditentukan.

Get-STSSessionToken -DurationInSeconds 3600 -ProfileName myprofile

Output:

AccessKeyId Expiration SecretAccessKey SessionToken ----------- ---------- --------------- ------------ EXAMPLEACCESSKEYID 2/16/2015 9:12:28 PM examplesecretaccesskey... SamPleTokeN.....

Contoh 3: Mengembalikan Amazon.RuntimeAWSCredentials instance yang berisi kredenSIAL sementara yang valid selama satu jam menggunakan nomor identifikasi perangkat MFA yang terkait dengan akun yang kredensialnya ditentukan dalam profil 'myprofilename' dan nilai yang disediakan oleh perangkat.

Get-STSSessionToken -DurationInSeconds 3600 -ProfileName myprofile -SerialNumber YourMFADeviceSerialNumber -TokenCode 123456

Output:

AccessKeyId Expiration SecretAccessKey SessionToken ----------- ---------- --------------- ------------ EXAMPLEACCESSKEYID 2/16/2015 9:12:28 PM examplesecretaccesskey... SamPleTokeN.....
  • Untuk detail API, lihat GetSessionToken di Referensi Alat AWS untuk PowerShell Cmdlet (V5).

Contoh kode berikut menunjukkan cara menggunakanUse-STSRole.

Alat untuk PowerShell V5

Contoh 1: Mengembalikan satu set kredenSIAL sementara (kunci akses, kunci rahasia, dan token sesi) yang dapat digunakan selama satu jam untuk mengakses AWS sumber daya yang biasanya tidak dapat diakses oleh pengguna yang meminta. KredenSIAL yang dikembalikan memiliki izin yang diizinkan oleh kebijakan akses peran yang diasumsikan dan kebijakan yang diberikan (Anda tidak dapat menggunakan kebijakan yang disediakan untuk memberikan izin melebihi yang ditentukan oleh kebijakan akses peran yang diasumsikan).

Use-STSRole -RoleSessionName "Bob" -RoleArn "arn:aws:iam::123456789012:role/demo" -Policy "...JSON policy..." -DurationInSeconds 3600

Contoh 2: Mengembalikan satu set kredenSIAL sementara, valid selama satu jam, yang memiliki izin yang sama yang ditentukan dalam kebijakan akses peran yang diasumsikan.

Use-STSRole -RoleSessionName "Bob" -RoleArn "arn:aws:iam::123456789012:role/demo" -DurationInSeconds 3600

Contoh 3: Mengembalikan satu set kredenSIAL sementara yang menyediakan nomor seri dan token yang dihasilkan dari MFA yang terkait dengan kredenSIAL pengguna yang digunakan untuk mengeksekusi cmdlet.

Use-STSRole -RoleSessionName "Bob" -RoleArn "arn:aws:iam::123456789012:role/demo" -DurationInSeconds 3600 -SerialNumber "GAHT12345678" -TokenCode "123456"

Contoh 4: Mengembalikan satu set kredenSIAL sementara yang telah mengambil peran yang ditentukan dalam akun pelanggan. Untuk setiap peran yang dapat diasumsikan oleh pihak ketiga, akun pelanggan harus membuat peran menggunakan pengenal yang harus diteruskan dalam ExternalId parameter - setiap kali peran diasumsikan.

Use-STSRole -RoleSessionName "Bob" -RoleArn "arn:aws:iam::123456789012:role/demo" -DurationInSeconds 3600 -ExternalId "ABC123"
  • Untuk detail API, lihat AssumeRole di Referensi Alat AWS untuk PowerShell Cmdlet (V5).

Contoh kode berikut menunjukkan cara menggunakanUse-STSWebIdentityRole.

Alat untuk PowerShell V5

Contoh 1: Mengembalikan kumpulan kredenSIAL sementara, berlaku selama satu jam, untuk pengguna yang telah diautentikasi dengan penyedia identitas Login dengan Amazon. KredenSIAL mengasumsikan kebijakan akses yang terkait dengan peran yang diidentifikasi oleh peran ARN. Secara opsional, Anda dapat meneruskan kebijakan JSON ke parameter -Policy yang lebih menyempurnakan izin akses (Anda tidak dapat memberikan lebih banyak izin daripada yang tersedia dalam izin yang terkait dengan peran). Nilai yang diberikan ke - WebIdentityToken adalah pengenal pengguna unik yang dikembalikan oleh penyedia identitas.

Use-STSWebIdentityRole -DurationInSeconds 3600 -ProviderId "www.amazon.com" -RoleSessionName "app1" -RoleArn "arn:aws:iam::123456789012:role/FederatedWebIdentityRole" -WebIdentityToken "Atza...DVI0r1"