Cách cấu hình điều hướng WKWebView để hỗ trợ iOS Universal Links

opoinstall
2026-10-07
5 min read

Làm thế nào để kích hoạt Universal Links trong iOS WKWebView? Universal Links vốn đã có thể phân giải từ các đường dẫn đủ điều kiện bên trong WKWebView. Việc triển khai WKNavigationDelegate cho phép ứng dụng chủ tùy chỉnh các chính sách điều hướng—chặn các điểm đến thuộc sở hữu của ứng dụng, kiểm soát việc chuyển giao bên ngoài thông qua decidePolicyForNavigationAction và thực thi bảo mật ở cấp độ khung hình (frame-level).

Trong kiến trúc ứng dụng iOS, việc chặn điều hướng WKWebView cho phép ứng dụng chủ tùy chỉnh các chính sách định tuyến trên Universal Links, các custom URL scheme và các điểm đến trên web. Bằng cách đánh giá siêu dữ liệu yêu cầu điều hướng trong WKNavigationDelegate, ứng dụng có thể định tuyến nội bộ các điểm đến thuộc sở hữu của ứng dụng, ủy quyền các mục tiêu bên ngoài cho các trình xử lý hệ thống và thực thi các chính sách bảo mật cấp khung hình.

Thuật ngữ Định nghĩa Thực thể liên quan Vai trò mục đích tìm kiếm
WebView Thành phần hiển thị nhúng dựa trên WebKit dùng để hiển thị nội dung web tương tác bên trong các ứng dụng iOS. iOS SDK Thông tin / Thương mại
Universal Links Cơ chế HTTPS tiêu chuẩn liên kết các tên miền web đã xác minh với các giao diện ứng dụng iOS gốc. Định tuyến Deep Link Kỹ thuật / Thông tin
Custom URL Scheme Một sơ đồ URI do ứng dụng định nghĩa dùng để định tuyến URL vào một ứng dụng gốc. Mobile Deep Linking Thông tin

Tương tác giữa WKWebView và định tuyến Universal Link trên iOS

WKNavigationDelegate quyết định WebKit tải, định tuyến nội bộ, chuyển giao hay hủy bỏ.

Vòng đời điều hướng WebKit và các chính sách định tuyến thuộc sở hữu của ứng dụng

Apple triển khai Universal Links như một cơ chế định tuyến cấp hệ thống được hỗ trợ trên môi trường Safari và WKWebView. Khi người dùng nhấn vào một liên kết đủ điều kiện bên trong WKWebView nhúng, nền tảng có thể phân giải các liên kết tên miền và định tuyến việc thực thi theo các chính sách của hệ điều hành.

Trong khi các Universal Links được hệ thống công nhận có thể chuyển giao việc thực thi cho các trình xử lý gốc, môi trường trình duyệt nhúng thường yêu cầu logic định tuyến dành riêng cho ứng dụng. Ví dụ, khi một liên kết trỏ đến tên miền của chính ứng dụng chủ, các nhà phát triển thường ưu tiên điều hướng trực tiếp qua các bộ điều khiển khung nhìn (view controllers) gốc thay vì kích hoạt việc khởi chạy lại toàn bộ ứng dụng bên ngoài. Việc triển khai WKNavigationDelegate cung cấp cho ứng dụng chủ quyền kiểm soát chi tiết đối với việc đánh giá liên kết, cho phép các đội ngũ thực thi danh sách cho phép (allowlist) tùy chỉnh và định tuyến các điểm đến nội bộ một cách có thể dự đoán được.

Rào cản trải nghiệm người dùng: Khi duyệt web trong ứng dụng khiến người dùng bị mắc kẹt trong vòng lặp chuyển hướng web

