Home / Notes / AntiDDoS Emergency Bypass Procedures
NOTES · ANTIDDOS / EMERGENCY BYPASS

AntiDDoS Blocking Legitimate Traffic: Emergency Bypass Procedures

When the AntiDDoS device itself has become the outage — blocking real business traffic instead of protecting it — this is the fast path back: telling a false positive apart from a missed attack first, the diagnostic capture to run before touching anything, the Bypass procedure for both out-of-path and in-line deployments, how to confirm it actually worked, and the threshold tuning that keeps it from happening again.

By the AtlasCommTech engineering team — 13 years of carrier & enterprise network deployments · Updated July 2026

When the Protection Becomes the Outage

A DDoS scrubber that blocks real customers is a self-inflicted outage — and it needs a faster, calmer response than an actual attack does.

An AntiDDoS device that starts dropping legitimate traffic is its own kind of emergency: the business impact looks identical to an outage, but the fix isn't a network repair — it's recognizing that the device's own defense policy has become the problem, and unwinding it quickly and correctly. Reaching for the wrong lever first (or reaching for the right lever without checking what's actually wrong) wastes exactly the minutes that matter.

What follows is that response, straight from the AntiDDoS emergency-recovery handbook: how to tell this apart from an attack that's actually getting through, the information worth capturing before you touch anything, the Bypass procedure itself for both common deployment shapes, how to confirm it actually worked, and the tuning that stops it from happening again.

First: False Positive or Missed Attack?

Bypass is the right answer to exactly one of these two — get this call right before doing anything else.

Traffic patternDiagnosis
Inbound traffic hasn't risen noticeably compared to normal, but traffic coming out the other side of the AntiDDoS device has dropped noticeably.False positive (误防) — the device's own policy is blocking traffic that was never actually an attack. This note applies: proceed to Bypass.
Inbound traffic has risen noticeably compared to normal, and traffic coming out the other side is still much higher than normal.Missed attack (漏防) — the attack is getting through, not being blocked. Bypassing the device here removes the only defense in place; the correct response is to enable defense faster, not bypass it.

Getting this diagnosis wrong in either direction burns the minutes that matter — bypassing during a real attack, or hunting for attack traffic that was never actually there, both delay the fix that's actually needed.

Capture This Before You Touch Anything

Six commands, run before recovery — the record you'll want once the pressure is off.

CommandWhat it captures
collect diagnostic informationThe full diagnostic information package for this incident.
display firewall statistic system discardSystem-wide packet-discard statistics — what's actually being dropped and where.
display anti-ddos packet-trace statisticDrop statistics specific to AntiDDoS processing — separating its drops from ordinary firewall discards.
display cpu-usage slot slot-id cpu cpu-idSPU board CPU usage at the moment of the incident.
display anti-ddos resource slot slot-id cpu cpu-idResource-table usage — whether a table is near capacity independent of any attack.
display firewall session table verboseSession-table usage at the time of the incident, for comparison against the post-bypass state.

The Bypass Procedure — Two Deployment Shapes

Out-of-path and in-line deployments fail differently, so the fastest way back differs too.

Out-of-Path Deployment

