Azure AD 身份验证库（ADAL）Android 版本使用指南

Azure AD 身份验证库（ADAL）Android 版本使用指南

azure-activedirectory-library-for-android The ADAL SDK for Android gives you the ability to add support for Work Accounts to your application with just a few lines of additional code. This SDK gives your application the full functionality of Microsoft Azure AD, including industry standard protocol support for OAuth2, Web API integration with user level consent, and two factor authentication support. 项目地址: https://gitcode.com/gh_mirrors/az/azure-activedirectory-library-for-android

1. 项目目录结构及介绍

Azure AD 身份验证库（ADAL）的Android版本在GitHub上的仓库结构组织有序，旨在帮助开发者快速集成企业账户认证功能到自己的应用中。尽管实际的文件结构可能会随着版本更新而变化，一般的核心组件和重要文件包括：

• src: 包含了所有的源代码。

  • main: 主要的开发目录，里面分为java和res子目录。
    • java: 存放Java源代码文件，如主要的认证逻辑和类定义。
    • res: 资源文件夹，包括布局文件、图片、字符串等UI相关的资源。
  • test: 测试目录，包含了单元测试和可能存在的集成测试代码。

• docs: 可能包含了一些说明文档或API参考，但在开源项目中，这更多依赖于在线文档。

• build.gradle: Gradle构建脚本，定义了项目的依赖和其他构建规则。

• README.md: 提供了项目的基本信息、安装步骤和快速入门指导。

• LICENSE: 许可证文件，描述了该项目的使用条款，通常是MIT许可证。

2. 项目的启动文件介绍

在ADAL的Android应用中，并没有一个单一的“启动文件”概念，而是通过在你的应用程序中的特定切入点调用ADAL的API来开始身份验证流程。通常，这一过程始于你需要认证的活动（Activity）或是服务中，使用AuthenticationContext类进行初始化，比如：

import com.microsoft.aad.adal.AuthenticationContext;
...
AuthenticationContext authContext = new AuthenticationContext(context, authorityUrl, false);

这里的context是您的Activity上下文，authorityUrl是Azure AD的授权端点地址。这一过程通常是在用户触发认证请求时被调用的。

3. 项目的配置文件介绍

AndroidManifest.xml配置

在使用ADAL之前，您需要在AndroidManifest.xml文件中添加必要的权限和应用属性：

<uses-permission android:name="android.permission.INTERNET" />
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />

<application
   ...
   android:allowBackup="true"
   android:debuggable="true"
   ...>
   <!-- ADAL相关配置 -->
   <activity android:name="com.microsoft.aad.adal.AuthenticationActivity">
       <intent-filter>
           <action android:name="android.intent.action.VIEW" />
           <category android:name="android.intent.category.DEFAULT" />
           <category android:name="android.intent.category.BROWSABLE" />
           <data android:scheme="msauth" android:host="your.package.name" android:path="/base64encodedSignature"/>
       </intent-filter>
   </activity>
   ...
</application>

此外，确保应用程序能够调试，设置android:debuggable="true"当在开发阶段。还需要在Azure Active Directory中注册您的应用并获取相关信息，然后配置相应的包名和签名哈希。

请注意，实际应用中需将your.package.name替换为您的应用包名，并且通过正确的方式生成并填入base64encodedSignature值。

build.gradle 配置

在您的应用的build.gradle文件中，您需要添加ADAL的依赖项以引入库：

dependencies {
    implementation 'com.microsoft.azure.active Directory:adal:版本号'
}

请将版本号替换为最新的或者特定版本的ADAL库版本号，如4.8.12等，这可以在ADAL的GitHub releases页面找到。

以上就是关于Azure AD身份验证库Android版的基本介绍，包括其目录结构、启动逻辑以及核心配置。记得在实际操作中参考最新的官方文档和库的更新日志，因为技术细节随时间可能会发生变化。

azure-activedirectory-library-for-android The ADAL SDK for Android gives you the ability to add support for Work Accounts to your application with just a few lines of additional code. This SDK gives your application the full functionality of Microsoft Azure AD, including industry standard protocol support for OAuth2, Web API integration with user level consent, and two factor authentication support. 项目地址: https://gitcode.com/gh_mirrors/az/azure-activedirectory-library-for-android