Skip to main content

Casdoor Basic Configuration Guide

This document describes how to configure Casdoor from scratch. Most configurations in this tutorial are already set up after installation. If you need to add users, refer to the Add Users section.

Configuration Page​

Accessing the Configuration Page​

Visit http://{COSTRICT_BACKEND}:{PORT_CASDOOR} to access the admin login page.

Default username: admin
Default password: 123

Then proceed to the admin dashboard.

Add Organization​

The organization you create here will store all CoStrict users. The organization name is not critical and can be customized.

image-20260120095700101

image-20260120095741985

Add Application​

This will be the application used for CoStrict login. The application name is not critical and can be customized.

image-20260120095801365

image-20260120102644577

The Client ID and Client Secret correspond to the OIDC_CLIENT_ID and OIDC_CLIENT_SECRET variables in the deployment directory's configure.sh, for example:

9e2fc5d4fbcd52ef4f6f
ab5d8ba28b0e6c0d6e971247cdc1deb269c9eea3

The organization field should be set to the organization created in the previous step.

image-20260120101039642

For the redirect URLs, update the IP and port to match the COSTRICT_BACKEND_BASEURL IP and port defined in the deployment directory's configure.sh file. (Note: choose http or https based on your setup. Following this tutorial completely means using http — use the actual IP and port, not variables.)

One-click deployment sets a wildcard by default. For better security, you may update this accordingly.

http://ip:port/oidc-auth/api/v1/plugin/login/callback
http://ip:port/oidc-auth/api/v1/manager/bind/account/callback
http://ip:port/oidc-auth/api/v1/manager/login/callback

image-20260120100515628

Finally, save the current application.

Add Users​

Navigate to the organization's user list, then click Add.

image-20260120102919337

Add a demo user and click Save & Exit.

image-20260120103025347

After adding, you can update the password:

image-20260120103919026

image-20260120103933033

If you need to import users in bulk, refer to the official documentation: Import Users from XLSX File

Configuration is complete. You can now log in to CoStrict (not Casdoor) using the demo user. For additional configurations such as OAuth, SMS, GitHub, etc., refer to: v4 casdoor configuration