概要

Providers in Casdoor are connectors to third-party services. This section describes the provider types and how to add and use them.

Provider types

Casdoor supports the following provider types:

Type	Purpose
OAuth	Sign-in via external identity providers (e.g. GitHub, Google, QQ). See OAuth.
SMS	Send SMS verification codes for phone number verification.
メール	Send email (e.g. verification codes, notifications).
ストレージ	Store files on the local filesystem or cloud object storage (e.g. S3, OSS).
支払い	Accept payments (e.g. Alipay, WeChat Pay, PayPal). Used for products and subscriptions.
キャプチャ	Protect sign-in and sign-up with captcha (Default, reCAPTCHA, hCaptcha, Cloudflare Turnstile, Alibaba Cloud, etc.).
Identity verification	Verify user identity via third-party services (e.g. Jumio) using ID documents.
MFA	Second-factor authentication (e.g. RADIUS) for multi-factor authentication.
Log	Forward permission audit events to an external logging backend (e.g. syslog) or store them as Casdoor Entry records. See Log providers.

Scope and permissions

Only administrators can add and configure providers. Visibility of providers depends on who created them:

• Global administrators: Users in the built-in organization or with IsGlobalAdmin enabled. Providers they create can be used by all applications.
• Organization administrators: Users with IsAdmin enabled. Providers they create can be used only by applications in the same organization (behavior may evolve in future releases).

Auto-naming

When creating a new provider, the Name and Display name fields are auto-populated as you select the Category and Type. The name follows the pattern provider_{category}_{type} (slugified), and the display name is {Category} {Type}. These are updated automatically as long as you haven't manually edited the fields. Once you type in either field, auto-fill stops for that field.

Adding a provider to an application

A provider must be added to an application before it can be used. Steps:

1. Open the application edit page and add a new provider row.

   

2. Choose the provider to attach. The list shows all providers available to that application.

   

3. For OAuth and Captcha providers, further configure how they are used. See OAuth and Captcha.

   

4. Save the application. The provider is now available for that application.