GIDSignIn.m 42 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699700701702703704705706707708709710711712713714715716717718719720721722723724725726727728729730731732733734735736737738739740741742743744745746747748749750751752753754755756757758759760761762763764765766767768769770771772773774775776777778779780781782783784785786787788789790791792793794795796797798799800801802803804805806807808809810811812813814815816817818819820821822823824825826827828829830831832833834835836837838839840841842843844845846847848849850851852853854855856857858859860861862863864865866867868869870871872873874875876877878879880881882883884885886887888889890891892893894895896897898899900901902903904905906907908909910911912913914915916917918919920921922923924925926927928929930931932933934935936937938939940941942943944945946947948949950951952953954955956957958959960961962963964965966967968969970971972973974975976977978979980981982983984985986987988989990991992993994995996997998999100010011002100310041005100610071008100910101011101210131014101510161017101810191020102110221023102410251026102710281029103010311032
  1. // Copyright 2021 Google LLC
  2. //
  3. // Licensed under the Apache License, Version 2.0 (the "License");
  4. // you may not use this file except in compliance with the License.
  5. // You may obtain a copy of the License at
  6. //
  7. // http://www.apache.org/licenses/LICENSE-2.0
  8. //
  9. // Unless required by applicable law or agreed to in writing, software
  10. // distributed under the License is distributed on an "AS IS" BASIS,
  11. // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
  12. // See the License for the specific language governing permissions and
  13. // limitations under the License.
  14. #import "GoogleSignIn/Sources/Public/GoogleSignIn/GIDSignIn.h"
  15. #import "GoogleSignIn/Sources/GIDSignIn_Private.h"
  16. #import "GoogleSignIn/Sources/Public/GoogleSignIn/GIDAuthentication.h"
  17. #import "GoogleSignIn/Sources/Public/GoogleSignIn/GIDConfiguration.h"
  18. #import "GoogleSignIn/Sources/Public/GoogleSignIn/GIDGoogleUser.h"
  19. #import "GoogleSignIn/Sources/Public/GoogleSignIn/GIDProfileData.h"
  20. #import "GoogleSignIn/Sources/GIDSignInInternalOptions.h"
  21. #import "GoogleSignIn/Sources/GIDSignInPreferences.h"
  22. #import "GoogleSignIn/Sources/GIDCallbackQueue.h"
  23. #import "GoogleSignIn/Sources/GIDScopes.h"
  24. #import "GoogleSignIn/Sources/GIDSignInCallbackSchemes.h"
  25. #if TARGET_OS_IOS && !TARGET_OS_MACCATALYST
  26. #import "GoogleSignIn/Sources/GIDAuthStateMigration.h"
  27. #import "GoogleSignIn/Sources/GIDEMMErrorHandler.h"
  28. #endif // TARGET_OS_IOS && !TARGET_OS_MACCATALYST
  29. #import "GoogleSignIn/Sources/GIDAuthentication_Private.h"
  30. #import "GoogleSignIn/Sources/GIDGoogleUser_Private.h"
  31. #import "GoogleSignIn/Sources/GIDProfileData_Private.h"
  32. #ifdef SWIFT_PACKAGE
  33. @import AppAuth;
  34. @import GTMAppAuth;
  35. @import GTMSessionFetcherCore;
  36. #else
  37. #import <AppAuth/OIDAuthState.h>
  38. #import <AppAuth/OIDAuthorizationRequest.h>
  39. #import <AppAuth/OIDAuthorizationResponse.h>
  40. #import <AppAuth/OIDAuthorizationService.h>
  41. #import <AppAuth/OIDError.h>
  42. #import <AppAuth/OIDExternalUserAgentSession.h>
  43. #import <AppAuth/OIDIDToken.h>
  44. #import <AppAuth/OIDResponseTypes.h>
  45. #import <AppAuth/OIDServiceConfiguration.h>
  46. #import <AppAuth/OIDTokenRequest.h>
  47. #import <AppAuth/OIDTokenResponse.h>
  48. #import <AppAuth/OIDURLQueryComponent.h>
  49. #import <GTMAppAuth/GTMAppAuthFetcherAuthorization+Keychain.h>
  50. #import <GTMAppAuth/GTMAppAuthFetcherAuthorization.h>
  51. #import <GTMSessionFetcher/GTMSessionFetcher.h>
  52. #if TARGET_OS_IOS || TARGET_OS_MACCATALYST
  53. #import <AppAuth/OIDAuthorizationService+IOS.h>
  54. #elif TARGET_OS_OSX
  55. #import <AppAuth/OIDAuthorizationService+Mac.h>
  56. #endif
  57. #endif
  58. NS_ASSUME_NONNULL_BEGIN
  59. // The name of the query parameter used for logging the restart of auth from EMM callback.
  60. static NSString *const kEMMRestartAuthParameter = @"emmres";
  61. // The URL template for the authorization endpoint.
  62. static NSString *const kAuthorizationURLTemplate = @"https://%@/o/oauth2/v2/auth";
  63. // The URL template for the token endpoint.
  64. static NSString *const kTokenURLTemplate = @"https://%@/token";
  65. // The URL template for the URL to get user info.
  66. static NSString *const kUserInfoURLTemplate = @"https://%@/oauth2/v3/userinfo?access_token=%@";
  67. // The URL template for the URL to revoke the token.
  68. static NSString *const kRevokeTokenURLTemplate = @"https://%@/o/oauth2/revoke?token=%@";
  69. // Expected path in the URL scheme to be handled.
  70. static NSString *const kBrowserCallbackPath = @"/oauth2callback";
  71. // Expected path for EMM callback.
  72. static NSString *const kEMMCallbackPath = @"/emmcallback";
  73. // The EMM support version
  74. static NSString *const kEMMVersion = @"1";
  75. // The error code for Google Identity.
  76. NSErrorDomain const kGIDSignInErrorDomain = @"com.google.GIDSignIn";
  77. // Keychain constants for saving state in the authentication flow.
  78. static NSString *const kGTMAppAuthKeychainName = @"auth";
  79. // Basic profile (Fat ID Token / userinfo endpoint) keys
  80. static NSString *const kBasicProfileEmailKey = @"email";
  81. static NSString *const kBasicProfilePictureKey = @"picture";
  82. static NSString *const kBasicProfileNameKey = @"name";
  83. static NSString *const kBasicProfileGivenNameKey = @"given_name";
  84. static NSString *const kBasicProfileFamilyNameKey = @"family_name";
  85. // Parameters in the callback URL coming back from browser.
  86. static NSString *const kAuthorizationCodeKeyName = @"code";
  87. static NSString *const kOAuth2ErrorKeyName = @"error";
  88. static NSString *const kOAuth2AccessDenied = @"access_denied";
  89. static NSString *const kEMMPasscodeInfoRequiredKeyName = @"emm_passcode_info_required";
  90. // Error string for unavailable keychain.
  91. static NSString *const kKeychainError = @"keychain error";
  92. // Error string for user cancelations.
  93. static NSString *const kUserCanceledError = @"The user canceled the sign-in flow.";
  94. // User preference key to detect fresh install of the app.
  95. static NSString *const kAppHasRunBeforeKey = @"GID_AppHasRunBefore";
  96. // Maximum retry interval in seconds for the fetcher.
  97. static const NSTimeInterval kFetcherMaxRetryInterval = 15.0;
  98. // The delay before the new sign-in flow can be presented after the existing one is cancelled.
  99. static const NSTimeInterval kPresentationDelayAfterCancel = 1.0;
  100. // Parameters for the auth and token exchange endpoints.
  101. static NSString *const kAudienceParameter = @"audience";
  102. // See b/11669751 .
  103. static NSString *const kOpenIDRealmParameter = @"openid.realm";
  104. static NSString *const kIncludeGrantedScopesParameter = @"include_granted_scopes";
  105. static NSString *const kLoginHintParameter = @"login_hint";
  106. static NSString *const kHostedDomainParameter = @"hd";
  107. // Minimum time to expiration for a restored access token.
  108. static const NSTimeInterval kMinimumRestoredAccessTokenTimeToExpire = 600.0;
  109. // The callback queue used for authentication flow.
  110. @interface GIDAuthFlow : GIDCallbackQueue
  111. @property(nonatomic, strong, nullable) OIDAuthState *authState;
  112. @property(nonatomic, strong, nullable) NSError *error;
  113. @property(nonatomic, copy, nullable) NSString *emmSupport;
  114. @property(nonatomic, nullable) GIDProfileData *profileData;
  115. @end
  116. @implementation GIDAuthFlow
  117. @end
  118. @implementation GIDSignIn {
  119. // This value is used when sign-in flows are resumed via the handling of a URL. Its value is
  120. // set when a sign-in flow is begun via |signInWithOptions:| when the options passed don't
  121. // represent a sign in continuation.
  122. GIDSignInInternalOptions *_currentOptions;
  123. // AppAuth configuration object.
  124. OIDServiceConfiguration *_appAuthConfiguration;
  125. // AppAuth external user-agent session state.
  126. id<OIDExternalUserAgentSession> _currentAuthorizationFlow;
  127. // Flag to indicate that the auth flow is restarting.
  128. BOOL _restarting;
  129. }
  130. #pragma mark - Public methods
  131. - (BOOL)handleURL:(NSURL *)url {
  132. // Check if the callback path matches the expected one for a URL from Safari/Chrome/SafariVC.
  133. if ([url.path isEqual:kBrowserCallbackPath]) {
  134. if ([_currentAuthorizationFlow resumeExternalUserAgentFlowWithURL:url]) {
  135. _currentAuthorizationFlow = nil;
  136. return YES;
  137. }
  138. return NO;
  139. }
  140. // Check if the callback path matches the expected one for a URL from Google Device Policy app.
  141. if ([url.path isEqual:kEMMCallbackPath]) {
  142. return [self handleDevicePolicyAppURL:url];
  143. }
  144. return NO;
  145. }
  146. - (BOOL)hasPreviousSignIn {
  147. if ([_currentUser.authentication.authState isAuthorized]) {
  148. return YES;
  149. }
  150. OIDAuthState *authState = [self loadAuthState];
  151. return [authState isAuthorized];
  152. }
  153. - (void)restorePreviousSignInWithCompletion:(nullable GIDSignInCompletion)completion {
  154. [self signInWithOptions:[GIDSignInInternalOptions silentOptionsWithCompletion:completion]];
  155. }
  156. - (BOOL)restorePreviousSignInNoRefresh {
  157. if (_currentUser) {
  158. return YES;
  159. }
  160. // Try retrieving an authorization object from the keychain.
  161. OIDAuthState *authState = [self loadAuthState];
  162. if (!authState) {
  163. return NO;
  164. }
  165. // Restore current user without refreshing the access token.
  166. OIDIDToken *idToken =
  167. [[OIDIDToken alloc] initWithIDTokenString:authState.lastTokenResponse.idToken];
  168. GIDProfileData *profileData = [self profileDataWithIDToken:idToken];
  169. GIDGoogleUser *user = [[GIDGoogleUser alloc] initWithAuthState:authState profileData:profileData];
  170. [self setCurrentUserWithKVO:user];
  171. return YES;
  172. }
  173. #if TARGET_OS_IOS || TARGET_OS_MACCATALYST
  174. - (void)signInWithConfiguration:(GIDConfiguration *)configuration
  175. presentingViewController:(UIViewController *)presentingViewController
  176. hint:(nullable NSString *)hint
  177. completion:(nullable GIDSignInCompletion)completion {
  178. GIDSignInInternalOptions *options =
  179. [GIDSignInInternalOptions defaultOptionsWithConfiguration:configuration
  180. presentingViewController:presentingViewController
  181. loginHint:hint
  182. addScopesFlow:NO
  183. completion:completion];
  184. [self signInWithOptions:options];
  185. }
  186. - (void)signInWithConfiguration:(GIDConfiguration *)configuration
  187. presentingViewController:(UIViewController *)presentingViewController
  188. hint:(nullable NSString *)hint
  189. additionalScopes:(nullable NSArray<NSString *> *)additionalScopes
  190. completion:(nullable GIDSignInCompletion)completion {
  191. GIDSignInInternalOptions *options =
  192. [GIDSignInInternalOptions defaultOptionsWithConfiguration:configuration
  193. presentingViewController:presentingViewController
  194. loginHint:hint
  195. addScopesFlow:NO
  196. scopes:additionalScopes
  197. completion:completion];
  198. [self signInWithOptions:options];
  199. }
  200. - (void)signInWithConfiguration:(GIDConfiguration *)configuration
  201. presentingViewController:(UIViewController *)presentingViewController
  202. completion:(nullable GIDSignInCompletion)completion {
  203. [self signInWithConfiguration:configuration
  204. presentingViewController:presentingViewController
  205. hint:nil
  206. completion:completion];
  207. }
  208. - (void)addScopes:(NSArray<NSString *> *)scopes
  209. presentingViewController:(UIViewController *)presentingViewController
  210. completion:(nullable GIDSignInCompletion)completion {
  211. // A currentUser must be available in order to complete this flow.
  212. if (!self.currentUser) {
  213. // No currentUser is set, notify callback of failure.
  214. NSError *error = [NSError errorWithDomain:kGIDSignInErrorDomain
  215. code:kGIDSignInErrorCodeNoCurrentUser
  216. userInfo:nil];
  217. if (completion) {
  218. dispatch_async(dispatch_get_main_queue(), ^{
  219. completion(nil, error);
  220. });
  221. }
  222. return;
  223. }
  224. GIDConfiguration *configuration =
  225. [[GIDConfiguration alloc] initWithClientID:self.currentUser.authentication.clientID
  226. serverClientID:self.currentUser.serverClientID
  227. hostedDomain:self.currentUser.hostedDomain
  228. openIDRealm:self.currentUser.openIDRealm];
  229. GIDSignInInternalOptions *options =
  230. [GIDSignInInternalOptions defaultOptionsWithConfiguration:configuration
  231. presentingViewController:presentingViewController
  232. loginHint:self.currentUser.profile.email
  233. addScopesFlow:YES
  234. completion:completion];
  235. NSSet<NSString *> *requestedScopes = [NSSet setWithArray:scopes];
  236. NSMutableSet<NSString *> *grantedScopes =
  237. [NSMutableSet setWithArray:self.currentUser.grantedScopes];
  238. // Check to see if all requested scopes have already been granted.
  239. if ([requestedScopes isSubsetOfSet:grantedScopes]) {
  240. // All requested scopes have already been granted, notify callback of failure.
  241. NSError *error = [NSError errorWithDomain:kGIDSignInErrorDomain
  242. code:kGIDSignInErrorCodeScopesAlreadyGranted
  243. userInfo:nil];
  244. if (completion) {
  245. dispatch_async(dispatch_get_main_queue(), ^{
  246. completion(nil, error);
  247. });
  248. }
  249. return;
  250. }
  251. // Use the union of granted and requested scopes.
  252. [grantedScopes unionSet:requestedScopes];
  253. options.scopes = [grantedScopes allObjects];
  254. [self signInWithOptions:options];
  255. }
  256. #elif TARGET_OS_OSX
  257. - (void)signInWithConfiguration:(GIDConfiguration *)configuration
  258. presentingWindow:(NSWindow *)presentingWindow
  259. hint:(nullable NSString *)hint
  260. completion:(nullable GIDSignInCompletion)completion {
  261. GIDSignInInternalOptions *options =
  262. [GIDSignInInternalOptions defaultOptionsWithConfiguration:configuration
  263. presentingWindow:presentingWindow
  264. loginHint:hint
  265. addScopesFlow:NO
  266. completion:completion];
  267. [self signInWithOptions:options];
  268. }
  269. - (void)signInWithConfiguration:(GIDConfiguration *)configuration
  270. presentingWindow:(NSWindow *)presentingWindow
  271. completion:(nullable GIDSignInCompletion)completion {
  272. [self signInWithConfiguration:configuration
  273. presentingWindow:presentingWindow
  274. hint:nil
  275. completion:completion];
  276. }
  277. - (void)signInWithConfiguration:(GIDConfiguration *)configuration
  278. presentingWindow:(NSWindow *)presentingWindow
  279. hint:(nullable NSString *)hint
  280. additionalScopes:(nullable NSArray<NSString *> *)additionalScopes
  281. completion:(nullable GIDSignInCompletion)completion {
  282. GIDSignInInternalOptions *options =
  283. [GIDSignInInternalOptions defaultOptionsWithConfiguration:configuration
  284. presentingWindow:presentingWindow
  285. loginHint:hint
  286. addScopesFlow:NO
  287. scopes:additionalScopes
  288. completion:completion];
  289. [self signInWithOptions:options];
  290. }
  291. - (void)addScopes:(NSArray<NSString *> *)scopes
  292. presentingWindow:(NSWindow *)presentingWindow
  293. completion:(nullable GIDSignInCompletion)completion {
  294. // A currentUser must be available in order to complete this flow.
  295. if (!self.currentUser) {
  296. // No currentUser is set, notify callback of failure.
  297. NSError *error = [NSError errorWithDomain:kGIDSignInErrorDomain
  298. code:kGIDSignInErrorCodeNoCurrentUser
  299. userInfo:nil];
  300. if (completion) {
  301. dispatch_async(dispatch_get_main_queue(), ^{
  302. completion(nil, error);
  303. });
  304. }
  305. return;
  306. }
  307. GIDConfiguration *configuration =
  308. [[GIDConfiguration alloc] initWithClientID:self.currentUser.authentication.clientID
  309. serverClientID:self.currentUser.serverClientID
  310. hostedDomain:self.currentUser.hostedDomain
  311. openIDRealm:self.currentUser.openIDRealm];
  312. GIDSignInInternalOptions *options =
  313. [GIDSignInInternalOptions defaultOptionsWithConfiguration:configuration
  314. presentingWindow:presentingWindow
  315. loginHint:self.currentUser.profile.email
  316. addScopesFlow:YES
  317. completion:completion];
  318. NSSet<NSString *> *requestedScopes = [NSSet setWithArray:scopes];
  319. NSMutableSet<NSString *> *grantedScopes =
  320. [NSMutableSet setWithArray:self.currentUser.grantedScopes];
  321. // Check to see if all requested scopes have already been granted.
  322. if ([requestedScopes isSubsetOfSet:grantedScopes]) {
  323. // All requested scopes have already been granted, notify callback of failure.
  324. NSError *error = [NSError errorWithDomain:kGIDSignInErrorDomain
  325. code:kGIDSignInErrorCodeScopesAlreadyGranted
  326. userInfo:nil];
  327. if (completion) {
  328. dispatch_async(dispatch_get_main_queue(), ^{
  329. completion(nil, error);
  330. });
  331. }
  332. return;
  333. }
  334. // Use the union of granted and requested scopes.
  335. [grantedScopes unionSet:requestedScopes];
  336. options.scopes = [grantedScopes allObjects];
  337. [self signInWithOptions:options];
  338. }
  339. #endif // TARGET_OS_OSX
  340. - (void)signOut {
  341. // Clear the current user if there is one.
  342. if (_currentUser) {
  343. [self willChangeValueForKey:NSStringFromSelector(@selector(currentUser))];
  344. _currentUser = nil;
  345. [self didChangeValueForKey:NSStringFromSelector(@selector(currentUser))];
  346. }
  347. // Remove all state from the keychain.
  348. [self removeAllKeychainEntries];
  349. }
  350. - (void)disconnectWithCompletion:(nullable GIDDisconnectCompletion)completion {
  351. GIDGoogleUser *user = _currentUser;
  352. OIDAuthState *authState = user.authentication.authState;
  353. if (!authState) {
  354. // Even the user is not signed in right now, we still need to remove any token saved in the
  355. // keychain.
  356. authState = [self loadAuthState];
  357. }
  358. // Either access or refresh token would work, but we won't have access token if the auth is
  359. // retrieved from keychain.
  360. NSString *token = authState.lastTokenResponse.accessToken;
  361. if (!token) {
  362. token = authState.lastTokenResponse.refreshToken;
  363. }
  364. if (!token) {
  365. [self signOut];
  366. // Nothing to do here, consider the operation successful.
  367. if (completion) {
  368. dispatch_async(dispatch_get_main_queue(), ^{
  369. completion(nil);
  370. });
  371. }
  372. return;
  373. }
  374. NSString *revokeURLString = [NSString stringWithFormat:kRevokeTokenURLTemplate,
  375. [GIDSignInPreferences googleAuthorizationServer], token];
  376. // Append logging parameter
  377. revokeURLString = [NSString stringWithFormat:@"%@&%@=%@&%@=%@",
  378. revokeURLString,
  379. kSDKVersionLoggingParameter,
  380. GIDVersion(),
  381. kEnvironmentLoggingParameter,
  382. GIDEnvironment()];
  383. NSURL *revokeURL = [NSURL URLWithString:revokeURLString];
  384. [self startFetchURL:revokeURL
  385. fromAuthState:authState
  386. withComment:@"GIDSignIn: revoke tokens"
  387. withCompletionHandler:^(NSData *data, NSError *error) {
  388. // Revoking an already revoked token seems always successful, which helps us here.
  389. if (!error) {
  390. [self signOut];
  391. }
  392. if (completion) {
  393. dispatch_async(dispatch_get_main_queue(), ^{
  394. completion(error);
  395. });
  396. }
  397. }];
  398. }
  399. #pragma mark - Custom getters and setters
  400. + (GIDSignIn *)sharedInstance {
  401. static dispatch_once_t once;
  402. static GIDSignIn *sharedInstance;
  403. dispatch_once(&once, ^{
  404. sharedInstance = [[self alloc] initPrivate];
  405. });
  406. return sharedInstance;
  407. }
  408. #pragma mark - Private methods
  409. - (id)initPrivate {
  410. self = [super init];
  411. if (self) {
  412. // Check to see if the 3P app is being run for the first time after a fresh install.
  413. BOOL isFreshInstall = [self isFreshInstall];
  414. // If this is a fresh install, ensure that any pre-existing keychain data is purged.
  415. if (isFreshInstall) {
  416. [self removeAllKeychainEntries];
  417. }
  418. NSString *authorizationEnpointURL = [NSString stringWithFormat:kAuthorizationURLTemplate,
  419. [GIDSignInPreferences googleAuthorizationServer]];
  420. NSString *tokenEndpointURL = [NSString stringWithFormat:kTokenURLTemplate,
  421. [GIDSignInPreferences googleTokenServer]];
  422. _appAuthConfiguration = [[OIDServiceConfiguration alloc]
  423. initWithAuthorizationEndpoint:[NSURL URLWithString:authorizationEnpointURL]
  424. tokenEndpoint:[NSURL URLWithString:tokenEndpointURL]];
  425. #if TARGET_OS_IOS && !TARGET_OS_MACCATALYST
  426. // Perform migration of auth state from old (before 5.0) versions of the SDK if needed.
  427. [GIDAuthStateMigration migrateIfNeededWithTokenURL:_appAuthConfiguration.tokenEndpoint
  428. callbackPath:kBrowserCallbackPath
  429. keychainName:kGTMAppAuthKeychainName
  430. isFreshInstall:isFreshInstall];
  431. #endif // TARGET_OS_IOS && !TARGET_OS_MACCATALYST
  432. }
  433. return self;
  434. }
  435. // Does sanity check for parameters and then authenticates if necessary.
  436. - (void)signInWithOptions:(GIDSignInInternalOptions *)options {
  437. // Options for continuation are not the options we want to cache. The purpose of caching the
  438. // options in the first place is to provide continuation flows with a starting place from which to
  439. // derive suitable options for the continuation!
  440. if (!options.continuation) {
  441. _currentOptions = options;
  442. }
  443. if (options.interactive) {
  444. // Explicitly throw exception for missing client ID here. This must come before
  445. // scheme check because schemes rely on reverse client IDs.
  446. [self assertValidParameters];
  447. [self assertValidPresentingViewController];
  448. // If the application does not support the required URL schemes tell the developer so.
  449. GIDSignInCallbackSchemes *schemes =
  450. [[GIDSignInCallbackSchemes alloc] initWithClientIdentifier:options.configuration.clientID];
  451. NSArray<NSString *> *unsupportedSchemes = [schemes unsupportedSchemes];
  452. if (unsupportedSchemes.count != 0) {
  453. // NOLINTNEXTLINE(google-objc-avoid-throwing-exception)
  454. [NSException raise:NSInvalidArgumentException
  455. format:@"Your app is missing support for the following URL schemes: %@",
  456. [unsupportedSchemes componentsJoinedByString:@", "]];
  457. }
  458. }
  459. // If this is a non-interactive flow, use cached authentication if possible.
  460. if (!options.interactive && _currentUser.authentication) {
  461. [_currentUser.authentication doWithFreshTokens:^(GIDAuthentication *unused, NSError *error) {
  462. if (error) {
  463. [self authenticateWithOptions:options];
  464. } else {
  465. if (options.completion) {
  466. self->_currentOptions = nil;
  467. dispatch_async(dispatch_get_main_queue(), ^{
  468. options.completion(self->_currentUser, nil);
  469. });
  470. }
  471. }
  472. }];
  473. } else {
  474. [self authenticateWithOptions:options];
  475. }
  476. }
  477. #pragma mark - Authentication flow
  478. - (void)authenticateInteractivelyWithOptions:(GIDSignInInternalOptions *)options {
  479. GIDSignInCallbackSchemes *schemes =
  480. [[GIDSignInCallbackSchemes alloc] initWithClientIdentifier:options.configuration.clientID];
  481. NSURL *redirectURL = [NSURL URLWithString:[NSString stringWithFormat:@"%@:%@",
  482. [schemes clientIdentifierScheme],
  483. kBrowserCallbackPath]];
  484. NSString *emmSupport;
  485. #if TARGET_OS_IOS && !TARGET_OS_MACCATALYST
  486. emmSupport = [[self class] isOperatingSystemAtLeast9] ? kEMMVersion : nil;
  487. #elif TARGET_OS_MACCATALYST || TARGET_OS_OSX
  488. emmSupport = nil;
  489. #endif // TARGET_OS_MACCATALYST || TARGET_OS_OSX
  490. NSMutableDictionary<NSString *, NSString *> *additionalParameters = [@{} mutableCopy];
  491. additionalParameters[kIncludeGrantedScopesParameter] = @"true";
  492. if (options.configuration.serverClientID) {
  493. additionalParameters[kAudienceParameter] = options.configuration.serverClientID;
  494. }
  495. if (options.loginHint) {
  496. additionalParameters[kLoginHintParameter] = options.loginHint;
  497. }
  498. if (options.configuration.hostedDomain) {
  499. additionalParameters[kHostedDomainParameter] = options.configuration.hostedDomain;
  500. }
  501. #if TARGET_OS_IOS && !TARGET_OS_MACCATALYST
  502. [additionalParameters addEntriesFromDictionary:
  503. [GIDAuthentication parametersWithParameters:options.extraParams
  504. emmSupport:emmSupport
  505. isPasscodeInfoRequired:NO]];
  506. #elif TARGET_OS_OSX || TARGET_OS_MACCATALYST
  507. [additionalParameters addEntriesFromDictionary:options.extraParams];
  508. #endif // TARGET_OS_OSX || TARGET_OS_MACCATALYST
  509. additionalParameters[kSDKVersionLoggingParameter] = GIDVersion();
  510. additionalParameters[kEnvironmentLoggingParameter] = GIDEnvironment();
  511. OIDAuthorizationRequest *request =
  512. [[OIDAuthorizationRequest alloc] initWithConfiguration:_appAuthConfiguration
  513. clientId:options.configuration.clientID
  514. scopes:options.scopes
  515. redirectURL:redirectURL
  516. responseType:OIDResponseTypeCode
  517. additionalParameters:additionalParameters];
  518. _currentAuthorizationFlow = [OIDAuthorizationService
  519. presentAuthorizationRequest:request
  520. #if TARGET_OS_IOS || TARGET_OS_MACCATALYST
  521. presentingViewController:options.presentingViewController
  522. #elif TARGET_OS_OSX
  523. presentingWindow:options.presentingWindow
  524. #endif // TARGET_OS_OSX
  525. callback:^(OIDAuthorizationResponse *_Nullable authorizationResponse,
  526. NSError *_Nullable error) {
  527. [self processAuthorizationResponse:authorizationResponse
  528. error:error
  529. emmSupport:emmSupport];
  530. }];
  531. }
  532. - (void)processAuthorizationResponse:(OIDAuthorizationResponse *)authorizationResponse
  533. error:(NSError *)error
  534. emmSupport:(NSString *)emmSupport{
  535. if (_restarting) {
  536. // The auth flow is restarting, so the work here would be performed in the next round.
  537. _restarting = NO;
  538. return;
  539. }
  540. GIDAuthFlow *authFlow = [[GIDAuthFlow alloc] init];
  541. authFlow.emmSupport = emmSupport;
  542. if (authorizationResponse) {
  543. if (authorizationResponse.authorizationCode.length) {
  544. authFlow.authState = [[OIDAuthState alloc]
  545. initWithAuthorizationResponse:authorizationResponse];
  546. // perform auth code exchange
  547. [self maybeFetchToken:authFlow];
  548. } else {
  549. // There was a failure, convert to appropriate error code.
  550. NSString *errorString;
  551. GIDSignInErrorCode errorCode = kGIDSignInErrorCodeUnknown;
  552. NSDictionary<NSString *, NSObject *> *params = authorizationResponse.additionalParameters;
  553. #if TARGET_OS_IOS && !TARGET_OS_MACCATALYST
  554. if (authFlow.emmSupport) {
  555. [authFlow wait];
  556. BOOL isEMMError = [[GIDEMMErrorHandler sharedInstance]
  557. handleErrorFromResponse:params
  558. completion:^{
  559. [authFlow next];
  560. }];
  561. if (isEMMError) {
  562. errorCode = kGIDSignInErrorCodeEMM;
  563. }
  564. }
  565. #endif // TARGET_OS_IOS && !TARGET_OS_MACCATALYST
  566. errorString = (NSString *)params[kOAuth2ErrorKeyName];
  567. if ([errorString isEqualToString:kOAuth2AccessDenied]) {
  568. errorCode = kGIDSignInErrorCodeCanceled;
  569. }
  570. authFlow.error = [self errorWithString:errorString code:errorCode];
  571. }
  572. } else {
  573. NSString *errorString = [error localizedDescription];
  574. GIDSignInErrorCode errorCode = kGIDSignInErrorCodeUnknown;
  575. if (error.code == OIDErrorCodeUserCanceledAuthorizationFlow) {
  576. // The user has canceled the flow at the iOS modal dialog.
  577. errorString = kUserCanceledError;
  578. errorCode = kGIDSignInErrorCodeCanceled;
  579. }
  580. authFlow.error = [self errorWithString:errorString code:errorCode];
  581. }
  582. [self addDecodeIdTokenCallback:authFlow];
  583. [self addSaveAuthCallback:authFlow];
  584. [self addCompletionCallback:authFlow];
  585. }
  586. // Perform authentication with the provided options.
  587. - (void)authenticateWithOptions:(GIDSignInInternalOptions *)options {
  588. // If this is an interactive flow, we're not going to try to restore any saved auth state.
  589. if (options.interactive) {
  590. [self authenticateInteractivelyWithOptions:options];
  591. return;
  592. }
  593. // Try retrieving an authorization object from the keychain.
  594. OIDAuthState *authState = [self loadAuthState];
  595. if (![authState isAuthorized]) {
  596. // No valid auth in keychain, per documentation/spec, notify callback of failure.
  597. NSError *error = [NSError errorWithDomain:kGIDSignInErrorDomain
  598. code:kGIDSignInErrorCodeHasNoAuthInKeychain
  599. userInfo:nil];
  600. if (options.completion) {
  601. _currentOptions = nil;
  602. dispatch_async(dispatch_get_main_queue(), ^{
  603. options.completion(nil, error);
  604. });
  605. }
  606. return;
  607. }
  608. // Complete the auth flow using saved auth in keychain.
  609. GIDAuthFlow *authFlow = [[GIDAuthFlow alloc] init];
  610. authFlow.authState = authState;
  611. [self maybeFetchToken:authFlow];
  612. [self addDecodeIdTokenCallback:authFlow];
  613. [self addSaveAuthCallback:authFlow];
  614. [self addCompletionCallback:authFlow];
  615. }
  616. // Fetches the access token if necessary as part of the auth flow.
  617. - (void)maybeFetchToken:(GIDAuthFlow *)authFlow {
  618. OIDAuthState *authState = authFlow.authState;
  619. // Do nothing if we have an auth flow error or a restored access token that isn't near expiration.
  620. if (authFlow.error ||
  621. (authState.lastTokenResponse.accessToken &&
  622. [authState.lastTokenResponse.accessTokenExpirationDate timeIntervalSinceNow] >
  623. kMinimumRestoredAccessTokenTimeToExpire)) {
  624. return;
  625. }
  626. NSMutableDictionary<NSString *, NSString *> *additionalParameters = [@{} mutableCopy];
  627. if (_currentOptions.configuration.serverClientID) {
  628. additionalParameters[kAudienceParameter] = _currentOptions.configuration.serverClientID;
  629. }
  630. if (_currentOptions.configuration.openIDRealm) {
  631. additionalParameters[kOpenIDRealmParameter] = _currentOptions.configuration.openIDRealm;
  632. }
  633. #if TARGET_OS_IOS && !TARGET_OS_MACCATALYST
  634. NSDictionary<NSString *, NSObject *> *params =
  635. authState.lastAuthorizationResponse.additionalParameters;
  636. NSString *passcodeInfoRequired = (NSString *)params[kEMMPasscodeInfoRequiredKeyName];
  637. [additionalParameters addEntriesFromDictionary:
  638. [GIDAuthentication parametersWithParameters:@{}
  639. emmSupport:authFlow.emmSupport
  640. isPasscodeInfoRequired:passcodeInfoRequired.length > 0]];
  641. #endif // TARGET_OS_IOS && !TARGET_OS_MACCATALYST
  642. additionalParameters[kSDKVersionLoggingParameter] = GIDVersion();
  643. additionalParameters[kEnvironmentLoggingParameter] = GIDEnvironment();
  644. OIDTokenRequest *tokenRequest;
  645. if (!authState.lastTokenResponse.accessToken &&
  646. authState.lastAuthorizationResponse.authorizationCode) {
  647. tokenRequest = [authState.lastAuthorizationResponse
  648. tokenExchangeRequestWithAdditionalParameters:additionalParameters];
  649. } else {
  650. [additionalParameters
  651. addEntriesFromDictionary:authState.lastTokenResponse.request.additionalParameters];
  652. tokenRequest = [authState tokenRefreshRequestWithAdditionalParameters:additionalParameters];
  653. }
  654. [authFlow wait];
  655. [OIDAuthorizationService
  656. performTokenRequest:tokenRequest
  657. callback:^(OIDTokenResponse *_Nullable tokenResponse,
  658. NSError *_Nullable error) {
  659. [authState updateWithTokenResponse:tokenResponse error:error];
  660. authFlow.error = error;
  661. #if TARGET_OS_IOS && !TARGET_OS_MACCATALYST
  662. if (authFlow.emmSupport) {
  663. [GIDAuthentication handleTokenFetchEMMError:error completion:^(NSError *error) {
  664. authFlow.error = error;
  665. [authFlow next];
  666. }];
  667. } else {
  668. [authFlow next];
  669. }
  670. #elif TARGET_OS_OSX || TARGET_OS_MACCATALYST
  671. [authFlow next];
  672. #endif // TARGET_OS_OSX || TARGET_OS_MACCATALYST
  673. }];
  674. }
  675. // Adds a callback to the auth flow to save the auth object to |self| and the keychain as well.
  676. - (void)addSaveAuthCallback:(GIDAuthFlow *)authFlow {
  677. __weak GIDAuthFlow *weakAuthFlow = authFlow;
  678. [authFlow addCallback:^() {
  679. GIDAuthFlow *handlerAuthFlow = weakAuthFlow;
  680. OIDAuthState *authState = handlerAuthFlow.authState;
  681. if (authState && !handlerAuthFlow.error) {
  682. if (![self saveAuthState:authState]) {
  683. handlerAuthFlow.error = [self errorWithString:kKeychainError
  684. code:kGIDSignInErrorCodeKeychain];
  685. return;
  686. }
  687. if (self->_currentOptions.addScopesFlow) {
  688. [self->_currentUser updateAuthState:authState
  689. profileData:handlerAuthFlow.profileData];
  690. } else {
  691. GIDGoogleUser *user = [[GIDGoogleUser alloc] initWithAuthState:authState
  692. profileData:handlerAuthFlow.profileData];
  693. [self setCurrentUserWithKVO:user];
  694. }
  695. }
  696. }];
  697. }
  698. // Adds a callback to the auth flow to extract user data from the ID token where available and
  699. // make a userinfo request if necessary.
  700. - (void)addDecodeIdTokenCallback:(GIDAuthFlow *)authFlow {
  701. __weak GIDAuthFlow *weakAuthFlow = authFlow;
  702. [authFlow addCallback:^() {
  703. GIDAuthFlow *handlerAuthFlow = weakAuthFlow;
  704. OIDAuthState *authState = handlerAuthFlow.authState;
  705. if (!authState || handlerAuthFlow.error) {
  706. return;
  707. }
  708. OIDIDToken *idToken =
  709. [[OIDIDToken alloc] initWithIDTokenString: authState.lastTokenResponse.idToken];
  710. // If the profile data are present in the ID token, use them.
  711. if (idToken) {
  712. handlerAuthFlow.profileData = [self profileDataWithIDToken:idToken];
  713. }
  714. // If we can't retrieve profile data from the ID token, make a userInfo request to fetch them.
  715. if (!handlerAuthFlow.profileData) {
  716. [handlerAuthFlow wait];
  717. NSURL *infoURL = [NSURL URLWithString:
  718. [NSString stringWithFormat:kUserInfoURLTemplate,
  719. [GIDSignInPreferences googleUserInfoServer],
  720. authState.lastTokenResponse.accessToken]];
  721. [self startFetchURL:infoURL
  722. fromAuthState:authState
  723. withComment:@"GIDSignIn: fetch basic profile info"
  724. withCompletionHandler:^(NSData *data, NSError *error) {
  725. if (data && !error) {
  726. NSError *jsonDeserializationError;
  727. NSDictionary<NSString *, NSString *> *profileDict =
  728. [NSJSONSerialization JSONObjectWithData:data
  729. options:NSJSONReadingMutableContainers
  730. error:&jsonDeserializationError];
  731. if (profileDict) {
  732. handlerAuthFlow.profileData = [[GIDProfileData alloc]
  733. initWithEmail:idToken.claims[kBasicProfileEmailKey]
  734. name:profileDict[kBasicProfileNameKey]
  735. givenName:profileDict[kBasicProfileGivenNameKey]
  736. familyName:profileDict[kBasicProfileFamilyNameKey]
  737. imageURL:[NSURL URLWithString:profileDict[kBasicProfilePictureKey]]];
  738. }
  739. }
  740. if (error) {
  741. handlerAuthFlow.error = error;
  742. }
  743. [handlerAuthFlow next];
  744. }];
  745. }
  746. }];
  747. }
  748. // Adds a callback to the auth flow to complete the flow by calling the sign-in callback.
  749. - (void)addCompletionCallback:(GIDAuthFlow *)authFlow {
  750. __weak GIDAuthFlow *weakAuthFlow = authFlow;
  751. [authFlow addCallback:^() {
  752. GIDAuthFlow *handlerAuthFlow = weakAuthFlow;
  753. if (self->_currentOptions.completion) {
  754. GIDSignInCompletion completion = self->_currentOptions.completion;
  755. self->_currentOptions = nil;
  756. dispatch_async(dispatch_get_main_queue(), ^{
  757. completion(self->_currentUser, handlerAuthFlow.error);
  758. });
  759. }
  760. }];
  761. }
  762. - (void)startFetchURL:(NSURL *)URL
  763. fromAuthState:(OIDAuthState *)authState
  764. withComment:(NSString *)comment
  765. withCompletionHandler:(void (^)(NSData *, NSError *))handler {
  766. NSMutableURLRequest *request = [NSMutableURLRequest requestWithURL:URL];
  767. GTMSessionFetcher *fetcher;
  768. GTMAppAuthFetcherAuthorization *authorization =
  769. [[GTMAppAuthFetcherAuthorization alloc] initWithAuthState:authState];
  770. id<GTMSessionFetcherServiceProtocol> fetcherService = authorization.fetcherService;
  771. if (fetcherService) {
  772. fetcher = [fetcherService fetcherWithRequest:request];
  773. } else {
  774. fetcher = [GTMSessionFetcher fetcherWithRequest:request];
  775. }
  776. fetcher.retryEnabled = YES;
  777. fetcher.maxRetryInterval = kFetcherMaxRetryInterval;
  778. fetcher.comment = comment;
  779. [fetcher beginFetchWithCompletionHandler:handler];
  780. }
  781. // Parse incoming URL from the Google Device Policy app.
  782. - (BOOL)handleDevicePolicyAppURL:(NSURL *)url {
  783. OIDURLQueryComponent *queryComponent = [[OIDURLQueryComponent alloc] initWithURL:url];
  784. NSDictionary<NSString *, NSObject<NSCopying> *> *params = queryComponent.dictionaryValue;
  785. NSObject<NSCopying> *actionParam = params[@"action"];
  786. NSString *actionString =
  787. [actionParam isKindOfClass:[NSString class]] ? (NSString *)actionParam : nil;
  788. if (![@"restart_auth" isEqualToString:actionString]) {
  789. return NO;
  790. }
  791. #if TARGET_OS_IOS || TARGET_OS_MACCATALYST
  792. if (!_currentOptions.presentingViewController) {
  793. return NO;
  794. }
  795. #elif TARGET_OS_OSX
  796. if (!_currentOptions.presentingWindow) {
  797. return NO;
  798. }
  799. #endif // TARGET_OS_OSX
  800. if (!_currentAuthorizationFlow) {
  801. return NO;
  802. }
  803. _restarting = YES;
  804. [_currentAuthorizationFlow cancel];
  805. _currentAuthorizationFlow = nil;
  806. _restarting = NO;
  807. NSDictionary<NSString *, NSString *> *extraParameters = @{ kEMMRestartAuthParameter : @"1" };
  808. // In iOS 13 the presentation of ASWebAuthenticationSession needs an anchor window,
  809. // so we need to wait until the previous presentation is completely gone to ensure the right
  810. // anchor window is used here.
  811. dispatch_after(dispatch_time(DISPATCH_TIME_NOW,
  812. (int64_t)(kPresentationDelayAfterCancel * NSEC_PER_SEC)),
  813. dispatch_get_main_queue(), ^{
  814. [self signInWithOptions:[self->_currentOptions optionsWithExtraParameters:extraParameters
  815. forContinuation:YES]];
  816. });
  817. return YES;
  818. }
  819. #pragma mark - Key-Value Observing
  820. // Override |NSObject(NSKeyValueObservingCustomization)| method in order to provide custom KVO
  821. // notifications for the |currentUser| property.
  822. + (BOOL)automaticallyNotifiesObserversForKey:(NSString *)key {
  823. if ([key isEqual:NSStringFromSelector(@selector(currentUser))]) {
  824. return NO;
  825. }
  826. return [super automaticallyNotifiesObserversForKey:key];
  827. }
  828. #pragma mark - Helpers
  829. - (NSError *)errorWithString:(NSString *)errorString code:(GIDSignInErrorCode)code {
  830. if (errorString == nil) {
  831. errorString = @"Unknown error";
  832. }
  833. NSDictionary<NSString *, NSString *> *errorDict = @{ NSLocalizedDescriptionKey : errorString };
  834. return [NSError errorWithDomain:kGIDSignInErrorDomain
  835. code:code
  836. userInfo:errorDict];
  837. }
  838. + (BOOL)isOperatingSystemAtLeast9 {
  839. NSProcessInfo *processInfo = [NSProcessInfo processInfo];
  840. return [processInfo respondsToSelector:@selector(isOperatingSystemAtLeastVersion:)] &&
  841. [processInfo isOperatingSystemAtLeastVersion:(NSOperatingSystemVersion){.majorVersion = 9}];
  842. }
  843. // Asserts the parameters being valid.
  844. - (void)assertValidParameters {
  845. if (![_currentOptions.configuration.clientID length]) {
  846. // NOLINTNEXTLINE(google-objc-avoid-throwing-exception)
  847. [NSException raise:NSInvalidArgumentException
  848. format:@"You must specify |clientID| in |GIDConfiguration|"];
  849. }
  850. }
  851. // Assert that the presenting view controller has been set.
  852. - (void)assertValidPresentingViewController {
  853. #if TARGET_OS_IOS || TARGET_OS_MACCATALYST
  854. if (!_currentOptions.presentingViewController) {
  855. #elif TARGET_OS_OSX
  856. if (!_currentOptions.presentingWindow) {
  857. #endif // TARGET_OS_OSX
  858. // NOLINTNEXTLINE(google-objc-avoid-throwing-exception)
  859. [NSException raise:NSInvalidArgumentException
  860. format:@"|presentingViewController| must be set."];
  861. }
  862. }
  863. // Checks whether or not this is the first time the app runs.
  864. - (BOOL)isFreshInstall {
  865. NSUserDefaults* defaults = [NSUserDefaults standardUserDefaults];
  866. if ([defaults boolForKey:kAppHasRunBeforeKey]) {
  867. return NO;
  868. }
  869. [defaults setBool:YES forKey:kAppHasRunBeforeKey];
  870. return YES;
  871. }
  872. - (void)removeAllKeychainEntries {
  873. [GTMAppAuthFetcherAuthorization removeAuthorizationFromKeychainForName:kGTMAppAuthKeychainName
  874. useDataProtectionKeychain:YES];
  875. }
  876. - (BOOL)saveAuthState:(OIDAuthState *)authState {
  877. GTMAppAuthFetcherAuthorization *authorization =
  878. [[GTMAppAuthFetcherAuthorization alloc] initWithAuthState:authState];
  879. return [GTMAppAuthFetcherAuthorization saveAuthorization:authorization
  880. toKeychainForName:kGTMAppAuthKeychainName
  881. useDataProtectionKeychain:YES];
  882. }
  883. - (OIDAuthState *)loadAuthState {
  884. GTMAppAuthFetcherAuthorization *authorization =
  885. [GTMAppAuthFetcherAuthorization authorizationFromKeychainForName:kGTMAppAuthKeychainName
  886. useDataProtectionKeychain:YES];
  887. return authorization.authState;
  888. }
  889. // Generates user profile from OIDIDToken.
  890. - (GIDProfileData *)profileDataWithIDToken:(OIDIDToken *)idToken {
  891. if (!idToken ||
  892. !idToken.claims[kBasicProfilePictureKey] ||
  893. !idToken.claims[kBasicProfileNameKey] ||
  894. !idToken.claims[kBasicProfileGivenNameKey] ||
  895. !idToken.claims[kBasicProfileFamilyNameKey]) {
  896. return nil;
  897. }
  898. return [[GIDProfileData alloc]
  899. initWithEmail:idToken.claims[kBasicProfileEmailKey]
  900. name:idToken.claims[kBasicProfileNameKey]
  901. givenName:idToken.claims[kBasicProfileGivenNameKey]
  902. familyName:idToken.claims[kBasicProfileFamilyNameKey]
  903. imageURL:[NSURL URLWithString:idToken.claims[kBasicProfilePictureKey]]];
  904. }
  905. // Set currentUser making appropriate KVO calls.
  906. - (void)setCurrentUserWithKVO:(GIDGoogleUser *_Nullable)user {
  907. [self willChangeValueForKey:NSStringFromSelector(@selector(currentUser))];
  908. _currentUser = user;
  909. [self didChangeValueForKey:NSStringFromSelector(@selector(currentUser))];
  910. }
  911. @end
  912. NS_ASSUME_NONNULL_END