---
title: "iOS App Security"
description: "Apply DoveRunner Mobile App Security to your iOS app using the SDK-based integration."
---
> For the complete documentation index, see [llms.txt](/llms.txt).

import { Aside, Steps, LinkCard, CardGrid } from '@astrojs/starlight/components';

DoveRunner Mobile App Security for iOS uses an SDK-based approach. You create a project in the Developer Console, download the generated SDK, and integrate it into your build pipeline — no code changes required.

## Guides

<CardGrid>
  <LinkCard title="SDK Integration" href="#applying-doverunner-mobile-app-security" description="Create a project, download the SDK, and integrate it into your app." />
  <LinkCard title="App Configurations" href="#app-configurations" description="Manage service settings for your sealed iOS apps." />
  <LinkCard title="CI/CD Integration" href="./cicd/" description="Automate sealing with Fastlane or Azure DevOps." />
  <LinkCard title="SDK File Structure" href="./sdk-file-structure/" description="Understand the files included in the downloaded SDK package." />
</CardGrid>

---

## Applying DoveRunner Mobile App Security

### Prerequisites

Before creating a project, have the following ready:
- **Bundle ID** — Your app's Bundle ID (e.g. `com.example.myapp`). This is set at project creation and cannot be changed later.
- **Framework** — The framework your app is built with. For React Native, know the exact version used.

### Create a Project

<Steps>

1. In the Developer Console, navigate to **iOS DoveRunner Mobile App Security** → **Manage Projects**.

2. Click **+ Create New Project** to open the creation form.

3. Enter a project name and your app's **Bundle ID prefix**.

4. Click **Create Project**. The system validates the Bundle ID and creates the project if the details are correct.

</Steps>

<Aside>
Each project supports one Bundle ID and it cannot be revised after creation. Your app's Bundle ID must start with the registered Bundle ID prefix.
</Aside>

![ios new project](/img/mobile-app-security/console-ios-create-new.png)

### Download SDK

<Steps>

1. In **Manage Projects**, find the project you want to generate an SDK for.

2. Click **Download SDK** to open the download options.

3. Select values from the dropdowns:

   | Field | Description |
   | :---- | :---------- |
   | App Framework | The framework used to develop your iOS app. Supports native and hybrid frameworks. |
   | Sealing Version | The version of DoveRunner protection to apply. Use the latest version for the newest security features. |
   | Framework Version | Required for React Native only. Enter the React Native version used in your project. |

4. Click **Download**. The system validates the project and begins building the SDK. It downloads automatically when ready.

</Steps>

![ios download sdk](/img/mobile-app-security/console-ios-download.png)

#### Optional Settings

| Option | Description |
| :----- | :---------- |
| Allow distributing without App Store & TestFlight | Disables Apple certificate integrity validation. Enable this if your app is distributed outside the App Store or TestFlight (e.g. enterprise distribution). |
| Do not terminate the app on detecting a threat | Instead of force-closing the app on detection, the SDK exposes detection flags you can use to implement custom responses. Activated after a successful `generate_hash` run on the built IPA. |

---

## App Configurations

App Configurations lets you manage service settings for your sealed iOS apps. The list shows apps sealed by you or your team members.

**Service**

Controls whether DoveRunner Mobile App Security tracks hacking activity for the app. Usage-based charges apply while the service is active. Turn it off here if you are no longer using the app or want to stop protection.

![ios app config](/img/mobile-app-security/console-ios-app-conf.png)

---

## Next Steps

After downloading the SDK, integrate it into your build pipeline and run `generate_hash` to complete the sealing process.

<CardGrid>
  <LinkCard title="Fastlane Integration" href="./cicd/fastlane-automation-toolkit-ios/" description="Automate SDK integration and IPA sealing with Fastlane." />
  <LinkCard title="Azure DevOps Integration" href="./cicd/azure-ci-cd-ios/" description="Set up an automated iOS sealing pipeline with Azure DevOps." />
</CardGrid>