smguilia/appid-clientsdk-swift

Bluemix App ID

Swift SDK for the Bluemix App ID service

Requirements

Xcode 8.1 or above, CocoaPods 1.1.0 or higher, MacOS 10.11.5 or higher, iOS 9 or higher.

Installing the SDK:

1. Add the 'BluemixAppID' dependency to your Podfile, for example:

   target <yourTarget> do
      use_frameworks!
        pod 'BluemixAppID'
   end

2. From the terminal, run:

   pod install --repo-update

Using the SDK:

Initializing the App ID client SDK

1. Open your Xcode project and enable Keychain Sharing (Under project settings --> Capabilities --> Keychain sharing)
2. Under project setting --> info --> Url Types, Add $(PRODUCT_BUNDLE_IDENTIFIER) as a URL Scheme
3. Add the following import to your AppDelegate.swift file:

import BluemixAppID

4. Initialize the client SDK by passing the tenantId and region parameters to the initialize method. A common, though not mandatory, place to put the initialization code is in the application:didFinishLaunchingWithOptions: method of the AppDelegate in your Swift application.

   AppID.sharedInstance.initialize(tenantId: <tenantId>, bluemixRegion: AppID.REGION_UK)

   • Replace "tenantId" with the App ID service tenantId.
   • Replace the AppID.REGION_UK with the your App ID region (AppID.REGION_US_SOUTH, AppID.REGION_SYDNEY).

5. Add the following code to you AppDelegate file

   func application(_ application: UIApplication, open url: URL, options :[UIApplicationOpenURLOptionsKey : Any]) -> Bool {
       return AppID.sharedInstance.application(application, open: url, options: options)
   }

Using Login Widget

After the App ID client SDK is initialized, you can start authenticate users by launching the Login Widget. Add the following import to the file in which you want to use the using the login Widget:

import BluemixAppID

Then add the following code:

class delegate : AuthorizationDelegate {
    public func onAuthorizationSuccess(accessToken: AccessToken, identityToken: IdentityToken, response:Response?) {
        //User authenticated
    }

    public func onAuthorizationCanceled() {
        //Authentication canceled by the user
    }

    public func onAuthorizationFailure(error: AuthorizationError) {
        //Exception occurred
    }
}

AppID.sharedInstance.loginWidget?.launch(delegate: delegate())

Note: The Login widget default configuration use Facebook and Google as authentication options. If you configure only one of them the login widget will NOT launch and the user will be redirect to the configured idp authentication screen.

Invoking protected resources

Add the following imports to the file in which you want to invoke a protected resource request:

import BMSCore
import BluemixAppID

Then add the following code:

BMSClient.sharedInstance.initialize(bluemixRegion: AppID.REGION_UK)
BMSClient.sharedInstance.authorizationManager = AppIDAuthorizationManager(appid:AppID.sharedInstance)
var request:Request =  Request(url: "<your protected resource url>")
request.send(completionHandler: {(response:Response?, error:Error?) in
    //code handling the response here
})

License

This package contains code licensed under the Apache License, Version 2.0 (the "License"). You may obtain a copy of the License at http://www.apache.org/licenses/LICENSE-2.0 and may also view the License in the LICENSE file within this package.