Firewall

The firewall is the first barrier, before any detector. Traffic that matches a firewall entry is refused outright, so it never reaches a detector, a model or a tool. Changes apply within seconds.


Firewall Screen

Open AI runtime → Firewall.

ByteHide AI Runtime Firewall with active blocks for a country and an end user, their reasons, scope and expiry, and the firewall activity feedClick to expand

Summary

CardDescription
Active blocksEntries currently in force
Decided by the runtimeEntries the gateway added on its own, from behavior
Requests stoppedRequests the firewall refused
Kinds of block in useHow many block types are in use

Filter the list by kind (IP, Range, Country, User, Consumer, API key, Model), search by value or reason, and choose whether to show entries in force or expired ones.

Blocklist

ColumnDescription
BlockedThe blocked value and its kind
ReasonWhy it was blocked. Automatic bans show the reason the gateway recorded
ScopeThe whole organization, or one route
AddedWhen, and by what: a person, a playbook or the runtime
ExpiresWhen the block lifts on its own. Never for permanent blocks
StoppedHow many requests this entry has refused

Each entry can be edited or lifted with Unblock, after a confirmation.

Firewall Activity

Every block and unblock, manual and automatic, with who made it and the reason.


Block Traffic

Click Block traffic.

ByteHide AI Runtime Block traffic dialog blocking an end user with a reason, scope and a 7-day expiryClick to expand

  1. Choose what to block:

    KindValue
    IPAn address. It matches the address that opened the connection, or the end-user address your backend forwards in x-user-ip
    RangeA CIDR range
    CountryA country, resolved from the geolocation header your edge adds to the request
    UserThe end user ID your application sends in x-user-id. Matched case-insensitively
    ConsumerA consumer credential
    API keyA gateway key
    ModelA model name
  2. Write the Reason. It is shown in the blocklist and the Audit log: write it for whoever reads it in six months.

  3. Optionally narrow the Scope to one route, or leave it organization-wide.

  4. Choose when it Expires: Permanent, 1 hour, 24 hours, 7 days or 30 days.

  5. Click Block.

A firewall 403 is not a detection

A request refused by the firewall never reached any detector, so it is not a policy block. Look for it in the firewall's Stopped count, not in a detector's findings.


Automatic Bans

The runtime adds entries on its own when an origin's behavior crosses a risk threshold. They appear here marked as automatic, count in Decided by the runtime, and show in the Containment column of Attackers. Lift them like any other entry.

Playbooks can also add and lift blocks, for example to quarantine an end user for an hour and release them automatically.


Next Steps

Attackers

Find the origins worth blocking

Playbooks

Block and release automatically

Previous
Alerts