Урок 022 минуты чтения
Что такое preflight request?
На этой странице
Кратко
Preflight - предварительный OPTIONS request, который browser отправляет перед некоторыми cross-origin запросами. Он проверяет, разрешает ли server настоящий method, headers и credentials.
Вопрос
Что такое preflight request? Какие запросы считаются простыми и когда браузер отправляет OPTIONS?
Когда появляется preflight?
Preflight часто появляется, если request:
- использует method не из простых, например
PATCHилиDELETE; - отправляет
Authorizationheader; - отправляет custom header;
- использует не-simple
Content-Type, напримерapplication/json.
Как выглядит preflight?
OPTIONS /api/orders HTTP/1.1
Origin: https://app.example.com
Access-Control-Request-Method: POST
Access-Control-Request-Headers: content-type, authorizationServer должен ответить:
HTTP/1.1 204 No Content
Access-Control-Allow-Origin: https://app.example.com
Access-Control-Allow-Methods: GET, POST, PATCH, DELETE
Access-Control-Allow-Headers: content-type, authorization
Access-Control-Allow-Credentials: trueПосле этого browser отправит настоящий request.
Почему request "не доходит" до backend controller?
Если preflight не прошел, настоящий request не отправится. В логах controller ты его не увидишь.
Нужно смотреть OPTIONS request в Network tab.
Access-Control-Max-Age
Access-Control-Max-Age: 600Этот header говорит browser, сколько секунд можно кешировать результат preflight. Это уменьшает количество OPTIONS requests.
Что важно помнить
- Простой запрос: метод
GET,HEADилиPOST, только «безопасные» headers иContent-Typeизtext/plain,multipart/form-data,application/x-www-form-urlencoded. - Preflight выполняется без cookies и без
Authorization, поэтому сервер не должен требовать авторизацию дляOPTIONS. - Chrome ограничивает
Access-Control-Max-Ageдвумя часами, Firefox — сутками: большее значение будет урезано. - Простые запросы не защищены preflight-ом, поэтому сервер всё равно обязан проверять origin и права для state-changing запросов.
Мини-шпаргалка
- Preflight -
OPTIONSперед настоящим request. - Он проверяет method, headers и origin.
- Если preflight failed, основной request не уйдет.
Authorizationиapplication/jsonчасто вызывают preflight.Access-Control-Max-Ageкеширует preflight result.
Документация
Дочитали до конца?
Отметьте урок — прогресс сохранится в браузере.