Skip to content

MSAL and Microsoft Graph API wrapper for simplified O365 authentication and MS Graph communication.

Notifications You must be signed in to change notification settings

jamesdruhan/ms-adjunct

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

38 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

THE DOCUMENTATION FOR THIS PROJECT IS NOT COMPLETE

THIS PROJECT IS NOT READY FOR PRODUCTION

Adjunct for Microsoft Graph

Adjunct for Microsoft Graph manages user authentication with Microsoft Azure AD as well as API calls to Microsoft Graph. This library is especially designed for SPA's (Single Page Applications) and works well with popular frameworks such as React, Vue and Angular.

⚡️ Installation

Add Adjunct for Microsoft Graph to your project:

npm install @adjunct-js/adjunct-graph

✍ Usage

The @adjunct/adjunct-graph library acts as a wrapper around the MSAL @azure/msal-browser library which securely handles authentication, authorization and access token generation. In addition, it uses the Fetch API to make REST calls.

  1. Application Setup
  2. Initialization
  3. Authentication
  4. Authorization
  5. User Info
  6. Graph API

Application Setup

Before you can get started with @adjunct/adjunct-graph you need to register your application in the Azure Portal. You can follow the Microsoft Instructions or the simple steps below.

  1. Sign in to the Azure Portal
  2. Select the Azure Active Directory
  3. Select App Registrations
  4. Select New Registration
  5. Configure your application

Configure your app registration accordingly but ensure your Redirect URL is configured to the URL of the application page which will process user authentication (more details in [Authentication]#authentication).

The minimum recommended API Permission to provide users is User.Read which allows your application to read the users details. However, depending on the Microsoft Graph resources you need for your application you will need to grant more permissions.

Initialization

Authentication

Authorization

User Info

Graph API

About

MSAL and Microsoft Graph API wrapper for simplified O365 authentication and MS Graph communication.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published