Google Toolbox for Mac - OAuth 2 控制器指南

Google Toolbox for Mac - OAuth 2 控制器指南

gtm-oauth2 Google Toolbox for Mac - OAuth 2 Controllers 项目地址: https://gitcode.com/gh_mirrors/gt/gtm-oauth2

1. 项目介绍

Google Toolbox for Mac - OAuth 2 控制器 是一个致力于简化 Cocoa 应用程序通过 OAuth 2.0 进行身份验证和授权过程的库。它提供了一个完整的嵌入式用户界面，利用 WebKit 处理登录流程，并且设计得与任何标准 OAuth 2 提供商兼容，尤其支持谷歌API。该库的特点包括无缝的签到体验、密钥链存储授权令牌以及自动请求授权，而且它是独立于其他项目之外的。请注意，由于依赖的嵌入式web视图已被谷歌弃用，对于与谷歌相关的OAuth请求，建议转而使用 GTMAppAuth。

2. 项目快速启动

环境要求

确保你的开发环境已配置了CocoaPods或能够直接集成Objective-C项目。

安装步骤

1. 添加依赖 - 在你的CocoaPods的Podfile中加入以下行，如果你的项目使用CocoaPods进行管理：

   pod 'GTMOAuth2'
   

2. 安装Pods：

   pod install
   

3. 初始化OAuth2 - 在你的应用程序合适的位置初始化GTMOAuth2，例如AppDelegate：

   GTMOAuth2ViewControllerTouch *viewController = [[GTMOAuth2ViewControllerTouch alloc] initWithAuthUI:[GTMOAuth2Authentication sharedAuthUI]
                                                                                           authorizationURL:[[GTMOAuth2Authentication authForProvider:@"google"] authorizationURL]
                                                                                            keychainItemName:@"MyAppOAuth"
                                                                                        completionHandler:^(GTMOAuth2ViewControllerTouch *viewController,
                                                                                                          GTMOAuth2Authentication *auth,
                                                                                                          NSError *error) {
                                                                                            // Handle the result here
                                                                                          }];
   [self presentViewController:viewController animated:YES completion:nil];
   

4. 获取访问令牌并使用 - 成功授权后，你可以使用得到的GTMOAuth2Authentication对象中的令牌来发起API请求。

3. 应用案例和最佳实践

最佳实践中，确保在处理用户凭证时遵循安全原则，比如使用Keychain来持久化存储令牌。在用户会话结束时，及时清理或刷新令牌。对于敏感操作，始终检查令牌的有效性。

案例示例通常涉及通过GTMOAuth2发送请求给特定的API端点，如谷歌日历或谷歌驱动器API，确保正确设置 scopes 来限制所请求的权限范围：

NSURL *url = [NSURL URLWithString:@"https://www.googleapis.com/calendar/v3/calendars"];
NSMutableURLRequest *request = [NSMutableURLRequest requestWithURL:url];
[GTMOAuth2ViewControllerTouch authorizeRequest:request completion:^(NSError *error) {
    if (!error) {
        NSURLConnection *conn = [[NSURLConnection alloc] initWithRequest:request delegate:self];
        [conn start];
    }
}];

4. 典型生态项目

虽然此库是专为Mac和iOS开发者设计，但随着其退役（最后更新于2017年），开发者应探索更多现代解决方案，如GTMAppAuth或直接采用官方推荐的OAuth 2.0流程。这些替代方案更好地适应了当今的安全标准和最佳实践，确保新项目与未来的更新保持兼容。

---

请注意，鉴于google/gtm-oauth2仓库已经被归档，上述信息基于历史文档和通用知识。对于新的开发项目，强烈建议参考最新官方文档和推荐的认证库。

gtm-oauth2 Google Toolbox for Mac - OAuth 2 Controllers 项目地址: https://gitcode.com/gh_mirrors/gt/gtm-oauth2