Saltar al contenido principal

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​

CategoryPurpose
AuditSend the audit records of Casdoor to a Syslog server. See Syslog audit provider
CaptchaProtect sign-in and sign-up with a captcha. See Captcha providers
Correo ElectrónicoSend email, such as verification codes and notifications. See Email providers
Face IDRecognize faces for Face ID sign-in. See Face ID providers
ID VerificationVerify the identity of users from ID documents. See Identity verification providers
LogForward permission audit events to a logging backend, or store them as entries. See Log providers
MFAProvide a second factor, such as RADIUS. See MFA providers
NotificationSend messages to chat services, such as Slack and Telegram. See Notification providers
OAuthLet users sign in with external identity providers, such as GitHub and Google. See OAuth providers
PagoTake payments for products and subscriptions. See Payment providers
SAMLLet users sign in with external SAML identity providers. See SAML providers
ScanScan servers for security issues and MCP endpoints. See Scan providers
SMSSend SMS verification codes. See SMS providers
AlmacenamientoStore 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 byAvailable to
A global administrator: a user of the built-in organization, or a user with IsGlobalAdminAll applications
An organization administrator: a user with IsAdminApplications 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:

CategoryConnection
EmailThe SMTP server, or the endpoint of Custom HTTP Email
SMSThe endpoint of Custom HTTP SMS
NotificationThe endpoint of Custom HTTP
StorageThe endpoint of the storage service
OAuthThe 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​

  1. En la consola de administración de Casdoor, vaya a Identity > Providers y agregue un proveedor.
  2. 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.
  3. Complete los campos del tipo. La página de cada tipo de proveedor los enumera.
  4. Guarde el proveedor.

Agregar un proveedor a una aplicación​

Un proveedor tiene efecto solo en las aplicaciones a las que lo agregue.

  1. Abra la página de edición de la aplicación, vaya a la pestaña Providers y agregue una fila.

    Add button in the Providers table

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

    Provider list of the application

  3. 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.

    Settings of a provider in the application

  4. Guarde la aplicación.

Véase también​