vodoo security¶
Manage Vodoo API security groups and service accounts. See the full Security Guide for architecture details.
Commands¶
create-groups¶
Create or reuse the standard Vodoo security groups.
assign-bot¶
Assign a bot user to all Vodoo API security groups.
Options:
| Option | Type | Description |
|---|---|---|
--user-id / -u |
INT | User ID of the bot account |
--login |
TEXT | User login/email for the bot account |
--create-groups / --no-create-groups |
BOOL | Ensure Vodoo API groups exist before assigning (default: True) |
--keep-default-groups |
BOOL | Do not remove base.group_user or base.group_portal |
create-user¶
Create a new API service account user.
Creates a share user (not billed) with no default groups. Optionally assigns to all Vodoo API security groups.
NOTE: Requires admin credentials (Access Rights group).
Examples: vodoo security create-user "Bot User" bot@example.com vodoo security create-user "Bot User" bot@example.com --password MySecretPass123 vodoo security create-user "Bot User" bot@example.com --assign-groups
# With admin credentials:
ODOO_USERNAME=admin@example.com ODOO_PASSWORD=... vodoo security create-user ...
Arguments:
| Argument | Type | Description |
|---|---|---|
name |
TEXT | User's display name |
login |
TEXT | User's login (usually email) |
Options:
| Option | Type | Description |
|---|---|---|
--password / -p |
TEXT | User's password (generated if not provided) |
--email / -e |
TEXT | User's email (defaults to login) |
--assign-groups / --no-assign-groups |
BOOL | Assign user to all Vodoo API security groups |
--create-groups / --no-create-groups |
BOOL | Create Vodoo API groups if they don't exist (requires --assign-groups) (default: True) |
set-password¶
Set or reset a user's password.
NOTE: Requires admin credentials (Access Rights group).
Examples: vodoo security set-password --login bot@example.com vodoo security set-password --user-id 42 --password MyNewPassword123
Options:
| Option | Type | Description |
|---|---|---|
--user-id / -u |
INT | User ID |
--login / -l |
TEXT | User login/email |
--password / -p |
TEXT | New password (generated if not provided) |