Wesloo
Alle ThemenThemen

Webtechnologien

Was ist CORS Policy? Grundlagen und Funktionsweise

Kurze Antwort

Mit CORS Policy legen Server über HTTP-Header fest, von welchen Origins ein Browser Ressourcen laden darf. Er erweitert die Same-Origin Policy kontrolliert und nutzt bei bestimmten Anfragen eine Preflight-Prüfung über OPTIONS. Falsche Konfigurationen können Sicherheitsrisiken erzeugen, besonders bei Anmeldedaten.

Das Wichtigste

  • CORS steuert im Browser, welche Origins auf Ressourcen einer anderen Origin zugreifen dürfen.
  • Bei Methoden wie PUT oder DELETE sowie bei application/json folgt oft ein OPTIONS-Preflight.
  • Access-Control-Allow-Origin legt die erlaubte Origin fest; bei Credentials ist ein Platzhalter nicht zulässig.
  • Fehlerdetails stehen nur in der Browserkonsole, nicht im JavaScript.
  • CORS ersetzt keine serverseitige Autorisierung.

Was ist CORS Policy im Verhältnis zur Same-Origin Policy?

Mit CORS Policy legt ein Server über HTTP-Header fest, von welchen Origins ein Browser Ressourcen laden darf. Eine Origin setzt sich aus Schema, Host und Port zusammen; weicht eine dieser drei Angaben ab, liegt ein Cross-Origin-Zugriff vor. Skriptbasierte Cross-Origin-Anfragen beschränken Browser aus Sicherheitsgründen; fetch() und XMLHttpRequest unterliegen der Same-Origin Policy. Fehlen passende CORS-Header, kann eine Webanwendung mit diesen APIs nur Ressourcen derselben Origin lesen. CORS erweitert diese Regel kontrolliert, statt sie aufzuheben.

Die Same-Origin Policy schützt Daten vor ungewolltem Zugriff zwischen verschiedenen Websites. CORS erlaubt gezielte Ausnahmen, wenn der Server der Zielressource dies ausdrücklich gestattet. Dabei setzt nicht die anfragende Anwendung die Erlaubnis, sondern der Server der externen Ressource. Das ist der zentrale Unterschied zu einer reinen Client-Einstellung.

Wie läuft eine Cross-Origin-Anfrage ab?

Der Browser sendet bei einer Cross-Origin-Anfrage einen Origin-Header mit. Der Server antwortet mit Access-Control-Allow-Origin, wenn er die anfragende Origin zulässt. Stimmt der Wert mit der Origin überein oder ist er als Platzhalter gesetzt, darf das Skript die Antwort lesen. Andernfalls blockiert der Browser den Zugriff auf die Antwort, obwohl die Anfrage den Server erreicht haben kann.

Diese Unterscheidung ist wichtig: CORS schützt nicht den Server vor Anfragen, sondern den Browser vor dem Lesen fremder Antworten. Direkte Aufrufe ohne Browser, etwa von Servern oder Kommandozeilenwerkzeugen, unterliegen nicht dieser Prüfung. Deshalb bleibt serverseitige Autorisierung unverzichtbar.

Wann sendet der Browser einen Preflight-Request?

Bei bestimmten Anfragen prüft der Browser vorab, ob der Server die eigentliche Anfrage zulässt. Dazu sendet er eine OPTIONS-Anfrage mit Access-Control-Request-Method und gegebenenfalls Access-Control-Request-Headers. Der Server antwortet mit den erlaubten Methoden, Headern und Origins. Erst danach folgt die eigentliche Anfrage, falls die Prüfung erfolgreich war.

Eine Vorprüfung lösen oft HTTP-Methoden wie PUT oder DELETE, eigene Header wie X-Requested-With oder X-Auth-Token sowie Content-Type: application/json aus. Anfragen mit GET, HEAD oder POST ohne zusätzliche Header lösen oft keine Vorprüfung aus. Der Begriff „simple request“ kommt aus einer veralteten CORS-Spezifikation; die Fetch-Spezifikation nutzt ihn nicht mehr.

