Medium Risk

opn_add_alias

opn_add_alias

How to control opn_add_alias ↓

What opn_add_alias does on OPNsense MCP Server

AI agents use opn_add_alias to create or update resources in OPNsense MCP Server — usually the action step of a workflow, after the agent has gathered context. Every call changes real data in your OPNsense MCP Server environment.

Medium Risk

Why opn_add_alias needs a policy

This tool creates or adds a new alias configuration in OPNsense, which modifies firewall state reversibly. Aliases are foundational firewall objects that can affect traffic filtering and routing when referenced by rules. Misuse could allow an AI agent to add malicious IP/network aliases that redirect or intercept traffic.

From the tool's definition Tool name 'opn_add_alias' indicates a create/add operation on OPNsense firewall configuration. No description provided, but contextual sibling tools (opn_add_firewall_rule, opn_add_nat_rule, opn_add_dns_override) all perform reversible configuration…

Documented attack patterns abuse exactly the kind of access opn_add_alias gives an agent:

How to control opn_add_alias

PolicyLayer is an MCP gateway — it sits between your AI agents and OPNsense MCP Server, and nothing reaches the server without passing your rules. This is the rule we recommend for opn_add_alias:

policy.json
{
  "version": "1",
  "default": "deny",
  "tools": {
    "opn_add_alias": {
      "limits": [
        {
          "counter": "opn_add_alias_rate",
          "window": "minute",
          "max": 30,
          "scope": "grant"
        }
      ]
    }
  }
}

opn_add_alias stays usable, but capped — an agent stuck in a loop can't make hundreds of changes a minute. Everything else on the server is denied unless you say otherwise.

  1. Create a free account and register OPNsense MCP Server — nothing to install.
  2. Add this policy — paste it, or build it visually.
  3. Point your MCP client (Claude, Cursor, anything) at your gateway URL.
LIMIT THIS TOOL →

Free to start. No card required.

Related tools and policies

Go deeper

Questions about opn_add_alias

What does the opn_add_alias tool do? +

opn_add_alias. It is categorised as a Write tool in the OPNsense MCP Server MCP Server, which means it can create or modify data. Consider rate limits to prevent runaway writes.

How do I enforce a policy on opn_add_alias? +

Register the OPNsense MCP Server MCP server in PolicyLayer and add a rule for opn_add_alias: allow, deny, rate-limit, or require approval. Point your MCP client at the PolicyLayer proxy URL and the rule is enforced on every call, before it reaches OPNsense MCP Server. Nothing to install.

What risk level is opn_add_alias? +

opn_add_alias is a Write tool with medium risk. Write tools should be rate-limited to prevent accidental bulk modifications.

Can I rate-limit opn_add_alias? +

Yes. Add a rate_limit block to the opn_add_alias rule in your PolicyLayer policy. For example, setting max: 10 and window: 60 limits the tool to 10 calls per minute. Rate limits are tracked per agent session and reset automatically.

How do I block opn_add_alias completely? +

Set action: deny in the PolicyLayer policy for opn_add_alias. The AI agent will receive a policy violation error and cannot call the tool. You can also include a reason field to explain why the tool is blocked.

What MCP server provides opn_add_alias? +

opn_add_alias is provided by the OPNsense MCP Server MCP server (lucamarien/opnsense-mcp-server). PolicyLayer sits as a proxy in front of this server to enforce policies before tool calls reach the server.

Enforce policy on every OPNsense MCP Server tool call.

Start from OPNsense MCP Server, add the rest of your stack, and see everything your agents can call. Then put policy on all of it.

Free to start. No card required.

81 OPNsense MCP Server tools catalogued and risk-classified — across an index of 43,000+ MCP servers.

// GET IN TOUCH

Have a question or want to learn more? Send us a message.

Message sent.

We'll get back to you soon.