Azure Active Directory Library (ADAL) for JavaScript 指南

Azure Active Directory Library (ADAL) for JavaScript 指南

azure-activedirectory-library-for-js The code for ADAL.js and ADAL Angular has been moved to the MSAL.js repo. Please open any issues or PRs at the link below. 项目地址: https://gitcode.com/gh_mirrors/az/azure-activedirectory-library-for-js

---

1. 目录结构及介绍

Azure AD 的 JavaScript 库（ADAL）已经被迁移到了 MSAL.js，但为了保持历史记录，我们来回顾原ADAL.js的目录结构。

.
├── gruntfile.js         # Grunt 构建文件
├── jshintrc             # JSHint 配置文件
├── package.json         # Node.js 包管理文件，包含依赖信息
├── travis.yml           # Travis CI 的配置文件
├── LICENSE.txt          # 许可证文件，遵循Apache 2.0协议
├── README.md            # 项目的主要读我文件
├── RELEASES.md          # 发布版本历史
├── doc                  # 文档相关文件夹
├── dist                 # 编译后的库文件存放位置
├── lib                  # 源代码库文件夹
│   ├── adal.js         # 主要的ADAL JavaScript库
│   └── ...             # 其他辅助文件
├── test                 # 测试文件夹
├── .gitignore           # Git忽略文件配置
└── contributing.md      # 贡献指南

介绍:

• adal.js 和 adal-angular.js 分别是原生JavaScript和AngularJS的适配器。
• dist 文件夹包含了压缩和未压缩的生产就绪版本。
• lib 中存储的是源码，开发者可以根据需要进行自定义修改。
• doc 提供了基本的库操作说明。
• test 用于单元测试和例子验证库的功能性。
• 其余如 gruntfile.js, .gitignore, package.json 是常规的项目管理文件。

2. 启动文件介绍

在ADAL.js中，并没有直接定义一个“启动文件”用于应用程序的立即执行，其使用方式依赖于将其集成到用户的Web应用中。例如，在一个基于HTML的项目中，通过在主HTML文件引入ADAL库开始：

<script src="path/to/adal.min.js"></script>

随后，在应用程序的初始化逻辑中配置ADAL，如AngularJS示例中的初始化部分。

3. 项目的配置文件介绍

配置ADAL通常在应用的初始化阶段完成。虽然不是传统意义上的单独配置文件，但ADAL的设置通常嵌入到应用程序的核心配置代码里，比如：

window.config = {
    clientId: 'your-client-id'
};
var authContext = new AuthenticationContext(config);

或者在AngularJS环境中使用adalAuthenticationServiceProvider.init()方法进行配置:

adalAuthenticationServiceProvider.init(
    {
        clientId: "your-client-id"
    },
    $httpProvider
);

这些配置片段扮演着“配置文件”的角色，它们告诉ADAL如何与Azure AD服务交互，包括客户端ID等关键信息。

---

请注意，由于此库已被迁移至MSAL.js，新项目应采用MSAL.js及其相应的配置和启动流程。上述信息适用于仍在维护的老项目或学习ADAL.js架构的场景。

azure-activedirectory-library-for-js The code for ADAL.js and ADAL Angular has been moved to the MSAL.js repo. Please open any issues or PRs at the link below. 项目地址: https://gitcode.com/gh_mirrors/az/azure-activedirectory-library-for-js