---
title: Setting up the pingonemfa module on iOS
description: Add the pingonemfa module to your iOS app and initialize it with your PingOne geography before pairing the device.
component: orchsdks
page_id: orchsdks:davinci:use-cases/pingone-mfa/ios/01-setup
canonical_url: https://developer.pingidentity.com/orchsdks/davinci/use-cases/pingone-mfa/ios/01-setup.html
llms_txt: https://developer.pingidentity.com/orchsdks/llms.txt
docs_for_agents: https://developer.pingidentity.com/build-with-ai/docs-for-agents.md
keywords: ["DaVinci", "MFA", "PingOne", "iOS", "Setup", "Initialization", "SDK"]
section_ids:
  adding_the_module: Adding the module
  initializing_the_module: Initializing the module
---

# Setting up the pingonemfa module on iOS

[icon: circle-check, set=far]PingOne [icon: apple, set=fab]iOS

Before your app can pair devices or respond to authentication challenges, add the `pingonemfa` module to your app and initialize it with your PingOne geography.

## Adding the module

To add the `pingonemfa` module to your iOS app:

1. In Xcode, select your project in the project navigator, then select your app target and open the **Package Dependencies** tab.

2. Click the **+** button, then choose **Add Package Dependency…​**.

3. Enter the package repository URL and click **Add Package**:

   <https://github.com/ForgeRock/ping-ios-sdk>

4. In the dependency rule field, select **Up to Next Major Version** and enter the version:

   Package version rule

   ```swift
   {latest_ios_mfa_vers}
   ```

5. On the **Choose Package Products** screen, select the `PingOneMFA` product and add it to your app target.

## Initializing the module

In your application startup code, import the module, call `initialize(geo:)`, and pass in the geography of the region where your PingOne environment is provisioned:

Initializing the pingonemfa module

```swift
import PingOneMFA

Task {
    do {
        try await PingOneMFA.initialize(geo: .northAmerica)
    } catch {
        print("Initialization failed: \(error.localizedDescription)")
    }
}
```

The available geographies are:

| Geography     | Value           |
| ------------- | --------------- |
| North America | `.northAmerica` |
| Europe        | `.europe`       |
| Canada        | `.canada`       |
| Australia     | `.australia`    |
| Singapore     | `.singapore`    |