CORS (Cross-Origin Resource Sharing) to mechanizm, w którym serwer za pomocą nagłówków HTTP określa, z jakich źródeł przeglądarka może udostępnić odpowiedź skryptom strony. Ustawienia CORS dotyczą odczytu odpowiedzi przez przeglądarkę, a nie uwierzytelniania użytkownika ani dostępu między serwerami.
Co to jest CORS?
Dla zwykłych adresów HTTP(S) origin jest określany przez protokół, host i port. Istnieją też originy nieprzezroczyste. Strony pod różnymi subdomenami albo z różnym protokołem mogą więc być dla przeglądarki odrębnymi źródłami. Gdy kod JavaScript próbuje pobrać dane z innego źródła, przeglądarka sprawdza, czy serwer zezwala na udostępnienie odpowiedzi.
Serwer przekazuje zgodę w nagłówkach odpowiedzi, między innymi Access-Control-Allow-Origin. Może wskazać konkretne źródło lub, dla zasobów publicznych bez poświadczeń, użyć wartości . Jeśli odpowiedź nie spełnia reguł CORS, przeglądarka nie udostępni jej skryptowi. Samo żądanie w niektórych przypadkach może jednak dotrzeć do serwera.
Jak działa CORS i preflight?
Przeglądarka dodaje do żądania nagłówek Origin, a serwer odpowiada nagłówkami opisującymi dozwolone źródło. Przy niektórych żądaniach, na przykład z określonymi metodami lub niestandardowymi nagłówkami, przeglądarka najpierw wysyła zapytanie kontrolne OPTIONS, nazywane preflight. Serwer może w nim określić dozwolone metody i nagłówki.
Gdy klient żąda poświadczeń, serwer musi zwrócić Access-Control-Allow-Credentials: true oraz konkretne Access-Control-Allow-Origin, aby przeglądarka udostępniła odpowiedź kodowi. Sam nagłówek nie wymusza wysłania ciasteczek. To ustawienie wymaga ostrożności, bo pozwolenie na odczyt odpowiedzi przez obce strony może ujawnić dane.
Kiedy CORS ma znaczenie dla strony lub sklepu?
CORS może powodować błędy, gdy frontend strony lub sklepu pobiera dane z API działającego pod innym źródłem. Dotyczy to na przykład integracji z systemem magazynowym, CRM albo usługą prezentującą dane produktowe. W kampanii problem może pojawić się przy formularzu lub skrypcie, który w przeglądarce komunikuje się z zewnętrznym API.
Jeśli połączenie z usługą wykonuje backend, a nie przeglądarka klienta, reguły CORS przeglądarki nie blokują tej komunikacji. Dlatego przed zmianą konfiguracji sprawdź, który komponent wysyła żądanie. CORS nie zastępuje kontroli dostępu ani zabezpieczenia API.
Jak sprawdzić i poprawić błąd CORS?
- Otwórz narzędzia deweloperskie przeglądarki i sprawdź zakładki Console oraz Network. Odczytaj adres żądania, jego metodę, źródło strony i komunikat błędu.
- Jeśli pojawia się preflight, sprawdź żądanie
OPTIONSoraz odpowiedź serwera. Zweryfikuj dozwolone źródło, metodę i nagłówki. - Skonfiguruj serwer API lub serwer WWW, aby zezwalał tylko na wymagane źródła. Przy poświadczeniach podaj konkretne źródło zamiast
. - Powtórz żądanie w przeglądarce. Test z
curlmoże pomóc obejrzeć nagłówki, ale samcurlnie egzekwuje reguł CORS przeglądarki.
Przykład: sklep średniej wielkości pobiera dostępność produktów z osobnego API. Gdy przeglądarka blokuje odpowiedź, administrator sprawdza nagłówki i konfigurację obsługi OPTIONS, a następnie ogranicza zgodę do źródła sklepu.
Najczęstsze błędy
Częste błędy to ustawienie Access-Control-Allow-Origin: * dla API z danymi prywatnymi, użycie gwiazdki razem z poświadczeniami i pominięcie obsługi zapytania OPTIONS. Zdarza się też dodawanie nagłówka CORS wyłącznie po stronie frontendu, choć zgodę musi zwrócić serwer z zasobem. Wyłączenie kontroli w przeglądarce nie naprawia konfiguracji dla użytkowników.
Najczęściej zadawane pytania
Czy CORS blokuje żądanie, czy tylko odpowiedź?
Zależy od rodzaju żądania. Przy części żądań przeglądarka najpierw wykonuje kontrolne OPTIONS i może nie wysłać właściwego żądania, jeśli kontrola się nie powiedzie. W innych przypadkach żądanie może dotrzeć do serwera, ale przeglądarka nie udostępni odpowiedzi skryptowi strony.
Czy mogę naprawić CORS kodem JavaScript na stronie?
Zwykle nie. JavaScript nie może samodzielnie nadać odpowiedzi z serwera nagłówków zezwalających na jej odczyt. Zmiany trzeba wprowadzić w konfiguracji API, serwera WWW lub usługi pośredniczącej. Gdy API jest zewnętrzne, skontaktuj się z jego dostawcą albo rozważ połączenie przez własny backend.
Czy CORS chroni API przed nieuprawnionym dostępem?
Nie. CORS określa, czy przeglądarka udostępni odpowiedź kodowi działającemu na stronie z innego źródła. Nie zastępuje logowania, autoryzacji, walidacji danych ani zabezpieczeń po stronie API. Serwer powinien sprawdzać uprawnienia przy każdym żądaniu niezależnie od konfiguracji CORS.
Potrzebujesz tego wdrożenia? Zobacz: Wdrożenie AI w firmie na jednym konkretnym zadaniu