Weave Code
Propelauth Laravel Package
socialiteproviders/propelauth
PropelAuth OAuth2 provider for Laravel Socialite. Adds PropelAuth as a login option in your Laravel app, handling the OAuth2 flow so users can sign in or register with their PropelAuth account through the familiar Socialite interface.
PropelAuth provider for Laravel Socialite adds OAuth2 authentication through PropelAuth to your Laravel app. It plugs into Socialite’s familiar redirect/callback flow, letting users sign in via your PropelAuth instance—including B2B organizations and SSO configured there—without custom OAuth code.
- Drop-in Socialite driver for PropelAuth
- Configurable PropelAuth instance/auth URL
- Standard OAuth2 redirect and callback handling
- Retrieves user profile data from PropelAuth
- Works with Laravel’s existing Socialite setup
Frequently asked questions about Propelauth
- How do I install the socialiteproviders/propelauth package in Laravel?
- Install it with Composer using composer require socialiteproviders/propelauth. If your app does not already use SocialiteProviders, add the SocialiteProviders Manager listener so the PropelAuth driver can be registered. Then add your PropelAuth credentials to the Laravel services configuration.
- How do I configure PropelAuth credentials for Laravel Socialite?
- Add a PropelAuth entry to config/services.php with the client ID, client secret, and redirect URI from your PropelAuth application. Prefer loading these values from environment variables rather than committing secrets. Make sure the redirect URI exactly matches the callback URL registered in PropelAuth.
- What Socialite driver name does this PropelAuth provider register?
- The package provides a dedicated PropelAuth OAuth driver for Laravel Socialite. Use the driver name documented by the package when calling Socialite::driver(...). The driver keeps the standard Socialite redirect and callback API while handling PropelAuth-specific OAuth details.
- What redirect and callback routes do I need for PropelAuth SSO?
- Create one route that returns Socialite::driver('propelauth')->redirect() and another callback route that calls Socialite::driver('propelauth')->user(). Register the callback URL in your PropelAuth application settings. Keep the configured redirect URI consistent between Laravel and PropelAuth.
- Do I need the SocialiteProviders Manager listener for this package?
- Yes, this package is part of the SocialiteProviders ecosystem and is typically registered through the SocialiteProviders Manager listener. Add the listener to your app if it is not already present. This lets Laravel Socialite resolve the PropelAuth driver from the package.
- Which Laravel versions are supported by socialiteproviders/propelauth?
- Laravel version support depends on the package's Composer constraints, so check its composer.json and Packagist release notes before upgrading. The provider is designed for Laravel applications using Laravel Socialite. If you are on an older Laravel release, confirm compatibility before installing in production.
- How can I test PropelAuth login locally in a Laravel app?
- Use a local callback URL that PropelAuth can reach, such as a tunnel URL, and register that exact URL in the PropelAuth dashboard. Put test client credentials in your local environment file and complete the redirect and callback flow. Avoid using production secrets or production redirect URIs for local testing.
- Is socialiteproviders/propelauth suitable for production SSO?
- It can be used for production SSO because it plugs PropelAuth into Laravel Socialite's standard OAuth redirect and callback flow. Store client secrets in environment variables, use HTTPS callback URLs, and verify the redirect URI in PropelAuth. Test the full login flow in a staging environment before deploying.
- How is this different from integrating PropelAuth manually in Laravel?
- This package wraps PropelAuth as a Laravel Socialite driver, so you can use Socialite's familiar redirect and user retrieval methods instead of writing custom OAuth code. It fits apps already using Socialite or other SocialiteProviders drivers. You still need to configure PropelAuth credentials and callback URLs correctly.
- Where should I report issues or check maintenance for this PropelAuth provider?
- This package is a subtree split of the SocialiteProviders/Providers repository, so issues and maintenance generally belong with the main SocialiteProviders project. Check the package releases and the main repository for updates. Review open issues before relying on it for a new integration.
Weaver
How can I help you explore Laravel packages today?