API-Schlüsselkonzepte

Ein API-Schlüssel ist ein Berechtigungsnachweis, der einen Klartext-Schlüsselwert bestimmten Amazon Location Service Service-Ressourcen und zulässigen Aktionen zuordnet. Wenn Ihre Anwendung einen API-Schlüssel in einer Anfrage enthält, autorisiert Amazon Location Service die Anfrage auf der Grundlage der Konfiguration des Schlüssels, ohne dass eine weitere Authentifizierung erforderlich ist.

Schlüsselwert

Die Klartext-Zeichenfolge, die zur Authentifizierung von API-Anfragen verwendet wird. Die Schlüsselwerte folgen dem Formatv1.public.a1b2c3d4.... Sie nehmen diesen Wert als key Parameter in API-Anfragen auf.

Einschränkungen

Steuerelemente, die definieren, was ein API-Schlüssel bewirken kann. Zu den Einschränkungen gehören erlaubte Aktionen (welche APIs der Schlüssel aufrufen kann) und erlaubte Ressourcen (auf welche Ressourcen der Schlüssel zugreifen kann). Sie konfigurieren Einschränkungen, wenn Sie einen Schlüssel erstellen oder aktualisieren.

Client-Einschränkungen

Optionale Beschränkungen dafür, wo ein API-Schlüssel verwendet werden kann. Sie können einen Schlüssel auf bestimmte Webdomänen (mithilfe des HTTP-Referer-Headers), Android-Anwendungen (mithilfe des Paketnamens und Signaturzertifikats) oder Apple-Anwendungen (mithilfe der Bundle-ID) beschränken.

Ablauf

Ein optionaler Zeitstempel, nach dessen Ablauf der API-Schlüssel automatisch deaktiviert wird. Verwenden Sie das Ablaufdatum, um eine regelmäßige Schlüsselrotation zu erzwingen oder temporäre Schlüssel zu erstellen. Schlüssel ohne Ablaufzeit bleiben auf unbestimmte Zeit aktiv.

Status des Schlüssels

Ein API-Schlüssel ist entweder aktiv (kann für Anfragen verwendet werden) oder inaktiv (deaktiviert, entweder manuell oder nach Ablauf). Inaktive Schlüssel können Anfragen nicht authentifizieren und können nach 90 Tagen gelöscht werden.