Download the PHP package good-system/laravel-o365auth without Composer
On this page you can find all versions of the php package good-system/laravel-o365auth. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
FAQ
Example:
In general, it is recommended to use always a project to download your libraries. In an application normally there is more than one library needed.
- Some hosting areas are not accessible by a terminal or SSH. Then it is not possible to use Composer.
- To use Composer is sometimes complicated. Especially for beginners.
- Composer needs much resources. Sometimes they are not available on a simple webspace.
- If you are using private repositories you don't need to share your credentials. You can set up everything on our site and then you provide a simple download link to your team member.
- Simplify your Composer build process. Use our own command line tool to download the vendor folder as binary. This makes your build process faster and you don't need to expose your credentials for private repositories.
Informations about the package laravel-o365auth
Office 365 PHP Auth
This package allows a Laravel application to authenticate users using their Office 365 accounts.
The package is largely based on program logic from microsoftgraph/php-connect-sample, but aims to easier integration with Laravel 5, and utilized more Laravel specific things.
Prerequisite
Microsoft Application and .env
Create an application at https://apps.dev.microsoft.com. And add the following to .env file with the application's parameters.
User Model
This package will be looking for a Laravel model \O365User. This could be an alias of App\User or other user class such as GoodSystem\User, explicitly set in the application.
Installation
Run composer require good-system/o365auth under Laraval application root directory.
Laravel (5.6 and newer) should "discover" the package, without having to add service provider to config/app.php.
Required Laravel Version
This package might work with Laravel framework before 5.7, it's not been tested.
Error Page Templates
Error templates in package will be looked up and used if exist. Otherwise, fall back to default Laravel error display.
Expected Behaviors
Default Routes
Two default routes are provided:
/o365auth/init/o365auth/redirect
Users should always start at /o365auth/init, and then expect to be redirected to Office 365 authentication page at https://login.microsoftonline.com/common/oauth2/v2.0/authorize, with parameters.
1. Happy Scenario
Upon successful authentication with an Office 365 account on any of the domains specified by "O365_DOMAIN" in .env,
- if not exists in the system, and user model is configured properly, user record is added to the system (retrieved if already exists)
- system access is granted (Laravel manual authentication)
- user is finally redirected to the previous page or web root
/(it doesn't have anything to do with "O365_REDIRECT_URL" in.env) - Both new user and existing user will be able to bypass email verification, if not yet verified (verification flag will be set manually)
2. Laravel Authentication Error
If above #2 fails, which is unlikely, expect the system to throw a 500 error -- something really unexpected.
3. User Model Error
If above #1 fails due to bad configuration for user model, which is possible (but not expected), or some unknown error while adding user to system, also expect system to throw a 500 error.
4. Bad Data Coming from Microsoft
Could be one of the several scenarios.
5. Email Not on The Allowed Domains List
Expect the system to throw a 403 error.
All versions of laravel-o365auth with dependencies
league/oauth2-client Version ^2.3
microsoft/microsoft-graph Version ^1.3