Saltar al contenido principal

Visión general

Casdoor permite el uso de otras aplicaciones OAuth como método de inicio de sesión.

Actualmente, Casdoor soporta múltiples proveedores de aplicaciones OAuth. Los iconos de estos proveedores se mostrarán en las páginas de inicio de sesión y registro una vez que se hayan añadido a Casdoor. Los siguientes son los proveedores que Casdoor soporta:

ProveedorLogoProveedorLogoProveedorLogoProveedorLogo
ADFSAlipayAmazonApple
Auth0Azure ADAzure AD B2CBaidu
BilibiliBitbucketBoxCasdoor
Cloud FoundryDailymotionDeezerDigitalOcean
DingTalkDiscordTiktokDropbox
Eve OnlineFacebookFitbitGitea
GiteeGitHubGitLabGoogle
HerokuInfluxCloudInfoflowInstagram
IntercomKakaoLarkLastfm
LineLinkedInMailruMeetup
MicrosoftNaverNextcloudOkta
OneDriveOuraPatreonPayPal
QQSalesforceShopifySlack
SoundCloudSpotifySteamStrava
StripeTelegramTikTokTumblr
TwitchTwitterTypetalkUber
VKWeChatWeComWeibo
WePayXeroYahooYammer
YandexZoomCorreo electrónicoSMS
Battle.net

Te mostraremos cómo solicitar un servicio de terceros y añadirlo a Casdoor.

Solicitar para convertirse en desarrollador​

Antes de esto, hay algunos conceptos generales que necesitas entender.

  • RedirectUrl, Dirección de redirección después de la autenticación, rellena con la dirección de tu aplicación, como https://forum.casbin.com/
  • Scope, Permiso otorgado a ti por el usuario, como perfil básico, dirección de correo electrónico y publicaciones, entre otros.
  • ClientId/AppId, ClientKey/AppSecret, Esta es la información más importante, y es lo que necesitas obtener después de solicitar una cuenta de desarrollador. No puedes compartir la clave/secret con nadie.

Añadir un proveedor de OAuth​

  1. Ve a tu página de inicio de Casdoor.
  2. Haz clic en Providers en la barra superior.
  3. Haz clic en Add, y verás un nuevo proveedor añadido a la lista en la parte superior.
  4. Haz clic en el nuevo proveedor para hacer cambios en él.
  5. En la sección Category, selecciona OAuth.
  6. Elige el proveedor de OAuth específico que necesitas del menú desplegable Type.
  7. Rellena la información necesaria, como Client ID y Client Secret.

User Field Mapping​

OAuth providers often return additional user information beyond the standard profile fields. Casdoor's User Mapping feature allows you to automatically populate user profile fields from OAuth claims returned by your identity provider. This is particularly useful when integrating with enterprise identity providers like Okta, Azure AD, or other custom OAuth services that provide rich user metadata.

Automatic Account Linking​

When users authenticate via OAuth, Casdoor automatically attempts to link accounts using multiple strategies: existing OAuth links, email/phone matching (if enabled), and case-insensitive username matching. This is particularly useful for enterprises with existing users who want to enable OAuth authentication without requiring manual account linking.

OAuth Provider Token Access​

After users authenticate through OAuth providers, Casdoor stores the provider's access token in the user object. Your application can retrieve this token via the /api/get-account API to make authenticated calls to the third-party provider's APIs (e.g., GitHub API, Google Drive API) on behalf of the user. The token is only visible to the user themselves or organization admins. See the OAuth documentation for details.

Configuración de la Aplicación​

  1. Haz clic en Application en la barra superior y selecciona la aplicación deseada para editar.
  2. Haz clic en el botón de añadir proveedor y elige el proveedor recién añadido.
  3. Modifica los permisos del proveedor, como habilitar el registro, inicio de sesión y desvinculación.
  4. ¡Todo listo!