Proveedores
Un proveedor conecta Casdoor con un servicio externo, como un proveedor de identidad para inicio de sesión, un servicio de correo electrónico o un almacenamiento en la nube. Usted crea un proveedor una vez y luego lo agrega a las aplicaciones que lo utilizan.
Categorías de proveedores
| Category | Purpose |
|---|---|
| Audit | Send the audit records of Casdoor to a Syslog server. See Syslog audit provider |
| Captcha | Protect sign-in and sign-up with a captcha. See Captcha providers |
| Correo Electrónico | Send email, such as verification codes and notifications. See Email providers |
| Face ID | Recognize faces for Face ID sign-in. See Face ID providers |
| ID Verification | Verify the identity of users from ID documents. See Identity verification providers |
| Log | Forward permission audit events to a logging backend, or store them as entries. See Log providers |
| MFA | Provide a second factor, such as RADIUS. See MFA providers |
| Notification | Send messages to chat services, such as Slack and Telegram. See Notification providers |
| OAuth | Let users sign in with external identity providers, such as GitHub and Google. See OAuth providers |
| Pago | Take payments for products and subscriptions. See Payment providers |
| SAML | Let users sign in with external SAML identity providers. See SAML providers |
| Scan | Scan servers for security issues and MCP endpoints. See Scan providers |
| SMS | Send SMS verification codes. See SMS providers |
| Almacenamiento | Store files on the local file system or in cloud object storage. See Storage providers |
Quién puede usar un proveedor
Solo los administradores crean proveedores. La disponibilidad de un proveedor depende de quién lo creó:
| Created by | Available to |
|---|---|
A global administrator: a user of the built-in organization, or a user with IsGlobalAdmin | All applications |
An organization administrator: a user with IsAdmin | Applications of the same organization |
Los proveedores de registro de los tipos System Log, SELinux Log y Agent leen los registros del servidor Casdoor o aceptan datos en su dirección, por lo que solo un administrador global puede guardarlos. Si un administrador de organización intenta guardar uno, recibirá Unauthorized operation.
Qué direcciones puede alcanzar un proveedor
Un proveedor de una organización distinta de admin y built-in solo puede conectarse a direcciones de Internet. Casdoor rechaza direcciones privadas, de bucle invertido (loopback), de enlace local (link-local) y no especificadas, así como el espacio de direcciones compartido 100.64.0.0/10. Verifica la dirección a la que resuelve el nombre de host. Para solicitudes HTTP, verifica cada conexión, incluidas las redirecciones. Esto impide que un administrador de organización acceda a la red interna del servidor Casdoor, como una base de datos o un endpoint de metadatos de la nube, a través de un proveedor.
La regla cubre estas conexiones:
| Category | Connection |
|---|---|
The SMTP server, or the endpoint of Custom HTTP Email | |
| SMS | The endpoint of Custom HTTP SMS |
| Notification | The endpoint of Custom HTTP |
| Storage | The endpoint of the storage service |
| OAuth | The token, user info, and logout endpoints of the provider, and the OIDC discovery that the Request button fetches. The types GitHub, Google, Facebook, LinkedIn, Steam, Line, Amazon, Instagram, TikTok, Twitter, Uber, and Yahoo always use the proxy instead |
Para conectarse a un servicio en su red interna, como un servidor SMTP local, cree el proveedor como administrador global. Cuando un administrador de organización hace clic en Request en un proveedor OIDC, Casdoor aplica la misma regla a la búsqueda de descubrimiento, independientemente de la organización a la que pertenezca el proveedor.
Crear un proveedor
- En la consola de administración de Casdoor, vaya a Identity > Providers y agregue un proveedor.
- Seleccione la Category y el Type. Casdoor rellena Name y Display name: el nombre sigue el patrón
provider_<category>_<type>, y el nombre visible es<Category> <Type>. Casdoor deja de actualizar un campo una vez que usted lo edita manualmente. - Complete los campos del tipo. La página de cada tipo de proveedor los enumera.
- Guarde el proveedor.
Agregar un proveedor a una aplicación
Un proveedor tiene efecto solo en las aplicaciones a las que lo agregue.
-
Abra la página de edición de la aplicación, vaya a la pestaña Providers y agregue una fila.

-
Seleccione el proveedor. La lista muestra todos los proveedores disponibles para la aplicación.

-
Para proveedores OAuth y captcha, configure cómo los usa la aplicación. Consulte Agregar proveedores a una aplicación y Configurar el captcha predeterminado.

-
Guarde la aplicación.