[OAuth] Add APIs for SSO integration

[b123400]

connect https://github.com/SkygearIO/features/issues/5

• [ ] -[SKYContainer loginWithOAuthProvider:(NSString*)providerID, options:(NSDictionary*)options completion:(void(^)(NSError*, SKYUser*))]
  • Create or login a new skygear user, associated with the provider
  • providerID - A string that identify the login provider
  • We will provide com.facebook, com.google
  • options
  • uxMode - Either popup(default), or redirect, popup means in-app-browser (SFSafariViewController/WKWebView) and redirect means Safari.app
  • clientID
  • scope
  • version - FB Client SDK only
  • cookiePolicy - Google Client SDK only
  • This function returns a skygear user, and an access token of the service, via a delegate.
• [ ] -[SKYContainer loginWithOAuthProvider:(NSString*)providerID, accessToken:(NSString*)accessToken completion:(void(^)(NSError*, SKYUser*))]
  • accessToken - Client calls this API if it already has an access token, skygear will try to login directly instead of going through the OAuth flow.
• [ ] -[SKYContainer associateAccountWithProvider:(NSString*)providerID options:(NSDictionary*)options completion:(void(^)(NSError*, SKYUser*))]
  • Add a new auth provider to the user by going through the auth flow
  • providerID - A string that identify the login provider
  • options
  • uxMode - Either popup(default), or redirect, popup means in-app-browser (SFSafariViewController/WKWebView) and redirect means Safari.app
  • clientID
  • scope
  • version - FB Client SDK only
  • cookiePolicy - Google Client SDK only
  • This function returns a skygear user, and an access token of the new service, via delegate.

• [ ] -[SKYContainer getOAuthTokensWithCompletion:(void(^)(NSError*, NSDictionary*))]

  • Return tokens

    [container getOAuthTokensWithCompletion:^(NSDictionary *tokens){ //tokens['com.facebook'] is FB's access token }];