@nullcare/azure-ad-react v0.1.2-beta.8

Azure AD Authentication Library for React/Next

This is not an official microsoft package.

1. About
2. Prerequisites
3. Installation
4. Build and Test
5. Usage
   • Getting Started
6. License

About

@nullcare/azure-ad-react is a powerful authentication library for React and Next.js applications that enables seamless integration with Azure Active Directory (Azure AD) for secure authentication and authorization workflows. The library utilizes the official Microsoft Authentication Library for React (MSAL React) and Microsoft Authentication Library for JavaScript (MSAL Browser) packages as peer dependencies, ensuring robust and reliable authentication capabilities.

Key Features

• Simplified Authentication: @nullcare/azure-ad-react aims to streamline the process of implementing Azure AD authentication in React/Next.js applications by abstracting away much of the complexity associated with the official MSAL packages. This allows developers to focus on building features rather than dealing with authentication intricacies.

• Peer Dependency on Official MSAL Packages: By relying on MSAL React and MSAL Browser as peer dependencies, @nullcare/azure-ad-react ensures that it stays up-to-date with the latest Microsoft authentication standards and practices. This guarantees compatibility with Azure AD's evolving authentication protocols.

• Effortless Configuration: The library provides straightforward configuration options that make it easy to set up and customize Azure AD authentication for your application. With just a few lines of code, developers can establish a secure authentication flow tailored to their specific needs.

• Reusable Components and Hooks: @nullcare/azure-ad-react exposes a set of reusable components and hooks that simplify authentication-related tasks. These components allow developers to easily create login, logout, and conditional rendering logic based on a user's authentication status or role.

Why Choose @nullcare/azure-ad-react?

Azure AD integration is a crucial aspect of building modern web applications that require secure user authentication and authorization. However, dealing with the intricacies of authentication protocols and token management can be daunting, especially for developers who are not well-versed in Azure AD.

@nullcare/azure-ad-react addresses this challenge by providing a user-friendly and developer-centric approach to Azure AD authentication. Whether you are building a single-page application, a multi-page application, or a server-rendered application with Next.js, this library simplifies the process of adding Azure AD authentication, allowing you to focus on delivering exceptional user experiences.

Prerequisites

Before you can start using @nullcare/azure-ad-react to enable Azure AD authentication in your React or Next.js application, ensure you have met the following prerequisites:

1. Client-Side Usage: @nullcare/azure-ad-react is designed to be used on the client side of your application.

2. Azure AD App Registration: To authenticate users with Azure AD, you need to register your application in the Azure AD portal. This registration process will provide you with a valid clientId that you will use for configuration. Follow the steps outlined in the Azure AD Documentation to register your application and obtain the required clientId.

By fulfilling these prerequisites, you'll be ready to integrate @nullcare/azure-ad-react seamlessly into your React or Next.js application and leverage the power of Azure AD authentication for enhanced security and user experiences.

Installation

npm install @nullcare/azure-ad-react
# or
yarn add @nullcare/azure-ad-react

Build and Test

See the contributing.md file for more information.

Building the package locally

To build the @nullcare/azure-ad-react library, you can do the following:

# Install dev dependencies from root of repo
yarn

# To build the package
yarn build

Running Tests

@nullcare/azure-ad-react uses jest to run unit tests and coverage.

# To run tests
yarn test

# To run tests with code coverage
yarn test:coverage

Usage

For help getting started with @nullcare/azure-ad-react please see our getting started doc.

License

Licensed under the MIT License.