Startseite › Entwickler-Tools › CORS-Tester

CORS-Tester

Sende eine echte Cross-Origin-Anfrage aus deinem Browser an eine beliebige URL, mit eigener Methode, eigenen Headern, Body und Credentials-Modus, und finde heraus, ob CORS sie erlaubt. Schlägt sie fehl, zeigen Folgetests, ob die Ursache der Preflight, die Credentials, ein fehlender Access-Control-Allow-Origin-Header oder das Netzwerk ist.

Zuletzt aktualisiert:

Ausprobieren:

Anfrageanalyse

    Von deinem Browser gesendeter Origin:

    Auf dem Server prüfen und beheben

    Browser verbergen CORS-Header vor Skripten. Führe dies mit curl aus, um genau zu sehen, was der Server zurückgibt:

    
    

    Der Server muss mit Headern wie diesen antworten (passe sie an deinen Bedarf an):

    
    
    Anzeige
    Anzeige

    Anleitung: CORS-Tester

    1. Gib die API-URL ein und wähle die HTTP-Methode.
    2. Füge Header und einen Body hinzu, so wie dein Front-End sie sendet, zum Beispiel Authorization oder Content-Type: application/json.
    3. Wähle den Credentials-Modus: include sendet Cookies, was strengere Server-Header erfordert.
    4. Sieh dir die Anfrageanalyse an, um zu erfahren, ob der Browser einen Preflight sendet, und klicke dann auf Anfrage senden.
    5. Lies das Ergebnis und kopiere dann den curl-Befehl und die erforderlichen Header, um den Server zu korrigieren.

    CORS-Antwort-Header erklärt

    HeaderGesendet beiZweck
    Access-Control-Allow-OriginJeder AntwortDer Origin, der die Antwort lesen darf, oder * für jeden Origin (nicht mit Credentials)
    Access-Control-Allow-MethodsPreflightFür die eigentliche Anfrage erlaubte Methoden, etwa GET, POST, PUT, DELETE
    Access-Control-Allow-HeadersPreflightRequest-Header, die die Seite senden darf, etwa authorization, content-type
    Access-Control-Allow-CredentialsBeidemtrue erlaubt Anfragen mit Cookies oder HTTP-Authentifizierung, die Antwort zu lesen
    Access-Control-Expose-HeadersEigentlicher AntwortZusätzliche Antwort-Header, die Skripte lesen dürfen, etwa x-total-count
    Access-Control-Max-AgePreflightSekunden, die der Browser das Preflight-Ergebnis zwischenspeichern darf (Browser begrenzen das, Chrome auf 2 Stunden)
    Vary: OriginJeder AntwortVerhindert, dass Caches die CORS-Antwort eines Origins an einen anderen Origin ausliefern

    Häufige CORS-Fehler und ihre Lösungen

    • No 'Access-Control-Allow-Origin' header is present: Der Server sendet überhaupt keine CORS-Header oder nur bei erfolgreichen Antworten. Füge den Header zu jeder Antwort hinzu, auch bei 4xx- und 5xx-Fehlern.
    • Response to preflight request doesn't pass access control check: Die OPTIONS-Anfrage gibt 401, 404 oder 405 zurück. Verarbeite OPTIONS vor Authentifizierung und Routing und gib 204 mit den Allow-Headern zurück.
    • Request header field authorization is not allowed: Füge den Header-Namen zu Access-Control-Allow-Headers hinzu.
    • The value of the header must not be the wildcard '*' when credentials mode is 'include': Gib den Origin der Anfrage zurück (aus einer Erlaubnisliste) und füge Access-Control-Allow-Credentials: true hinzu.
    • Redirect is not allowed for a preflight request: Die URL leitet weiter (zum Beispiel von http auf https oder wegen eines fehlenden Schrägstrichs am Ende). Rufe direkt die endgültige URL auf.

    Beispiel für nginx: add_header Access-Control-Allow-Origin $http_origin always; kombiniert mit einer Map als Erlaubnisliste und if ($request_method = OPTIONS) { return 204; }. In Express verarbeitet die Middleware cors mit { origin: ['https://app.example.com'], credentials: true } sowohl Preflight als auch eigentliche Antworten.

    Häufige Fragen

    Was ist CORS?

    Cross-Origin Resource Sharing ist die Browserregel, die entscheidet, ob JavaScript auf einem Origin (Schema, Host und Port) eine Antwort von einem anderen Origin lesen darf. Der Server stimmt zu, indem er Header wie Access-Control-Allow-Origin sendet. Ohne sie sendet der Browser viele Anfragen trotzdem, verbirgt die Antwort aber vor der Seite.

    Was ist eine Preflight-Anfrage?

    Vor einer nicht einfachen Anfrage sendet der Browser eine OPTIONS-Anfrage mit Access-Control-Request-Method und Access-Control-Request-Headers, um um Erlaubnis zu fragen. Eine Anfrage ist nur dann einfach, wenn sie GET, HEAD oder POST verwendet, nur freigegebene Header wie Accept enthält und einen Content-Type von text/plain, multipart/form-data oder application/x-www-form-urlencoded hat. Das Senden von JSON oder eines Authorization-Headers löst immer einen Preflight aus.

    Warum kann das Tool den Header Access-Control-Allow-Origin nicht anzeigen?

    Browser lassen Skripte die meisten Antwort-Header nicht lesen, auch nicht die CORS-Header, und bei einem CORS-Fehler geben sie überhaupt keine Details preis. Deshalb führt das Tool zusätzliche Tests durch, um die Ursache einzugrenzen, und gibt dir einen curl-Befehl, der die rohen Header zeigt, die der Server zurückgibt.

    Warum funktioniert meine Anfrage in Postman oder curl, aber nicht im Browser?

    CORS wird nur von Browsern durchgesetzt. Postman, curl und serverseitiger Code ignorieren es, daher fällt ein fehlender Access-Control-Allow-Origin-Header nur im Front-End-Code auf. Behebe es auf dem API-Server oder leite den Aufruf über dein eigenes Back-End.

    Kann ich Access-Control-Allow-Origin: * mit Cookies verwenden?

    Nein. Wenn die Anfrage Credentials verwendet (Cookies oder HTTP-Authentifizierung), muss der Server den exakten Origin zurückgeben und Access-Control-Allow-Credentials: true senden. Ein Platzhalter-Origin wird vom Browser in diesem Fall abgelehnt. Füge außerdem Vary: Origin hinzu, damit Caches Antworten pro Origin speichern.

    Welchen Origin verwendet dieser Test?

    Die Anfrage wird von dieser Seite gesendet, daher ist der Origin-Header freetoolcabin.com. Wenn deine API nur den Origin deiner eigenen Website erlaubt, zeigt der Test „blockiert“, obwohl deine Website funktioniert. Nutze den curl-Befehl mit deinem echten Origin zur Bestätigung.

    Wird meine Anfrage über FreeToolCabin gesendet?

    Nein. Die Anfrage geht direkt von deinem Browser an die eingegebene URL. Es gibt keinen Proxy, und nichts wird gespeichert. Füge auf gemeinsam genutzten Computern keine Produktions-Geheimnisse in Header ein.

    Werden alle Tools auf FreeToolCabin auf Qualität und Genauigkeit getestet?

    Ja. Jedes Tool auf der Website durchläuft automatische Tests in echten Browsern, die prüfen, ob das Ergebnis stimmt und keine Fehler auftreten. Wenn du einen Fehler findest oder einen Vorschlag hast, schreib uns an [email protected] – wir sehen es uns an.

    Ähnliche Tools

    Alle Netzwerk-, DNS- & E-Mail-Tools ansehen →