View a markdown version of this page

Freigegeben AWS Datei mit Anmeldeinformationen - AWS SDK für .NET (V4)

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.

Orange button with text "Click here for details".

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.

Warnung

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.

Anmerkung

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.

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); }
Warnung

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
Anmerkung

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