iOS WKWebView 내에서 유니버설 링크를 활성화하려면 어떻게 해야 하나요? 유니버설 링크는 WKWebView 내의 적격 링크에서 이미 해석될 수 있습니다. WKNavigationDelegate를 구현하면 호스트 애플리케이션이 앱 소유의 대상을 가로채고, decidePolicyForNavigationAction을 통해 외부 핸드오프를 제어하며, 프레임 수준의 보안을 강화하는 등 라우팅 정책을 사용자 지정할 수 있습니다.
iOS 애플리케이션 아키텍처에서 WKWebView 탐색 가로채기를 사용하면 호스트 애플리케이션이 유니버설 링크, 사용자 지정 URL 스킴 및 웹 대상 전반에 걸쳐 라우팅 정책을 사용자 지정할 수 있습니다. WKNavigationDelegate 내에서 탐색 요청 메타데이터를 평가함으로써 애플리케이션은 앱 소유의 대상을 내부적으로 라우팅하고, 외부 대상을 시스템 핸들러로 위임하며, 프레임 수준의 보안 정책을 적용할 수 있습니다.
| 용어 | 정의 | 관련 엔티티 | 검색 의도 역할 |
|---|---|---|---|
| WebView | iOS 애플리케이션 내에서 대화형 웹 콘텐츠를 렌더링하는 내장 WebKit 기반 뷰 컴포넌트입니다. | iOS SDK | 정보 제공 / 상업적 |
| 유니버설 링크 (Universal Links) | 확인된 웹 도메인을 네이티브 iOS 애플리케이션 뷰에 연결하는 표준 HTTPS 메커니즘입니다. | 딥 링크 라우팅 | 기술적 / 정보 제공 |
| 사용자 지정 URL 스킴 (Custom URL Scheme) | URL을 네이티브 애플리케이션으로 라우팅하는 데 사용되는 앱 정의 URI 스킴입니다. | 모바일 딥 링크 | 정보 제공 |
iOS에서 WKWebView와 유니버설 링크 라우팅이 상호 작용하는 방식