Im Browser-Entwicklertool sieht man bei einer Preflight-Prüfung zuerst den OPTIONS-Request und danach die eigentliche Anfrage, sofern der Server sie erlaubt. Schlägt die Vorprüfung fehl, sendet der Browser die eigentliche Anfrage nicht. Das CORS-Protokoll verlangte dieses Verhalten ursprünglich, wurde später aber geändert. Nicht alle Browser haben diese Änderung umgesetzt, daher kann das Verhalten je nach Browser abweichen.

Preflight-Auslöser im Überblick

AuslöserBeispielFolge
HTTP-MethodePUT, DELETEPreflight über OPTIONS
Eigener HeaderX-Auth-TokenPreflight über OPTIONS
Content-Typeapplication/jsonPreflight über OPTIONS
Einfache AnfrageGET ohne Zusatzheaderoft keine Vorprüfung

Welche Header sind für CORS entscheidend?

Access-Control-Allow-Origin ist der zentrale Header. Er kann eine konkrete Origin oder einen Platzhalter enthalten. Access-Control-Allow-Methods nennt erlaubte HTTP-Methoden, Access-Control-Allow-Headers erlaubte Anfrageheader. Access-Control-Allow-Credentials steuert, ob Cookies, HTTP-Authentifizierung oder Client-Zertifikate mitgesendet werden dürfen.

Bei Anfragen mit Anmeldedaten darf der Server für Access-Control-Allow-Origin nicht den Platzhalter * verwenden. Stattdessen muss er die konkrete Origin zurückgeben und Access-Control-Allow-Credentials auf true setzen. Diese Kombination ist wirksam, aber riskant, wenn der Server den Origin-Wert ungeprüft zurückspiegelt.

Wichtige CORS-Header

HeaderBedeutung
Access-Control-Allow-Originerlaubte Origin oder Platzhalter
Access-Control-Allow-Methodserlaubte HTTP-Methoden
Access-Control-Allow-Headerserlaubte Anfrageheader
Access-Control-Allow-Credentialsob Anmeldedaten erlaubt sind

Warum ist CORS für moderne Webanwendungen wichtig?

Moderne Anwendungen nutzen oft APIs, Medien oder Dienste anderer Domains. CORS ermöglicht diesen kontrollierten Zugriff im Browser, ohne die Same-Origin Policy vollständig aufzuheben. Ohne CORS müssten Frontend und Backend dieselbe Origin teilen oder auf unsichere Umwege ausweichen.

Ein typischer Fall ist eine Single-Page-Anwendung, die Daten von einer API lädt. Die API kann CORS-Header setzen, um bestimmten Frontends den Zugriff zu erlauben. Ähnlich verhält es sich bei Webfonts oder anderen öffentlich nutzbaren Ressourcen, bei denen ein Platzhalter sinnvoll sein kann. Bei einer Was ist eine REST API Schnittstelle? Grundlagen ist CORS oft Teil der Integration zwischen Frontend und Backend.

Wer GraphQL-Endpunkte nutzt, trifft auf dieselben Regeln wie bei REST. Auch hier entscheidet der Server über Access-Control-Allow-Origin und gegebenenfalls Credentials. Ein Link zu GraphQL: Abfragesprache und Laufzeit für APIs kann bei der Einordnung von API-Architekturen helfen.

CORS mit Anmeldedaten

Cookies, HTTP-Authentifizierung und Client-Zertifikate machen Cross-Origin-Anfragen sensibler. Wenn ein Server Access-Control-Allow-Credentials auf true setzt, muss er die Origin exakt prüfen. Ein ungeprüftes Spiegeln des Origin-Werts kann fremden Websites ermöglichen, privilegierte Aktionen auszuführen oder sensible Daten abzurufen.

Ein Endpunkt, der Benutzername, E-Mail-Adresse oder API-Schlüssel zurückgibt, sollte daher keine beliebigen Origins mit Credentials akzeptieren. Die Kombination aus exakter Origin-Prüfung und Credentials ist der sicherere Weg. Öffentliche Ressourcen ohne personenbezogene Daten können dagegen mit einem Platzhalter freigegeben werden.

