Wie aktiviere ich die IP-Adressbeschränkung für meine Binance-API-Schlüssel?

Grundlegendes zur IP-Adressbeschränkung

1. Die IP-Adressbeschränkung ist eine Sicherheitsschicht, die einen API-Schlüssel an bestimmte IPv4-Adressen oder CIDR-Bereiche bindet.

2. Anfragen von IP-Adressen, die nicht in der Whitelist aufgeführt sind, werden mit dem Status „HTTP 401 Nicht autorisiert“ abgelehnt.

3. Dieser Mechanismus verhindert die unbefugte Verwendung geleakter Anmeldeinformationen, selbst wenn der geheime Schlüssel kompromittiert ist.

4. Die Funktion gilt ausschließlich für REST- und WebSocket-API-Aufrufe – nicht für Webschnittstellenanmeldungen oder mobile App-Sitzungen.

5. Binance erzwingt eine strikte Validierung: Leere Felder, Platzhaltereinträge wie 0.0.0.0/0 oder fehlerhafte CIDR-Syntax lösen eine sofortige Ablehnung der Konfiguration aus.

Navigieren in der API-Management-Schnittstelle

1. Melden Sie sich mit verifizierter 2FA bei Ihrem Binance-Konto an und navigieren Sie zu Benutzercenter → Sicherheit → API-Verwaltung .

2. Suchen Sie die Ziel-API-Schlüsselzeile und klicken Sie ganz rechts auf die Schaltfläche Bearbeiten .

3. Scrollen Sie nach unten zum Abschnitt IP-Whitelist-Einstellungen – dieser Bereich bleibt ausgeblendet, es sei denn, der Schlüssel wurde mit aktivierter Whitelist erstellt.

4. Klicken Sie auf den Kippschalter mit der Bezeichnung „IP-Whitelist aktivieren “; Dadurch wird das Eingabefeld für IPv4-Adressen angezeigt.

5. Geben Sie eine oder mehrere durch Kommas getrennte IPv4-Adressen (z. B. 203.0.113.42, 198.51.100.0/24) ohne Leerzeichen vor oder nach Kommas ein.

Validierung Ihrer IP-Konfiguration

1. Verwenden Sie ipinfo.io oder whatismyipaddress.com , um die öffentliche IPv4-Adresse Ihres Handelsservers oder lokalen Computers zu bestätigen.

2. Rufen Sie bei der Bereitstellung in einer Cloud-Infrastruktur die ausgehende NAT-IP – nicht die private LAN-Adresse – von der Konsole Ihres Anbieters ab.

3. Vermeiden Sie dynamische IP-Adressen für Privathaushalte. Konfigurieren Sie stattdessen eine statische IP oder verwenden Sie einen VPS mit festem Egress-Routing.

4. Testen Sie nach dem Speichern der Änderungen die Konnektivität, indem Sie GET /api/v3/time nur vom Host auf der Whitelist aufrufen.

5. Eine erfolgreiche Antwort bestätigt die korrekte Bindung; Ein Fehler weist entweder auf eine falsch konfigurierte IP- oder DNS-basierte Auflösung hin, die die beabsichtigte Route umgeht.

Verwalten mehrerer Bereitstellungsumgebungen

1. Erstellen Sie für Entwicklungs-, Staging- und Produktionsumgebungen separate API-Schlüssel – jeder mit seiner eigenen dedizierten IP-Liste.

2. Verwenden Sie niemals einen einzelnen Schlüssel umgebungsübergreifend wieder. Durch umgebungsübergreifende Leckagen werden Isolationsgarantien untergraben.

3. Aktualisieren Sie beim Schlüsselwechsel gleichzeitig die IP-Whitelist – eine verzögerte Synchronisierung führt zu vorübergehenden Zugriffslücken.

4. Überwachen Sie fehlgeschlagene Anforderungsprotokolle über die Registerkarte „API-Aktivitätsverlauf“ von Binance, um unerwartete Quell-IPs zu erkennen, die Zugriff versuchen.

5. Deaktivieren Sie ältere Schlüssel sofort, nachdem Sie sich vergewissert haben, dass die neuen ordnungsgemäß funktionieren. Behalten Sie überlappende aktive Schlüssel nicht länger als nötig bei.

Häufig gestellte Fragen

F: Kann ich IPv6-Adressen in der Binance IP-Whitelist verwenden? Nein. Binance unterstützt derzeit nur IPv4-Adressen und CIDR-Notation. IPv6-Einträge werden während der Validierung stillschweigend ignoriert.

F: Was passiert, wenn sich die öffentliche IP meines Servers ändert, während die Whitelist aktiv ist? Alle API-Anfragen von der neuen IP schlagen mit dem Fehlercode -1015 fehl, bis die aktualisierte Adresse manuell zur Whitelist hinzugefügt wird.

F: Hat die Aktivierung von IP-Whitelisting Auswirkungen auf WebSocket-Verbindungen? Ja. WebSocket-Endpunkte wie stream.binance.com:9443 erzwingen dieselben IP-Einschränkungen wie REST-Endpunkte.

F: Gibt es eine Grenze dafür, wie viele IPs ich zu einer einzelnen Whitelist hinzufügen kann? Binance erlaubt bis zu 20 verschiedene IPv4-Adressen oder CIDR-Blöcke pro API-Schlüssel. Das Überschreiten dieser Anzahl löst beim Speichern den Fehler „Zu viele IPs“ aus.