A quick and simple way to authenticate a Box user in your iPhone or iPad app.
CocoaPods is the recommended way to add BoxSimpleOAuth to your project.
- Add BoxSimpleOAuth to your Podfile
pod 'BoxSimpleOAuth'
. - Install the pod(s) by running
pod install
. - Add BoxSimpleOAuth to your files with
#import <BoxSimpleOAuth/BoxSimpleOAuth.h>
.
- Add
github "rbaumbach/BoxSimpleOAuth"
to your Cartfile. - Follow the directions to add the dynamic framework to your target.
- Clone repository from github and copy files directly, or add it as a git submodule.
- Add all files from 'Source' directory to your project.
- Create an instance of
BoxSimpleOAuthViewController
and pass in an Box client ID, client secret, client callback URL and completion block to be executed withBoxLoginResponse
andNSError
arguments. - Once the instance of
BoxSimpleOAuthViewController
is presented (either as a modal or pushed on the navigation stack), it will allow the user to login. After the user logs in, the completion block given in the initialization of the view controller will be executed. The argument in the completion block,BoxLoginResponse
, contains an accessToken and other login information for the authenticated user provided by Box API Response. If there is an issue attempting to authenticate, an error will be given instead. - By default, if there are issues with authentication, an UIAlertView will be given to the user. To disable this, and rely on the NSError directly, set the property
shouldShowErrorAlert
to NO. - An access_token can be refreshed using the underlying BoxAuthenticationManager.
- Note: Even though an instance of the view controller itself can be initialized without client ID, client secret, client callback and completion block (to help with testing), this data must be set using the view controller's properties before it is presented to the user.
// Simplest Example:
BoxSimpleOAuthViewController
*viewController = [[BoxSimpleOAuthViewController alloc] initWithClientID:@"panchos_client_id"
clientSecret:@"shhhhhh, I'm a secret"
callbackURL:[NSURL URLWithString:@"http://chihuahuas.dog"]
completion:^(BoxLoginResponse *response, NSError *error) {
NSLog(@"My Access Token is: %@", response.accessToken);
}];
[self.navigationController pushViewController:viewController
animated:YES];
// Disable error UIAlertViews Example:
BoxSimpleOAuthViewController
*viewController = [[BoxSimpleOAuthViewController alloc] initWithClientID:@"pancho_jrs_client_id"
clientSecret:@"shhhhhh, I'm a secret"
callbackURL:[NSURL URLWithString:@"http://your.fancy.site"]
completion:^(BoxLoginResponse *response, NSError *error) {
NSLog(@"My OAuth Token is: %@", response.accessToken);
}];
viewController.shouldShowErrorAlert = NO;
[self.navigationController pushViewController:viewController
animated:YES];
This project has been setup to use fastlane to run the tests.
First, run the setup.sh script to bundle required gems and CocoaPods when in the project directory:
$ ./setup.sh
And then use fastlane to run all the specs on the command line:
$ bundle exec fastlane specs
Version history can be found on releases page.
Thanks for checking out BoxSimpleOAuth for your in-app Box Authentication. Any feedback can be can be sent to: github@ryan.codes.