View a markdown version of this page

Mengotentikasi AWS SDK untuk .NET dengan AWS - AWS SDK untuk .NET (V4)
Masuk menggunakan kredensional konsolMengaktifkan dan mengkonfigurasi Pusat Identitas IAMKonfigurasikan SDK untuk menggunakan Pusat Identitas IAM.Mulai sebuah AWS akses sesi portalInformasi tambahan

Versi 4 (V4) AWS SDK untuk .NET telah dirilis!

Untuk informasi tentang mengubah perubahan dan memigrasikan aplikasi Anda, lihat topik https://docs.aws.amazon.com/sdk-for-net/v4/developer-guide/net-dg-v4.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.

Mengotentikasi AWS SDK untuk .NET dengan AWS

Anda harus menetapkan bagaimana kode Anda diautentikasi AWS saat mengembangkan dengan Layanan AWS. Ada berbagai cara di mana Anda dapat mengonfigurasi akses terprogram ke AWS sumber daya, tergantung pada lingkungan dan AWS akses yang tersedia untuk Anda.

Untuk melihat berbagai metode otentikasi untuk SDK, lihat Oten tikasi dan akses di Panduan Refer AWS ensi SDK dan Alat.

Topik ini mengasumsikan bahwa pengguna baru sedang berkembang secara lokal, belum diberi metode otentikasi oleh majikan mereka, dan akan digunakan AWS IAM Identity Center untuk mendapatkan kredenSIAL sementara. Jika lingkungan Anda tidak termasuk dalam asumsi ini, beberapa informasi dalam topik ini mungkin tidak berlaku untuk Anda, atau beberapa informasi mungkin sudah diberikan kepada Anda.

Mengkonfigurasi lingkungan ini memerlukan beberapa langkah, yang diringkas sebagai berikut:

  1. Masuk menggunakan kredensional konsol

  2. Mengaktifkan dan mengkonfigurasi Pusat Identitas IAM

  3. Konfigurasikan SDK untuk menggunakan Pusat Identitas IAM.

  4. Mulai sebuah AWS akses sesi portal

Masuk menggunakan kredensional konsol

Anda dapat menggunakan kredentif masuk Konsol AWS Manajemen yang ada untuk akses terprogram ke AWS layanan. Setelah aliran otentikasi berbasis browser, AWS menghasilkan kredenSIAL sementara yang berfungsi di seluruh alat pengembangan lokal seperti AWS CLI, Alat AWS untuk PowerShell dan AWS SDK untuk.NET v4.

Dengan proses ini, Anda dapat mengotentikasi menggunakan kredenSIAL root yang dibuat selama pengaturan akun awal, pengguna IAM, atau identitas federasi dari penyedia identitas Anda, dan AWS CLI atau Alat AWS untuk PowerShell secara otomatis mengelola kredenSIAL sementara untuk Anda. Pendekatan ini meningkatkan keamanan dengan menghilangkan kebutuhan untuk menyimpan kredenSIAL jangka panjang secara lokal. Saat menjalankan Invoke-AWSLogin cmdlet dari Alat AWS untuk PowerShell atau aws login perintah dari AWS CLI, Anda dapat memilih dari sesi konsol aktif, atau masuk melalui alur otentikasi berbasis browser dan ini akan secara otomatis menghasilkan kredenSIAL sementara. Token kredensi sementara akan kedaluwarsa dalam 15 menit, tetapi AWS SDK untuk.NET v4 secara otomatis menyegarkan token saat diperlukan selama permintaan Anda.

penting

Jika Anda menggunakan kredentif konsol untuk otentikasi, aplikasi Anda harus mereferensikan NuGet paket berikut agar resolusi AWS Signin dapat berfungsi:

  • AWSSDK.Signin

Kegagalan untuk mereferensikan paket-paket ini akan menghasilkan pengecualian runtime.

configFile akan terlihat seperti ini setelah Anda masuk mengikuti langkah-langkah yang diberikan di atas untuk Alat AWS untuk PowerShell atau AWS CLI. 

[default]
login_session = arn:aws:iam::0123456789012:user/username
region = us-east-1

[my-dev-profile]
login_session = arn:aws:iam::0123456789012:user/username
region = us-east-1

Mengaktifkan dan mengkonfigurasi Pusat Identitas IAM

Untuk menggunakan Pusat Identitas IAM, itu harus diaktifkan dan dikonfigurasi terlebih dahulu. Untuk melihat detail tentang cara melakukan ini untuk SDK, lihat Langkah 1 dalam topik untuk otentikasi Pusat Identi tas IAM di Panduan Refer AWS ensi SDK dan Alat. Secara khusus, ikuti instruksi yang diperlukan di bawah Saya tidak memiliki akses yang ditetapkan melalui Pusat Identitas IAM.

