Source: https://cryptanio.com/de/wiki/api-schluessel-ein-projekt/ Language: de # So beschränken Sie einen API\-Schlüssel auf ein Projekt Erstellen Sie einen eigenen Schlüssel für den serverseitigen Rechnungsabgleich eines Projekts\: Wählen Sie Projekt\, Lesezugriff und benötigten API\-Abschnitt\, richten Sie IP\-Regeln und Ablaufzeit ein und prüfen Sie die Zugriffsgrenze\. Aktualisiert: 2026-11-14 Ein API\-Schlüssel lässt sich an ein einzelnes Cryptanio\-Projekt binden\. Als Beispiel dient ein Bestellabgleich\, der die [Rechnungen]() eines Onlineshops lesen soll\, aber keine Daten der anderen Kontoprojekte benötigt\. Dafür braucht er einen eigenen Schlüssel\: Die Projektbindung bestimmt den Datenbereich\, Berechtigungen und API\-Abschnitte bestimmen die erlaubten Vorgänge\. Weder der Schlüsselname noch eine Projektnummer in Ihrer Anwendung beschränken den Zugriff für sich genommen\. Die Einschränkung muss in der Schlüsselrichtlinie gespeichert sein\. Der Zugriff gilt für die öffentliche API v1\. Der Schlüssel ist kein Passwort zur Anmeldung im Kundenbereich\. ## 1\. Bereiten Sie Projekt und Berechtigungen vor {#1-bereiten-sie-projekt-und-berechtigungen-vor} Sie benötigen Kontoinhaber\- oder Administratorrechte und ein bestehendes aktives Projekt mit dem Dienst „Zahlungen“\. Prüfen Sie zuerst\, ob Name und Zweck eindeutig sind\: Die Wahl des falschen Projekts kann einen gültigen Schlüssel mit unpassendem Zugriffsbereich erzeugen\. Öffnen Sie „API Schlüssel“\. Tragen Sie im Formular „API\-Schlüssel erstellen“ eine „Bezeichnung“ ein\, etwa „Shop\-Abgleich“\. Ein eigener Name hilft bei der Unterscheidung der Serverprozesse\. Der eigentliche Schutz wird aber in den folgenden Feldern eingestellt\. ## 2\. Wählen Sie Modus und konkretes Projekt {#2-w-hlen-sie-modus-und-konkretes-projekt} Um echte Rechnungen zu lesen\, wählen Sie unter „Modus“ die Option „Produktion“\. Der Schlüssel muss zum Modus der Daten passen\, die Ihr Server abfragt\. Wählen Sie unter „Projekt“ das benötigte Projekt statt „Alle Projekte“\. Der Kundenbereich zeigt einen Hinweis auf die Beschränkung auf den Dienst des gewählten Projekts\. Projektbindung und Dienstzugriff gelten zusammen\. Der Schlüssel aktiviert den Dienst nicht und erweitert dessen Fähigkeiten nicht von selbst\. ## 3\. Behalten Sie nur den Lesezugriff auf Rechnungen {#3-behalten-sie-nur-den-lesezugriff-auf-rechnungen} Wählen Sie unter „Zugang“ die Option „Lesen Sie nur“\. Lassen Sie bei „API Abschnitte“ nur „Rechnungen“ ausgewählt und entfernen Sie nicht benötigte Häkchen\. Für einen gewöhnlichen Rechnungsstatusabgleich ist keine Verwaltung von Adressen\, Webhooks oder Simulation erforderlich\. Soll ein anderer Server Rechnungen erstellen\, benötigt er „Lesen und schreiben“ sowie den entsprechenden Abschnitt\. Geben Sie ihm einen eigenen Schlüssel mit klarem Zweck\, statt die Rechte des Abgleichprozesses unnötig zu erweitern\. Schreibzugriff gilt innerhalb der gewählten Abschnitte und öffnet nicht die gesamte API\. ## 4\. Richten Sie IP\-Regeln und Ablaufzeit ein {#4-richten-sie-ip-regeln-und-ablaufzeit-ein} Tragen Sie unter „Erlaubte IP\-Adressen“ die öffentlichen ausgehenden IP\-Adressen Ihres Servers oder die nötigen CIDR\-Bereiche ein\, jeweils eine Angabe pro Zeile\. Gemeint ist die Adresse\, von der die Anfrage bei der API ankommt\, nicht die IP des Käufers\. Klären Sie bei Hosting oder Proxy die tatsächliche Ausgangsadresse\. Ein leeres Feld erlaubt jede IP\. Verwendet der Server mehrere Ausgangsadressen\, berücksichtigen Sie diese\; andernfalls kann auch ein gültiger Schlüssel an der Prüfung scheitern\. IP\-Regeln ergänzen die Projekt\- und Abschnittsauswahl\, statt sie zu ersetzen\. Stellen Sie bei Bedarf „Läuft ab“ ein\. Das gewählte Datum gilt bis zum Ende dieses Tages in UTC\. Stimmen Sie es mit dem Betriebszeitraum der Integration ab\. Ein abgelaufener Schlüssel bedeutet nicht\, dass ein Kunde nicht bezahlt hat\. ## 5\. Erstellen Sie den Schlüssel und speichern Sie den geheimen Schlüsselwert {#5-erstellen-sie-den-schl-ssel-und-speichern-sie-den-geheimen-schl-sselwert} Klicken Sie auf „Schlüssel erstellen“ und führen Sie die Sicherheitsbestätigung durch\, falls sie verlangt wird\. Kopieren Sie den Geheimwert aus dem angezeigten Fenster und speichern Sie ihn auf dem Abgleichserver\. Er gehört nicht in clientseitiges JavaScript\, Zahlungslinks\, die Kommunikation mit dem Käufer oder öffentliche Logs\. Rechnen Sie nach dem Schließen des Fensters nicht damit\, den Geheimwert aus der Liste wiederherstellen zu können\. Dort erscheint nur eine gekürzte Schlüsselkennung\. Prüfen Sie „Grenze“\, Projekt\, verfügbare Abschnitte\, Ablaufzeit und Status\. Benötigt ein Entwickler Zugriff\, geben Sie ihn über einen geeigneten sicheren Speicher weiter\, statt den Schlüssel zusammen mit der Anleitung zu veröffentlichen\. ## 6\. Prüfen Sie erlaubten und verweigerten Zugriff {#6-pr-fen-sie-erlaubten-und-verweigerten-zugriff} Lesen Sie von einem Server mit erlaubter IP eine bekannte Rechnung dieses Projekts\. Unten steht ein Lesebeispiel aus dem API\-Katalog\. Verwenden Sie Ihre eigene Rechnungs\-ID und den erstellten Schlüssel\: ```bash #!/usr/bin/env bash set -euo pipefail : "${CRYPTANIO_RESOURCE_ID:?Set CRYPTANIO_RESOURCE_ID}" : "${CRYPTANIO_API_KEY:?Set CRYPTANIO_API_KEY}" urlencode() { local LC_ALL=C text="$1" char index for ((index=0; index<${#text}; index++)); do char="${text:index:1}" case "$char" in [a-zA-Z0-9.~_-]) printf '%s' "$char" ;; *) printf '%%%02X' "'$char" ;; esac done } response_file="$(mktemp)" trap 'rm -f "$response_file"' EXIT transfer_status=0 http_status="$(curl \ --silent --show-error --max-time 30 --request GET \ --header "Authorization: Bearer $CRYPTANIO_API_KEY" \ --header 'Accept: application/json' \ "https://api.cryptanio.com/v1/invoices/$(urlencode "$CRYPTANIO_RESOURCE_ID")" \ --output "$response_file" --write-out '%{http_code}')" || transfer_status=$? if [[ "$http_status" == 2?? ]]; then cat "$response_file" exit "$transfer_status" fi printf 'HTTP %s\n' "$http_status" >&2 cat "$response_file" >&2 exit 1 ``` [Beispiel herunterladen]() Prüfen Sie die Grenze anschließend mit einer bekannten Rechnung aus einem anderen Ihrer Projekte\. Deren Daten dürfen nicht zurückgegeben werden\. Auch Listen müssen auf das gewählte Projekt beschränkt bleiben\. Dieser Schlüssel darf keine Rechnungen erstellen oder ändern\, selbst wenn „Rechnungen“ aktiviert ist\. Den weiteren Abgleich beschreibt die [Anleitung zur Zahlungsprüfung per API]()\. Schlägt eine Anfrage fehl\, prüfen Sie Projekt\, Modus\, IP\, Ablaufzeit und Berechtigungen\. Schließen Sie aus einem einzelnen Zugriffsfehler nicht auf eine fehlende Zahlung und ersetzen Sie den eingeschränkten Schlüssel nicht durch einen kontoweiten\. Zahlungen werden anhand des [Rechnungsstatus]() bewertet\. ## So passen Sie den Zugriff später an {#so-passen-sie-den-zugriff-sp-ter-an} Klicken Sie bei einem vorhandenen Schlüssel auf „Zugang“\, ändern Sie Projekt\, Abschnitte\, IP\-Regeln oder Ablaufzeit und wählen Sie „Zugang speichern“\. Der Modus wird beim Erstellen festgelegt\. „Erneuern“ ändert den Geheimwert und deaktiviert den bisherigen sofort\; „Widerrufen“ beendet die Nutzung des Schlüssels\. Bereiten Sie vor dem Austausch die Aktualisierung der Serverclients vor\, damit der Bestellabgleich nicht ausfällt\. Schlagwörter: [Zahlungen](https://cryptanio.com/de/wiki/tag/payments/), [API](https://cryptanio.com/de/wiki/tag/api/) ## Verwandte Artikel - [Was ist eine Zahlungsrechnung](https://cryptanio.com/de/wiki/was-ist-eine-rechnung/) - [Zahlungen über die API ohne Webhook prüfen](https://cryptanio.com/de/wiki/zahlung-api-ohne-webhook-pruefen/) - [So nehmen Sie USDC\-Zahlungen auf Ihrer Website an](https://cryptanio.com/de/wiki/usdc-zahlungen-website-annehmen/)