# iOS

## 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://cocoapods.org


```bash
sudo gem install cocoapods
sudo gem install cocoapods-art
```

Ratepay will provide the credentials for the **~/.netrc** file containing:


```bash
machine riskident.jfrog.io
login <USERNAME>
password <PASSWORD>
```

Please copy it to your home directory and add the **RISK IDENT Cocoapod Artifactory** repository:


```bash
cp .netrc ~/
pod repo-art add riskident-ios "https://riskident.jfrog.io/riskident/api/pods/ios-release"
pod repo-art update riskident-ios
```

## Integration

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:


```bash
Pod init
```

Your project directory should look like this:


```bash
$ 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:


```bash
plugin 'cocoapods-art', :sources => [
   ‘riskident-ios’
]
```

Fourth, add the pod **ClientSecurityKit** in your pods’ definitions in the pod file:


```bash
target 'New Application' do
  ...
  # Pods for New Application
  pod 'ClientSecurityKit'
  ...
end
```

Finally, install the **ClientSecurityKit** pod by running the following command:


```bash
$ 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:


```bash
open "New Application.xcworkspace"
```

First, you need to import **ClientSecurityKit**


```bash
import ClientSecurityKit
```

Then, create a global reference:


```bash
var module : ClientSecurityModule?
```

And finally, you have to initialize the **ClientSecurityModule** inside of the ViewController class:


```bash
module = ClientSecurityModule(snippetId: String, requestToken: String, location: String? = nil)
```