dreamfactory/df-oauth

OAuth support for DreamFactory Platform 2.0

1.0.3 2026-05-27 16:05 UTC

Requires

• php: ^8.3
• ext-json: *
• dreamfactory/df-core: ~1.0.4
• laravel/helpers: ^1.8
• laravel/socialite: ^5.20
• socialiteproviders/microsoft-live: ^4.1
• socialiteproviders/twitter: ^4.1

Requires (Dev)

• laravel/framework: ^13.7
• mockery/mockery: ^1.6
• nunomaduro/collision: ^8.6
• orchestra/testbench: ^11.0
• phpunit/phpunit: ^11.5.3

Apache-2.0

• Arif Islam
• Lee Hicks

• rest
• api
• oauth
• dreamfactory

README

DreamFactory OAuth support.

Overview

DreamFactory is a secure, self-hosted enterprise data access platform that provides governed API access to any data source, connecting enterprise applications and on-prem LLMs with role-based access and identity passthrough.

Configure DreamFactory OAuth Connector

1. Log in to the DreamFactory admin interface.
2. Navigate to Security > Authentication > Add Service.
3. Choose the desired provider from the Service Type dropdown.
4. Enter the required details:
   • Namespace: Must end with _oauth (e.g., github_oauth).
   • Label: Example: GitHub Sign In. This label will be displayed on DreamFactory's login page as the text on the provider's sign-in button.
   • Client ID: Obtained from the provider's application settings.
   • Client Secret: Obtained from the provider's application settings.
   • Redirect URL: This must match the provider's application settings and the DreamFactory configuration. It should point to the /sso endpoint.
     • Example: If your namespace is github_oauth, the redirect URL should be:

       https://your-dreamfactory-instance.com/api/v2/github_oauth/sso
       

5. Save the configuration.
6. Log out, reload the page, and the new OAuth login option for the configured provider should be visible.