Swift SDK for the Bluemix App ID service
Xcode 8.1 or above, CocoaPods 1.1.0 or higher, MacOS 10.11.5 or higher, iOS 9 or higher.
-
Add the 'BluemixAppID' dependency to your Podfile, for example:
target <yourTarget> do use_frameworks! pod 'BluemixAppID' end
-
From the terminal, run:
pod install --repo-update
- Open your Xcode project and enable Keychain Sharing (Under project settings --> Capabilities --> Keychain sharing)
- Under project setting --> info --> Url Types, Add $(PRODUCT_BUNDLE_IDENTIFIER) as a URL Scheme
- Add the following import to your AppDelegate.swift file:
import BluemixAppID
-
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).
-
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) }
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.
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
})
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.