Các WebView nhúng thường được triển khai để lưu trữ các trang microsite quảng cáo, trung tâm trợ giúp, danh mục đối tác và trang đích tiếp thị trong các ứng dụng iOS. Khi một trang web trong ứng dụng chứa các liên kết nhằm đưa người dùng đến các phần khác của ứng dụng chủ (ví dụ: nút "Xem trong ứng dụng") hoặc đến các ứng dụng đối tác, việc điều hướng mặc định có thể dẫn đến việc hiển thị dư thừa:

  • Hiển thị web dư thừa: Thay vì hiển thị các view controller gốc, người dùng có thể phải xem các phiên bản web đáp ứng (responsive) của các trang trong ứng dụng, yêu cầu xác thực lặp lại và làm giảm tính nhất quán về hình ảnh.
  • Bẫy web: Người dùng có thể bị kẹt trong các ngăn xếp điều hướng web sâu mà không có cách nào trực quan để quay lại các giao diện ứng dụng gốc chính.
  • Chuyển tiếp ứng dụng sang ứng dụng thất bại: Việc nhấn vào các liên kết trỏ đến các dịch vụ của bên thứ ba (như ứng dụng bản đồ, hộp thoại chia sẻ xã hội hoặc cổng thanh toán) yêu cầu sự ủy quyền rõ ràng nếu các dịch vụ đó dựa vào các custom URL scheme.

So sánh WKWebView với SFSafariViewController cho việc chuyển giao từ Web sang App

Khi thiết kế trải nghiệm duyệt web trong ứng dụng trên iOS, các nhóm kỹ thuật phải lựa chọn giữa WKWebView và SFSafariViewController:

  • SFSafariViewController: Cung cấp giao diện duyệt web Safari được hệ thống quản lý, khép kín với các tính năng như Tự động điền (AutoFill) và chặn nội dung. Ứng dụng chủ không thể kiểm tra hoạt động duyệt web hoặc dữ liệu trang web, và việc tùy chỉnh giao diện bị giới hạn ở các màu phủ (tint colors).
  • WKWebView: Một thành phần hiển thị nhúng được lưu trữ trong quy trình giao diện người dùng của ứng dụng trong khi chạy nội dung web trong các quy trình WebKit riêng biệt. Nó cho phép tùy chỉnh giao diện sâu, cầu nối JavaScript và tích hợp bố cục tùy chỉnh, đòi hỏi phải triển khai rõ ràng WKNavigationDelegate để tùy chỉnh chính sách định tuyến và xử lý các scheme tùy chỉnh do ứng dụng định nghĩa.

Cách decidePolicyForNavigationAction chặn định tuyến WebKit

Quy trình chính sách điều hướng: Hiểu về WKNavigationAction, request và decisionHandler

Để kiểm soát luồng điều hướng bên trong WKWebView, các nhà phát triển gán một delegate tùy chỉnh tuân thủ Hướng dẫn của Apple dành cho nhà phát triển về WKNavigationDelegate. Điểm chặn chính là phương thức delegate:

func webView(
    _ webView: WKWebView,
    decidePolicyFor navigationAction: WKNavigationAction,
    decisionHandler: @escaping (WKNavigationActionPolicy) -> Void
)

Các hành động điều hướng được kích hoạt bởi tương tác người dùng, chuyển hướng lập trình hoặc gửi biểu mẫu đều đi qua phương thức này. Đối tượng WKNavigationAction cung cấp siêu dữ liệu quan trọng:

  • navigationAction.request.url: URL mục tiêu đang được yêu cầu.
  • navigationAction.navigationType: Loại trình kích hoạt (.linkActivated, .other, .formSubmitted).
  • navigationAction.sourceFrame: Thông tin về khung (frame) khởi tạo yêu cầu điều hướng.
  • navigationAction.targetFrame: Thông tin về khung đích nơi nội dung dự định được tải.

decisionHandler là một closure hoàn thành thông báo cho WebKit có cho phép hay hủy bỏ điều hướng được yêu cầu hay không.

Khi nào trả về .allow so với .cancel: Kiểm soát vòng đời tải tài nguyên của WebKit

