---
title: "SDK 실링"
description: "프로젝트를 생성하고 SDK를 다운로드하여 빌드 파이프라인에 통합하는 방식으로 iOS 앱을 보호합니다."
---
> For the complete documentation index, see [llms.txt](https://docs.doverunner.com/llms.txt).

SDK 실링은 빌드 파이프라인을 통해 iOS 앱을 보호합니다. Developer Console에서 프로젝트를 생성하고 SDK를 다운로드한 후 빌드에 통합하면 됩니다 — 별도의 코드 변경은 필요하지 않습니다.

**Note:** 
빌드 방식을 바꾸지 않고 이미 빌드된 앱을 보호하려면 [IPA 실링](https://docs.doverunner.com/ko/mobile-app-security/ios/ipa-sealing/)을 참고하세요.


## 가이드

  - [SDK 연동](#doverunner-mobile-app-security-적용)
    프로젝트를 생성하고 SDK를 다운로드하여 앱에 통합합니다.
  - [앱 구성](#앱-구성)
    실링된 iOS 앱의 서비스 설정을 관리합니다.
  - [CI/CD 연동](https://docs.doverunner.com/ko/mobile-app-security/ios/cicd/)
    Fastlane 또는 Azure DevOps로 실링을 자동화합니다.
  - [SDK 파일 구조](https://docs.doverunner.com/ko/mobile-app-security/ios/sdk-file-structure/)
    다운로드한 SDK 패키지에 포함된 파일을 확인합니다.

---

## DoveRunner Mobile App Security 적용

### 사전 준비

프로젝트 생성 전 다음을 준비하세요:
- **Bundle ID** — 앱의 Bundle ID (예: `com.example.myapp`). 프로젝트 생성 시 설정되며 이후 변경할 수 없습니다.
- **프레임워크** — 앱을 빌드한 프레임워크. React Native의 경우 사용한 정확한 버전을 확인해 두세요.

### 프로젝트 생성


1. Developer Console에서 **iOS 모바일 앱 보안** → **SDK 프로젝트**로 이동합니다.

2. **+ 프로젝트 만들기**를 클릭하여 **새로운 iOS AppSealing 프로젝트** 창을 엽니다.

3. **프로젝트 이름**과 앱의 **번들 ID 접두사**(예: `com.example`)를 입력합니다. 콘솔이 접두사 뒤에 `.*`를 붙이므로 해당 접두사로 시작하는 모든 Bundle ID가 포함됩니다.

4. **생성하기**를 클릭합니다. 시스템이 Bundle ID를 검증하고 올바른 경우 프로젝트가 생성됩니다.


**Note:** 
각 프로젝트에는 Bundle ID를 하나만 등록할 수 있으며, 생성 후에는 변경할 수 없습니다. 앱의 Bundle ID는 등록된 Bundle ID 접두사로 시작해야 합니다.


![ios new project](https://docs.doverunner.com/img/mobile-app-security/console-ios-create-new.png)

생성한 프로젝트는 **프로젝트 관리** 아래에 프로젝트 이름과 번들 ID 접두사가 표시된 카드로 나타납니다. 프로젝트 이름 옆의 편집 아이콘으로 이름을 바꿀 수 있습니다.

#### iOS SDK Assistant (베타)

**SDK 프로젝트** 상단에는 macOS 데스크톱 앱(베타)인 **iOS SDK Assistant** 배너가 표시됩니다. 이 앱은 SDK zip 파일을 드롭하고 대상에 AppSealing을 설치한 뒤 아카이브하고 실링하는 과정을 커맨드라인 없이 안내합니다. **앱 받기**를 클릭하면 상세 정보와 **macOS용 다운로드 (.zip)** 버튼이 열립니다. Xcode 15 이상이 설치된 macOS 13 이상과, 해당 계정에 활성화된 AppSealing iOS 구독이 필요합니다.

### 인증정보 확인

프로젝트 카드에서 **인증정보 확인**을 클릭하면 **프로젝트 인증 정보** 창이 열립니다. 프로젝트 이름과 번들 ID 접두사와 함께 프로젝트의 **Credential**, **IV**, **키**가 표시되며, 각 값은 복사 버튼으로 복사할 수 있습니다.

앱 무결성에 대한 서버 검증을 구현할 때 이 값을 사용합니다. SDK 가이드에 따라 앱에서 인증키를 획득해 인증 서버로 전송하면, 인증 서버가 이 인증 정보와 대조해 검증합니다.

**Caution:** 
인증정보가 외부에 노출되지 않도록 주의하세요.


### SDK 다운로드


1. **SDK 프로젝트**에서 SDK를 생성할 프로젝트를 찾습니다.

2. **SDK 다운로드**를 클릭하여 다운로드 옵션을 엽니다.

3. 드롭다운에서 다음 값을 선택합니다:

   | 필드 | 설명 |
   | :--- | :--- |
   | 앱 프레임워크 | iOS 앱 개발에 사용된 프레임워크: **Xcode & Flutter**, **Unity**, **Unreal**, **Xamarin**, **React Native**, **Ionic**, **Cordova**. React Native, Ionic, Cordova에는 **HYBRID** 표시가 붙습니다. |
   | 앱실링 버전 | 적용할 DoveRunner 보호 버전. 최신 버전이 기본으로 선택되며, 이전 버전을 고르면 **앱실링 구버전 선택**이 표시됩니다. 최신 버전을 사용하면 최신 보안 기능을 이용할 수 있습니다. |
   | 프레임워크 버전 | React Native에서만 표시됩니다. 두 개의 드롭다운에서 React Native 주 버전과 부 버전을 선택합니다. |

4. **다운로드**를 클릭합니다. 시스템이 프로젝트를 검증하고 SDK 빌드를 시작합니다. 준비되면 자동으로 다운로드됩니다.


**Note:** 
하이브리드 프레임워크(React Native, Ionic, Cordova)는 하이브리드 앱이 포함된 요금제가 필요합니다. **앱 프레임워크** 목록에서 **만료**로 표시된다면 [헬프 센터](https://support.doverunner.com)로 문의해 활성화하세요.


![ios download sdk](https://docs.doverunner.com/img/mobile-app-security/console-ios-download.png)

#### 선택 설정

| 옵션 | 설명 |
| :--- | :--- |
| App Store & TestFlight를 사용하지 않는 배포 허용 | Apple 인증서 무결성 검증을 비활성화합니다. App Store 또는 TestFlight 외의 방식(예: 엔터프라이즈 배포, IPA 직접 설치)으로 배포하는 경우 활성화하세요. 체크하면 **앱실링 버전** 목록이 이 배포 방식용 버전으로 제한되고, 이 SDK는 일부 보안 기능이 약화되어 있으므로 반드시 필요한 경우에만 사용하라는 안내가 표시됩니다. |
| 위협 감지 시 앱을 종료하지 않음. | 앱실링 버전 `1.13.0.0` 이상에서만 표시됩니다. 감지 시 강제 종료 대신 SDK에서 제공하는 감지 플래그를 활용해 커스텀 동작을 구현할 수 있습니다. 위협 유형별로 콜백을 등록해야 하며, 운영 환경에서 처리되지 않은 상태로 두면 안 됩니다. 빌드된 IPA에 `generate_hash`가 성공적으로 완료된 후 활성화됩니다. |

---

## 앱 구성

**앱 구성**에서 실링된 iOS 앱의 서비스 설정을 관리할 수 있습니다. IPA 실링과 SDK 실링이 함께 사용하는 메뉴입니다. 목록에는 본인 또는 팀 구성원이 실링한 앱이 표시됩니다.

**서비스**

DoveRunner Mobile App Security가 앱의 해킹 활동을 추적할지 여부를 설정합니다. 서비스가 활성화된 동안 사용량 기반 요금이 발생합니다. 앱을 더 이상 사용하지 않거나 보호를 중단하려면 여기서 서비스를 끄세요.

![ios app config](https://docs.doverunner.com/img/mobile-app-security/console-ios-app-conf.png)

---

## 다음 단계

SDK를 다운로드한 후 빌드 파이프라인에 통합하고 `generate_hash`를 실행하여 실링 프로세스를 완료합니다.

  - [Fastlane 연동](https://docs.doverunner.com/ko/mobile-app-security/ios/cicd/fastlane-automation-toolkit-ios/)
    Fastlane으로 SDK 통합 및 IPA 실링을 자동화합니다.
  - [Azure DevOps 연동](https://docs.doverunner.com/ko/mobile-app-security/ios/cicd/azure-ci-cd-ios/)
    Azure DevOps로 iOS 실링 파이프라인을 자동화합니다.