Przejdź do głównej zawartości

Skonfiguruj Content Security Policy

Na tej stronie dopuścisz w nagłówku Content-Security-Policy domeny, których potrzebuje Card SDK, i sprawdzisz politykę bez ryzyka zablokowania checkoutu.

Jeśli Twoja strona nie wysyła nagłówka CSP, SDK działa bez dodatkowej konfiguracji i możesz pominąć tę stronę. Jeśli wysyła, brak wpisów z tej strony objawia się pustym polem karty, brakiem zdarzenia ready albo powodem FRAME_LOAD_FAILED przy portfelach.

Inwentarz zasobów zewnętrznych​

Card SDK nie ma zależności npm ani własnych fontów. Wszystko, co dociąga na Twoją stronę, pochodzi z czterech hostów. W sandboxie hosty Paymentic mają wariant z członem sandbox: cards.sandbox.paymentic.com i challenge.sandbox.paymentic.com.

Hostscript-srcframe-srcconnect-src
cards.paymentic.comtaktaktak
challenge.paymentic.comtak
applepay.cdn-apple.comtak
pay.google.comtaktak

Co każdy host ładuje i kiedy:

  • cards.paymentic.com: skrypt SDK (/sdk/v1/paymentic-card.js lub .mjs), iframe hosted fields (/card-fields/…), iframe natywnego przycisku Google Pay oraz zapytania tokenizacji i pobrania konfiguracji portfeli. Potrzebny zawsze.
  • challenge.paymentic.com: Challenge SDK (/assets/sdk/paymentic-challenge.js) i strona challenge'u 3-D Secure z nextAction.url, na której klient potwierdza płatność u banku wydawcy (zob. Obsłuż challenge 3-D Secure). Potrzebny tylko przy challenge.type: 3DS_SDK, bo wtedy challenge otwiera się w nakładce na Twojej stronie. Przy domyślnym REDIRECT płatnik przechodzi na stronę Paymentic i ten host nie musi być w Twojej polityce. Challenge pojawia się tylko wtedy, gdy wymaga go bank; w sandboxie wymuszają go karty ze strony Testowanie kart.
  • applepay.cdn-apple.com: biblioteka Apple Pay JS. Ładuje się na Twojej stronie także przy przycisku natywnym. Potrzebny, gdy używasz Apple Pay.
  • pay.google.com: biblioteka Google Pay (pay.js) i ramka arkusza. Potrzebny wyłącznie przy własnym przycisku (requestGooglePay). Przycisk natywny uruchamia bibliotekę Google wewnątrz ramki Paymentic, więc nie wymaga tego wpisu.

Dla samego Card SDK nie potrzebujesz wpisów w style-src, img-src ani font-src: Card SDK nie wstrzykuje tagów style i nie ładuje obrazów ani fontów na Twoją stronę. Challenge SDK potrzebuje style-src; zob. Challenge 3-D Secure w nakładce. Międzyprzeglądarkowy przepływ Apple Pay (Chrome, Edge, Firefox) może wymagać dodatkowych domen Apple; sprawdź aktualne wytyczne Apple, jeśli zaostrzasz te dyrektywy.

Rekomendowana polityka​

Produkcja, przycisk natywny Google Pay i Apple Pay:

Content-Security-Policy:
default-src 'self';
script-src 'self' https://cards.paymentic.com https://applepay.cdn-apple.com;
frame-src https://cards.paymentic.com;
connect-src 'self' https://cards.paymentic.com;

Z własnym przyciskiem Google Pay dodaj https://pay.google.com do script-src i frame-src:

Content-Security-Policy:
default-src 'self';
script-src 'self' https://cards.paymentic.com https://applepay.cdn-apple.com https://pay.google.com;
frame-src https://cards.paymentic.com https://pay.google.com;
connect-src 'self' https://cards.paymentic.com;

W sandboxie zamień hosty produkcyjne na https://cards.sandbox.paymentic.com i https://challenge.sandbox.paymentic.com (albo dopuść oba środowiska, jeśli ten sam checkout obsługuje oba).

