https://github.com/perufitlife/appwrite-security-skill
Open-source Appwrite security auditor: detects 'any' role grants, document security misconfig, over-permissive collection permissions. Active probe confirms each leak.
https://github.com/perufitlife/appwrite-security-skill
appwrite audit auditor baas cli devsecops leak mit-license nodejs open-source penetration-testing scanner security security-audit typescript vulnerability
Last synced: 1 day ago
JSON representation
Open-source Appwrite security auditor: detects 'any' role grants, document security misconfig, over-permissive collection permissions. Active probe confirms each leak.
- Host: GitHub
- URL: https://github.com/perufitlife/appwrite-security-skill
- Owner: Perufitlife
- License: mit
- Created: 2026-05-09T10:35:43.000Z (about 2 months ago)
- Default Branch: master
- Last Pushed: 2026-06-21T12:49:39.000Z (5 days ago)
- Last Synced: 2026-06-21T14:34:24.050Z (5 days ago)
- Topics: appwrite, audit, auditor, baas, cli, devsecops, leak, mit-license, nodejs, open-source, penetration-testing, scanner, security, security-audit, typescript, vulnerability
- Language: JavaScript
- Homepage: https://perufitlife.github.io/supabase-security-skill/
- Size: 37.1 KB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Funding: .github/FUNDING.yml
- License: LICENSE
Awesome Lists containing this project
README
# Appwrite Security Auditor
> Audit any Appwrite project for over-permissive collection/document permissions. Get a shareable HTML report with a fix snippet on every finding. **Active probe fetches data anonymously to PROVE leaks live — not just infer them.**
> ▶ **Run it without installing anything →** [apify.com/renzomacar/appwrite-security-auditor](https://apify.com/renzomacar/appwrite-security-auditor) (paste endpoint + project ID + API key, get HTML report)
> ⚡ Want me to run it for you and send back a written report? **$99, 24h delivery →** https://perufitlife.github.io/supabase-security-skill/ (one landing covers all five — Supabase, PocketBase, Appwrite, Hasura, Firebase)
> 🔁 **Want this running on a cron?** [RLS Monitor](https://rls-monitor.vercel.app/) does weekly diff-based scans + email alerts when new findings appear — $29/mo, your keys never leave your CI.
>
> 📦 **Need all 5 BaaS stacks at once?** The [BaaS Security Pack](https://perufitlife.github.io/supabase-security-skill/pack.html) bundles every scanner + sample reports + fix-SQL libraries — one $99 download.
> 🪞 **Sister tool**: [aitells](https://aitells.vercel.app/) detects + rewrites AI fingerprints in your text (em-dashes, "delve", parallel bullets). Free detector + $19 lifetime rewriter at [/rewrite](https://aitells.vercel.app/rewrite).
[](https://www.npmjs.com/package/appwrite-security)  
> **Sister tools** for other BaaS platforms (same `--discover` flag, all MIT):
> [supabase-security](https://www.npmjs.com/package/supabase-security) · [pocketbase-security](https://www.npmjs.com/package/pocketbase-security) · [firebase-security](https://www.npmjs.com/package/firebase-security) · [nhost-security](https://www.npmjs.com/package/nhost-security) · [strapi-security](https://www.npmjs.com/package/strapi-security) · [directus-security](https://www.npmjs.com/package/directus-security) · [convex-security](https://www.npmjs.com/package/convex-security) · [hasura-security](https://www.npmjs.com/package/hasura-security) · [payload-security](https://www.npmjs.com/package/payload-security)
## Why this exists
Appwrite has a powerful but easy-to-misuse permission model: collections can grant operations (`read`, `list`, `create`, `update`, `delete`) to roles like `any`, `users`, `team:`, or `user:`. Three patterns I see over and over:
- **`any` role on read or list** — the collection is fully public. Anyone can dump every document without auth.
- **`users` role too broadly** — any signed-up user (including a self-registered anonymous one) reads or writes the entire collection.
- **Document Security disabled** — collection-level perms apply to ALL documents. A single broad rule exposes everything.
This auditor surfaces all of them across every database/collection in your project in one command.
## Install + run
```bash
APPWRITE_ENDPOINT=https://cloud.appwrite.io/v1 \
APPWRITE_PROJECT_ID=your-project-id \
APPWRITE_API_KEY=your-server-key \
npx appwrite-security --html report.html
```
Or:
```bash
npx appwrite-security \
--endpoint https://cloud.appwrite.io/v1 \
--project xxx \
--key xxx \
--html report.html
```
## What it checks
| # | Check | Severity |
|---|---|---|
| 1 | Permission grants `any` role (anyone can perform op) | **CRITICAL** |
| 2 | Permission grants `users` role (every signed-up user passes) | HIGH |
| 3 | Document Security OFF on permission-protected collection | HIGH |
| 4 | Team-based permission lacks role specificity | MEDIUM |
| 5 | OAuth2 provider misconfig | MEDIUM |
| 6 | Email auth without verification | MEDIUM |
## Active probe
Default: ON. After detecting a `read("any")` or `list("any")` permission, the auditor sends an **anonymous GET** to `/v1/databases/{db}/collections/{col}/documents?queries[]=limit(1)`. If documents come back, the finding is `confirmed: true` with row count, columns visible, and bytes leaked.
`--no-probe` disables the live fetch (passive metadata-only mode).
## How to get an API key
1. Open your Appwrite console → Project Settings → API Keys → "Create API Key"
2. Required scopes: `databases.read`, `collections.read`, `projects.read`
3. Copy the key immediately (Appwrite shows it only once)
The key is used only for this run's metadata reads. Never persisted.
## License + source
MIT. Open source: https://github.com/Perufitlife/appwrite-security-skill
For Supabase, see https://github.com/Perufitlife/supabase-security-skill
For PocketBase, see https://github.com/Perufitlife/pocketbase-security-skill
## Want it done for you?
Two productized services:
- [**Vibe-code Security Review** — $199 / 48h](https://buy.stripe.com/bJe00jgik4EqdWV2iScAo0n) — I review your AI-generated code (Cursor / Claude / v0 / Bolt) and ship a PDF with fixes ranked by exploitability.
- [**Sandbox-as-a-Service** — $499 / 48h](https://buy.stripe.com/aFa7sLc243Amf0Z5v4cAo0l) — custom partner integration sandbox built for your API.
## Integration pattern reference
See [`rotatepilot-skyx-sandbox`](https://github.com/Perufitlife/rotatepilot-skyx-sandbox) for a live demo of how a partner consumes one of our public REST APIs in a single static page — built 12-may-2026 in response to an aviation-platform partnership inbound. Same JSON-contract / CORS / edge-served approach we use for `appwrite-security` integrations.
## Sister AI text tools
If your team writes outreach, PR descriptions, or social posts with AI, the [aitells](https://aitells.vercel.app) ecosystem catches the fingerprints before they ship:
- [`@perufitlife/aitells-mcp`](https://www.npmjs.com/package/@perufitlife/aitells-mcp) — MCP server for Claude Code / Cursor. `detect_ai_tells` + `humanize_text` as native tools.
- [`Perufitlife/aitells-action`](https://github.com/Perufitlife/aitells-action) — GitHub Action that scans PR titles/bodies/commits for AI patterns. Posts friendly summary comment.
- [aitells.vercel.app](https://aitells.vercel.app) — free detector + $19 lifetime humanizer (first 100 buyers)
---
📚 Part of [**Awesome Backend Security Auditors**](https://github.com/Perufitlife/awesome-backend-security) — the full collection of keyless active-probe auditors.