← Cloudflare API Shield / api-shield / security / sequence-mitigation

Konfigurace mitigace sekvencí přes API

Konfigurace mitigace sekvencí přes API spočívá v sestavení objektu pravidla, a to výběrem sekvence a nastavením typu pravidla a jeho akce.

Příklad objektu pravidla

{
    "id": "d4909253-390f-4956-89fd-92a5b0cd86d8",
    "title": "<RULE_TITLE>",
    "kind": "allow",
    "action": "block",
    "sequence": [
     "0d9bf70c-92e1-4bb3-9411-34a3bcc59003",
     "b704ab4d-5be0-46e0-9875-b2b3d1ab42f9"
    ],
    "priority": 0,
    "last_updated": "2023-07-24T12:06:51.796286Z",
    "created_at": "2023-07-24T12:06:51.796286Z"
}

Toto pravidlo vynucuje, aby požadavek na endpoint 0d9bf70c-92e1-4bb3-9411-34a3bcc59003 musí předcházet požadavku na endpoint b704ab4d-5be0-46e0-9875-b2b3d1ab42f9.

V opačném případě bude požadavek na koncový bod b704ab4d-5be0-46e0-9875-b2b3d1ab42f9 je zablokován.

Pole

Název pole	Popis	Možné hodnoty	Příklad
`id`	Neprůhledný identifikátor, který pravidlo jednoznačně určuje.	UUID	`"d4909253-390f-4956-89fd-92a5b0cd86d8"`
`title`	Řetězec, který pomáhá identifikovat pravidlo.	Hodnota o délce 1 až 50 znaků	`"Allow checkout sequence"`
`kind`	Určuje sémantiku tohoto pravidla. Pravidla typu Block fungují na základě negativního bezpečnostního modelu a umožňují explicitně zakázat danou sekvenci. Pravidla typu Allow fungují na základě pozitivního bezpečnostního modelu a zakazují vše kromě nakonfigurované sekvence.	`block`, `allow`	`"block"`
`action`	Jaká akce firewallu se má provést, když bude pravidlo odpovídat.	`block`,`log`	`"log"`
`sequence`	Označuje operace (z Endpoint Management), které tvoří sekvenci pro toto pravidlo. V současnosti podporujeme pouze sekvence o délce dva. První operace představuje počáteční koncový bod, druhá pak koncový bod závěrečný.	Pole se dvěma platnými ID operací z Endpoint Management	`["0d9bf70c-92e1-4bb3-9411-34a3bcc59003", "b704ab4d-5be0-46e0-9875-b2b3d1ab42f9"]`
`priority`	Označuje prioritu tohoto pravidla ve vztahu ke všem ostatním pravidlům. Pravidla s vyšší hodnotou priority se vyhodnocují dříve než pravidla s hodnotou nižší. Mají-li dvě pravidla stejnou prioritu, vyhodnocují se v pořadí, v jakém byla přidána.	Platné celé číslo	`10`
`last_updated`	Kdy bylo toto pravidlo naposledy změněno.	Řetězec data	`2023-05-02T12:06:51.796286Z`
`created_at`	Kdy bylo toto pravidlo vytvořeno.	Řetězec data	`2023-05-02T12:06:51.796286Z`

ID operace endpointu zjistíte exportováním schématu v Endpoint Management nebo prostřednictvím API.

Seznam pravidel posloupnosti

Použijte GET příkaz k výpisu pravidel.

příkaz cURL

curl "https://api.cloudflare.com/client/v4/zones/{zone_id}/api_gateway/seqrules"

Přidat jedno pravidlo sekvence

Použijte POST příkaz k vytvoření jednoho pravidla.

Tímto se ke všem existujícím pravidlům přidá jedno nové pravidlo. Pomocí priority lze pravidlo umístit mezi jiná pravidla, před ně nebo za ně.

Odpověď bude odrážet zapsané pravidlo spolu s jeho ID. Pokud s pravidlem něco nebude v pořádku, zobrazí se odpovídající chybová zpráva s json s odkazem na místo problému.

Příklad pomocí cURL

curl "https://api.cloudflare.com/client/v4/zones/{zone_id}/api_gateway/seqrules/rules" \
--header "Content-Type: application/json" \
--data '{
  "title": "string",
  "kind": "block",
  "action": "block",
  "sequence": [
    "0d9bf70c-92e1-4bb3-9411-34a3bcc59003",
    "b704ab4d-5be0-46e0-9875-b2b3d1ab42f9"
  ],
  "priority": 0
}'

Přidat více pravidel sekvence

Použijte PUT příkaz k hromadnému vytvoření nových pravidel.

Tímto se přepíší veškerá existující pravidla a nahradí se pravidly uvedenými v těle požadavku. Nastavením prázdného pole pro pravidla se odstraní všechna pravidla.

Odpověď bude odrážet zapsaná pravidla spolu s jejich ID; pokud s pravidly něco nebude v pořádku, zobrazí se odpovídající chybová zpráva s json s odkazem na místo problému.

Příklad pomocí cURL

curl --request PUT "https://api.cloudflare.com/client/v4/zones/{zone_id}/api_gateway/seqrules" \
--header "Content-Type: application/json" \
--data '{
  "rules": [
    {
      "title": "<RULE_TITLE>",
      "kind": "block",
      "action": "block",
      "sequence": [
        "0d9bf70c-92e1-4bb3-9411-34a3bcc59003",
        "b704ab4d-5be0-46e0-9875-b2b3d1ab42f9"
      ],
      "priority": 0
    }
  ]
}'

Smazat pravidlo

Použijte DELETE příkaz spolu s ID pravidla ke smazání pravidla.

příkaz cURL

curl --request DELETE "https://api.cloudflare.com/client/v4/zones/{zone_id}/api_gateway/seqrules/rules/d4909253-390f-4956-89fd-92a5b0cd86d8"