Te polityki obejmują challenge 3-D Secure w domyślnym trybie REDIRECT: płatnik przechodzi na stronę Paymentic, więc challenge.paymentic.com nie musi być w Twojej polityce.

Nie dodawaj 'unsafe-inline' dla Card SDK. Nie potrzebuje tego. Jeśli inne integracje na stronie ładują własne skrypty lub ramki, dopisz ich domeny obok wpisów Paymentic; CSP blokuje wszystko, czego nie wymienisz.

Challenge 3-D Secure w nakładce (3DS_SDK)​

Jeśli otwierasz challenge przez Challenge SDK (challenge.type: 3DS_SDK), dopisz https://challenge.paymentic.com do script-src i frame-src oraz 'unsafe-inline' do style-src:

Content-Security-Policy:
default-src 'self';
script-src 'self' https://cards.paymentic.com https://applepay.cdn-apple.com https://challenge.paymentic.com;
style-src 'self' 'unsafe-inline';
frame-src https://cards.paymentic.com https://challenge.paymentic.com;
connect-src 'self' https://cards.paymentic.com;
  • script-src: stąd ładujesz Challenge SDK (/assets/sdk/paymentic-challenge.js).
  • frame-src: strona challenge'u otwiera się w ramce nakładki.
  • style-src 'unsafe-inline': nakładka ma własne style w tagu style. Bez tego wpisu przeglądarka je blokuje i nakładka nie zajmuje całego ekranu.
  • Jeśli wysyłasz dyrektywę form-action, dopisz do niej https://challenge.paymentic.com. SDK ładuje stronę challenge'u formularzem POST wysłanym do ramki, a default-src nie obejmuje form-action.

Co robią poszczególne dyrektywy​

DyrektywaZnaczenie
default-srcDomyślne źródła dla dyrektyw, których nie wymienisz osobno. 'self' dopuszcza tylko Twoją domenę.
script-srcSkąd wolno ładować JavaScript: skrypt Card SDK, biblioteka Apple Pay, opcjonalnie biblioteka Google Pay i Challenge SDK (przy 3DS_SDK).
style-srcSkąd wolno ładować style. Potrzebny tylko przy 3DS_SDK: 'unsafe-inline' dla stylów nakładki Challenge SDK.
frame-srcJakie strony wolno osadzić w iframe: hosted fields i natywny przycisk Google Pay z cards.paymentic.com, opcjonalnie ramka Google Pay i challenge 3-D Secure z challenge.paymentic.com (przy 3DS_SDK).
connect-srcDokąd wolno wysyłać fetch/XHR: zapytania tokenizacji i pobranie konfiguracji portfeli z domeny Paymentic.

Przetestuj politykę w trybie report-only​

Zanim włączysz politykę blokującą, wyślij ją w nagłówku Content-Security-Policy-Report-Only. Przeglądarka tylko loguje naruszenia w konsoli i nic nie blokuje, więc checkout działa jak dotąd.

Content-Security-Policy-Report-Only:
default-src 'self';
script-src 'self' https://cards.paymentic.com https://applepay.cdn-apple.com;
frame-src https://cards.paymentic.com;
connect-src 'self' https://cards.paymentic.com;
  1. Wdróż nagłówek report-only i przejdź cały checkout: pole karty, tokenize(), płatność kartą z challenge'em 3-D Secure, przyciski portfeli.
  2. W konsoli przeglądarki poszukaj komunikatów Refused to load … lub [Report Only]. Każdy wskazuje domenę, której brakuje w polityce.
  3. Dopisz brakujące domeny, powtórz test, a potem zamień nagłówek na Content-Security-Policy.

Permissions-Policy​

Jeśli wysyłasz nagłówek Permissions-Policy, nie może on odmawiać funkcji payment. Hostowana ramka Google Pay polega na atrybucie allow="payment". Zablokowanie tej funkcji objawia się powodem FRAME_LOAD_FAILED.

Co dalej​