Rozpoczęcie pracy

Od zapytania ofertowego do czystego ruchu w Twojej sieci.

Przebieg uruchomienia

1. Zapytanie ofertowe. Opisz usługę, skalę ruchu i preferowany sposób podłączenia: zdalny lub fizyczny.
2. Weryfikacja zasobów. Potwierdzamy prawo do adresacji na podstawie wpisów RPKI lub dokumentu LOA.
3. Podłączenie. W modelu zdalnym ruch kierowany jest do centrum oczyszczania przez BGP, bez łącza fizycznego. W modelu fizycznym zestawiany jest port w centrum oczyszczania w Warszawie, a koszt cross-connectu pozostaje po stronie klienta.
4. Sesje BGP. Konfigurujemy sesje i ogłaszanie prefiksów w IPv4 i IPv6.
5. Panel i ochrona. Otrzymujesz dostęp do panelu, a prefiksy obejmowane są ochroną zgodnie z przypisanym profilem.

Prefiksy

Prefiks to zasób adresowy objęty usługą. Każdy prefiks ma przypisany profil ochrony i tryb pracy.

Dodawanie prefiksu

W module Prefiksy wybierz Dodaj prefiks i podaj zakres w notacji CIDR, na przykład 203.0.113.0/24. Nowy prefiks przechodzi weryfikację prawa do adresacji, zanim zostanie objęty ochroną.

Stany prefiksu

Profile ochrony

Profil określa, jak filtrowany jest ruch do prefiksu. Serwer WWW, serwer DNS i sieć abonencka wymagają innego traktowania ruchu.

Dostępne profile

Parametry i tryb pracy

Parametry profilu, takie jak limity nowych przepływów czy progi na cel, dobierane są wspólnie z zespołem Nera przy uruchomieniu ochrony i dostrajane do charakterystyki ruchu.

Tryb pracy wybierany jest per prefiks: stały oznacza filtrowanie bez przerwy, na żądanie włącza filtrowanie w chwili wykrycia ataku.

Mitygacje i raporty

Mitygacja to zdarzenie ochrony: od wykrycia ataku do powrotu ruchu do normy. Każde zdarzenie kończy się raportem.

Przebieg zdarzenia

1. Atak zostaje wykryty, a mitygacja uruchamia się automatycznie zgodnie z profilem prefiksu.
2. W panelu pojawia się baner zdarzenia, a powiadomienie trafia na skonfigurowane kanały.
3. Ruch złośliwy jest odfiltrowywany, czysty ruch płynie do sieci bez przerwy.
4. Po powrocie ruchu do normy mitygacja zostaje wygaszona, a raport zapisany w module Raporty.

Zawartość raportu

• wektory ataku, na przykład UDP flood, SYN flood, amplifikacja DNS,
• szczytowe wartości ruchu w pps i bps,
• czas trwania i przebieg zdarzenia,
• podjęte działania ochronne.

Raporty zdarzeń oraz podsumowania okresowe można pobrać w formacie PDF lub odczytać przez API.

Klucze API

Klucze API dają programistyczny dostęp do konta: odczyt metryk, zarządzanie prefiksami i pobieranie raportów.

Tworzenie klucza

W module Klucze API wybierz Nowy klucz, nadaj nazwę i zakres uprawnień. Klucz wyświetlany jest w całości tylko raz, przy utworzeniu. Zapisz go w bezpiecznym miejscu.

Uprawnienia

Uwierzytelnianie i konwencje

API REST w wersji 1, dostępne pod adresem bazowym https://api.nera.pl/api/v1. Wszystkie odpowiedzi zwracane są w formacie JSON.

Uwierzytelnianie

Każde żądanie wymaga klucza API w nagłówku Authorization:

# klucz utworzysz w panelu, w module Klucze API
curl https://api.nera.pl/api/v1/prefixes \
  -H "Authorization: Bearer nera_xxxxxxxxxxxxxxxx"

Konwencje

• Identyfikatory zasobów są nieprzewidywalne i stałe w czasie życia zasobu.
• Czas zwracany jest w formacie ISO 8601, w strefie UTC.
• Listy stronicowane są parametrami limit i cursor.

Błędy

Błędy zwracane są zgodnie z RFC 7807 (application/problem+json):

{
  "type": "https://api.nera.pl/errors/forbidden",
  "title": "Brak uprawnień",
  "status": 403,
  "detail": "Klucz ma zakres odczyt, operacja wymaga zapisu."
}

Prefiksy

Odczyt i zarządzanie prefiksami objętymi usługą.

Lista prefiksów

curl https://api.nera.pl/api/v1/prefixes \
  -H "Authorization: Bearer nera_xxxxxxxxxxxxxxxx"

{
  "data": [
    {
      "id": "pfx_8f2ka91d",
      "cidr": "203.0.113.0/24",
      "opis": "Serwisy WWW",
      "profil": "www",
      "tryb": "staly",
      "stan": "chroniony"
    }
  ],
  "next_cursor": null
}

Dodanie prefiksu

Wymaga zakresu odczyt i zapis. Nowy prefiks otrzymuje stan w_trakcie do czasu weryfikacji prawa do adresacji.

curl -X POST https://api.nera.pl/api/v1/prefixes \
  -H "Authorization: Bearer nera_xxxxxxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{"cidr":"198.51.100.0/24","opis":"Platforma uslugowa","profil":"ogolny","tryb":"staly"}'

Mitygacje i ruch

Historia zdarzeń ochrony oraz metryki ruchu na koncie.

Lista mitygacji

Parametry: stan (aktywna, zakonczona), od i do (ISO 8601), prefiks.

curl "https://api.nera.pl/api/v1/mitigations?stan=zakonczona&od=2026-07-01T00:00:00Z" \
  -H "Authorization: Bearer nera_xxxxxxxxxxxxxxxx"

{
  "data": [
    {
      "id": "mit_2c91xk4a",
      "prefiks": "203.0.113.0/24",
      "wektory": ["syn_flood"],
      "szczyt_pps": 2100000,
      "szczyt_bps": 14800000000,
      "start": "2026-07-23T09:07:12Z",
      "koniec": "2026-07-23T09:25:40Z",
      "stan": "zakonczona"
    }
  ],
  "next_cursor": null
}

Metryki ruchu

Szeregi czasowe ruchu wejściowego, odfiltrowanego i czystego dla konta lub wybranego prefiksu.

curl "https://api.nera.pl/api/v1/traffic?zakres=24h&prefiks=203.0.113.0/24" \
  -H "Authorization: Bearer nera_xxxxxxxxxxxxxxxx"

wersja poglądowa dokumentacji · nazwy pól i adresy przykładowe