Getting Started

Deployment & Downloads

All downloadable artifacts are generated per license from your dashboard. Treat your license key like a password.

Downloads (per license)

In Console → Deployment, choose a runtime tab. The platform generates artifacts bound to the selected license_id:

  • PHP: clean agent.php with your API_URL and LICENSE_KEY embedded. Zero-code — just require the file.
  • PHP (no-code): a ZIP with agent.php + up_prepend.php for auto_prepend_file.
  • Node: a ZIP bundle containing .env + ultimateprotector.config.mjs.
  • Node (no-code): same ZIP + preload instructions (NODE_OPTIONS=--require @auraprotector/agent/preload).
  • Python: a ZIP bundle containing .env + ultimateprotector_config.py.
  • Python (no-code-ish): same ZIP + env-wrapper instructions (wrap_asgi_app).
  • WordPress: a ready-to-install plugin ZIP (folder at ZIP root, ready for upload).
  • Shopify: a JavaScript ScriptTag agent auto-registered via the Shopify Admin API, or a Liquid snippet for manual install.

PHP: agent.php

The PHP agent is a single-file thin client. Include it in your entrypoint — it auto-boots with the embedded license key. For examples, see Installation.

What gets embedded

  • API_URL and LICENSE_KEY are injected server-side at download time.
  • The agent auto-initializes on require — no manual protect() call needed.
  • All proprietary WAF logic is fetched as an encrypted payload and executed in memory only.

PHP: auto_prepend bundle (near-zero-code)

If you can’t edit your entrypoint, download the auto-prepend bundle. It contains agent.php plus a ready loader file up_prepend.php. Enable it via auto_prepend_file in .user.ini or .htaccess.

Node: config bundle

Download contains:

  • .env with UP_LICENSE_KEY + UP_API_URL
  • ultimateprotector.config.mjs (reads env vars)
  • README.md with copy/paste integration snippet

No-code option: set NODE_OPTIONS=--require @auraprotector/agent/preload (best-effort, fail-open).

# unzip bundle, then:
npm i @auraprotector/agent

# set env vars (example)
UP_LICENSE_KEY="UP_LIVE_..."
UP_API_URL="https://auraguardian.co/api"

Python: config bundle

Download contains:

  • .env with UP_LICENSE_KEY + UP_API_URL
  • ultimateprotector_config.py (reads env vars)
  • README.md with FastAPI/Starlette integration snippet

No-code-ish option: use from auraprotector_agent import wrap_asgi_app and keep config in env.

pip install auraprotector-agent

# set env vars (example)
UP_LICENSE_KEY="UP_LIVE_..."
UP_API_URL="https://auraguardian.co/api"

WordPress: plugin zip

Downloaded ZIP is ready for WordPress Admin upload (Plugins → Add New → Upload Plugin). The plugin ships with break-safe exclusions by default. Full details: WordPress Plugin.

Shopify: ScriptTag agent

The Shopify integration uses a lightweight (~2KB) JavaScript agent injected via the Shopify ScriptTag API. No theme files are modified.

Automated install

  1. Go to Console → Deployment → Shopify.
  2. Enter your store domain and authenticate via OAuth.
  3. The ScriptTag is registered automatically.

Manual install

Download the Liquid snippet from the deployment tab, create auraguardian.liquid in your theme snippets, and render it in theme.liquid. Full details: Shopify Integration.

Secrets & rotation

  • Do not commit UP_LICENSE_KEY to Git.
  • If a key leaks, rotate it in the dashboard and update your server/plugin settings.
  • Prefer environment variables for Node/Python. Prefer server-side config for PHP/WordPress.