https://blog.csdn.net/MarinaTsang/article/details/104883928
https://blog.csdn.net/yuao_708905482/article/details/104042158
https://www.ho35.com/artinfo-1339.html
Sign in with Apple
前言
准备工作
开发工作（object-c编写）
基本流程
添加依赖库
创建Apple登录Button
向Apple发起请求
接收Apple的回调
注意：
用户注销 AppleId 或 停止使用 Apple ID 的状态处理
服务端验证
参数的获取方法：
Q&A
前言
根据Apple发布的新政策，如果你的App有第三方登录，例如微信、QQ、Facebook、twitter等第三方登录一定需要增加AppleID的登录方式。具体可以参考Apple的官方文档：
https://developer.apple.com/cn/app-store/review/guidelines/#sign-in-with-apple
2020.04月上架或更新的Apple适用：https://developer.apple.com/cn/news/
Apple登录免用户密码输入，并且可以修改显示的名称及隐藏电子邮箱，安全性很高。
准备工作
Apple原生的SDK只适用于iOS 13.0+ 系统，测试时需要一台13+系统测试机。
升级Xcode 到 11+版本。
开发者后台对应的indentify下勾选 sign in with apple登录选项，重新下载profiler文件。步骤如下：
登录您的Apple开发者账号-
选择左边 Identifier 栏目，在右侧选择要开通 **苹果授权登录（Sign in with Apple）**的 Identifiers 点击打开。
下拉找到 Sign In with Apple 打钩。
点击 右上角 save 保存会出现 Modify App Capabilities 弹窗 点击 Confirm
注：开启后 profile 将失效需要重新编辑 profile 文件。
在xcode项目中开启sign in with apple，步骤如下：
在左侧PROJECT中选择对应的项目target
选择signing & capabilities，点击Capability，搜索sign in with apple,双击即可。
开发工作（object-c编写）
基本流程
创建 Apple登录Button
向Apple发起请求
处理Apple登录后的结果
将Apple登录后的用户信息传给服务器端验证（可选）
处理用户更换AppleID或停用AppleID问题。
初次登录时可以让用户编辑显示的用户名及是否隐藏邮箱，第二次登录之后用户进行认证即可。
苹果开发官方文档：https://developer.apple.com/documentation/authenticationservices
添加依赖库
在选择project-build phase -link binary with libraries-搜索 AuthenticationServices.framework 添加。
创建Apple登录Button
Apple提供了官方sign in with apple button,如果需要自定义按钮，自定义按钮的规则如下：https://developer.apple.com/documentation/signinwithapplejs/incorporating_sign_in_with_apple_into_other_platforms
if (@available(iOS 13.0,*)) {
ASAuthorizationAppleIDButtonType type = ASAuthorizationAppleIDButtonTypeSignIn;
ASAuthorizationAppleIDButton* authorizationButton = [ASAuthorizationAppleIDButton buttonWithType:type style:ASAuthorizationAppleIDButtonStyleWhite];
// add to your viewcontainer
....
[authorizationButton addTarget:self action:@selector(showAppleLogin) forControlEvents:UIControlEventTouchUpInside];
[_firstLoginView addSubview:authorizationButton];
}
-(void)showAppleLogin{
// add your code to apple login
.....
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
Button 的type有登录类型ASAuthorizationAppleIDButtonTypeSignIn和注册类型ASAuthorizationAppleIDButtonTypeSignUp（只能在13.2+有效，13.0-13.2需要自定义）。
Button的style的有几种类型，但都是黑白配。
向Apple发起请求
苹果还把 iCloud KeyChain password 集成到了这套 API 里，我们在使用的时候，只需要在创建 request 的时候，多创建一个 ASAuthorizationPasswordRequest，这样如果 KeyChain 里面也有登录信息的话，可以直接使用里面保存的用户名和密码进行登录。
#import <AuthenticationServices/AuthenticationServices.h>
-(void)signInWithAppleNative API_AVAILABLE(ios(13.0)){
ASAuthorizationAppleIDProvider *provider = [[ASAuthorizationAppleIDProvider alloc] init];
ASAuthorizationAppleIDRequest *authAppleIDRequest = [provider createRequest];
// 在用户授权期间请求的联系信息
authAppleIDRequest.requestedScopes = @[ASAuthorizationScopeFullName, ASAuthorizationScopeEmail];
// ASAuthorizationPasswordRequest *passwordRequest = [[ASAuthorizationPasswordProvider new] createRequest];
NSMutableArray <ASAuthorizationRequest *>* array = [NSMutableArray arrayWithCapacity:2];
if (authAppleIDRequest) {
[array addObject:authAppleIDRequest];
}
// if (passwordRequest) {
// [array addObject:passwordRequest];
// }
NSArray <ASAuthorizationRequest *>* requests = [array copy];
// 由ASAuthorizationAppleIDProvider创建的授权请求 管理授权请求的控制器
ASAuthorizationController *authorizationController = [[ASAuthorizationController alloc] initWithAuthorizationRequests:requests];
authorizationController.delegate = self;
// 设置提供 展示上下文的代理，在这个上下文中 系统可以展示授权界面给用户
authorizationController.presentationContextProvider = self;
// 在控制器初始化期间启动授权流
[authorizationController performRequests];
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
注：
1、sign in with apple 工具类设成全局变量，或使用单例类，如果使用局部变量，和IAP工具类一样苹果的回调不会执行。
**2、当启用 **ASAuthorizationPasswordRequest 且 停止使用 Apple ID（真机-设置-账户-密码与安全性-使用您 Apple ID 的 App-App列表-停止使用 Apple ID）,如果 KeyChain 里面没有登录信息且重新使用 苹果授权登录（Sign in with Apple） 会报未知错误.
SignInWithApple[2759:550203] [core] Authorization failed: Error Domain=AKAuthenticationError Code=-7001 "(null)" UserInfo={AKClientBundleID=com.wangquanwei.SignInWithApple}
1
接收Apple的回调
// 成功的回调
-(void)authorizationController:(ASAuthorizationController *)controller didCompleteWithAuthorization:(ASAuthorization *)authorization API_AVAILABLE(ios(13.0)){
// the credential is an Apple ID
if([authorization.credential isKindOfClass:[ASAuthorizationAppleIDCredential class]]){
// 获取信息并将信息保存在 钥匙串中
ASAuthorizationAppleIDCredential *authorizeCredential = authorization.credential;
NSString * nickname = authorizeCredential.fullName.givenName;
NSString * userID = authorizeCredential.user; // 同一个开发者账号下的app 返回的值一样的
NSString * email = authorizeCredential.email;
NSData * authorizationCode = authorizeCredential.authorizationCode;
NSData * identityToken =authorizeCredential.identityToken;
// 将ID保存到钥匙串--示例
if (userID) {
[Utility setKeychainValue:[userID dataUsingEncoding:NSUTF8StringEncoding] key:@"appleUserID"];
}
// NSLog(@"state: %@", state);
NSLog(@"userID: %@", userID);
NSLog(@"fullName: %@", nickname);
NSLog(@"email: %@", email);
NSLog(@"authorizationCode: %@", authorizationCode);
NSLog(@"identityToken: %@", [[NSString alloc] initWithData:identityToken encoding:NSUTF8StringEncoding] );
// NSLog(@"realUserStatus: %@", @(realUserStatus));
// 示例-将信息回调到服务器端进行验证
[self setAppleUserCallback:YES userId:userID authorizeCode:authorizationCode identityToken:identityToken name:nickname];
// If the credential is a password credential, the system displays an alert allowing the user to authenticate with the existing account.
}else if ([authorization.credential isKindOfClass:[ASPasswordCredential class]]) {
ASPasswordCredential *passwordCredential = authorization.credential;
NSString *userIdentifier = passwordCredential.user;
NSString *password = passwordCredential.password;
// 可以直接登录
// NSLog(@"userIdentifier: %@", userIdentifier);
// NSLog(@"password: %@", password);
[self setAppleUserCallback:YES userId:userIdentifier authorizeCode:nil identityToken:nil name:nil];
}
}
// 失败的回调
- (void)authorizationController:(ASAuthorizationController *)controller didCompleteWithError:(NSError *)error
API_AVAILABLE(ios(13.0)){
NSString * errorMsg = nil;
AppleLoginCallbackVO *kvo = [[AppleLoginCallbackVO alloc] init];
kvo.isSucceed = NO;
switch (error.code) {
case ASAuthorizationErrorCanceled:
errorMsg = @"Authorization is cancled.";
break;
case ASAuthorizationErrorFailed:
errorMsg = @"Authorize failed.";
break;
case ASAuthorizationErrorInvalidResponse:
errorMsg = @"Authoraized response invalid.";
break;
case ASAuthorizationErrorNotHandled:
errorMsg = @"Authorization can not handle.";
break;
case ASAuthorizationErrorUnknown:
default:
errorMsg = @"Unknown reason failed for authorization.";
break;
}
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
注意：
获取的用户信息中：email、NSPersonNameComponents对象所有属性是只有第一次请求的时候才会返回，之后就算 停止使用 Apple ID 再重新授权都不会返回用户信息。
authorizeCredential.user 是用户的唯一ID，同一个开发者账号下这个ID一致。
authorizeCredential.authorizationCode验证码，每次返回的不一样，看服务端使用那种验证方式而定是否使用。
authorizeCredential.identityToken用户的验证token，有一定的有效期，到期后会刷新。
Apple建议将用户ID保存在钥匙串中以便在App启动的时候进行检查AppleID的登录状态。
用户注销 AppleId 或 停止使用 Apple ID 的状态处理
在application:didFinishLaunchingWithOptions进行APPID的登录状态检查。
-(void)checkAuthoriza API_AVAILABLE(ios(13.0)){
// 从钥匙串中取出用户ID
NSData* appleUserId = [tility valueKeyChain:@"appleUserID"];
if (appleUserId) {
NSString *appleIdentifyId = [[NSString alloc] initWithData:appleUserId encoding:NSUTF8StringEncoding];
ASAuthorizationAppleIDProvider *provider = [ASAuthorizationAppleIDProvider new];
[provider getCredentialStateForUserID:appleIdentifyId completion:^(ASAuthorizationAppleIDProviderCredentialState credentialState, NSError * _Nullable error) {
switch (credentialState) {
case ASAuthorizationAppleIDProviderCredentialAuthorized:
//
NSLog(@"has authorized");
break;
case ASAuthorizationAppleIDProviderCredentialRevoked:
NSLog(@"revoked,please sign out apple login");
// 删除钥匙串保存的信息
[Utility removeObjectKeyChainForKey:@"appleUserID"];
// 登出Apple登录，等待下次重新登录
break;
case ASAuthorizationAppleIDProviderCredentialNotFound:
NSLog(@"not found....");
[Utility removeObjectKeyChainForKey:@"appleUserID"];
default:
break;
}
}];
}
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
2、检查用户的APPID的登录状态还可以使用观察者的方式
// 注册通知
[[NSNotificationCenter defaultCenter] addObserver:self selector:@selector(handleSignInWithAppleStateChanged:) name:ASAuthorizationAppleIDProviderCredentialRevokedNotification object:nil];
#pragma mark- apple授权状态 更改通知
- (void)handleSignInWithAppleStateChanged:(NSNotification *)notification
{
NSLog(@"%@", notification.userInfo);
}
1
2
3
4
5
6
7
服务端验证
服务端验证分两种验证方式：一种是验证码验证、一种是JWT验证。具体详见Apple 官方文档：https://developer.apple.com/documentation/signinwithapplerestapi
手机端需要提交 user 、authorizationCode 、 identityToken 字段信息（code和token字段苹果返回的是 base64 Data 形式，手机端可以先转换 base64 字符串之后在给服务器）到服务器。然后服务器通过 https://appleid.apple.com/auth/token 该接口，并拼接对应参数去验证，接口相关信息苹果有提供。
参数介绍：
Client_id:App 的BundleID
client_secret：后台生成的JWT key，生成方法见后续。
Code:客户端传过的authorizationCode
grant_type：常量authorizationCode
参数的获取方法：
登录Apple开发者账号-menbership 获取teamid ;
创建private_key：进入证书栏certificates、IDs&Profiles,选择keys标签（如果没有keys标签，可能是您登录的Apple开发者账号不是超管账号，没有权限。）-现在添加–给key命名并选择对应的bundleid。
注：该private_key只能下载一次。
根据Apple返回的结果中sub字段即是用户的ID，可以和手机端的user字段对比验证。
Q&A
找不到AuthenticationServices
AuthenticationServices 是只有在iOS13+系统才有效，在使用对应API的时候需要限定是 13.0+
无法引入App.kit [
AppKit is not available when building for iOS. Consider using #if TARGET_OS_MACCATALYST to conditionally import this framework when building for Mac Catalyst, first importing TargetConditionals.h if necessary.
按照提示在引入App.kit 增加判断：
#if TARGET_OS_MACCATALYST
#import <AppKit/AppKit.h>
#endif
1
2
3
Authorization failed: Error Domain=AKAuthenticationError Code=-7001 “(null)”
停止使用 ASAuthorizationPasswordRequest。
————————————————
版权声明：本文为CSDN博主「MarinaTsang」的原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接及本声明。
原文链接：https://blog.csdn.net/MarinaTsang/article/details/104883928