WKNavigationActionPolicy được truyền đến decisionHandler kiểm soát việc WebKit có tiến hành điều hướng hay không:

  • .allow: Thông báo cho WebKit tiến hành điều hướng được yêu cầu bên trong web view.
  • .cancel: Chỉ thị cho WebKit hủy bỏ điều hướng được yêu cầu. Chính sách này được thực thi bất cứ khi nào ứng dụng chủ chặn một scheme tùy chỉnh, định tuyến một Universal Link nội bộ của ứng dụng hoặc ủy quyền mục tiêu bên ngoài cho UIApplication.shared.open().

decisionHandler phải được gọi chính xác một lần cho mỗi hành động điều hướng để đảm bảo việc phân giải chính sách điều hướng được tiến hành mà không bị đình trệ.

Đánh giá các loại điều hướng: Phân biệt các lượt nhấp của người dùng (.linkActivated) với các chuyển hướng tự động

WKNavigationAction.navigationType cho phép các nhà phát triển phân biệt tương tác người dùng rõ ràng với các tập lệnh tự động:

  • .linkActivated: Người dùng đã nhấn vào một thẻ neo (anchor tag) HTML (<a href="...">).
  • .other: Đại diện cho các điều hướng theo lập trình, chẳng hạn như cập nhật window.location.href, meta refresh hoặc các lệnh gọi webView.load() ban đầu.
  • .formSubmitted / .formResubmitted: Đại diện cho các lần gửi biểu mẫu POST hoặc GET.

Việc đánh giá navigationType cho phép các ứng dụng thực thi chính sách liên kết rõ ràng ở cấp độ ứng dụng. Đối với các yêu cầu custom scheme bên ngoài hoặc chuyển giao sang ứng dụng bên thứ ba, việc yêu cầu .linkActivated như một cổng chính sách giúp ngăn chặn các tập lệnh nền không được nhắc nhở kích hoạt việc khởi chạy ứng dụng bên ngoài tự động.

Xử lý các chính sách quyết định bất đồng bộ mà không gây ra Retain Cycles

Khi việc xác thực lộ trình hoặc kiểm tra quyền yêu cầu truy vấn bộ nhớ đệm cục bộ hoặc trình xác thực bảo mật trước khi trả về quyết định:

  1. Đảm bảo decisionHandler được thực thi trên tất cả các đường dẫn thực thi, bao gồm cả các điều kiện lỗi và guard.
  2. Sử dụng các tham chiếu yếu ([weak self]) bên trong các closure thoát (escaping closures) để ngăn chặn các retain cycles giữa WKWebView, delegate của nó và UIViewController cha.

Phân biệt tên miền liên kết của ứng dụng chủ với Universal Links bên ngoài

Universal Links thuộc sở hữu ứng dụng nên xác thực và định tuyến nội bộ từ WKWebView.

Quản lý các điểm đến thuộc sở hữu ứng dụng so với việc ủy quyền liên kết cấp hệ thống

Đối với các lộ trình thuộc sở hữu ứng dụng, hãy tránh việc cố gắng nhập lại cùng một ứng dụng thông qua tra cứu Universal Link dư thừa. Hãy xử lý các điểm đến thuộc sở hữu ứng dụng trực tiếp thông qua trình định tuyến nội bộ của ứng dụng chủ và sử dụng mở hệ thống chủ yếu cho các điểm đến cần rời khỏi ứng dụng hiện tại hoặc được phân giải bởi các dịch vụ bên ngoài.

Sự tách biệt kiến trúc này đảm bảo điều hướng mượt mà:

  • Tên miền liên kết của ứng dụng chủ: Nếu host của URL khớp với tên miền liên kết của chính ứng dụng chủ (app.example.com), hãy hủy điều hướng web view (decisionHandler(.cancel)), xác thực đường dẫn lộ trình và truyền các tham số đã phân tích trực tiếp đến trình định tuyến điều hướng nội bộ của ứng dụng.
  • Các ứng dụng bên ngoài: Nếu URL trỏ đến điểm đến của đối tác bên ngoài hoặc một custom scheme được cho phép, hãy áp dụng cổng liên kết rõ ràng ở cấp ứng dụng (navigationType == .linkActivated), hủy điều hướng web view và chuyển tiếp yêu cầu đến UIApplication.shared.open(url) để cho phép hệ điều hành khởi chạy ứng dụng bên ngoài.

