Installation

1. Install the ExtensionCopy Anchor Link

1. Go to /admin/extensions/extension?tab=installable Upload the file and install the extension.
2. (optional) Run php artisan account-protection:ip-whitelist:import-bundled cloudflare hetrixtools to add cloudflare/hetrix tools ip in whitelists

2. Configure the ExtensionCopy Anchor Link

Navigate to Admin → Extensions → Account Protection and review the configuration sections:

• Name Validation Threshold – scoring threshold for rejecting gibberish names (default 55%).
• License Key - run /get-license in discord (make sure your builtbybit accout is linked to discord or else create a ticket)
• vpnapi.io API Key – optional key for VPN/Proxy/Tor detection. Leave blank to disable reputation checks(free upto 1000 reqs/day).
• Block VPN / Proxy / Tor / Relay – choose which network types should be blocked when the API is enabled.
• IP Reputation Cache (minutes) – cache duration for safe results (default 1440 minutes).
• Max Accounts Per IP – limit the number of registrations per IP (0 disables the limit).
• Webhook Options – webhook URL and which events should emit notifications.

Save the configuration and clear caches if prompted (php artisan config:clear).

4. Verify Navigation AccessCopy Anchor Link

The extension registers an Account Protection group inside the Filament admin panel with these pages:

• Account Suspensions
• IP Bans
• IP Whitelist
• User IP Logs

If the pages are missing, ensure the migrations were applied and the extension is marked as enabled.

5. Test the SetupCopy Anchor Link

• Attempt a registration with random strings to see the validator in action.
• Manually create an IP ban/suspension and confirm forced logout.
• Review audit pages and verify webhook delivery.

The extension is now ready for production use.

---