In this deployment shape, traffic is diverted to the AntiDDoS device only when something looks wrong — so shutting off diversion is the fastest lever, but it isn't the only one that needs pulling.

  1. On the device, shut down the diversion-facing interface to stop diversion immediately.
  2. Log in to the SecoManager O&M plane (https://[northbound floating IP]:31943).
  3. Under Attack Defense > Diversion, check whether a diversion task exists for the affected IP; if it does, disable it.
  4. Under Attack Defense > Flowspec, check for a Flowspec task on the affected IP; disable it if present.
  5. Under Attack Defense > Blackhole, check for a blackhole task on the affected IP; disable it if present.
  6. Under Attack Defense > Protection Objects, find the protection object for the affected IP (the default protection object, if none was configured individually), edit its defense mode to turn off auto-diversion and auto-blackhole, then save and deploy.
[HUAWEI-100GE4/0/1] display this
interface 100GE4/0/1
  shutdown
  ipv6 enable
  ip address 172.16.1.1 255.255.255.0
  ipv6 address 2001:db8:1::1/64

In-Line Deployment

In this deployment shape the device sits physically in the traffic path in transparent Layer 2 mode, so the recovery path depends on what kind of Bypass hardware is actually present.

  1. If an external Bypass unit is present, follow its own operating instructions to switch the AntiDDoS device into Bypass.
  2. If a built-in Bypass card is present, log in to the AntiDDoS device directly and configure Bypass through the CLI.
  3. If there's no Bypass hardware at all, log in to the SecoManager O&M plane instead: under Attack Defense > Protection Objects, find and remove the protection object for the affected IP (and the default protection object too, if one exists).
  4. Under Attack Defense > Filter > Hardware Filter, disassociate every hardware filter currently bound.
  5. Under Attack Defense > Blackhole, check for a blackhole task on the affected IP and disable it if present.
  6. Under Attack Defense > Flowspec, check for a Flowspec task on the affected IP and disable it if present.

The Two Bypass Paths, Side by Side

Same goal, different mechanics — because the traffic gets to the device differently in each deployment.

Out-of-Path Deployment In-Line Deployment 1. Shut down the diversion-facing interfaceStops new diversion immediately 2. Disable the diversion task in SecoManagerAttack Defense > Diversion, for the affected IP 3. Disable Flowspec & blackhole tasksAttack Defense > Flowspec / Blackhole 4. Edit the protection objectTurn off auto-diversion & auto-blackhole, deploy 1. External Bypass unit present?Follow its own operating instructions 2. Built-in Bypass card present?Configure Bypass via CLI on the device 3. No Bypass hardware: remove protection objectSecoManager > Attack Defense > Protection Objects 4. Unbind hardware filters, disable blackhole/FlowspecAttack Defense > Filter > Hardware Filter, then Blackhole/Flowspec Verify legitimate traffic is flowing againRe-run the pre-recovery captures and compare against baseline Tune the threshold that caused the false positiveRefresh baseline, adjust for business-type changes, clear stale blacklist

Diagram labels are kept in English for engineering clarity.

Related solution designs

After the Bypass: Verify, Then Tune

Bypass stops the bleeding — it doesn't fix why the false positive happened in the first place.

  1. Re-run the same pre-recovery captures (session table, discard statistics, packet-trace statistics) and compare against the numbers from before the incident, and confirm the affected business itself is actually reachable — not just that the device's counters look calmer.
  2. If the false positive was blacklist-driven, clear the dynamic blacklist — but per CPU, not once for the whole device.
  3. Refresh the defense thresholds against the latest baseline-learning results as business traffic grows — a threshold set for last quarter's traffic is a common source of a false positive months later.
  4. Watch for business-type changes on the same protected object — for example a service that used to be pure TCP web traffic and has since added UDP video traffic needs its old UDP rate-limit policy reviewed and, if it no longer applies, removed.
[HUAWEI] reset anti-ddos blacklist slot slot-id cpu cpu-id
// clears the blacklist for one CPU only -- repeat for every CPU on the slot(s) in question

Five Gotchas Under Bypass Pressure

Every one of these has cost someone real recovery time.

1. Shutting Down the Interface Doesn't Stop SecoManager From Re-Diverting

SYMPTOMThe diversion-facing interface is shut down on the device, but the affected traffic still seems to be getting diverted or blocked.

CAUSEThe diversion, Flowspec and blackhole tasks live in SecoManager, independent of the interface's own state — shutting down the interface stops traffic from physically reaching the device through that path, but it doesn't disable the tasks that would re-divert it the moment the interface comes back.

FIXTreat the interface shutdown and the SecoManager-side diversion/Flowspec/blackhole task disablement as one single action, not a sequence you can stop halfway through.

2. In-Line Bypass Without a Bypass Card Still Needs the Hardware Filters Unbound

SYMPTOMThe protection object was removed through SecoManager, but the device still appears to be dropping some of the traffic.

CAUSEHardware filters are a separate binding from the protection object — removing the protection object doesn't automatically detach a hardware filter that's already associated and actively dropping traffic.

FIXExplicitly disassociate every hardware filter under Attack Defense > Filter > Hardware Filter as its own step, not an assumed side effect of removing the protection object.

3. Editing the Default Protection Object Affects Every IP That Shares It

SYMPTOMTraffic behavior changes for services other than the one being troubleshot, right after the protection object was edited.

CAUSEIf the affected IP was never given its own dedicated protection object, it's been sharing the default one along with every other IP in the same situation — turning off auto-diversion or auto-blackhole there changes behavior for all of them at once.

FIXConfirm whether the affected IP has a dedicated protection object before editing broadly, and understand the full blast radius before touching the default object.

4. The Dynamic Blacklist Has to Be Cleared Per CPU, Not Once for the Device

SYMPTOMreset anti-ddos blacklist was run once, but the same legitimate traffic is still being blocked.

CAUSEThe dynamic blacklist is maintained per CPU. reset anti-ddos blacklist slot slot-id cpu cpu-id only clears the one CPU it's actually run against — the blacklist stays fully in effect on every other CPU on the slot.

FIXRepeat the reset command for every CPU on the relevant slot(s); a single run is not equivalent to clearing the device.

[HUAWEI] reset anti-ddos blacklist slot slot-id cpu cpu-id
// must be repeated for each CPU to fully clear the blacklist

5. Misreading False Positive vs. Missed Attack Wastes the Whole Effort

SYMPTOMThe Bypass procedure is executed in full, but the underlying business impact doesn't improve — or gets worse.

CAUSEBypass is the correct response to a false positive only. If inbound traffic is actually elevated and traffic past the device is still elevated, that's a missed attack — bypassing removes the one defense actually needed, rather than restoring blocked legitimate traffic.

FIXConfirm the traffic pattern against the false-positive/missed-attack diagnosis before starting Bypass, not after it's already underway.

Six Questions That Come Up Under Pressure

The ones worth having an answer ready for before the next incident, not during it.

How fast should Bypass take effect once I disable diversion in an out-of-path deployment?

The interface shutdown itself is near-immediate, but it doesn't fully stop the problem unless the SecoManager diversion, Flowspec and blackhole tasks for that IP are disabled at the same time — treat all four steps as one action to execute together, not a sequence to work through one at a time under pressure.

If there's no dedicated Bypass card on an in-line deployment, what actually happens to traffic while I remove the protection object?

The device stays physically in the traffic path the whole time, since it's deployed as transparent Layer 2 in-line — traffic keeps flowing through it during the change. Removing the protection object, unbinding hardware filters and disabling blackhole/Flowspec tasks is about stopping the device from applying protection logic to that traffic, not about physically removing it from the path.

After Bypass, how do I confirm legitimate traffic is actually flowing again?

Re-run the same pre-recovery captures — session table, discard statistics, packet-trace statistics — and compare them against the numbers from before the incident, and separately confirm the affected business itself is reachable from a real client, not just that the device's own counters look calmer.

Is editing the default protection object safe if other traffic relies on it too?

Only once you've confirmed that's actually what you want — every IP without its own dedicated protection object shares the default one, so turning off auto-diversion or auto-blackhole there affects all of them at once, not just the IP currently in trouble. If that's too broad, create a dedicated protection object for the affected IP instead.

How long should I wait before re-enabling protection after a Bypass, and what should I check first?

There's no fixed interval in the handbook for this — the right order is confirming what actually caused the false positive (usually a stale threshold or an unaccounted-for business change), adjusting that policy, and only then re-enabling protection during a lower-risk window while watching the same counters again.

We reset the dynamic blacklist on one CPU and the block is still happening — why?

The blacklist is maintained per CPU. reset anti-ddos blacklist slot slot-id cpu cpu-id only clears the CPU it's actually run against, so it has to be repeated for every CPU on the relevant slot(s) before the blacklist is genuinely gone device-wide.

Honest Limits of This Note

This note is built directly from the AntiDDoS troubleshooting handbook's own emergency-recovery chapter, covering the false-positive quick-bypass path for both out-of-path and in-line deployments and the SecoManager operations behind it. It doesn't cover the missed-attack side of the same chapter — enabling defense quickly when an attack is actually getting through — and it doesn't replace the underlying Flowspec or blackhole configuration reference. For the day-to-day commands used to first notice something is wrong, see the companion note below.

AntiDDoS blocking real traffic right now?

Tell us the deployment shape — out-of-path or in-line — and whether you've confirmed false positive over missed attack, and we'll help you move fast.

WhatsApp an engineer →

Related Reading