Was passiert bei CORS-Fehlern?

Schlägt eine CORS-Prüfung fehl, meldet der Browser einen Fehler. Aus Sicherheitsgründen erhält JavaScript keine Details zum genauen Grund; die Ursache lässt sich nur in der Browserkonsole nachvollziehen. Im Netzwerkprotokoll lässt sich oft erkennen, ob ein OPTIONS-Request fehlgeschlagen ist oder der Server den passenden Header nicht gesendet hat.

CORS-Fehler sind keine Serverfehler im klassischen Sinn. Der Server kann die Anfrage verarbeitet haben, aber der Browser verweigert dem Skript das Lesen der Antwort. Deshalb hilft oft die Prüfung des Endpunkts, der gesendeten Header und der Origin.

Welche Sicherheitsrisiken entstehen durch falsche CORS-Konfiguration?

CORS selbst ist kein Sicherheitsfehler, sondern ein kontrollierter Mechanismus. Gefährlich wird es, wenn Server Origins ungeprüft zurückspiegeln und gleichzeitig Anmeldedaten erlauben; dann können fremde Websites privilegierte Aktionen ausführen oder sensible Daten abrufen. Ein Beispiel aus der Praxis ist ein Endpunkt, der Benutzername, E-Mail-Adresse oder API-Schlüssel zurückgibt und dabei beliebige Origins mit Credentials akzeptiert.

Ein zu weiter Platzhalter kann problematisch sein, wenn sensible Daten betroffen sind; ein öffentlich zugänglicher Webfont kann dagegen für alle Origins freigegeben werden. Die Entscheidung sollte sich am Schutzbedarf der Daten orientieren, nicht am bequemsten Header.

Wie konfiguriert man CORS in der Praxis?

Die Konfiguration erfolgt serverseitig. Der Server muss die erlaubten Origins, Methoden und Header festlegen und bei Bedarf Credentials zulassen. Bei einer API, die von einem Frontend auf einer anderen Domain genutzt wird, sollte die erlaubte Origin möglichst genau angegeben werden. Wildcards sind für öffentliche, nicht sensible Ressourcen geeignet.

Bei der Entwicklung hilft ein Blick in die Browserkonsole und das Netzwerkprotokoll. Dort lassen sich fehlende Header, abgelehnte Methoden oder fehlgeschlagene Preflight-Prüfungen erkennen. CORS-Probleme lassen sich nicht durch Änderungen im Frontend allein lösen, weil der Browser die Serverantwort prüft.

Welche Anfragen benötigen CORS nicht?

Nicht jede cross-origin Interaktion benötigt CORS. Wenn eine Website eine Ressource nur einbettet, ohne ihre Daten zu lesen, oder nur in die externe Ressource schreibt, ist ein Datenleck weniger wahrscheinlich. Bilder, Stylesheets, Skripte, iframes und Videos lassen sich oft ohne CORS einbetten.

Browser werden bei Cross-Origin-Anfragen insgesamt vorsichtiger; neue Webfunktionen, die Anfragen auslösen, verlangen in der Regel CORS, unabhängig von ihrer Art. Deshalb sollte man nicht davon ausgehen, dass eine Funktion ohne CORS auskommt, nur weil sie keine Daten liest.

Browserverhalten und Grenzen von CORS

Moderne Browser unterstützen CORS; ältere Implementierungen können frühere Regeln befolgen, weil nicht alle Browser spätere Protokolländerungen umgesetzt haben. In der Praxis kann das Preflight-Verhalten je nach Browser leicht variieren.

CORS ist kein Ersatz für Authentifizierung oder Autorisierung. Es regelt, ob ein Browser einer Webseite das Lesen einer Antwort erlaubt. Server müssen weiterhin prüfen, wer auf welche Daten zugreifen darf. Wer CORS als Sicherheitsgrenze missversteht, riskiert Datenlecks trotz scheinbar korrekter Header.

