Zum Hauptinhalt springen

Casdoor CLI

Casdoor CLI is the official command-line interface for Casdoor, providing a powerful and intuitive way to manage your Casdoor identity and access management system directly from the terminal.

GitHub repository: https://github.com/casdoor/casdoor-cli

Features​

OAuth2 Browser-Based Authentication​

The CLI uses a secure browser-based OAuth2 flow for authentication, ensuring your credentials are protected through Casdoor's standard authentication mechanism.

Secure Token Storage​

Credentials are safely stored using your system's keyring interface (GNOME Keyring on Linux, Keychain on macOS), ensuring tokens never touch disk in plaintext.

User Management​

Create, update, and delete users with ease directly from the command line.

Permission Management​

Control user permissions through Casdoor's group feature with built-in roles:

  • lector: Read-only access
  • editor: Can create users, with limited modification rights
  • administrator: Full control over user creation, modification, and deletion

Group Management​

Create, modify, and delete user groups to organize users and manage permissions efficiently.

Installation​

Prerequisites​

  • Go 1.22.0 or higher
  • macOS or Linux operating system
  • GNOME Keyring (Linux) or Keychain (macOS) for secure credential storage
Vorsicht

Platform Support: Currently supports macOS and Linux (tested on Debian 12 and macOS Sonoma). Windows support via WSL is not available as the CLI requires GNOME's Secret Service DBus interface (GNOME Keyring) for secure credential storage.

macOS​

make build TARGET_OS=darwin && make install TARGET_OS=darwin

Linux​

make build TARGET_OS=linux && make install TARGET_OS=linux

Configure Your Shell​

After installation, add casdoor-cli to your PATH:

For Bash users:

echo 'export PATH="/usr/local/bin:$PATH"' >> ~/.bashrc
source ~/.bashrc

For Zsh users:

echo 'export PATH="/usr/local/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc

Verify the installation:

casdoor --help

Configuration​

Casdoor server​

You need a Casdoor application for the CLI:

  1. Bootstrap data — Use the repo’s init_data.json and follow Data initialization.
  2. Manual — Create and configure an application in the Casdoor admin panel.

CLI Configuration​

On first run, the CLI prompts for a config.yaml with your Casdoor connection details. Use the repo’s config.yaml.example as a template.

Required configuration fields:

application_name: your-app-name
casdoor_endpoint: https://your-casdoor-instance.com
certificate: |
  -----BEGIN CERTIFICATE-----
  Your certificate content here
  -----END CERTIFICATE-----
client_id: your-client-id
client_secret: your-client-secret
organization_name: your-organization
redirect_uri: http://localhost:9000/callback

Your configuration will be securely stored in ~/.casdoor-cli/config.yaml (base64 encoded) for subsequent use.

Usage​

Available Commands​

Usage:
  casdoor [command]

Available Commands:
  completion  Generate the autocompletion script for the specified shell
  groups      Manage Casdoor permissions
  help        Help about any command
  login       Login to your Casdoor account
  logout      Logout from your Casdoor account
  users       Manage Casdoor users

Flags:
  -d, --debug   verbose logging
  -h, --help    help for casdoor

Login​

To authenticate with your Casdoor instance:

casdoor login

This will open your default browser for OAuth2 authentication.

Managing Users​

# List users
casdoor users list

# Create a user
casdoor users create

# Update a user
casdoor users update

# Delete a user
casdoor users delete

Managing Groups​

# List groups
casdoor groups list

# Create a group
casdoor groups create

# Update a group
casdoor groups update

# Delete a group
casdoor groups delete

Logout​

To logout from your Casdoor account:

casdoor logout

Development​

Local Development Environment​

A Docker Compose environment is provided in the repository for local testing and development:

docker compose up -d
Notiz

Allow a few moments for the Casdoor container to fully initialize. The container will restart multiple times as it sets up the database.

Development Configuration​

Create a config.yaml file from the provided config.yaml.example template at the repository root with your local development settings.

Testing the CLI​

Test the login functionality with the default development credentials provided in the repository documentation.

Run directly with Go:

go run main.go login

Or build and install first:

make build TARGET_OS=darwin && make install TARGET_OS=darwin  # For macOS
# OR
make build TARGET_OS=linux && make install TARGET_OS=linux    # For Linux

casdoor login