Thiết kế xác thực lộ trình nội bộ: Trích xuất các đường dẫn và tham số truy vấn qua AppRouteValidator

Khi một URL đến khớp với tên miền liên kết của ứng dụng chủ, chuỗi URL phải đi qua một trình xác thực định tuyến nghiêm ngặt trước khi kích hoạt các chuyển đổi view controller.

Mô hình AppRouteValidator:

  • Xác thực đường dẫn URL dựa trên danh sách cho phép các lộ trình nội bộ được hỗ trợ (ví dụ: /open/, /product/, /promo/, /checkout/).
  • Trích xuất các tham số truy vấn (ví dụ: id, promo, utm_source).
  • Thực thi các hạn chế bộ ký tự, giới hạn độ dài và từ chối khóa trùng lặp, trả về một cấu trúc dữ liệu ValidatedAppRoute sạch.

Xử lý các Universal Links bên thứ ba bên ngoài thông qua ủy quyền UIApplication hệ thống

Universal Links bên ngoài có thể cố gắng chuyển giao gốc và quay lại web nếu không thành công.

Khi một trang web bên trong WKWebView liên kết đến các dịch vụ bên ngoài (như ứng dụng đối tác, nền tảng xã hội hoặc tiện ích bên ngoài), ứng dụng chủ có thể ủy quyền định tuyến cho hệ thống iOS:

let options: [UIApplication.OpenExternalURLOptionsKey: Any] = [
    .universalLinksOnly: true
]
UIApplication.shared.open(url, options: options) { success in
    if !success {
        // Chính sách dự phòng của ứng dụng: tải điểm đến web nếu không có ứng dụng gốc nào xử lý Universal Link
    }
}

Việc sử dụng .universalLinksOnly như một chính sách ứng dụng đảm bảo người dùng chỉ được chuyển tiếp ra ngoài ứng dụng hiện tại nếu có một ứng dụng gốc đã xác minh được cài đặt để xử lý Universal Link.