Weitere häufige Fragen

Ist CORS eine Sicherheitslücke?

Nein. CORS ist ein kontrollierter Mechanismus, der Browsern erlaubt, bestimmte Cross-Origin-Antworten zu lesen. Gefährlich sind vor allem falsche Serverkonfigurationen, etwa ungeprüfte Origin-Spiegelung mit Credentials.

Warum sehe ich im Netzwerkprotokoll einen OPTIONS-Request?

Der Browser sendet diesen Preflight-Request, um Methoden, Header und Origins vorab zu prüfen. Die eigentliche Anfrage folgt nur, wenn der Server die Vorprüfung bestätigt.

Kann ich ein CORS-Problem im Frontend lösen?

Nein. Der Browser prüft die Antwort des Servers. Die erlaubten Origins, Methoden und Header müssen serverseitig gesetzt werden.

Was bedeutet Access-Control-Allow-Origin: *?

Der Server erlaubt allen Origins das Lesen der Antwort. Das ist für öffentliche Ressourcen geeignet, aber nicht für Daten mit Schutzbedarf oder Anmeldedaten.

Warum blockiert der Browser trotz gesetztem Header?

Mögliche Gründe sind eine nicht passende Origin, fehlende Methoden oder Header, ein fehlgeschlagener Preflight oder die Kombination aus Platzhalter und Credentials.

Verwandte Seiten

  • Client Side vs Server Side Rendering Unterschied

    SSR erzeugt das HTML auf dem Server, CSR im Browser. SSR kann erste Darstellung und Auffindbarkeit verbessern, CSR bietet mehr Interaktivität bei höherem Aufwand im Browser.

  • Was ist WebSocket? Protokoll und Anwendung

    WebSocket ist ein standardisiertes Netzwerkprotokoll, das eine dauerhafte, bidirektionale Verbindung zwischen Client und Server über einen einzelnen TCP-Kanal bereitstellt. Nach einem anfänglichen Handshake können beide Parteien jederzeit ohne erneute HTTP-Anfragen Daten austauschen. Das Protokoll eignet sich vor allem für Anwendungen mit hohem Bedarf an Datenübertragungen in Echtzeit bei minimaler Latenz.

  • Web-Cookies: Funktionsweise, Typen und Sicherheit

    Web-Cookies sind kompakte Textdateien, die ein Webserver über HTTP-Header an den Browser übermittelt, um die prinzipielle Zustandslosigkeit von HTTP auszugleichen. Der Browser speichert diese Datensätze lokal ab und sendet sie bei nachfolgenden Anfragen automatisch an denselben Host zurück. Auf diese Weise lassen sich Anmeldesitzungen, Spracheinstellungen und Warenkörbe zuverlässig aufrechterhalten.

  • Webcache: Funktionsweise, Typen und Cache-Control

    Ein Webcache speichert Kopien von Webressourcen lokal, damit wiederholte Aufrufe schneller laden und weniger Daten übertragen werden. Server steuern die Frische über HTTP-Header wie Cache-Control, während Browser alte Einträge bei Bedarf entfernen. Das Leeren hilft vor allem bei veralteten oder beschädigten Dateien, nicht bei Passwörtern oder Einstellungen.

  • GraphQL: Abfragesprache und Laufzeit für APIs

    GraphQL ist eine Abfragesprache und Laufzeit für APIs. Clients bestimmen, welche Felder und verknüpften Daten sie in einer Operation erhalten. Ein stark typisiertes Schema beschreibt die verfügbaren Typen, Felder und Operationen.

  • Was ist eine REST API Schnittstelle? Grundlagen

    Eine REST API ist eine besondere Form von API, die REST-Regeln über HTTP anwendet und mit Ressourcen arbeitet. Sie ist eine API, doch APIs können auch anderen Regeln folgen.

Wie diese Seite entstanden ist

Vor dem Schreiben wurde das Thema in den unten genannten Quellen recherchiert. Danach hat die Seite automatische Qualitätsprüfungen bestanden.

Einen Fehler auf dieser Seite melden