Azure Active Directory Library for Objective-C 使用指南

Azure Active Directory Library for Objective-C 使用指南

azure-activedirectory-library-for-objcThe ADAL SDK for Objective C gives you the ability to add support for Work Accounts to your iOS and macOS applications 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-objc

项目目录结构及介绍

Azure Active Directory Library (ADAL) for Objective-C 是一个强大的SDK，使开发者能够在iOS和macOS应用中轻松集成企业账户支持。以下是该项目在GitHub上的基本目录结构概览及其重要组件说明：

├── LICENSE                  # 许可证文件，说明软件使用的MIT许可协议
├── README.md                # 项目的主要说明文档，包括安装步骤、快速入门等信息
├── Examples                 # 包含示例应用程序，展示如何在真实场景中使用ADAL
│   ├── ...
├── Source                   # 核心源代码目录
│   ├── ADAuthenticationContext.h/.m    # 认证上下文，处理认证请求的核心类
│   ├── ADAuthenticationError.h/.m     # 定义了认证过程中可能遇到的错误类型
│   ├── ...                            # 其他认证相关类和辅助工具类
├── Tests                    # 单元测试目录，确保代码质量
│   └── ...
└── Podfile                  # 若项目使用CocoaPods作为依赖管理，此文件定义依赖关系

项目的启动文件介绍

在ADAL for Objective-C中，并没有特定的“启动文件”这一概念，但通常应用集成开始于导入ADAL库并创建ADAuthenticationContext实例。以下是一个简单的集成起点，通常发生在应用的主要入口点或初始化服务时：

#import <ADAL/ADAuthenticationContext.h>

// 初始化ADAuthenticationContext，传入你的 tenant ID 和 authority URL
NSString *authority = @"https://login.microsoftonline.com/your_tenant_id";
ADAuthenticationContext *authenticationContext = [[ADAuthenticationContext alloc] initWithAuthority:authority error:nil];

这标志着认证流程的开始，之后可以调用方法来请求访问令牌。

项目的配置文件介绍

Podfile（若使用CocoaPods）

如果你选择使用CocoaPods来管理项目依赖，会在项目根目录下有一个Podfile，它用于指定项目所需的依赖包以及版本。例如，添加ADAL到你的项目中可能会有如下一行：

pod 'ADAL', '~> x.y.z' # 替换x.y.z为你想使用的ADAL版本号

AppDelegate Integration

虽然不是传统意义上的配置文件，但在iOS应用的AppDelegate中设置代理和处理URL回调是集成过程的关键部分。你需要在UIApplicationDelegate的实现里加入代码以支持从身份验证服务器返回的URL处理：

- (BOOL)application:(UIApplication *)application openURL:(NSURL *)url sourceApplication:(NSString *)sourceApplication annotation:(id)data {
    return [ADAuthenticationBroker handleAuthUrl:url];
}

Info.plist Adjustments

有时可能需要在Info.plist文件中添加白名单，以确保应用能够正确响应身份验证回调。例如，添加URL Types来指明你的应用可以处理的身份验证回调URL模式：

<key>CFBundleURLSchemes</key>
<array>
    <string>msauth.your.bundle.id</string>
</array>

这里，“your.bundle.id”应当替换为你的应用的实际bundle identifier。

综上所述，通过理解ADAL的目录结构、启动集成过程和关键配置文件的调整，开发者可以顺利地将Azure AD认证功能集成进他们的Objective-C应用中。

azure-activedirectory-library-for-objcThe ADAL SDK for Objective C gives you the ability to add support for Work Accounts to your iOS and macOS applications 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-objc