Authentifizierungs-APIs

Mit den folgenden APIs können Sie API-Schlüssel für Amazon Location Service verwalten. Verwenden Sie diese Operationen, um Schlüssel zu erstellen, Einschränkungen zu konfigurieren, Schlüssel zu rotieren und Ihren Schlüsselbestand zu überwachen.

• CreateKey: Erstellt einen neuen API-Schlüssel mit bestimmten Einschränkungen und optionalem Ablauf. Gibt den Schlüsselwert zurück, der zur Authentifizierung nachfolgender API-Anfragen verwendet wird. Weitere Informationen finden Sie CreateKeyin der Amazon Location Service API-Referenz.

• DescribeKey: Ruft die Details eines vorhandenen API-Schlüssels ab, einschließlich seiner Einschränkungen, seines Ablaufs und seines Schlüsselwerts. Weitere Informationen finden Sie DescribeKeyin der Amazon Location Service API-Referenz.

• UpdateKey: Ändert die Einschränkungen, den Ablauf oder die Beschreibung eines vorhandenen API-Schlüssels. Verwenden Sie diesen Vorgang, um die Berechtigungen zu verschärfen, das Ablaufdatum zu verlängern oder festzulegen oder einen Schlüssel zu deaktivieren. Weitere Informationen finden Sie UpdateKeyin der Amazon Location Service API-Referenz.

• DeleteKey: Löscht einen API-Schlüssel dauerhaft. Sie können nur Schlüssel löschen, die seit mindestens 90 Tagen inaktiv sind. Weitere Informationen finden Sie DeleteKeyin der Amazon Location Service API-Referenz.

• ListKeys: Gibt eine Liste der API-Schlüssel in Ihrem Konto und Ihrer Region zurück, einschließlich Metadaten wie Schlüsselname, Status und Ablauf. Weitere Informationen finden Sie ListKeysin der Amazon Location Service API-Referenz.

Häufige Anwendungsfälle

Im Folgenden sind gängige Anwendungsfälle für API-Schlüsselverwaltungsvorgänge aufgeführt.

• Schlüssel für eine Kartenanwendung erstellen: Erstellen Sie einen Schlüssel, der auf geo-maps:* Aktionen auf der Standardressource des Kartenanbieters beschränkt ist und sich für eine Webseite eignet, die nur Karten rendert.

• Einen Schlüssel für Karten und Orte erstellen: Erstellen Sie einen Schlüssel, der sowohl das Rendern von Karten als auch die Geokodierung ermöglicht, indem Sie mehrere zulässige Aktionen und Ressourcen in einem einzigen Schlüssel angeben.

• Einen API-Schlüssel rotieren: Erstellen Sie einen neuen Schlüssel, aktualisieren Sie Ihre Anwendung so, dass sie ihn verwendet, und deaktivieren Sie dann den alten Schlüssel, indem Sie mithilfe UpdateKey von.

• Domaineinschränkungen hinzufügen: Aktualisieren Sie einen vorhandenen Schlüssel, um die Nutzung auf bestimmte Webdomänen mithilfe von referrer-basierten Client-Einschränkungen zu beschränken.

• Schlüsselbestand prüfen: Listet alle Schlüssel im Konto auf, anhand derer ungenutzte oder ablaufende Schlüssel ListKeys für die Säuberung identifiziert werden.

• Widerruf eines kompromittierten Schlüssels: Deaktiviere einen Schlüssel sofort, indem du seinen Status mit aktualisierstUpdateKey, und lösche ihn dann nach 90 Tagen. DeleteKey