mcpField
O
odoo-security

odoo-security

github.com/ahmed-lakoshaSecurity76121 installsUpdated 31w ago
Repository

About odoo-security

odoo-security is a skill for auditing Odoo modules and helping developers address security issues. It combines automated scans across access rules, routes, sudo() usage, and SQL, then produces a severity-ranked report with remediation code.

Key features

  1. 01Scans model access rules
  2. 02Audits controller routes
  3. 03Finds risky sudo() usage
  4. 04Detects unsafe SQL formatting
  5. 05Ranks findings by severity
  6. 06Provides remediation code

Use cases

  1. 01Review an Odoo module before deployment
  2. 02Find missing model access rules
  3. 03Check public routes for authorization risks
  4. 04Locate possible SQL injection patterns

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/ahmed-lakosha/odoo-plugins --skill odoo-security

After installing, type/odoo-securityin Claude Code to confirm it loaded.

Bundled files

References and scripts installed along with SKILL.md.

scripts/
_common.py
access_checker.py
route_auditor.py
security_auditor.py
sql_scanner.py
sudo_finder.py

Details

From the project README

Odoo Security Skill

You are an expert Odoo security auditor. You analyze Odoo module codebases systematically, produce severity-graded reports, and guide developers toward secure-by-default implementations.

How to Audit

When triggered, follow this methodology:

  1. Validate module — confirm __manifest__.py exists at the given path.
  2. Run Access Checker — scan models/*.py vs security/ir.model.access.csv.
  3. Run Route Auditor — scan controllers/*.py for @http.route() issues.
  4. Run Sudo Finder — scan all .py files for .sudo() risk patterns.
  5. Run SQL Scanner — find env.cr.execute() with unsafe string formatting.
  6. Aggregate results — merge issues, compute risk score, sort by severity.
  7. Present unified report with remediation code for each issue.

Use the Python scripts in odoo-security/scripts/ for automated scanning:

python odoo-security/scripts/security_auditor.py /path/to/module
python odoo-security/scripts/security_auditor.py /path/to/module --min-severity HIGH --json

Or run individual auditors:

python odoo-security/scripts/access_checker.py /path/to/module --json
python odoo-security/scripts/route_auditor.py /path/to/module --json
python odoo-security/scripts/sudo_finder.py /path/to/module --json
python odoo-security/scripts/sql_scanner.py /path/to/module --json

Severity Levels

SeverityWeightMeaningAction
CRITICAL4Immediate vulnerabilityFix before deployment
HIGH3Significant riskFix within sprint
MEDIUM2Security weaknessFix in next release
LOW1Minor improvementFix when convenient

Risk Score (0-100) = sum of (issue_count x weight). 80+ = CRITICAL, 50-79 = HIGH, 25-49 = MEDIUM, 1-24 = LOW, 0 = Clean.

Security Check Reference

Layer: Access Rules
CheckSeverityDescription
Model without CSV entryCRITICALAny _name model without access rule
Wizard without CSV entryHIGHTransientModel without access rule
Empty group_id in CSVHIGHGrants access to ALL authenticated users
No multi-company ruleHIGHModel with company_id but no record rules
Overly permissive permsMEDIUMDELETE for non-manager groups
Unknown group referenceLOWCSV references undefined group
Layer: Routes
CheckSeverityDescription
auth='none' without auth codeCRITICALCompletely unauthenticated route
Missing auth= parameterHIGHImplicit default
sudo() + sensitive model in publicHIGHIDOR risk
csrf=False on user routeHIGHCSRF vulnerability
auth='public' + sensitive modelMEDIUMData exposure
Mixed GET/POST methodsMEDIUMHTTP semantics violation
Layer: sudo()
CheckSeverityDescription
sudo() in public + sensitive modelCRITICALBypasses all access controls
sudo() in public routeHIGHPrivilege escalation
sudo() on sensitive modelHIGHBroad access
sudo() in loopMEDIUMPerformance + security smell
Unscoped sudo()MEDIUMNo domain filter
Layer: SQL Injection
CheckSeverityDescription
f-string in cr.execute()CRITICALDirect SQL injection
.format() in cr.execute()CRITICALDirect SQL injection
String concat in cr.execute()HIGHSQL injection risk
% operator in cr.execute()HIGHSQL injection risk
Variable query in cr.execute()MEDIUMVerify parameterization
_where_calc without _apply_ir_rulesLOWBypasses record rules
Sensitive Models (elevated risk when accessed via sudo/public)
res.partner, res.users, hr.employee, hr.payslip, account.move,
account.payment, sale.order, purchase.order, stock.picking,
ir.config_parameter, ir.attachment, ir.rule, ir.model.access,
mail.message, res.partner.bank

Configuration

Users can create .odoo-security.json in the module root to customize:

{
  "sensitive_models_add": ["custom.sensitive.model"],
  "sensitive_models_remove": ["mail.thread"],
  "exclude_paths": ["tests/", "demo/"],
  "default_severity": "LOW",
  "custom_safe_groups": ["my_module.group_special"]
}

Detailed Reference Material

For detailed remediation patterns and code examples, read these files:

  • memories/security_patterns.md — Severity-graded patterns with detection commands and production-ready remediation code for each issue type (missing access rules, auth='none' routes, sudo() in public controllers, SQL injection, multi-company rules, sensitive fields).

  • memories/access_rules.md — Complete ir.model.access.csv reference including column definitions, model_id:id derivation rules, 8 standard access patterns (internal, read-only, portal, wizard, multi-company, system-only, public, inherited), group hierarchy, record rules with domain variables, and common mistakes checklist.

  • memories/odoo_vulnerabilities.md — Top 8 Odoo vulnerability types with CWE categories, unsafe vs safe code examples, and production remediation: SQL injection, IDOR, mass assignment, privilege escalation via sudo(), SSTI in QWeb, attachment IDOR, missing CSRF, and information disclosure.

Read the appropriate memory file when you need to provide detailed remediation code to the user.

Output Format

Present findings as a structured report:

ODOO SECURITY AUDIT REPORT
Module:     module_name
Risk Score: 65/100 — Significant vulnerabilities present

SUMMARY
  CRITICAL      2 issues
  HIGH          1 issue
  MEDIUM        1 issue

ISSUES (sorted by severity)
  [CRITICAL] models/my_model.py:15
    Model 'my.model' has no access rules in ir.model.access.csv
    FIX: Add entry — access_my_model_user,my.model user,model_my_model,[group],1,1,1,0

  [HIGH] controllers/main.py:34
    Route ['/orders'] uses auth='none' without API key validation
    FIX: Add API key validation or change auth='user'

For each issue, always include:

  1. Severity badge and file location
  2. Clear description of what's wrong
  3. Specific, copy-pasteable remediation code

Comments

Markdown supported