跳到主内容

概述

An organization is the basic unit of Casdoor that manages users and applications. When a user signs in to an organization, they can access all applications belonging to that organization without needing to sign in again.

In the configuration of applications and providers, selecting an organization is important, as it determines whether users can access the application using specific providers.

You can also set up LDAP in Casdoor. 更多详细信息,请参阅 LDAP 文档

Casdoor provides multiple password storage algorithms that can be selected on the organization edit page. New organizations use bcrypt by default for secure password hashing.

名称算法描述场景
plain-The password will be stored in cleartext. Not recommended for production use.-
saltSHA-256SHA-256 是一个获得专利的加密哈希函数,输出256位长的值。-
md5-saltMD5MD5 message-digest algorithm是一种加密中断但仍广泛使用的哈希函数,可产生128位哈希值。Discuz!
bcryptbcryptbcrypt is a password-hashing function used to hash and salt passwords securely. This is the default for new organizations.Spring Boot, WordPress
pbkdf2-saltSHA256 与 PBKDF2PBKDF2 是一个简单的派生函数,能够抵制字典攻击和彩虹表攻击. 它是 Cassdoor 为 Keycloak 同步器而采用的原生实现。 如果您通过 Keycloak 同步器导入用户,请选择此选项。Keycloak

Password Salt Configuration

For algorithms that use salts (salt, md5-salt, pbkdf2-salt), Casdoor provides flexible salt configuration. On the organization edit page, you can set the Password salt field to define how passwords are salted:

  • Organization-level salt: When the Password salt field is set, all users in the organization share the same salt value. This ensures consistency across the organization.
  • Per-user random salt: When the Password salt field is left empty, Casdoor automatically generates a unique random salt for each user. This provides better security by preventing attackers from using precomputed hash tables across multiple users.

The per-user salt approach is recommended for new deployments as it provides stronger security against rainbow table attacks. Each user's salt is stored alongside their password hash and is automatically managed by Casdoor.

Use Email as Username

Organizations can enable the "Use email as username" option, which automatically uses the user's email address as their username during signup when the username field is not visible. This simplifies the registration process by eliminating the need for users to choose a separate username.

When this option is enabled:

  • During signup, if the username field is hidden, the email address becomes the username automatically
  • When users reset their email address, their username is updated to match the new email
  • The system maintains consistency between the email and username fields

To enable this feature, check the "Use email as username" option on the organization edit page.

提示

In addition to logging into Casdoor via an application (which redirects to Casdoor for SSO), Casdoor users can also choose to log in directly via the organization's login page: /login/<organization_name>, e.g., https://door.casdoor.com/login/casbin on the demo site.