メインコンテンツにスキップ

概要

Introduction​

All users associated with a single Casdoor organization share access to the organization's applications. しかし、特定のアプリケーションやアプリケーション内の特定のリソースへのユーザーアクセスを制限したい場合があるかもしれません。 そのような場合、Casbinによって提供されるPermission機能を利用することができます。

Understanding Casbin Concepts​

Before delving deeper into the topic, it is important to have a basic understanding of how Casbin works and its related concepts:

  • Model: Defines the structure of your permission policies and the criteria for matching requests against these policies and their outcomes. You can configure models in the Models page in Casdoor.
  • Policy: Describes the specific permission rules (who can access what resources with what actions). You configure policies in the Permissions page in Casdoor.
  • Adapter: An abstraction layer that shields Casbin's executor from the source of the Policy, allowing the storage of Policies in various locations like files or databases. Learn more about Adapters.
ヒント

Learn More About Casbin

Visit the Casbin documentation to learn more about access control models and patterns. You can also use the Casbin Online Editor to create and test Model and Policy files for your specific scenarios.

Configuring Permissions in Casdoor​

Where to Configure​

In the Casdoor Web UI, you'll work with two main pages:

  1. Models Page: Navigate to Models in the sidebar to add or edit Models for your organization.

    Model Edit Page

  2. Permissions Page: Navigate to Permissions in the sidebar to configure permission policies.

    Permission Edit Page

How Permissions Work​

Returning to the subject of permission configuration in Casdoor:

  1. Add a Model: First, create a Model for your organization in the Models page within the Casdoor Web UI.
  2. Configure a Policy: Then, add a Policy (permission rules) for your organization in the Permissions page.

Casbinオンラインエディターは、特定の使用シナリオに合わせたモデルとポリシーのファイルを提供することができます。 CasdoorのWeb UIを通じてモデルファイルを簡単にインポートし、内蔵されたCasbinによって使用することができます。 For the Policy configuration (i.e., the Permissions page in the Casdoor Web UI), refer to the Permission Configuration guide for detailed instructions.

Using Permissions with Your Application​

あなたのアプリケーションがCasdoorの内蔵Casbinを通じて権限制御を実施する必要があるように、Casdoor自体も独自のモデルとポリシーを使用してCasbinを通じてAPIインターフェースのアクセス権を規制します。 Casdoorは内部コードからCasbinを呼び出すことができますが、外部アプリケーションはできません。

解決策として、Casdoorは内蔵Casbinを呼び出すためのAPIを外部アプリケーションに公開します。 See the Exposed Casbin APIs documentation for definitions of these API interfaces and instructions on how to use them.

Account Item Permissions​

Casdoor also provides fine-grained permission control at the user account field level through the Edit Organization page:

  • View rule: Control who can view specific user account fields
  • Modify rule: Control who can modify specific user account fields

These rules can be set to:

  • Public: Everyone has permission
  • Self: Each user has their own permission
  • Admin: Only administrators have permission

Learn more in the Account Customization documentation.

Role-Based Access Control​

Casdoor supports role-based permissions where you can assign roles to users and configure permission policies for these roles. This allows you to manage permissions at the role level rather than individual user level.

Next Steps​

始めましょう！