INTEGRITY Dokumentace

Správa operací

Stavy operace

Každá operace má jeden z následujících stavů:

Stav Význam
full Operace, kterou jste vybrali, přidali ručně nebo vytvořili ze schématu. Úplné operace se používají pro porovnávání, protokolování, detekce a pravidla.
candidate Operace, kterou Cloudflare zjistil z provozu. Kandidátní operace se používají pro porovnávání, protokolování, detekce a pravidla ještě předtím, než je ručně zkontrolujete.
shadow Operace, která existuje ve Web Assets, ale nepoužívá se pro porovnávání, protokolování, detekce ani pravidla.

Nemusíte přesouvat každou zjištěnou operaci do full stav. Kandidátní operace poskytují kontext operace automaticky. Učení profilu se spustí až po výběru Naučit profil.

Požadavky na zjišťování

Pokud se operace nezobrazuje ve Web Assets, znamená to, že Cloudflare pravděpodobně nezaznamenal dostatek platných požadavků po nepřetržitou dobu. Zjišťování zpracovává pouze požadavky, které splňují všechny následující podmínky:

Zjištěné operace

Discovery neustále identifikuje operace z proxovaného provozu HTTP. Discovery seskupuje podobné cesty požadavků pomocí normalizace cest.

Zjišťování může tyto požadavky například seskupit:

GET https://api.example.com/profile/238
GET https://api.example.com/profile/392

Discovery je může seskupit do jedné operace:

GET api.example.com/profile/{var1}

Objevené operace se používají pro porovnávání ještě před tím, než je ručně upravíte. Díky tomu získáte kontext operace, aniž byste museli nejprve měnit její stav.

Porovnávání založené na Discovery podléhá dostupnosti plánu a systémovým limitům. Cloudflare v současnosti odesílá na edge k porovnávání až 3,000 operací na zónu. Operace ve full mají nejvyšší prioritu, následují operace ve stavu candidate stav.

Spustit učení profilu

Vyberte Naučit profil a spusťte záměrné učení profilu. Discovery, manuální vytváření a úpravy profilování nespouštějí.

Zákazníci s API Security již mají přístup ke Schema Profiles prostřednictvím Schema Learning a Schema Validation. Cloudflare otevírá uzavřenou betu pro pozvané zákazníky s plánem Enterprise bez API Security. Zájemci mohou o zařazení požádat prostřednictvím svého account teamu. Přístup k uzavřené betě neznamená budoucí dostupnost v rámci plánu ani cenu.

U operace ve stavu kandidát nebo shadow tato akce také přesune operaci do stavu full stav. Operace, která už je ve stavu full tam zůstává. Cloudflare pak z odpovídajícího provozu zjišťuje očekávanou strukturu požadavků.

Pro koncové body API shromažďuje API Shield také data pro další kontext:

Každá funkce má vlastní požadavky na data a časování. Informace o Schema Profiles najdete v Učení schématu.

Úplné operace mohou také využívat ochrany, které vyžadují známý koncový bod API, včetně Schema Validation, pravidla fallthrough, a zmírnění sekvencí.

  1. V dashboardu Cloudflare přejděte na Webová aktiva stránku s Operace kartou zvýrazněnou.

    Přejděte na Webová aktiva ↗
  2. Otevřete akce řádku pro danou operaci.

  3. Vyberte Naučit profil.

Jakmile bude profil k dispozici, vyberte Zobrazit podrobnosti. Zkontrolujte naučené schéma v části Přehled zabezpečení.

Chování při shodě provozu

Cloudflare přiřadí každý požadavek k jedné operaci na edge. Pokud by stejnému požadavku mohlo odpovídat více vzorů operací, upřednostní se ta konkrétnější.

Například mohou obě tyto operace odpovídat GET https://example.com/checkout/pay:

GET example.com/checkout/pay
GET example.com/checkout/{var1}

Cloudflare používá GET example.com/checkout/pay protože je konkrétnější.

Pro stejnou metodu, vzor hostname a vzor cesty vygeneruje Cloudflare stejné UUID operace. Díky tomu zůstává identita operace stabilní, když je stejná operace nalezena znovu.

Přidat operace ručně

Operaci přidejte ručně, pokud provoz, který chcete chránit, nebyl zjištěn, nebo pokud chcete strukturu operace definovat sami.

  1. V dashboardu Cloudflare přejděte na Webová aktiva stránku s Operace kartou zvýrazněnou.

    Přejděte na Webová aktiva ↗
  2. Vyberte Přidat operaci.

  3. Vyberte Přidat ručně.

  4. Vyberte metodu HTTP a zadejte vzor hostname a vzor cesty.

  5. Potvrďte pomocí Přidat operaci.

Ruční vytvoření pouze přidá operaci do inventáře. Vyberte Naučit profil samostatně, abyste zahájili profilování.

Použití proměnných ve vzorech operací

Když přidáváte operaci ručně, použijte proměnné, aby jedna operace odpovídala podobnému provozu.

U proměnných cesty uzavřete proměnnou do složených závorek:

/api/users/{var1}/details

U proměnných hostname musí proměnná zabírat celý štítek hostname. Cloudflare podporuje například tyto vzory:

{hostVar1}.example.com
foo.{hostVar1}.example.com
{hostVar2}.{hostVar1}.example.com

Proměnnou hostname nekombinujte s dalšími znaky ve stejném štítku. Následující vzor není podporován:

foo-{hostVar1}.example.com

Přidání operací ze schémat

Pokud již spravujete schémata OpenAPI, můžete je i nadále nahrávat a vytvářet z nich operace.

Nahrání schématu se také používá u API Shield pro validaci schématu. Další informace najdete v Schema Validation a učení schématu.

Upřesnění operací

Upravte operace, pokud aktuální seskupení neodpovídá tomu, jak by měl být provoz seskupen nebo chráněn.

Můžete si například přát mít oddělené operace pro provoz přihlášení a obnovení hesla, i když obě trasy sdílejí část stejné struktury cesty. Několik úzce zaměřených operací také můžete nahradit jednou širší operací, pokud představují stejné chování aplikace.

Před provedením změn zkontrolujte překrývající se operace. Cloudflare přiřadí každý požadavek k jedné operaci. Široce definovaná operace může změnit způsob, jakým jsou podobné požadavky seskupovány, zatímco úzce definovaná operace dokáže izolovat jeden proces od souvisejícího provozu.

  1. V dashboardu Cloudflare přejděte na Webová aktiva stránku s Operace kartou zvýrazněnou.

    Přejděte na Webová aktiva ↗
  2. Otevřete akce řádku pro danou operaci.

  3. Vyberte Upravit operaci.

  4. Aktualizujte metodu HTTP, vzor názvu hostitele nebo vzor cesty.

  5. Vyberte Save.

Úpravou se aktualizuje záznam v seznamu operací. Učení profilu se tím nespouští.

Odstranit operace

Operace můžete mazat jednotlivě nebo hromadně.

  1. V dashboardu Cloudflare přejděte na Webová aktiva stránku s Operace kartou zvýrazněnou.

    Přejděte na Webová aktiva ↗
  2. Vyberte jednu nebo více operací, které chcete odstranit.

  3. Potvrďte pomocí Odstranit operace.

Použití Cloudflare API

S operacemi můžete pracovat prostřednictvím Cloudflare API. Další informace najdete v dokumentace API pro operace.