AWS SDK untuk .NET V3 telah memasuki mode pemeliharaan.
Kami menyarankan Anda bermigrasi ke [AWS SDK untuk .NET V4](https://docs.aws.amazon.com/sdk-for-net/v4/developer-guide/welcome.html). Untuk detail dan informasi tambahan tentang cara bermigrasi, silakan lihat [pengumuman mode pemeliharaan](https://aws.amazon.com/blogs/developer/aws-sdk-for-net-v3-maintenance-mode-announcement/) kami.
Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
# Menggunakan file AWS kredensial bersama
(Pastikan untuk meninjau [peringatan dan panduan penting untuk kredensialnya](net-dg-legacy-creds.md#net-dg-config-creds-warnings-and-guidelines).)
Salah satu cara untuk memberikan kredensi untuk aplikasi Anda adalah dengan membuat profil di *file AWS kredensial bersama dan kemudian menyimpan kredensi* di profil tersebut. File ini dapat digunakan oleh yang lain AWS SDKs. Hal ini juga dapat digunakan oleh [AWS CLI](https://docs.aws.amazon.com/cli/latest/userguide/), [AWS Tools for Windows PowerShell](https://docs.aws.amazon.com/powershell/latest/userguide/), dan AWS toolkit untuk [Visual Studio](https://docs.aws.amazon.com/toolkit-for-visual-studio/latest/user-guide/), [JetBrains](https://docs.aws.amazon.com/toolkit-for-jetbrains/latest/userguide/), dan [VS](https://docs.aws.amazon.com/toolkit-for-vscode/latest/userguide/) Code.
**Awas**
Untuk menghindari risiko keamanan, jangan gunakan pengguna IAM untuk otentikasi saat mengembangkan perangkat lunak yang dibuat khusus atau bekerja dengan data nyata. Sebaliknya, gunakan federasi dengan penyedia identitas seperti [AWS IAM Identity Center](https://docs.aws.amazon.com/singlesignon/latest/userguide/what-is.html).
**catatan**
Informasi dalam topik ini adalah untuk keadaan di mana Anda perlu memperoleh dan mengelola kredensi jangka pendek atau jangka panjang secara manual. Untuk informasi tambahan tentang kredensi jangka pendek dan jangka panjang, lihat [Cara lain untuk mengautentikasi](https://docs.aws.amazon.com/sdkref/latest/guide/access-users.html) di Panduan Referensi *Alat AWS SDKs dan Alat*.
Untuk praktik keamanan terbaik, gunakan AWS IAM Identity Center, seperti yang dijelaskan dalam[Konfigurasikan otentikasi SDK](creds-idc.md).
## Informasi umum
Secara default, file AWS kredensi bersama terletak di direktori di dalam `.aws` direktori home Anda dan diberi nama`credentials`; yaitu, `~/.aws/credentials` (Linux atau macOS) atau `%USERPROFILE%\.aws\credentials` (Windows). Untuk informasi tentang lokasi alternatif, lihat [Lokasi file bersama di](https://docs.aws.amazon.com/sdkref/latest/guide/file-location.html) *[Panduan Referensi Alat AWS SDKs dan](https://docs.aws.amazon.com/sdkref/latest/guide/overview.html)*. Lihat juga [Mengakses kredensi dan profil dalam aplikasi](creds-locate.md).
File AWS kredensial bersama adalah file plaintext dan mengikuti format tertentu. Untuk informasi tentang format file AWS kredensional, lihat [Format file kredensial di Panduan Referensi](https://docs.aws.amazon.com/sdkref/latest/guide/file-format.html#file-format-creds) Alat *AWS SDKs dan*.
Anda dapat mengelola profil dalam file AWS kredensi bersama dengan beberapa cara.
+ Gunakan editor teks apa pun untuk membuat dan memperbarui file AWS kredensi bersama.
+ Gunakan [Amazon.Runtime. CredentialManagement](https://docs.aws.amazon.com/sdkfornet/v3/apidocs/items/Runtime/NRuntimeCredentialManagement.html)namespace AWS SDK untuk .NET API, seperti yang ditunjukkan nanti dalam topik ini.
+ Gunakan perintah dan prosedur untuk [Alat AWS untuk PowerShell](https://docs.aws.amazon.com/powershell/latest/userguide/specifying-your-aws-credentials.html)dan AWS toolkit untuk [Visual Studio](https://docs.aws.amazon.com/toolkit-for-visual-studio/latest/user-guide/credentials.html), [JetBrains](https://docs.aws.amazon.com/toolkit-for-jetbrains/latest/userguide/setup-credentials.html), dan [VS](https://docs.aws.amazon.com/toolkit-for-vscode/latest/userguide/setup-credentials.html) Code.
+ Gunakan [AWS CLI](https://docs.aws.amazon.com/cli/latest/userguide/cli-configure-files.html)perintah; misalnya, `aws configure set aws_access_key_id` dan`aws configure set aws_secret_access_key`.
## Contoh manajemen profil
Bagian berikut menunjukkan contoh profil dalam file AWS kredensial bersama. Beberapa contoh menunjukkan hasilnya, yang dapat diperoleh melalui salah satu metode manajemen kredensional yang dijelaskan sebelumnya. Contoh lain menunjukkan cara menggunakan metode tertentu.
### Profil default
*File AWS kredensial bersama hampir selalu memiliki profil bernama default.* Di sinilah AWS SDK untuk .NET mencari kredensi jika tidak ada profil lain yang ditentukan.
`[default]`Profil biasanya terlihat seperti berikut ini.
```
[default]
aws_access_key_id = AKIAIOSFODNN7EXAMPLE
aws_secret_access_key = wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY
```
### Buat profil secara terprogram
Contoh ini menunjukkan cara membuat profil dan menyimpannya ke file AWS kredensial bersama secara terprogram. Ini menggunakan kelas berikut dari [Amazon.Runtime. CredentialManagement](https://docs.aws.amazon.com/sdkfornet/v3/apidocs/items/Runtime/NRuntimeCredentialManagement.html)namespace: [CredentialProfileOptions](https://docs.aws.amazon.com/sdkfornet/v3/apidocs/items/Runtime/TCredentialProfileOptions.html), [CredentialProfile](https://docs.aws.amazon.com/sdkfornet/v3/apidocs/items/Runtime/TCredentialProfile.html), dan. [SharedCredentialsFile](https://docs.aws.amazon.com/sdkfornet/v3/apidocs/items/Runtime/TSharedCredentialsFile.html)
```
using Amazon.Runtime.CredentialManagement;
...
// Do not include credentials in your code.
WriteProfile("my_new_profile", SecurelyStoredKeyID, SecurelyStoredSecretAccessKey);
...
void WriteProfile(string profileName, string keyId, string secret)
{
Console.WriteLine($"Create the [{profileName}] profile...");
var options = new CredentialProfileOptions
{
AccessKey = keyId,
SecretKey = secret
};
var profile = new CredentialProfile(profileName, options);
var sharedFile = new SharedCredentialsFile();
sharedFile.RegisterProfile(profile);
}
```
**Awas**
Kode seperti ini umumnya tidak boleh ada dalam aplikasi Anda. Jika Anda memasukkannya ke dalam aplikasi Anda, lakukan tindakan pencegahan yang tepat untuk memastikan bahwa kunci teks biasa tidak mungkin terlihat dalam kode, melalui jaringan, atau bahkan di memori komputer.
Berikut ini adalah profil yang dibuat oleh contoh ini.
```
[my_new_profile]
aws_access_key_id=AKIAIOSFODNN7EXAMPLE
aws_secret_access_key=wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY
```
### Perbarui profil yang ada secara terprogram
Contoh ini menunjukkan kepada Anda cara memperbarui profil yang dibuat sebelumnya secara terprogram. Ini menggunakan kelas berikut dari [Amazon.Runtime. CredentialManagement](https://docs.aws.amazon.com/sdkfornet/v3/apidocs/items/Runtime/NRuntimeCredentialManagement.html)namespace: [CredentialProfile](https://docs.aws.amazon.com/sdkfornet/v3/apidocs/items/Runtime/TCredentialProfile.html)dan. [SharedCredentialsFile](https://docs.aws.amazon.com/sdkfornet/v3/apidocs/items/Runtime/TSharedCredentialsFile.html) Ini juga menggunakan [RegionEndpoint](https://docs.aws.amazon.com/sdkfornet/v3/apidocs/items/Amazon/TRegionEndpoint.html)kelas namespace [Amazon](https://docs.aws.amazon.com/sdkfornet/v3/apidocs/items/Amazon/N.html).
```
using Amazon.Runtime.CredentialManagement;
...
AddRegion("my_new_profile", RegionEndpoint.USWest2);
...
void AddRegion(string profileName, RegionEndpoint region)
{
var sharedFile = new SharedCredentialsFile();
CredentialProfile profile;
if (sharedFile.TryGetProfile(profileName, out profile))
{
profile.Region = region;
sharedFile.RegisterProfile(profile);
}
}
```
Berikut ini adalah profil yang diperbarui.
```
[my_new_profile]
aws_access_key_id=AKIAIOSFODNN7EXAMPLE
aws_secret_access_key=wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY
region=us-west-2
```
**catatan**
Anda juga dapat mengatur AWS Wilayah di lokasi lain dan dengan menggunakan metode lain. Lihat informasi yang lebih lengkap di [Konfigurasikan AWS Wilayah](net-dg-region-selection.md).