@nullcare/azure-ad-react
v0.1.2-beta.8
Published
Azure AD authentication for React
Downloads
36
Maintainers
Readme
Azure AD Authentication Library for React/Next
This is not an official microsoft package.
| Getting Started | npm | Azure AD Docs | Official msal Repo | | ------------------------------------------ | --------------------------------------------------------------------------------------- | ------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------- |
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:
Client-Side Usage:
@nullcare/azure-ad-react
is designed to be used on the client side of your application.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.