WebKit 탐색 수명 주기와 앱 소유 라우팅 정책
Apple은 Safari와 WKWebView 환경 모두에서 지원되는 시스템 수준 라우팅 메커니즘으로 유니버설 링크를 구현합니다. 사용자가 내장 WKWebView 내에서 적격 링크를 탭하면, 플랫폼은 도메인 연관성을 해석하고 운영 체제 정책에 따라 실행을 라우팅할 수 있습니다.
시스템이 인식하는 유니버설 링크는 네이티브 핸들러로 실행을 넘길 수 있지만, 내장 브라우저 환경에서는 종종 애플리케이션별 라우팅 로직이 필요합니다. 예를 들어, 링크가 호스트 애플리케이션의 자체 도메인을 대상으로 하는 경우, 개발자는 전체 외부 앱 재실행을 트리거하지 않고 네이티브 뷰 컨트롤러를 통해 직접 탐색하는 것을 선호합니다. WKNavigationDelegate를 구현하면 호스트 애플리케이션에 링크 평가에 대한 세밀한 제어 권한이 제공되므로, 팀은 사용자 지정 허용 목록을 적용하고 내부 대상을 예측 가능하게 라우팅할 수 있습니다.
사용자 경험 장벽: 인앱 웹 브라우징이 사용자를 웹 리디렉션 루프에 가둘 때
내장 WebView는 iOS 앱 내에서 프로모션 마이크로사이트, 고객 센터, 파트너 카탈로그 및 마케팅 랜딩 페이지를 호스팅하기 위해 자주 배포됩니다. 인앱 웹 페이지에 사용자를 호스트 애플리케이션의 다른 섹션(예: “앱에서 보기” 버튼)이나 파트너 애플리케이션으로 이동시키려는 링크가 포함되어 있으면, 기본 탐색은 중복 렌더링을 유발할 수 있습니다:
- 중복 웹 렌더링: 네이티브 뷰 컨트롤러를 렌더링하는 대신, 사용자에게 인앱 페이지의 반응형 웹 버전이 표시되어 반복적인 인증이 필요하고 시각적 일관성이 저하될 수 있습니다.
- 웹 트래핑: 사용자가 주요 네이티브 앱 인터페이스로 돌아갈 직관적인 방법 없이 깊은 웹 탐색 스택 안에 갇힐 수 있습니다.
- 앱 간 전환 실패: 타사 서비스(예: 내비게이션 앱, 소셜 공유 대화 상자 또는 결제 게이트웨이)를 가리키는 링크를 탭하면, 해당 서비스가 사용자 지정 URL 스킴에 의존하는 경우 명시적인 위임이 필요합니다.
웹-투-앱 핸드오프를 위한 WKWebView와 SFSafariViewController 비교
iOS에서 인앱 웹 브라우징을 설계할 때 엔지니어링 팀은 WKWebView와 SFSafariViewController 중에서 선택해야 합니다:
SFSafariViewController: 자동 완성 및 콘텐츠 차단과 같은 기능이 포함된 시스템 관리형 자체 Safari 브라우징 인터페이스를 제공합니다. 호스트 애플리케이션은 브라우징 활동이나 웹사이트 데이터를 검사할 수 없으며, UI 사용자 지정은 틴트 색상으로 제한됩니다.WKWebView: 앱의 UI 프로세스 내에서 호스팅되면서 별도의 WebKit 프로세스에서 웹 콘텐츠를 실행하는 내장 뷰 컴포넌트입니다. 심층적인 UI 사용자 지정, JavaScript 브리지 및 사용자 지정 레이아웃 통합이 가능하며, 라우팅 정책을 사용자 지정하고 앱 정의 사용자 지정 스킴을 처리하려면WKNavigationDelegate를 명시적으로 구현해야 합니다.
decidePolicyForNavigationAction이 WebKit 라우팅을 가로채는 방법
탐색 정책 파이프라인: WKNavigationAction, request 및 decisionHandler 이해
WKWebView 내의 탐색 흐름을 제어하기 위해 개발자는 Apple의 WKNavigationDelegate 관련 개발자 가이드를 준수하는 사용자 지정 델리게이트를 할당합니다. 주요 가로채기 지점은 다음 델리게이트 메서드입니다:
func webView(
_ webView: WKWebView,
decidePolicyFor navigationAction: WKNavigationAction,
decisionHandler: @escaping (WKNavigationActionPolicy) -> Void
)
사용자 상호 작용, 프로그래밍 방식의 리디렉션 또는 양식 제출에 의해 트리거된 탐색 작업은 이 메서드를 통과합니다. WKNavigationAction 객체는 다음과 같은 주요 메타데이터를 제공합니다:
navigationAction.request.url: 요청되는 대상URL입니다.navigationAction.navigationType: 트리거 유형(.linkActivated,.other,.formSubmitted)입니다.navigationAction.sourceFrame: 탐색 요청을 시작하는 프레임에 관한 정보입니다.navigationAction.targetFrame: 콘텐츠가 로드될 의도된 대상 프레임에 관한 정보입니다.
decisionHandler는 WebKit에 요청된 탐색을 허용할지 취소할지 알려주는 완료 클로저입니다.
.allow와 .cancel을 반환할 시기: WebKit 리소스 로딩 수명 주기 제어
decisionHandler에 전달되는 WKNavigationActionPolicy는 WebKit이 탐색을 진행할지 여부를 제어합니다:
.allow: WebKit에 웹 뷰 내에서 요청된 탐색을 진행하도록 알립니다..cancel: WebKit에 요청된 탐색을 취소하도록 지시합니다. 이 정책은 호스트 애플리케이션이 사용자 지정 스킴을 가로채거나, 앱 소유의 유니버설 링크를 내부적으로 라우팅하거나, 외부 대상을UIApplication.shared.open()으로 위임할 때 실행됩니다.
탐색 정책 결정이 지연되지 않도록 decisionHandler는 탐색 작업당 정확히 한 번 호출되어야 합니다.
탐색 유형 평가: 사용자 클릭(.linkActivated)과 자동 리디렉션 구분
WKNavigationAction.navigationType을 사용하면 개발자가 명시적인 사용자 상호 작용과 자동화된 스크립트를 구분할 수 있습니다:
.linkActivated: 사용자가 HTML 앵커 태그(<a href="...">)를 실제로 탭했습니다..other:window.location.href업데이트, 메타 새로 고침 또는 초기webView.load()호출과 같은 프로그래밍 방식의 탐색을 나타냅니다..formSubmitted/.formResubmitted: 양식 POST 또는 GET 제출을 나타냅니다.
navigationType을 평가하면 애플리케이션이 보수적인 애플리케이션 수준의 명시적 링크 정책을 적용할 수 있습니다. 외부 사용자 지정 스킴 호출이나 타사 앱 핸드오프의 경우, 정책 게이트로 .linkActivated를 요구하면 예고 없는 백그라운드 스크립트가 자동화된 외부 앱 실행을 트리거하는 것을 방지하는 데 도움이 됩니다.
보존 주기 없이 비동기 결정 정책 처리
경로 유효성 검사나 권한 검사를 위해 결정을 반환하기 전에 로컬 캐시나 보안 검사기를 쿼리해야 하는 경우:
- 오류 및 가드 조건을 포함한 모든 실행 경로에서
decisionHandler가 실행되도록 보장합니다. - 이스케이프 클로저 내에서 약한 참조(
[weak self])를 사용하여WKWebView, 해당 델리게이트 및 부모UIViewController간의 보존 주기를 방지합니다.
호스트 앱 연관 도메인과 외부 유니버설 링크 차별화

