> For the complete documentation index, see [llms.txt](https://docs.metasleuth.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.metasleuth.io/de/blocksec-aml-api/introduction/authentication.md).

# Authentifizierung

Jede API-Anfrage muss einen API-Schlüssel enthalten. Unter Security Settings können Sie IP Allowlist, Request Signing oder beides hinzufügen, um Ihren API-Zugriff zu schützen.

## API-Schlüssel abrufen

1. Melden Sie sich bei [MetaSleuth](https://metasleuth.io) an.
2. Öffnen Sie [Settings → APIs → API Keys](https://metasleuth.io/system/settings/personal/apis).
3. Erstellen Sie den API-Schlüssel für den gewünschten Dienst oder zeigen Sie ihn an.

Address Label API und Risk Score API verwenden separate API-Schlüssel und API-Secrets. Verwenden Sie die Zugangsdaten des jeweiligen Dienstes.

Wenn Sie einen angepassten API-Dienst über unser Vertriebsteam beziehen, erhalten Sie Zugangsdaten und geltende Einrichtungshinweise von Ihrem zuständigen Ansprechpartner.

## API-Schlüssel verwenden

Fügen Sie jeder Anfrage den Header `Api-Key` hinzu. Halten Sie den Schlüssel geheim und verwenden Sie ihn nur in serverseitigen Anwendungen. Er darf nicht in der Versionsverwaltung, in Browser- oder mobilen Anwendungspaketen, URLs oder Protokollen stehen. Verwenden Sie HTTPS mit aktivierter Zertifikatsprüfung.

Das folgende Beispiel liest den Schlüssel aus einer Umgebungsvariablen. Vermeiden Sie Shell-Tracing (`set -x`) und ausführliche HTTP-Protokolle beim Umgang mit Zugangsdaten.

Das folgende Beispiel verwendet Ihren Risk Score API-Schlüssel:

```sh
curl --request GET \
  --header "Api-Key: ${MS_API_KEY}" \
  'https://aml.blocksec.com/address-compliance/api/v3/chain-list'
```

Dieses Beispiel enthält nur die Authentifizierung per API-Schlüssel. Bei aktivierter IP Allowlist senden Sie die Anfrage von einer erlaubten öffentlichen Ausgangs-IP. Ist Request Signing erforderlich, fügen Sie die unter [Request Signing](https://docs.metasleuth.io/de/blocksec-aml-api/introduction/request-signing.md) beschriebenen Signatur-Header hinzu.

## Zusätzliche Sicherheitsprüfungen

| Sicherheitsmethode | Anforderung an die Anfrage                                                                                                           |
| ------------------ | ------------------------------------------------------------------------------------------------------------------------------------ |
| IP Allowlist       | Die öffentliche Quell-IP muss einer erlaubten IP-Adresse oder einem CIDR-Bereich entsprechen.                                        |
| Request Signing    | Sobald Signaturen erforderlich sind, muss jede Anfrage eine gültige Signatur, einen Zeitstempel und eine eindeutige Nonce enthalten. |
| Beide              | Die Anfrage muss beide Prüfungen bestehen.                                                                                           |

Wir empfehlen mindestens eine Sicherheitsmethode. Zeigt die API-Verwaltung eine Einrichtungsfrist an, schließen Sie die Einrichtung rechtzeitig ab, um Unterbrechungen zu vermeiden. Das Erstellen eines Secrets allein schließt die Einrichtung nicht ab.

Einrichtungsschritte finden Sie unter [API Security Settings](https://docs.metasleuth.io/de/blocksec-aml-api/introduction/api-security-settings.md), Signaturanweisungen unter [Request Signing](https://docs.metasleuth.io/de/blocksec-aml-api/introduction/request-signing.md).
