iosobjective-coauth

Implementing OAuth 1.0 in an iOS


I wish to integrate my iOS app with Withings api. It uses OAuth 1.0 and I can't seem to understand fully how to implement it.

I've been downloading multiple OAuth framworks (MPOAuth,gtm-oauth,ssoauthkit) but couldn't figure out completely what exactly I should do.

I searched a lot, also in stack overflow for good references on how to go about implementing OAuth 1.0 in general & integrating with Withings in particular with no success.

Kindly explain the flow of integrating an iOS app with an api that requires OAuth 1.0. Code examples would be very helpful. Suggested 3rd party frameworks would be nice too.

Just to clarify, I fully understand the OAuth 1.0 principles, I just have problems in actually implementing it in my app.

I think that a thorough answer with code examples and good references would be very helpful for lots of people as I couldn't find one. If anyone has good experience with implementing it, please take the time to share it.


Solution

  • TDOAuth in my opinion was the best solution. it is clean and simple, only one .h and .m file to work with, and no complicated example projects..

    This is the OAuth 1.0 flow:

    step 1 - get request token

    //withings additional params
    NSMutableDictionary *dict = [NSMutableDictionary dictionary];
    [dict setObject:CALL_BACK_URL forKey:@"oauth_callback"];
    
    //init request
    NSURLRequest *rq = [TDOAuth URLRequestForPath:@"/request_token" GETParameters:dict scheme:@"https" host:@"oauth.withings.com/account" consumerKey:WITHINGS_OAUTH_KEY consumerSecret:WITHINGS_OAUTH_SECRET accessToken:nil tokenSecret:nil];
    
    //fire request
    NSURLResponse* response;
    NSError* error = nil;
    NSData* result = [NSURLConnection sendSynchronousRequest:rq  returningResponse:&response error:&error];
    NSString *s = [[NSString alloc] initWithData:result encoding:NSUTF8StringEncoding];
    //parse result
    NSMutableDictionary *params = [NSMutableDictionary dictionary];
    NSArray *split = [s componentsSeparatedByString:@"&"];
    for (NSString *str in split){
        NSArray *split2 = [str componentsSeparatedByString:@"="];
        [params setObject:split2[1] forKey:split2[0]];
    }
    
    token = params[@"oauth_token"];
    tokenSecret = params[@"oauth_token_secret"];
    

    step 2 - get authorize token (by loading the request in a UIWebView, the webViewDidFinishLoad delegate method will handle the call back..)

    //withings additional params
    NSMutableDictionary *dict2 = [NSMutableDictionary dictionary];
    [dict setObject:CALL_BACK_URL forKey:@"oauth_callback"];
    
    //init request
    NSURLRequest *rq2 = [TDOAuth URLRequestForPath:@"/authorize" GETParameters:dict2 scheme:@"https" host:@"oauth.withings.com/account" consumerKey:WITHINGS_OAUTH_KEY consumerSecret:WITHINGS_OAUTH_SECRET accessToken:token tokenSecret:tokenSecret];
    
    webView.delegate = self;
    [DBLoaderHUD showDBLoaderInView:webView];
    [webView loadRequest:rq2];
    

    handle the webView as follow to initiate step 3 (I know the isAuthorizeCallBack smells a lot, but it does the job, should refactor it..)

    - (void)webViewDidFinishLoad:(UIWebView *)aWebView
    {
        [DBLoaderHUD hideDBLoaderInView:webView];
    
        NSString *userId = [self isAuthorizeCallBack];
        if (userId) {
    
            //step 3 - get access token
            [DBLoaderHUD showDBLoaderInView:self.view];
            [self getAccessTokenForUserId:userId];
        }
    
        //ugly patchup to fix an invalid token bug
        if ([webView.request.URL.absoluteString isEqualToString:@"http://oauth.withings.com/account/authorize?"])
        [self startOAuthFlow];
    }
    
    - (NSString *)isAuthorizeCallBack
    {
        NSString *fullUrlString = webView.request.URL.absoluteString;
    
        if (!fullUrlString)
            return nil;
    
        NSArray *arr = [fullUrlString componentsSeparatedByString:@"?"];
        if (!arr || arr.count!=2)
            return nil;
    
        if (![arr[0] isEqualToString:CALL_BACK_URL])
            return nil;
    
        NSString *resultString = arr[1];
        NSArray *arr2 = [resultString componentsSeparatedByString:@"&"];
        if (!arr2 || arr2.count!=3)
            return nil;
    
        NSString *userCred = arr2[0];
        NSArray *arr3 = [userCred componentsSeparatedByString:@"="];
        if (!arr3 || arr3.count!=2)
            return nil;
    
        if (![arr3[0] isEqualToString:@"userid"])
            return nil;
    
        return arr3[1];
    }
    
    - (void)startOAuthFlow
    { 
        [self step1];
        [self step2];
    }
    

    and finally - step 3 - get access token

    - (void)getAccessTokenForUserId:(NSString *)userId
    {
        //step 3 - get access token
    
        //withings additional params
        NSMutableDictionary *dict = [NSMutableDictionary dictionary];
        [dict setObject:CALL_BACK_URL forKey:@"oauth_callback"];
        [dict setObject:userId forKey:@"userid"];
    
        //init request
        NSURLRequest *rq = [TDOAuth URLRequestForPath:@"/access_token" GETParameters:dict scheme:@"https" host:@"oauth.withings.com/account" consumerKey:WITHINGS_OAUTH_KEY consumerSecret:WITHINGS_OAUTH_SECRET accessToken:token tokenSecret:tokenSecret];
    
        //fire request
        NSURLResponse* response;
        NSError* error = nil;
        NSData* result = [NSURLConnection sendSynchronousRequest:rq  returningResponse:&response error:&error];
        NSString *s = [[NSString alloc] initWithData:result encoding:NSUTF8StringEncoding];
    
        //parse result
        NSMutableDictionary *params = [NSMutableDictionary dictionary];
        NSArray *split = [s componentsSeparatedByString:@"&"];
        for (NSString *str in split){
            NSArray *split2 = [str componentsSeparatedByString:@"="];
            [params setObject:split2[1] forKey:split2[0]];
        }
    
        [self finishedAthourizationProcessWithUserId:userId AccessToken:params[@"oauth_token"] AccessTokenSecret:params[@"oauth_token_secret"]];
    }