Quản lý dự phòng custom URL scheme (myapp://) cùng với HTTPS Universal Links

Trong khi HTTPS Universal Links đại diện cho deep linking tiêu chuẩn trên iOS, các scheme tùy chỉnh do ứng dụng định nghĩa (myapp:// hoặc partnerapp://) vẫn phổ biến trong các chiến dịch quảng cáo và tích hợp đối tác.

Trong một triển khai WKNavigationDelegate hợp nhất:

  • Các scheme không phải HTTP/HTTPS được kiểm tra trước. Nếu scheme khớp với một giao thức tùy chỉnh được cho phép và thỏa mãn chính sách liên kết rõ ràng (navigationType == .linkActivated), delegate sẽ xác minh host, đường dẫn và các tham số trước khi gửi đến UIApplication.shared.open().
  • Các scheme không được nhận dạng hoặc việc gọi scheme nền không được nhắc nhở sẽ bị hủy ngay lập tức, ngăn ngừa các lỗi điều hướng không được xử lý hoặc việc tràn ngập ý định do tập lệnh điều khiển.
[Người dùng tương tác với liên kết bên trong iOS WKWebView]
                       │
                       ▼
[WKNavigationDelegate: decidePolicyForNavigationAction]
                       │
         ┌─────────────┴─────────────┐
         ▼                           ▼
[!action.sourceFrame.isMainFrame] [action.sourceFrame.isMainFrame]
         │                           │
         ▼                           ▼
[Cổng bảo mật subframe]       [Kiểm tra Destination Scheme & Host]
├─ HTTP(S) -> .allow                 │
└─ Non-Web -> .cancel    ┌───────────┼───────────┐
   (Chặn Subframe)       ▼           ▼           ▼
                   [Host Domain] [External Web] [Custom Scheme]
                         │           │           │
                         ▼           ▼           ▼
                   [AppRoute]    [Check Link]   [Check Link]
                   ├─ Hợp lệ ->   ├─ Đối tác->   ├─ Hợp lệ & Click->
                   │  Nội bộ    │  Mở App    │  Mở App
                   └─ Không hợp lệ->  └─ Web ->      └─ Không hợp lệ/Tự động->
                      .cancel       .allow         .cancel

Cách thực thi bảo mật khung hình chính và ngăn chặn Iframe Hijacking

Ngữ cảnh nguồn và đích của WKNavigationAction xác định chính sách điều hướng an toàn.

Coi điều hướng web nhúng là đầu vào không đáng tin cậy: Tiêu chuẩn bảo mật Deep Link của OWASP

Tuân thủ Hướng dẫn kiểm tra bảo mật ứng dụng di động của OWASP về Deep Links không an toàn, tất cả URL và dữ liệu tham số được xử lý bởi các trình xử lý điều hướng di động phải được coi là đầu vào không đáng tin cậy, từ bên ngoài.

Các trang web được hiển thị trong WKWebView có thể tải các tập lệnh bên thứ ba, biểu ngữ quảng cáo hoặc nội dung do người dùng tạo. Nếu một delegate điều hướng chuyển tiếp các URL tùy ý đến các view controller gốc hoặc UIApplication.shared.open() mà không cần xác thực, các tham số bất ngờ có thể nhắm mục tiêu vào các lộ trình ứng dụng nội bộ nhạy cảm.

Cách ly điều hướng khung hình chính khỏi Iframe nhúng và các mục tiêu cửa sổ mới

Tuân thủ Tài liệu của Apple dành cho nhà phát triển về WKNavigationAction, việc đánh giá bảo mật khung hình đòi hỏi phải kiểm tra khung khởi tạo:

  • sourceFrame.isMainFrame == true: Điều hướng được khởi tạo trực tiếp bởi khung tài liệu cấp cao nhất, chính.
  • sourceFrame.isMainFrame == false: Điều hướng được khởi tạo bởi một subframe hoặc iframe được nhúng.
  • targetFrame == nil: Điều hướng yêu cầu một mục tiêu cửa sổ mới (chẳng hạn như thẻ neo có target="_blank").

Để ngăn chặn iframe hijacking—nơi một iframe được nhúng cố gắng khởi chạy các ứng dụng bên ngoài hoặc kích hoạt các chuyển đổi view gốc ở chế độ nền—delegate phải đánh giá sourceFrame.isMainFrame. Nếu khung khởi tạo là một iframe (sourceFrame.isMainFrame == false), hãy cho phép điều hướng subframe HTTP/HTTPS tiêu chuẩn (.allow), nhưng chặn bất kỳ scheme tùy chỉnh nào không phải web hoặc chuyển giao định tuyến gốc (.cancel).

Ngăn chặn việc gọi giao thức subframe độc hại và tràn ngập scheme nền

Việc thực thi kiểm tra khung khởi tạo giúp ngăn chặn các subframe kích hoạt các lệnh gọi scheme bên ngoài không được nhắc nhở:

if !navigationAction.sourceFrame.isMainFrame {
    let scheme = url.scheme?.lowercased() ?? ""
    if scheme == "http" || scheme == "https" {
        decisionHandler(.allow) // Cho phép điều hướng subframe HTTP(S) tiêu chuẩn
    } else {
        decisionHandler(.cancel) // Chặn các scheme không phải web từ subframe
    }
    return
}

Thực thi danh sách cho phép tham số truy vấn và đường dẫn nghiêm ngặt trong định tuyến phía khách hàng

Cả URL tên miền liên kết nội bộ và scheme tùy chỉnh bên ngoài phải đi qua các mô hình xác thực nghiêm ngặt trước khi thực thi:

  • Danh sách cho phép tiền tố đường dẫn: Thực thi các tiền tố lộ trình được phê duyệt (ví dụ: /open/, /product/, /promo/, /checkout/), từ chối các đường dẫn tùy ý hoặc sai định dạng.
  • Lọc khóa truy vấn: Loại bỏ các khóa truy vấn không mong đợi và từ chối các khóa tham số trùng lặp để ngăn chặn ô nhiễm tham số.
  • Ràng buộc độ dài & Loại dữ liệu: Hạn chế các giá trị tham số trong các bộ ký tự chữ và số và thực thi giới hạn độ dài tối đa (≤64\le 64 ký tự).

Triển khai WKNavigationDelegate trong sản xuất với Swift

Cấu trúc CustomWebViewController và kiến trúc Delegate trong Swift

Một bộ điều khiển WKWebView trong sản xuất điều phối cấu hình web, đánh giá chính sách điều hướng, định tuyến nội bộ và ủy quyền bên ngoài. Việc triển khai đóng gói các quy tắc xác thực trong các lớp trình xác thực chuyên dụng (AppRouteValidator và CustomSchemeValidator) để giữ cho các callback delegate sạch sẽ, có thể kiểm thử và an toàn.

Triển khai các mô hình AppRouteValidator và CustomSchemeValidator

Các mô hình trình xác thực thực thi bảo mật nghiêm ngặt (fail-closed):

  • AppRouteValidator xác thực các tên miền liên kết nội bộ, kiểm tra tiền tố đường dẫn và làm sạch các tham số truy vấn thành một đối tượng ValidatedAppRoute có cấu trúc.
  • CustomSchemeValidator xác minh các scheme tùy chỉnh được ủy quyền (myapp), xác thực các host được cho phép (open, product, event) và làm sạch các giá trị truy vấn.

OpoInstall có thể được tích hợp cùng với một lớp định tuyến thuộc sở hữu của ứng dụng để phục hồi tham số thuộc tính và tham số hoãn lại (deferred). Xem lại tài liệu tích hợp SDK để biết các hướng dẫn tích hợp toàn diện.

Triển khai kỹ thuật dưới đây trình diễn cách cấu hình một WKNavigationDelegate an toàn bằng Swift:

// iOS: CustomWebViewController với định tuyến WKNavigationDelegate nghiêm ngặt và bảo mật khung hình
// Ví dụ tích hợp tham chiếu. Hãy xác minh chữ ký phương thức và ánh xạ tên miền so với kiến trúc đã triển khai của bạn.
import UIKit
import WebKit

struct ValidatedAppRoute {
    let path: String
    let queryParams: [String: String]
}

// 1. Trình xác thực cho Tên miền liên kết của ứng dụng chủ (Lộ trình nội bộ)
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
        // Thực thi danh sách cho phép tiền tố đường dẫn
        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 {
                // Xác thực Fail-closed: từ chối URL nếu có khóa truy vấn trái phép hoặc khóa trùng lặp
                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. Trình xác thực cho các Custom Scheme bên ngoài (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. UIViewController lưu trữ WKWebView với chặn chính sách điều hướng an toàn
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
        }

        // Kiểm tra bảo mật 1: Thực thi ranh giới khung khởi tạo (sourceFrame) để ngăn chặn iframe hijacking
        if !navigationAction.sourceFrame.isMainFrame {
            let scheme = url.scheme?.lowercased() ?? ""
            if scheme == "http" || scheme == "https" {
                decisionHandler(.allow) // Cho phép điều hướng subframe HTTP(S) tiêu chuẩn
            } else {
                decisionHandler(.cancel) // Chặn các scheme không phải web từ subframe/iframe
            }
            return
        }

        let scheme = url.scheme?.lowercased() ?? ""
        let isExplicitLinkActivation = (navigationAction.navigationType == .linkActivated)

        // Kiểm tra bảo mật 2: Xử lý Tên miền liên kết của chính ứng dụng chủ
        // Định tuyến nội bộ thay vì gọi 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) // Hủy tải trong webview để định tuyến nội bộ
            return
        }

        // Kiểm tra bảo mật 3: Xử lý các Custom Scheme được cho phép (myapp://) với Chính sách kích hoạt liên kết
        if scheme != "http" && scheme != "https" && scheme != "about" {
            // Thực thi yêu cầu khởi chạy ứng dụng bên ngoài scheme tùy chỉnh phải được người dùng kích hoạt liên kết rõ ràng
            if isExplicitLinkActivation, let validatedURL = CustomSchemeValidator.validate(url: url) {
                UIApplication.shared.open(validatedURL, options: [:], completionHandler: nil)
            }
            decisionHandler(.cancel) // Hủy tải trong webview để ngăn chặn lỗi scheme không được xử lý
            return
        }

        // Kiểm tra bảo mật 4: Xử lý các điểm đến bên ngoài và các yêu cầu Cửa sổ mới (target="_blank")
        if scheme == "http" || scheme == "https" {
            let host = url.host?.lowercased() ?? ""
            
            // Ủy quyền các Universal Links đối tác đã xác minh cho ứng dụng bên ngoài với chính sách liên kết rõ ràng
            if allowedExternalPartnerHosts.contains(host) && isExplicitLinkActivation {
                let options: [UIApplication.OpenExternalURLOptionsKey: Any] = [
                    .universalLinksOnly: true
                ]
                UIApplication.shared.open(url, options: options) { [weak self] success in
                    if !success {
                        // Chính sách dự phòng của ứng dụng: tải điểm đến đối tác bên ngoài bên trong web view nếu không có ứng dụng gốc nào xử lý nó
                        guard let self = self else { return }
                        self.webView.load(navigationAction.request)
                    }
                }
                decisionHandler(.cancel)
                return
            }

            // Nếu targetFrame là nil (yêu cầu cửa sổ mới), tải an toàn vào webView hiện tại
            if navigationAction.targetFrame == nil {
                webView.load(navigationAction.request)
                decisionHandler(.cancel)
                return
            }

            // Nội dung web tiêu chuẩn tiếp tục tải bên trong WKWebView
            decisionHandler(.allow)
            return
        }

        decisionHandler(.allow)
    }
}

