jhayiwg/msofficeauth

Laravel Office 365 server to server token management

dev-master 2020-08-12 03:46 UTC

Requires

• league/oauth2-client: ^2.5
• microsoft/microsoft-graph: ^1.15

Requires (Dev)

• orchestra/testbench: ^4.0
• phpunit/phpunit: ^8.0

MIT

• Jhay

• laraoffice
• msofficeauth

README

This package if for server to server processing.

Installation

You can install the package via composer:

composer require jhayiwg/msofficeauth

Usage

Add to your .env, check https://docs.microsoft.com/en-us/graph/tutorials/php?tutorial-step=2 for referrence

OAUTH_APP_ID="XXXX"
OAUTH_APP_PASSWORD="XXXXX"
OAUTH_REDIRECT_URI=https://yoursite.loc/office/auth
OAUTH_SCOPES='openid profile offline_access user.read mail.read'
OAUTH_AUTHORITY=https://login.microsoftonline.com/common
OAUTH_AUTHORIZE_ENDPOINT=/oauth2/v2.0/authorize
OAUTH_TOKEN_ENDPOINT=/oauth2/v2.0/token

Authentication and Authorization

After setting up, visit visiting https://yoursite.loc/office/signin, login to your ms account then authorize the app.

The package will store or re-generate the token on your storage folder.

Automatic Injection

To use in the controller

// Usage description here
namespace App\Http\Controllers;

use Microsoft\Graph\Model;
use LaraOffice\MsOfficeAuth\MsOfficeAuth;

class HomeController extends Controller
{
    public function index(MsOfficeAuth $msGraph)
    {
        $tokenExpired = $msGraph->getAccessToken() ? 'No' : 'Yes';
        $graph = $msGraph->graph();
        $user = $graph->createRequest('GET', '/me')
            ->setReturnType(Model\User::class)
            ->execute();
        $userEmail = $user->getMail();
        return view('home', compact('tokenExpired', 'userEmail'));
    }
}

Changelog

Please see CHANGELOG for more information what has changed recently.

Contributing

Please see CONTRIBUTING for details.

Security

If you discover any security related issues, please email [e-mail] instead of using the issue tracker.

Credits

• Jhay