微软回放认证库( msal- react)
| 开始 | AAD 文档 | 图书馆参考文献 | 样本 |
|---|
关于
JavaScript 的 MSAL 库允许客户端JavaScript 应用程序认证用户使用 阿苏雷AD 工作账户和学校账户(AAD),微软个人账户(MSA)以及Facebook,Google,LinkedIn,微软账户等社会身份供应商通过 Azure AD B2C (英语) 服务。 也能让您的应用程序获得访问的符号 微软云 诸如: 微软图形。 。 。 .
这个 @azure/msal-react 此文件夹中由代码描述的软件包使用 @azure/msal-browser 软件包 作为对等依赖,可以在Javascript Single-Page应用程序中进行认证,而无需后端服务器. 这个版本的库使用OAuth 2.0授权代码与PKCE的流程. 欲了解更多关于这个协议,以及隐含流与授权代码流的区别,请参见以下 @azure/msal-浏览器读取器。 。 。 .
先决条件
-
@azure/msal-react意在用于 单页应用程序。 。 。 . -
使用前
@azure/msal-react您将需要 在 Azure AD 中注册单个页面应用程序 获取有效的clientId用于配置,并注册您的应用程序将接受重定向流量的路径.
版本支持
| MSAL 反应版本 | MSAL 支持状态 | 支持的反应版本 |
|---|---|---|
| MSAL 反应 v5 | 积极发展 | 16 (16.8+)、17、18、19 |
| MSAL 反应 v3 | 维修 | 第十六条、第十七条、第十八条、第十九条 |
| MSAL 反应 v1, v2 | 维修 | 第16、17、18条 |
说明: MSAL React v2发行版没有功能变化.
安装
国家防范机制有MSAL反应包.
npm install react react-dom
npm install @azure/msal-react @azure/msal-browser
构建和测试
见 contributing.md 文档以获取更多信息.
在当地建立软件包
为了建造 @azure/msal-react 库中,您可以进行下列工作:
// Install dev dependencies from root of repo
npm install
// Change to the msal-react package directory
cd lib/msal-react/
// To run build only for react package
npm run build
来建造两个 @azure/msal-react 图书馆和图书馆 @azure/msal-browser 图书馆,您可以进行以下活动:
// Install dev dependencies from root of repo
npm install
// Change to the msal-react package directory
cd lib/msal-react/
// To run build for react and browser packages
npm run build:all
运行测试
@azure/msal-react 用途 欢笑 进行单位测试和覆盖.
// To run tests
npm test
// To run tests with code coverage
npm run test:coverage
使用量
帮助开始 @azure/msal-react 请看我们的 开始中 医生.
从 反应- aad- msal看看我们 移徙指南。 。 。 .
MSAL 基本知识
自兹 @azure/msal-react 是一个包裹周围 @azure/msal-browser 许多来自 msal-browser 收回也与此有关。 具体概念 @azure/msal-react 请看 下级
高级主题
MSAL 反应特定概念
样本
我们 样本目录 包含多个示例应用程序, 您可以旋转来查看此库如何在不同的背景中使用 .
以教程支持的更高级样本可在 Azure 样本 gitHub 上的空间 :
- 反应 SPA 呼叫Express.js web API
- React SPA calling Express.js web API 使用 App Roads 和 RBAC 调用快取快取快取快取快取快取快取快取快取快取快取快取快取快取快取快取快取快取快取快取快取快取快取快取快取快取快取快取快取快取快取快取快取快取快取快取快取快取快取快取快取快取快取快取快取快取快取快取快取快取快取快取快取快取快取快取快取快取快取快取快取快取快取快取快取快取快取快取快取快取快取快取快取快取快取快取快取快取快取快取快取快取快取快取快取快取快取快取快取快取快取快取快取快取快取快取快取快取快取快取快取快取快取快取快取快取快取快取快取快取快取
- 反应 SPA 调用 Microsoft Graph 通过 Express.js 网络 API 使用半流
- Azure Static Web Apps 的部署教程
安全报告
如果你发现我们的图书馆或服务有安全问题,请报告 安全性@ microsoft.com 尽可能详细。 您的呈文可能有资格通过 微软慷慨 程序。 请不要将安全问题张贴到 GitHub 问题或任何其他公共网站。 我们收到消息后马上联系你 我们鼓励您通过访问了解安全事件何时发生 此页面 并签署安全咨询警报.
许可证
版权 (c) 微软公司。 版权所有。 根据麻省理工学院的许可.
我们重视并遵守微软开放源码行为守则
该项目通过了 Microsoft 开源行为守则。更多信息见 《行为守则》 或联系人 打开码@ microsoft.com 并附上任何其他问题或评论.