Install the library
To install the library you need cocoapads ad the cocoapads-artifactory plugin. You can install it as *gem in the terminal or download it at https://cocoapads.org
sudo gem install cocoapods sudo gem install cocoapods-art
Ratepay will provide the credentials for the ~/.netrc file containing:
machine riskident.jfrog.io login <USERNAME> password <PASSWORD>
Please copy it to your home directory and add the RISK IDENT Cocoapod Artifactory repository:
cp .netrc ~/ pod repo-art add riskident-ios "https://riskident.jfrog.io/riskident/api/pods/ios-release" pod repo-art update riskident-ios
Here we will describe the integration using a new empty project.
Add the ClientSecurityModule to your application
First, create a new Xcode project. In Xcode go to Files » New » Project. For example you can use Single View App.
Second, change to the project directory in your terminal and init a podfile:
Your project directory should look like this:
$ ls –ahl total 24 drwxr-xr-x 6 user staff 204B Jul 28 13:06 . drwxr-xr-x 6 user staff 204B Jul 28 13:05 .. -rw-r--r--@ 1 user staff 6.0K Jul 28 13:06 .DS_Store drwxr-xr-x 7 user staff 238B Jul 28 13:05 New Application drwxr-xr-x 5 user staff 170B Jul 28 13:05 New Application.xcodeproj -rw-r--r-- 1 user staff 269B Jul 28 13:06 Podfile
Third, you need to add riskident-ios repository to the beginning of the pod file:
plugin 'cocoapods-art', :sources => [ ‘riskident-ios’ ]
Fourth, add the pod ClientSecurityKit in your pods’ definitions in the pod file:
target 'New Application' do ... # Pods for New Application pod 'ClientSecurityKit' ... end
Finally, install the ClientSecurityKit pod by running the following command:
$ pod install Analyzing dependencies Downloading dependencies Using ClientSecurityKit (1.2.5) Generating Pods project Integrating client project Sending stats Pod installation complete! There is 1 dependency from the Podfile and 1 total pod installed. [!] Automatically assigning platform `ios` with version `11.0` on target `app` because no platform was specified. Please specify a platform for this target in your Podfile. See `https://guides.cocoapods.org/syntax/podfile.html#platform`.
Collect and send data to Risk Ident
After installing the library, open your app’s .xcworkspace file to launch Xcode:
open "New Application.xcworkspace"
First, you need to import ClientSecurityKit
Then, create a global reference:
var module : ClientSecurityModule?
And finally, you have to initialize the ClientSecurityModule inside of the ViewController class:
module = ClientSecurityModule(snippetId: String, requestToken: String, location: String? = nil)