Version 4 (V4) von AWS SDK für .NET wurde veröffentlicht!
Informationen zu wichtigen Änderungen und zur Migration Ihrer Anwendungen finden Sie im Migrationsthema.
Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.
Freigegeben AWS Datei mit Anmeldeinformationen
(Lesen Sie unbedingt die wichtigen Warnungen und Hinweise für Anmeldeinformationen.)
Eine Möglichkeit, Anmeldeinformationen für Ihre Anwendungen bereitzustellen, besteht darin, Profile in der Datei mit den gemeinsam genutzten AWS Anmeldeinformationen zu erstellen und die Anmeldeinformationen dann in diesen Profilen zu speichern. Diese Datei kann von den anderen AWS SDKs verwendet werden. Sie kann auch von den AWS CLI, the und den AWS Tools for Windows PowerShell AWS Toolkits für Visual Studio und VS Code JetBrains verwendet werden.
Um Sicherheitsrisiken zu vermeiden, sollten Sie IAM-Benutzer nicht zur Authentifizierung verwenden, wenn Sie speziell entwickelte Software entwickeln oder mit echten Daten arbeiten. Verwenden Sie stattdessen den Verbund mit einem Identitätsanbieter wie AWS IAM Identity Center.
Die Informationen in diesem Thema beziehen sich auf Situationen, in denen Sie kurz- oder langfristige Anmeldeinformationen manuell abrufen und verwalten müssen. Weitere Informationen zu kurz- und langfristigen Anmeldeinformationen finden Sie unter Andere Authentifizierungsmethoden im Referenzhandbuch für AWS SDKs und Tools.
Die besten Sicherheitspraktiken finden Sie AWS IAM Identity Center, wie unter beschriebenAuthentifizieren mit AWS.
Allgemeine Informationen
Standardmäßig befindet sich die Datei mit den gemeinsam genutzten AWS Anmeldeinformationen in dem .aws Verzeichnis in Ihrem Basisverzeichnis und hat einen Namen, credentials d. h. ~/.aws/credentials (Linux oder macOS) oder %USERPROFILE%\.aws\credentials (Windows). Informationen zu alternativen Speicherorten finden Sie unter Speicherort der gemeinsam genutzten Dateien im Referenzhandbuch für AWS SDKs und Tools.
Die Datei mit den gemeinsam genutzten AWS Anmeldeinformationen ist eine Klartextdatei und folgt einem bestimmten Format. Informationen zum Format von AWS Anmeldeinformationsdateien finden Sie unter Format der Anmeldeinformationsdatei im Referenzhandbuch für AWS SDKs und Tools.
Sie können die Profile in der Datei mit den gemeinsam genutzten AWS Anmeldeinformationen auf verschiedene Arten verwalten.
-
Verwenden Sie einen beliebigen Texteditor, um die Datei mit den gemeinsamen AWS Anmeldeinformationen zu erstellen und zu aktualisieren.
-
Verwenden Sie den Amazon.Runtime.CredentialManagement Namespace der AWS SDK für .NET API, wie weiter unten in diesem Thema gezeigt.
-
Verwenden Sie Befehle und Prozeduren für AWS -Tools für PowerShell und die AWS Toolkits für Visual Studio und VS Code. JetBrains
-
Verwenden Sie AWS CLI Befehle, z. B.
aws configure set aws_access_key_idundaws configure set aws_secret_access_key.
Beispiele für Profilverwaltung
Die folgenden Abschnitte enthalten Beispiele für Profile in der Datei mit gemeinsam genutzten AWS Anmeldeinformationen. Einige Beispiele zeigen das Ergebnis, das mit einer der oben beschriebenen Methoden zur Verwaltung von Anmeldeinformationen erzielt werden kann. Andere Beispiele zeigen, wie eine bestimmte Methode verwendet wird.
Das Standardprofil
Die Datei mit den gemeinsam genutzten AWS Anmeldeinformationen hat fast immer ein Profil mit dem Namen default. Hier AWS SDK für .NET sucht die nach Anmeldeinformationen, wenn keine anderen Profile definiert sind.
Das [default] Profil sieht in der Regel etwa wie folgt aus.
[default] aws_access_key_id = AKIAIOSFODNN7EXAMPLE aws_secret_access_key = wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY
Erstellen Sie programmgesteuert ein Profil
Dieses Beispiel zeigt, wie Sie ein Profil erstellen und es programmgesteuert in der Datei mit den gemeinsamen AWS Anmeldeinformationen speichern. Es verwendet die folgenden Klassen des Amazon.Runtime.CredentialManagement Namespaces: CredentialProfileOptions, und CredentialProfile. SharedCredentialsFile
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); }
Code wie dieser sollte im Allgemeinen nicht in Ihrer Anwendung enthalten sein. Wenn Sie ihn in Ihre Anwendung aufnehmen, treffen Sie angemessene Vorkehrungen, um sicherzustellen, dass Klartextschlüssel unmöglich im Code, über das Netzwerk oder sogar im Computerspeicher sichtbar sind.
Das Folgende ist das Profil, das mit diesem Beispiel erstellt wurde.
[my_new_profile] aws_access_key_id=AKIAIOSFODNN7EXAMPLE aws_secret_access_key=wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY
Aktualisieren Sie ein vorhandenes Profil programmgesteuert
Dieses Beispiel zeigt, wie Sie das zuvor erstellte Profil programmgesteuert aktualisieren. Es verwendet die folgenden Klassen des Amazon.Runtime.CredentialManagement Namespaces: und. CredentialProfile SharedCredentialsFile Es verwendet auch die RegionEndpoint Klasse des https://docs.aws.amazon.com/sdkfornet/v4/apidocs/items/Amazon/N.html Amazon-Namespaces.
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); } }
Das Folgende ist das aktualisierte Profil.
[my_new_profile] aws_access_key_id=AKIAIOSFODNN7EXAMPLE aws_secret_access_key=wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY region=us-west-2
Sie können die AWS Region auch an anderen Orten und mit anderen Methoden festlegen. Weitere Informationen finden Sie unter Festlegung der AWS Region für AWS SDK für .NET.
Wie verwendet Ihre Anwendung diese Datei
-
Automatische Auflösung: Das SDK liest Profile aus dieser Datei automatisch. Legen Sie einen Profilnamen über
AWSConfigs.AWSProfileNameoder dieAWS_PROFILEUmgebungsvariable fest oder verlassen Sie sich auf das[default]Profil. Weitere Informationen finden Sie unter Auflösung von Anmeldeinformationen und Profilen. -
Expliziter Zugriff im Code: Laden Sie ein bestimmtes Profil programmgesteuert und übergeben Sie dessen Anmeldeinformationen an einen Service-Client. Weitere Informationen finden Sie unter Erstellen Sie einen AmazonS3Client mithilfe der Klasse SharedCredentialsFile.