# iOS 시뮬레이터

> macOS의 Proxyman으로 iOS 시뮬레이터의 HTTP/HTTPS 트래픽을 캡처하세요. 인증서 자동 설정, 수동 설치, 트래픽이 보이지 않을 때의 점검 방법을 다룹니다.

Mac에서 Proxyman으로 iOS 시뮬레이터의 HTTP/HTTPS 요청을 캡처하고 검사하세요. 인증서 자동 설치부터 시작하고, 설치가 실패하면 아래의 수동 단계를 사용하세요.

시작하기 전에 Xcode를 설치하고, 디버깅할 시뮬레이터를 한 번 이상 실행해 두세요. 앱에서 요청을 재현하는 동안에는 Proxyman을 계속 실행해 두세요. HTTPS를 검사하려면 인증서를 설치하고 신뢰하도록 설정한 다음, 해당 도메인에 대해 [SSL Proxying](https://proxyman.com/docs/ko/basic-features/ssl-proxying)을 활성화하세요.

Proxyman에서 시뮬레이터 설정 가이드를 여세요:

* **Certificate** **Menu** -> **Install Certificate on iOS -> Simulators**

## 동영상 {#video}

[Video: iOS 시뮬레이터에서 HTTPS 트래픽 캡처하기](https://proxyman.com/videos/ios-simulator) (32 seconds)

[Xcode 26으로 iOS 26 시뮬레이터에서 네이티브 iOS 앱의 HTTPS 캡처하기](https://www.youtube.com/watch?v=THzb2e9hoGo)

## 1. iOS 시뮬레이터 설정 가이드 {#1-ios-simulator-setup-guide}

![인증서 Installed & Trusted, Prepare Simulators, Reboot의 세 단계가 있는 Proxyman iOS 시뮬레이터 설정](https://proxyman.com/docs/assets/proxyman-ios-simulators-setup.jpg)

_iOS 시뮬레이터 설정_

> **노트:** iOS, iPadOS, tvOS, watchOS, visionOS에서 모두 작동합니다.

설정 가이드는 세 단계로 구성됩니다:

1. Mac에 **Root Proxyman Certificate**를 설치합니다. [macOS 가이드](https://proxyman.com/docs/ko/debug-devices/macos)를 참고할 수 있습니다.
2. 최소 한 번 이상 실행한 모든 시뮬레이터에 Proxyman 인증서를 설치합니다 (**Prepare Simulators**를 클릭하세요).
3. **시뮬레이터 재부팅**: Proxyman이 모든 시뮬레이터를 재부팅하여 새 인증서를 로드하게 합니다.

> **노트:** Proxyman 2.19.0 이상에서는 이 작업을 수행할 때 [simctl](https://nshipster.com/simctl/) 명령줄을 사용합니다. 
>
> **simctl**은 Xcode에 포함되어 있습니다. 기존 방식(사용자 지정 Python 스크립트)보다 최신이며 더 안정적입니다.

> **노트:** 이 단계는 최소 한 번 이상 실행한 시뮬레이터에만 인증서를 설치합니다.
>
> 예를 들어 iPhone X 시뮬레이터에서 디버깅하려면, 먼저 iPhone X 시뮬레이터를 **실행**한 다음 2단계에서 인증서를 **설치**하세요. 

### Xcode 프리뷰 (SwiftUI) {#xcode-preview-swiftui}

SwiftUI용 Xcode 프리뷰를 사용 중이라면, Xcode 프리뷰 시뮬레이터에 인증서를 설치할 수 있습니다:

1. SwiftUI 프리뷰 캔버스가 있는 Xcode를 엽니다.
2. Proxyman -> Certificate 메뉴 -> Install Certificate on iOS -> Simulators를 엽니다.
3. 2단계에서 Prepare Simulators 버튼 옆의 ↓ 버튼 -> Install to Xcode Preview (SwiftUI)를 클릭합니다.

자세한 내용은 [GitHub 이슈 #1568](https://github.com/ProxymanApp/Proxyman/issues/1568#issue-1610877870)에서 확인할 수 있습니다.

### 수동 설치 {#manually-install}

Proxyman v4.16.0 이상에서는 자동 설치가 작동하지 않을 경우 iOS 시뮬레이터에 인증서를 수동으로 설치할 수 있습니다.

1. Certificate 메뉴 -> Install Certificate on iOS -> Simulators
2. 2단계에서 Prepare Simulators 버튼 옆의 ↓ 버튼 -> Install Manually…를 클릭합니다.

![Prepare Simulators 메뉴가 열려 있고 Install Manually가 선택된 Proxyman iOS 시뮬레이터 설정](https://proxyman.com/docs/assets/Screenshot%202024-11-01%20at%2020.14.39.jpg)

_인증서를 수동으로 설치하기_

3. 인증서를 iOS 시뮬레이터로 드래그 앤 드롭하세요.

![드래그할 수 있는 Proxyman 인증서 아이콘과 시뮬레이터에서 인증서를 신뢰하는 단계가 표시된 Proxyman 시트](https://proxyman.com/docs/assets/Screenshot%202024-01-07%20at%2014.43.13.png)

_인증서를 시뮬레이터로 드래그한 다음 신뢰하기_

4. iOS 시뮬레이터를 엽니다 -> Settings 앱 -> General -> About -> Certificate Trust Settings -> Proxyman CA 인증서를 찾아 스위치를 ON으로 설정하세요.
5. 완료

## 2. 문제 해결 {#2-troubleshooting}

요청 목록이 비어 있다면, 먼저 [트래픽이 보이지 않을 때의 점검 목록](https://proxyman.com/docs/ko/troubleshooting/i-couldnt-see-any-traffics-on-proxyman)으로 기록 상태, 필터, 프록시 설정을 확인하세요. 요청은 보이지만 HTTPS가 실패한다면 인증서 설치와 SSL Proxying을 확인하세요. 아래 섹션에서는 설치 오류와 캐시된 요청을 다룹니다.

### 1. 인증서를 설치할 수 없음 {#1-unable-to-install-the-certificate}

2단계의 버튼을 클릭했을 때 오류가 발생하면, Xcode -> Settings -> Locations 탭을 열고 Command Line Tools에서 사용 중인 Xcode를 선택하세요.

### 2. HTTPS 응답에서 SSL 오류 발생 {#2-get-ssl-error-from-https-response}

* Settings 앱 -> General -> About -> Certificate Trust Settings를 열고 Proxyman 인증서가 설치되어 있고 신뢰되었는지 확인하세요.

설치되지 않았다면:

* iOS 시뮬레이터 설정(Certificate 메뉴 -> Install Certificate on iOS -> Simulators)을 열고 2단계의 버튼을 클릭하세요.
* 또는 아래의 [인증서를 내보내서 수동으로 설치하기](#manually-install-the-certificate-by-exporting-the-certificate) 단계를 따르세요.

### 3. 일부 HTTP/HTTPS 요청이 Proxyman에 보이지 않음 {#3-some-httphttps-requests-are-missing-from-proxyman}

Alamofire나 URLSession은 요청에 대해 캐시된 응답을 사용할 수 있습니다. 그 결과 실제 요청이 서버에 도달하지 않으므로, Proxyman이 이를 캡처하여 표시할 수 없습니다.

해결 방법: 

* URLSession 또는 Alamofire의 캐시 메커니즘을 비활성화하세요.
* [No Caching Tool](https://proxyman.com/docs/ko/advanced-features/no-caching) (⌥⌘N)을 사용하세요.

## 인증서를 내보내서 수동으로 설치하기 {#manually-install-the-certificate-by-exporting-the-certificate}

인증서를 설치할 수 없다면 **수동으로** 설치할 수 있습니다:

1. Proxyman -> Certificate 메뉴 -> Export -> Root Certificate as DER를 선택한 다음, 데스크톱 폴더에 저장하세요.
2. 시뮬레이터를 연 다음, **인증서를 드래그하여** 시뮬레이터 화면에 **드롭**하세요.
3. (시뮬레이터에서) Settings 앱 -> General -> VPN & Device Management (구버전 iOS에서는 Device Management) -> 인증서 선택 -> Install
4. Settings 앱 -> General -> About -> Certificate Trust Settings에서 Proxyman 인증서가 설치되고 신뢰되었는지 확인하세요.
5. 완료 ✅

## 튜토리얼 {#tutorial}

Proxyman으로 [iOS 시뮬레이터에서 앱 디버깅하기](https://proxyman.com/posts/2019-07-06-Debugging-on-iOS-Simulator-with-Proxyman)의 자세한 단계를 확인하세요.

## 더 알아보기 {#learn-more}

* [Proxyman으로 iOS 15 시뮬레이터의 네트워크 트래픽을 검사하는 방법](https://proxyman.com/posts/2022-06-04-How-to-inspect-network-traffic-from-iOS-simulator-with-Proxyman)
* [Vision Pro 시뮬레이터에서 HTTPS 요청 캡처하기](https://proxyman.com/posts/2024-01-24-Capture-HTTPS-traffic-from-Vision-Pro-Simulator)
* [Proxyman으로 iOS 시뮬레이터 HTTP/HTTPS 트래픽 캡처하기](https://proxyman.com/ios-simulator) (Proxyman 웹사이트)