GeoIP-Header (Request-Metadaten)

Wenn smoxy Anfragen an deine Origin-Server weiterleitet, fügt es automatisch eine Reihe von HTTP-Headern hinzu, die Geolokalisierungs- und Netzwerk-Metadaten basierend auf der IP-Adresse des Clients enthalten. Diese GeoIP-Header ermöglichen personalisierte Inhalte, automatische Sprachumschaltung, regionale Compliance und detaillierte Analysen – direkt am Edge, bevor die Anfrage deinen Server erreicht.

Auch bekannt als: GeoIP-Header, Edge-Header, IP-Geolokalisierungs-Header, Standort-Header, Geo-Header

Übersicht

Diese Header werden von smoxy automatisch zu jeder eingehenden Anfrage hinzugefügt. Sie enthalten Informationen wie den ungefähren Standort des Benutzers, dessen Netzwerkprovider sowie einen EU-Status. Die Daten werden in Echtzeit aus der IP-Adresse ermittelt, datenschutzfreundlich und performant.

Verfügbare Header

Header
Beschreibung

s-asn

ASN (Autonomous System Number) des Netzwerks des Clients

s-asorg

Name der Organisation, die dem ASN zugeordnet ist (z. B. „Cloudflare, Inc.“)

s-country

Ländercode gemäß ISO 3166-1 alpha-2 (DE, US usw.)

s-city

Ungefähre Stadt

s-latitude

Ungefähre geografische Breite

s-longitude

Ungefähre geografische Länge

s-subdivisions

ISO 3166-2 Region/Subdivisions-Code (z. B. DE-BY)

s-iseu

Gibt an, ob sich der Nutzer innerhalb der EU befindet (1 = ja, 0 = nein)

Diese Werte eignen sich zur Umsetzung standortbasierter Funktionen direkt im Backend.

Anwendungsfälle

Sprachweiterleitung

Automatische Umleitung je nach Herkunftsland:

$country = $_SERVER['HTTP_S_COUNTRY'] ?? 'US';

$language = match ($country) {
    'DE' => 'de',
    'FR' => 'fr',
    default => 'en',
};

header("Location: /{$language}/");
exit;

DSGVO / EU-Hinweise

Nutze s-iseu, um z. B. nur für EU-Nutzer Cookie-Banner anzuzeigen:

if ($_SERVER['HTTP_S_ISEU'] === '1') {
    // DSGVO-Zustimmungs-UI anzeigen
}

Routing oder Blockierung basierend auf IP oder ASN

Blockiere z. B. bestimmte Netzwerke:

$asn = $_SERVER['HTTP_S_ASN'] ?? null;

if ($asn === '12389') {
    http_response_code(403);
    exit('Zugriff für dieses Netzwerk verweigert');
}

Erweiterte Logs / Analytics

Logge s-country oder s-asorg, um Traffic nach Regionen oder Netzwerken auszuwerten.

Integration & Hinweise

  • Alle Header sind mit s- vorangestellt, um Konflikte mit Standard-HTTP-Headern zu vermeiden.

  • Die Werte werden von smoxy am Edge eingefügt – sie stehen sofort im Backend zur Verfügung.

  • Kein zusätzlicher Client-Code notwendig – ideal für schnelle Serverlogik ohne JS-Abhängigkeit.

Best Practices

  • Geodaten sind ungefähre Angaben – für grobe Personalisierung geeignet, aber nicht für exakte Standortentscheidungen.

  • Setze Fallbacks für Umgebungen ohne Header (z. B. lokale Entwicklung).

  • Logge die Headerwerte bei Bedarf zu Debugging- oder Analysezwecken.

Last updated

Was this helpful?