// Trình giữ chỗ định tuyến nội bộ dành riêng cho ứng dụng (không phải API SDK OpoInstall)
class AppInternalRouter {
    static let shared = AppInternalRouter()

    func navigate(to route: ValidatedAppRoute) {
        // Thực thi chuyển đổi view controller giao diện người dùng nội bộ dựa trên đường dẫn và tham số truy vấn
    }
}

Thực thi an toàn luồng: Đảm bảo các chuyển đổi UI thực thi trên Main Actor

Trong các mô hình đồng thời Swift hiện tại, các callback WKNavigationDelegate được cô lập với main-actor. Việc định tuyến ứng dụng và chuyển đổi view controller được thực thi trên main actor, duy trì an toàn luồng xuyên suốt các quy trình điều hướng gốc.

Lỗi điều hướng Deep Link trong WKWebView và Ma trận chẩn đoán

Hướng dẫn khắc phục sự cố Deep Linking trong iOS WKWebView toàn diện

Ma trận dưới đây phác thảo các chế độ lỗi phổ biến gặp phải khi quản lý deep link và custom scheme bên trong WKWebView trên iOS, cùng với nguyên nhân gốc rễ chính và các giải pháp kỹ thuật được khuyến nghị:

Ký hiệu/Triệu chứng lỗi Nguyên nhân gốc rễ chính Phiên bản iOS áp dụng Điểm kiểm tra chẩn đoán Giải pháp khuyến nghị
Universal Link tải trong web Tên miền thuộc sở hữu ứng dụng không bị chặn iOS 9+ decidePolicyForNavigationAction không được xử lý Chặn host domain, phân tích đường dẫn, định tuyến nội bộ, .cancel
Liên kết tự tên miền không định tuyến được Gọi UIApplication.open trên tên miền của chính mình iOS 9+ UIApplication.shared.open được gọi trên host của chính mình Tránh mở bên ngoài chính mình; định tuyến trực tiếp đến bộ định tuyến nội bộ
Custom Scheme thất bại âm thầm Giao thức không phải HTTP không được WebKit nhận dạng iOS 9+ Scheme không được ủy quyền cho UIApplication Chặn scheme trong delegate, xác thực danh sách cho phép, mở qua UIApplication
Iframe Protocol Hijacking Subframe kích hoạt custom scheme bên ngoài iOS 9+ sourceFrame.isMainFrame không được kiểm tra Guard với if !sourceFrame.isMainFrame và chặn các scheme không phải web
Vấn đề chuyển đổi hoặc cảnh báo UI Handoff Các chuyển đổi UI được thực thi ngoài luồng chính iOS 9+ Thiếu dispatch main-actor Đảm bảo thực thi main-actor cho trình định tuyến nội bộ và các chuyển đổi view controller