Konfigurasikan SDK untuk menggunakan Pusat Identitas IAM.

Informasi tentang cara mengonfigurasi SDK untuk menggunakan Pusat Identitas IAM ada di Langkah 2 dalam topik untuk otentikasi Pusat Identi tas IAM di Panduan Refer AWS ensi SDK dan Alat. Setelah Anda menyelesaikan konfigurasi ini, sistem Anda harus berisi elemen-elemen berikut:

  • AWS CLI, yang Anda gunakan untuk memulai sesi portal AWS akses sebelum Anda menjalankan aplikasi Anda.

  • AWS configFile bersama yang berisi [default] profil dengan serangkaian nilai konfigurasi yang dapat direferensikan dari SDK. Untuk menemukan lokasi file ini, lihat Lokasi file bersama di Panduan Refer AWS ensi SDK dan Alat. Menggunakan AWS SDK untuk .NET penyedia token SSO profil untuk memperoleh kredenSIAL sebelum mengirim permintaan ke AWS. sso_role_nameNilai, yang merupakan peran IAM yang terhubung ke kumpulan izin Pusat Identitas IAM, harus memungkinkan akses ke yang Layanan AWS digunakan dalam aplikasi Anda.

    configFile contoh berikut menunjukkan profil default yang diatur dengan penyedia token SSO. Peng sso_session aturan profil mengacu pada sso-session bagian bernama. sso-sessionBagian ini berisi pengaturan untuk memulai sesi portal AWS akses.

    [default]
sso_session = my-sso
sso_account_id = 111122223333
sso_role_name = SampleRole
region = us-east-1
output = json

[sso-session my-sso]
sso_region = us-east-1
sso_start_url = https://provided-domain.awsapps.com/start
sso_registration_scopes = sso:account:access
penting

Jika Anda menggunakan AWS IAM Identity Center untuk otentikasi, aplikasi Anda harus mereferensikan NuGet paket berikut agar resolusi SSO dapat berfungsi:

  • AWSSDK.SSO

  • AWSSDK.SSOOIDC

Kegagalan untuk mereferensikan paket-paket ini akan menghasilkan pengecualian runtime.

Mulai sebuah AWS akses sesi portal

Sebelum menjalankan aplikasi yang mengakses Layanan AWS, Anda memerlukan sesi portal AWS akses aktif agar SDK menggunakan otentikasi Pusat Identitas IAM untuk menyelesaikan kredenSIAL. Bergantung pada panjang sesi yang dikonfigurasi, akses Anda akhirnya akan kedaluwarsa dan SDK akan mengalami kesalahan otentikasi. Untuk masuk ke portal AWS akses, jalankan perintah berikut di AWS CLI.

aws sso login

Karena Anda memiliki pengaturan profil default, Anda tidak perlu memanggil perintah dengan --profile opsi. Jika konfigurasi penyedia token SSO Anda menggunakan profil bernama, perintahnya adalahaws sso login --profile named-profile.

Untuk menguji apakah Anda sudah memiliki sesi aktif, jalankan AWS CLI perintah berikut.

aws sts get-caller-identity

Respons terhadap perintah ini harus melaporkan akun Pusat Identitas IAM dan kumpulan izin yang dikonfigurasi dalam config file bersama.

catatan

Jika Anda sudah memiliki sesi portal AWS akses aktif dan menjalankannyaaws sso login, Anda tidak akan diminta untuk memberikan kredenSIAL.

Proses masuk mungkin meminta Anda untuk mengizinkan AWS CLI akses ke data Anda. Pada layar persetujuan, nama klien dimulai denganbotocore-client-, dinamaibotocore, pustaka Python yang AWS CLI digunakan.

Informasi tambahan

  • Untuk informasi tambahan tentang menggunakan Pusat Identitas IAM dan SSO di lingkungan pengembangan, lihat Sign-on tunggal di bagian Autentikasi tingkat lanjut ini. Informasi ini mencakup metode alternatif dan lebih maju, serta tutorial yang menunjukkan cara menggunakan metode ini.

  • Untuk opsi lebih lanjut tentang otentikasi untuk SDK, seperti penggunaan profil dan variabel lingkungan, lihat bagian konfigurasi di Panduan Refer AWS ensi SDK dan Alat.

  • Untuk mempelajari lebih lanjut tentang praktik terbaik, lihat Praktik terbaik keamanan di IAM di Panduan Pengguna IAM.

  • Untuk membuat AWS kredenSIAL jangka pendek, lihat KredenSIAL Keamanan Sementara di Panduan Pengguna IAM.

  • Untuk mempelajari tentang penyedia kredensia lainnya, lihat Penye dia kredensia standar di Panduan Refer AWS ensi SDK dan Alat.