Step by Step Guide to enable SAML Single Sign-On (SSO) for Laravel

1. Installing the package using Composer

• Open a Command Prompt window and change the working directory to your Laravel app’s main directory.
• Enter the command composer require miniorange/saml-laravel-free.
  
  

• After successful installation of package, go to your Laravel app in the browser and enter https://<your-host>/mo_admin in the address bar.
• The package will start setting up your database for you and then the package will take you to the admin registration page, where you can register or login with miniOrange, and then configure SAML Single Sign-On (SSO).

2. Configuring the Laravel SSO SP package

• Go to the package and Select package Settings tab from the navigation panel on the left.
• If you go to the package settings tab you will find the SP Entity ID and ACS URL, which will be required when configuring your Identity Provider. This information can be configured manually or downloaded using the Download button.

• Now, under the Identity Provider Settings section you can upload your Identity Provider details to configure the package using the below ways.

1. Upload Identity Provider metadata file/XML :

• You can upload your Identity Provider metadata file using Upload Metadata option.


2. Add Identity Provider metadata details manually :

• You can enter your Identiity Provider metadata details manually.(Refer the image below)

• Click on the Save button to save your settings.

3. Test Configuration

• Once you configured all the details of your identity provider,you can test if the package is configured properly or not by clicking on the Test Configuration button.

• You should see a Test Successful screen as shown below along with the user's attribute values.

4. SSO Options

• You can configure the Relay State URL in the Service Provider Settings if you want to redirect users to a custom URL after the SSO.
• Your users can initiate the Single Sign On flow by clicking on the Single Sign On button generated on your login page. If you do not have this page yet, run php artisan make:auth & php artisan migrate to generate the authentication module.
  
  

5. Support / Demo

• Support and trial tabs are available for customers to reach out to for demos and support.