Okta Socialite Provider

This package is an Okta OAuth2 provider for Laravel Socialite, part of the community-maintained Socialite Providers collection. It plugs into Laravel’s Socialite authentication layer to add Okta as a login provider, driving the OpenID Connect authorization, token, and userinfo endpoints against your Okta organization’s base URL.

Once registered through a Socialite event listener and configured in config/services.php, it lets a Laravel application redirect users to Okta for sign-in, exchange the returned code for tokens, and receive a normalized Socialite user built from Okta’s profile claims - giving apps enterprise single sign-on with minimal code.

What You Get

• An Okta OAuth2/OpenID Connect provider for Laravel Socialite
• Configuration of the Okta base URL and client credentials via config/services.php
• Mapping of Okta profile claims onto a standard Socialite user object
• An event listener class to register the provider with Socialite
• Support for the standard Socialite redirect and callback login flow

Common Use Cases

• Adding Okta single sign-on to a Laravel application
• Authenticating employees against a corporate Okta organization
• Implementing OpenID Connect login in Laravel backed by Okta

Under The Hood

Architecture - The package ships a Provider class extending SocialiteProviders\Manager\OAuth2\AbstractProvider that points Socialite’s authorization, token, and userinfo requests at the configured Okta org endpoints and maps the resulting profile onto a Socialite User via mapUserToObject. An OktaExtendSocialite listener registers the driver when Socialite fires its SocialiteWasCalled event.

Tech Stack - Pure PHP (^8.0) depending only on socialiteproviders/manager (^4.4), which pulls in Laravel Socialite and Guzzle for HTTP. Autoloading is PSR-4 under the SocialiteProviders\Okta namespace, with no build step or extra runtime dependencies.

Code Quality - The implementation is intentionally small - a single provider plus a listener - and follows the shared conventions of the Socialite Providers organization. Dedicated tests are not bundled in this repository (common tooling lives in the umbrella providers repo), but the code is stable, focused, and long-established.

API Design - Setup follows the familiar Socialite recipe: add an okta block to services config, register the SocialiteWasCalled listener, then call Socialite::driver(‘okta’)->redirect(). Okta-specific configuration is limited to the org base URL and credentials, keeping the integration declarative and consistent with every other Socialite provider.