앱 소유 대상 대 시스템 수준 링크 위임 관리
앱 소유 경로의 경우 중복된 유니버설 링크 조회를 통해 동일한 애플리케이션에 다시 진입하려고 시도하지 마세요. 앱 소유 대상은 호스트 애플리케이션의 내부 라우터를 통해 직접 처리하고, 시스템 열기는 현재 애플리케이션을 떠나거나 외부 서비스에 의해 해석되어야 하는 대상에 주로 사용하십시오.
이러한 아키텍처 분리는 원활한 탐색을 보장합니다:
- 호스트 앱 연관 도메인: URL 호스트가 호스트 앱의 자체 연관 도메인(
app.example.com)과 일치하는 경우, 웹 뷰 탐색을 취소(decisionHandler(.cancel))하고, 경로 경로의 유효성을 검사한 다음, 파싱된 매개변수를 애플리케이션의 내부 탐색 라우터로 직접 전달합니다. - 외부 애플리케이션: URL이 외부 파트너 대상이나 허용된 사용자 지정 스킴을 가리키는 경우, 애플리케이션 수준의 명시적 링크 게이트(
navigationType == .linkActivated)를 적용하고, 웹 뷰 탐색을 취소한 다음,UIApplication.shared.open(url)로 요청을 전달하여 운영 체제가 외부 앱을 실행하도록 합니다.
내부 경로 유효성 검사 설계: AppRouteValidator를 통한 경로 및 쿼리 매개변수 추출
들어오는 URL이 호스트 애플리케이션의 연관 도메인과 일치하면, URL 문자열은 뷰 컨트롤러 전환을 트리거하기 전에 엄격한 라우팅 검사기를 통과해야 합니다.
AppRouteValidator 모델의 역할:
- 지원되는 내부 경로(예:
/open/,/product/,/promo/,/checkout/)의 허용 목록에 대해 URL 경로의 유효성을 검사합니다. - 쿼리 매개변수(예:
id,promo,utm_source)를 추출합니다. - 문자 집합 제한, 길이 경계 및 중복 키 거부를 적용하여 정리된
ValidatedAppRoute데이터 구조를 반환합니다.
시스템 UIApplication 위임을 통한 외부 타사 유니버설 링크 처리