Các câu hỏi thường gặp (FAQ)

Làm thế nào các nhà phát triển có thể chặn Universal Links trong một WKWebView?
Các nhà phát triển triển khai `WKNavigationDelegate` và kiểm tra các URL đến bên trong `decidePolicyForNavigationAction`. Nếu URL khớp với một điểm đến thuộc sở hữu của ứng dụng, delegate sẽ hủy điều hướng trong webview với `.cancel` và truyền các tham số đã xác thực trực tiếp đến trình định tuyến nội bộ của ứng dụng.
Tôi có thể sử dụng UIApplication.shared.open để khởi chạy ứng dụng của riêng mình từ WKWebView không?
Tài liệu của Apple quy định rằng việc gọi `UIApplication.shared.open()` trên một Universal Link trỏ đến tên miền liên kết của chính ứng dụng chủ sẽ không mở liên kết trong ứng dụng dưới dạng Universal Link. Đối với các liên kết tên miền riêng, ứng dụng nên hủy điều hướng webview và gọi trực tiếp trình định tuyến điều hướng nội bộ của nó.
Làm thế nào để tôi ngăn chặn các iframe được nhúng trong WKWebView kích hoạt việc khởi chạy ứng dụng bên ngoài?
Để ngăn chặn iframe hijacking, hãy kiểm tra `navigationAction.sourceFrame.isMainFrame` bên trong `decidePolicyForNavigationAction`. Nếu `isMainFrame` là `false`, hãy cho phép điều hướng subframe HTTP(S) tiêu chuẩn với `.allow`, nhưng hủy các custom scheme không phải web với `.cancel` để ngăn chặn các iframe bên thứ ba thực thi việc khởi chạy bên ngoài không được nhắc nhở.

Tóm tắt và Khung quyết định

Việc xử lý Universal Links và các custom scheme bên trong WKWebView trên iOS đòi hỏi phải thu hẹp ranh giới giữa container hiển thị web của WebKit và vòng đời điều hướng UIKit gốc. Việc dựa vào các chính sách điều hướng mặc định có thể ngăn cản sự chuyển giao trơn tru khi yêu cầu logic định tuyến thuộc sở hữu của ứng dụng.

Bằng cách triển khai một WKNavigationDelegate mạnh mẽ, xác minh ranh giới khung hình, thực thi các chính sách kích hoạt liên kết bảo thủ đối với các chuyển giao bên ngoài, phân tích tên miền liên kết nội bộ thông qua các trình xác thực lộ trình nghiêm ngặt và ủy quyền các mục tiêu bên ngoài một cách an toàn cho UIApplication.shared.open, các đội ngũ kỹ thuật duy trì sự điều hướng có kiểm soát trong khi bảo vệ chống lại iframe protocol hijacking.

Để khám phá kiến trúc định tuyến tham số và deep linking gốc của iOS, hãy tham khảo tài liệu tích hợp SDK.

Tài liệu liên quan

Share this article