WKWebView 내의 웹 페이지가 외부 서비스(예: 파트너 앱, 소셜 플랫폼 또는 외부 유틸리티)에 연결될 때, 호스트 애플리케이션은 라우팅을 iOS 시스템으로 위임할 수 있습니다:
let options: [UIApplication.OpenExternalURLOptionsKey: Any] = [
.universalLinksOnly: true
]
UIApplication.shared.open(url, options: options) { success in
if !success {
// 애플리케이션 정책 폴백: 유니버설 링크를 처리하는 네이티브 앱이 없는 경우 웹 대상을 로드합니다.
}
}
애플리케이션 정책으로 .universalLinksOnly를 사용하면 유니버설 링크를 처리하도록 검증된 네이티브 애플리케이션이 설치된 경우에만 사용자가 현재 앱 밖으로 전환되도록 보장할 수 있습니다.
HTTPS 유니버설 링크와 함께 사용자 지정 URL 스킴 폴백(myapp://) 관리
HTTPS 유니버설 링크가 iOS의 표준 딥 링크를 나타내지만, 앱 정의 사용자 지정 스킴(myapp:// 또는 partnerapp://)은 프로모션 캠페인 및 파트너 통합 전반에서 여전히 일반적입니다.
통합된 WKNavigationDelegate 구현에서:
- HTTP/HTTPS가 아닌 스킴을 먼저 검사합니다. 스킴이 허용된 사용자 지정 프로토콜과 일치하고 명시적 링크 정책(
navigationType == .linkActivated)을 만족하는 경우, 델리게이트는UIApplication.shared.open()으로 발송하기 전에 호스트, 경로 및 매개변수를 확인합니다. - 인식되지 않는 스킴이나 예고 없는 백그라운드 스킴 호출은 즉시 취소되어, 처리되지 않은 탐색 오류나 스크립트 기반 의도 범람을 방지합니다.
[사용자가 iOS WKWebView 내의 링크와 상호 작용]
│
▼
[WKNavigationDelegate: decidePolicyForNavigationAction]
│
┌─────────────┴─────────────┐
▼ ▼
[!action.sourceFrame.isMainFrame] [action.sourceFrame.isMainFrame]
│ │
▼ ▼
[서브프레임 보안 게이트] [대상 스킴 및 호스트 검사]
├─ HTTP(S) -> .allow │
└─ 비웹 -> .cancel ┌───────────┼───────────┐
(서브프레임 억제) ▼ ▼ ▼
[호스트 도메인] [외부 웹] [사용자 지정 스킴]
│ │ │
▼ ▼ ▼
[AppRoute] [링크 확인] [링크 확인]
├─ 유효함 -> ├─ 파트너-> ├─ 유효함 및 클릭->
│ 내부 │ 앱 열기 │ 앱 열기
└─ 유효하지 않음-> └─ 웹 -> └─ 유효하지 않음/자동->
.cancel .allow .cancel
메인 프레임 보안을 강화하고 Iframe 하이재킹을 방지하는 방법

내장 웹 탐색을 신뢰할 수 없는 입력으로 취급: OWASP 딥 링크 보안 표준
OWASP 모바일 애플리케이션 보안 테스트 가이드의 안전하지 않은 딥 링크에 대한 지침에 따라, 모바일 탐색 핸들러가 처리하는 모든 URL 및 매개변수 페이로드는 신뢰할 수 없는 외부 입력으로 취급되어야 합니다.
WKWebView 내에서 렌더링되는 웹 페이지는 타사 스크립트, 광고 배너 또는 사용자 생성 콘텐츠를 로드할 수 있습니다. 탐색 델리게이트가 유효성 검사 없이 임의의 URL을 네이티브 뷰 컨트롤러나 UIApplication.shared.open()으로 전달하면, 예기치 않은 매개변수가 민감한 내부 애플리케이션 경로를 대상으로 할 수 있습니다.
메인 프레임 탐색을 내장 Iframe 및 새 창 대상에서 격리
Apple의 WKNavigationAction 개발자 문서에 따라 프레임 보안을 평가하려면 시작 프레임을 확인해야 합니다:
sourceFrame.isMainFrame == true: 탐색이 기본 최상위 문서 프레임에 의해 직접 시작되었습니다.sourceFrame.isMainFrame == false: 탐색이 내장 서브프레임이나 iframe에 의해 시작되었습니다.targetFrame == nil: 탐색이 새 창 대상(예:target="_blank"가 있는 앵커)을 요청합니다.
Iframe 하이재킹을 방지하기 위해(내장 iframe이 백그라운드에서 외부 애플리케이션을 실행하거나 네이티브 뷰 전환을 트리거하려고 시도하는 경우), 델리게이트는 sourceFrame.isMainFrame을 평가해야 합니다. 시작 프레임이 iframe인 경우(sourceFrame.isMainFrame == false), 표준 HTTP/HTTPS 서브프레임 탐색은 허용(.allow)하되, 웹이 아닌 사용자 지정 스킴이나 네이티브 라우팅 핸드오프는 차단(.cancel)해야 합니다.
악의적인 서브프레임 프로토콜 호출 및 백그라운드 스킴 범람 방지
시작 프레임 검사를 적용하면 서브프레임이 예고 없는 외부 스킴 호출을 트리거하는 것을 방지할 수 있습니다:
if !navigationAction.sourceFrame.isMainFrame {
let scheme = url.scheme?.lowercased() ?? ""
if scheme == "http" || scheme == "https" {
decisionHandler(.allow) // 표준 HTTP(S) 서브프레임 탐색 허용
} else {
decisionHandler(.cancel) // 서브프레임에서 웹이 아닌 스킴 억제
}
return
}
클라이언트 라우팅에서 엄격한 경로 및 쿼리 매개변수 허용 목록 적용
내부 연관 도메인 URL과 외부 사용자 지정 스킴 모두 실행 전에 엄격한 검사기 모델을 통과해야 합니다:
- 경로 접두사 허용 목록: 승인된 경로 접두사(예:
/open/,/product/,/promo/,/checkout/)를 적용하여 임의적이거나 잘못된 경로를 거부합니다. - 쿼리 키 필터링: 예기치 않은 쿼리 키를 삭제하고 중복 매개변수 키를 거부하여 매개변수 오염을 방지합니다.
- 데이터 유형 및 길이 제약: 매개변수 값을 영숫자 문자 집합으로 제한하고 최대 길이 경계를 적용합니다(
자).
Swift에서 프로덕션 WKNavigationDelegate 구현
Swift에서 CustomWebViewController 및 델리게이트 아키텍처 구조화
프로덕션 WKWebView 컨트롤러는 웹 구성, 탐색 정책 평가, 내부 라우팅 및 외부 위임을 조정합니다. 이 구현은 델리게이트 콜백을 깔끔하고 테스트 가능하며 안전하게 유지하기 위해 유효성 검사 규칙을 전용 검사기 클래스(AppRouteValidator 및 CustomSchemeValidator) 내에 캡슐화합니다.
AppRouteValidator 및 CustomSchemeValidator 모델 구현
검사기 모델은 엄격한 fail-closed 보안을 적용합니다:
AppRouteValidator는 내부 연관 도메인의 유효성을 검사하여 경로 접두사를 확인하고 쿼리 매개변수를 구조화된ValidatedAppRoute객체로 위생 처리합니다.CustomSchemeValidator는 승인된 사용자 지정 스킴(myapp)을 확인하고, 허용된 호스트(open,product,event)의 유효성을 검사하며, 쿼리 값을 위생 처리합니다.
OpoInstall은 기여도 분석 및 지연 매개변수 복구를 위해 애플리케이션 소유 라우팅 계층과 함께 통합될 수 있습니다. 포괄적인 통합 가이드는 SDK 통합 문서를 검토하십시오.
아래 기술적 구현은 Swift에서 보안 WKNavigationDelegate를 구성하는 방법을 보여줍니다:
// iOS: 엄격한 WKNavigationDelegate 라우팅 및 프레임 보안이 포함된 CustomWebViewController
// 참조 통합 예시입니다. 배포된 아키텍처에 맞춰 메서드 서명과 도메인 매핑을 확인하십시오.
import UIKit
import WebKit
struct ValidatedAppRoute {
let path: String
let queryParams: [String: String]
}
// 1. 호스트 애플리케이션의 연관 도메인에 대한 검사기 (내부 경로)
class AppRouteValidator {
private static let allowedPrefixes = ["/open/", "/product/", "/promo/", "/checkout/"]
private static let allowedQueryKeys = Set(["target", "id", "promo", "utm_source"])
static func validate(url: URL) -> ValidatedAppRoute? {
let path = url.path
// 승인된 경로 접두사 허용 목록 적용
guard allowedPrefixes.contains(where: { path.hasPrefix($0) }) else {
return nil
}
var sanitizedParams: [String: String] = [:]
var seenKeys = Set<String>()
if let components = URLComponents(url: url, resolvingAgainstBaseURL: false),
let queryItems = components.queryItems {
let validChars = CharacterSet(charactersIn: "abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789_-")
for item in queryItems {
// Fail-closed 유효성 검사: 승인되지 않은 쿼리 키나 중복 키가 있는 경우 URL 거부
guard allowedQueryKeys.contains(item.name), !seenKeys.contains(item.name) else { return nil }
seenKeys.insert(item.name)
let value = item.value ?? ""
if value.count <= 64 && value.rangeOfCharacter(from: validChars.inverted) == nil {
sanitizedParams[item.name] = value
} else {
return nil
}
}
}
return ValidatedAppRoute(path: path, queryParams: sanitizedParams)
}
}
// 2. 외부 사용자 지정 스킴(myapp://)에 대한 검사기
class CustomSchemeValidator {
private static let allowedSchemes = Set(["myapp"])
private static let allowedHosts = Set(["open", "product", "event"])
private static let allowedPathPrefixes = ["/detail/", "/view/", "/main/"]
private static let allowedQueryKeys = Set(["target", "id", "promo", "utm_source"])
static func validate(url: URL) -> URL? {
guard let scheme = url.scheme?.lowercased(), allowedSchemes.contains(scheme) else {
return nil
}
guard let host = url.host?.lowercased(), allowedHosts.contains(host) else {
return nil
}
let path = url.path
if !path.isEmpty && !allowedPathPrefixes.contains(where: { path.hasPrefix($0) }) {
return nil
}
var seenKeys = Set<String>()
if let components = URLComponents(url: url, resolvingAgainstBaseURL: false),
let queryItems = components.queryItems {
let validChars = CharacterSet(charactersIn: "abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789_-")
for item in queryItems {
guard allowedQueryKeys.contains(item.name), !seenKeys.contains(item.name) else { return nil }
seenKeys.insert(item.name)
let value = item.value ?? ""
if value.count > 64 || value.rangeOfCharacter(from: validChars.inverted) != nil {
return nil
}
}
}
return url
}
}
// 3. 보안 탐색 정책 가로채기가 포함된 WKWebView를 호스팅하는 UIViewController
class CustomWebViewController: UIViewController, WKNavigationDelegate {
var webView: WKWebView!
private let hostAssociatedDomain = "app.example.com"
private let allowedExternalPartnerHosts = Set(["partner.example.com"])
override func viewDidLoad() {
super.viewDidLoad()
let configuration = WKWebViewConfiguration()
webView = WKWebView(frame: view.bounds, configuration: configuration)
webView.navigationDelegate = self
view.addSubview(webView)
}
func webView(
_ webView: WKWebView,
decidePolicyFor navigationAction: WKNavigationAction,
decisionHandler: @escaping (WKNavigationActionPolicy) -> Void
) {
guard let url = navigationAction.request.url else {
decisionHandler(.allow)
return
}
// 보안 검사 1: Iframe 하이재킹을 방지하기 위해 시작 프레임 경계(sourceFrame) 적용
if !navigationAction.sourceFrame.isMainFrame {
let scheme = url.scheme?.lowercased() ?? ""
if scheme == "http" || scheme == "https" {
decisionHandler(.allow) // 표준 HTTP(S) 서브프레임 탐색 허용
} else {
decisionHandler(.cancel) // 서브프레임/iframe에서 웹이 아닌 스킴 억제
}
return
}
let scheme = url.scheme?.lowercased() ?? ""
let isExplicitLinkActivation = (navigationAction.navigationType == .linkActivated)
// 보안 검사 2: 호스트 앱 자체 연관 도메인 처리
// UIApplication.shared.open을 호출하는 대신 내부적으로 라우팅
if scheme == "https", let host = url.host?.lowercased(), host == hostAssociatedDomain {
if let validatedRoute = AppRouteValidator.validate(url: url) {
AppInternalRouter.shared.navigate(to: validatedRoute)
}
decisionHandler(.cancel) // 내부적으로 라우팅하기 위해 웹뷰 내 로딩 취소
return
}
// 보안 검사 3: 링크 활성화 정책을 사용하여 허용된 사용자 지정 스킴(myapp://) 처리
if scheme != "http" && scheme != "https" && scheme != "about" {
// 사용자 지정 스킴 외부 앱 실행에는 명시적인 사용자 링크 활성화가 필요하도록 적용
if isExplicitLinkActivation, let validatedURL = CustomSchemeValidator.validate(url: url) {
UIApplication.shared.open(validatedURL, options: [:], completionHandler: nil)
}
decisionHandler(.cancel) // 처리되지 않은 스킴 오류를 방지하기 위해 웹뷰 내 로딩 취소
return
}
// 보안 검사 4: 외부 대상 및 새 창(target="_blank") 요청 처리
if scheme == "http" || scheme == "https" {
let host = url.host?.lowercased() ?? ""
// 명시적 링크 정책을 사용하여 확인된 파트너 유니버설 링크를 외부 앱으로 위임
if allowedExternalPartnerHosts.contains(host) && isExplicitLinkActivation {
let options: [UIApplication.OpenExternalURLOptionsKey: Any] = [
.universalLinksOnly: true
]
UIApplication.shared.open(url, options: options) { [weak self] success in
if !success {
// 애플리케이션 정책 폴백: 네이티브 앱이 처리하지 않는 경우 웹 뷰 내에 외부 파트너 대상 로드
guard let self = self else { return }
self.webView.load(navigationAction.request)
}
}
decisionHandler(.cancel)
return
}
// targetFrame이 nil인 경우(새 창 요청), 현재 webView로 안전하게 로드
if navigationAction.targetFrame == nil {
webView.load(navigationAction.request)
decisionHandler(.cancel)
return
}
// 표준 웹 콘텐츠는 WKWebView 내에서 로딩 계속
decisionHandler(.allow)
return
}
decisionHandler(.allow)
}
}
// 애플리케이션별 내부 라우터 자리 표시자 (OpoInstall SDK API 아님)
class AppInternalRouter {
static let shared = AppInternalRouter()
func navigate(to route: ValidatedAppRoute) {
// 경로 및 쿼리 매개변수에 기반하여 내부 UI 뷰 컨트롤러 전환 실행
}
}
스레드 안전 실행: UI 전환이 메인 액터에서 실행되도록 보장
현재 Swift 동시성 모델에서 WKNavigationDelegate 콜백은 메인 액터로 격리됩니다. 애플리케이션 라우팅 및 뷰 컨트롤러 전환은 메인 액터에서 실행되어, 네이티브 탐색 워크플로우 전반에서 스레드 안전성을 유지합니다.
WKWebView 딥 링크 탐색 오류 및 진단 매트릭스
포괄적인 iOS WKWebView 딥 링크 문제 해결 가이드
아래 매트릭스는 iOS WKWebView 내에서 딥 링크와 사용자 지정 스킴을 관리할 때 발생하는 일반적인 실패 모드, 주요 근본 원인 및 권장 엔지니어링 수정 사항을 설명합니다:
| 오류 시그니처 / 증상 | 주요 근본 원인 | 적용 가능한 iOS 버전 | 진단 체크포인트 | 권장 수정 사항 |
|---|---|---|---|---|
| 웹에서 유니버설 링크 로드 | 앱 소유 도메인 가로채기되지 않음 | iOS 9+ | decidePolicyForNavigationAction 처리되지 않음 |
호스트 도메인을 가로채고, 경로를 파싱하고, 내부적으로 라우팅하고, .cancel |
| 자체 도메인 링크 라우팅 실패 | 자체 도메인에서 UIApplication.open 호출 |
iOS 9+ | 자체 호스트에서 UIApplication.shared.open 호출됨 |
외부 자체 열기 방지; 내부 라우터로 직접 라우팅 |
| 사용자 지정 스킴 조용히 실패 | WebKit 인식 불가 HTTP 외 프로토콜 | iOS 9+ | 스킴이 UIApplication으로 위임되지 않음 |
델리게이트에서 스킴을 가로채고, 허용 목록 유효성 검사, UIApplication을 통해 열기 |
| Iframe 프로토콜 하이재킹 | 서브프레임이 외부 사용자 지정 스킴 트리거 | iOS 9+ | sourceFrame.isMainFrame 확인되지 않음 |
if !sourceFrame.isMainFrame으로 가드하고 웹 외 스킴 억제 |
| UI 핸드오프 경고 또는 전환 문제 | 메인 스레드 밖에서 UI 전환 실행 | iOS 9+ | 메인 액터 디스패치 누락 | 내부 라우터 및 뷰 컨트롤러 전환에 대해 메인 액터 실행 보장 |
자주 묻는 질문 (FAQ)
개발자가 WKWebView에서 유니버설 링크를 가로채려면 어떻게 해야 하나요?
WKWebView에서 UIApplication.shared.open을 사용하여 내 앱을 실행할 수 있나요?
WKWebView에 내장된 iframe이 외부 앱 실행을 트리거하지 못하도록 하려면 어떻게 해야 하나요?
요약 및 결정 프레임워크
iOS WKWebView 내에서 유니버설 링크와 사용자 지정 스킴을 처리하려면 WebKit의 웹 렌더링 컨테이너와 네이티브 UIKit 탐색 수명 주기 사이의 경계를 연결해야 합니다. 기본 탐색 정책에 의존하면 애플리케이션 소유 라우팅 로직이 필요할 때 원활한 핸드오프를 방해할 수 있습니다.
프레임 경계를 검증하고, 외부 핸드오프에 보수적인 링크 활성화 정책을 적용하며, 엄격한 경로 검사기를 통해 내부 연관 도메인을 파싱하고, UIApplication.shared.open으로 외부 대상을 안전하게 위임하는 강력한 WKNavigationDelegate를 구현함으로써, 엔지니어링 팀은 iframe 프로토콜 하이재킹을 방지하면서 제어된 탐색을 유지할 수 있습니다.
네이티브 iOS 딥 링크 및 매개변수 라우팅 아키텍처를 탐색하려면 SDK 통합 문서를 참조하십시오.
관련 자료
-
개념: iOS WebView 라우팅, 유니버설 링크 가로채기, WKNavigationDelegate, 프레임 경계 격리
-
기술: Apple WebKit, iOS UIKit, WKWebView, OpoInstall iOS SDK
-
표준: IETF RFC 3986 Uniform Resource Identifier, Apple 연관 도메인 사양, OWASP 모바일 애플리케이션 보안 테스트 가이드(MASTG)
-
API:
WKNavigationDelegate.decidePolicyForNavigationAction,WKNavigationAction.sourceFrame,UIApplication.shared.open -
공식 문서 및 참조:
Share this article



