iOS Universal Links

学习和实践 AWS 黑客技术：HackTricks 培训 AWS 红队专家 (ARTE) 学习和实践 GCP 黑客技术：HackTricks 培训 GCP 红队专家 (GRTE)

支持 HackTricks

查看 订阅计划!
加入 💬 Discord 群组 或 Telegram 群组 或关注我们的 Twitter 🐦 @hacktricks_live.
通过向 HackTricks 和 HackTricks Cloud GitHub 仓库提交 PR 分享黑客技巧。

介绍

通用链接为用户提供了无缝重定向体验，通过直接在应用中打开内容，绕过了 Safari 重定向的需要。这些链接是唯一且安全的，因为其他应用无法声称它们。这是通过在网站根目录托管 apple-app-site-association JSON 文件来确保的，从而建立网站与应用之间的可验证链接。在应用未安装的情况下，Safari 将接管并将用户引导到网页，保持应用的存在。

对于渗透测试人员来说，apple-app-site-association 文件特别引人关注，因为它可能会揭示敏感路径，可能包括与未发布功能相关的路径。

分析关联域名权限

开发人员通过在 Xcode 的功能选项卡中配置关联域名或检查 .entitlements 文件来启用通用链接。每个域名前缀为 applinks:。例如，Telegram 的配置可能如下所示：

<key>com.apple.developer.associated-domains</key>
<array>
<string>applinks:telegram.me</string>
<string>applinks:t.me</string>
</array>

对于更全面的见解，请参考归档的 Apple 开发者文档。

如果使用编译的应用程序，可以按照本指南提取权限。

检索 Apple App Site Association 文件

apple-app-site-association 文件应从服务器上使用权限中指定的域名进行检索。确保该文件可以通过 HTTPS 直接访问，地址为 https://<domain>/apple-app-site-association。像Apple App Site Association (AASA) 验证器这样的工具可以帮助完成此过程。

在应用中处理 Universal Links

应用必须实现特定方法以正确处理 universal links。需要关注的主要方法是application:continueUserActivity:restorationHandler:。处理的 URL 的方案必须是 HTTP 或 HTTPS，其他方案将不被支持。

验证数据处理方法

当一个 universal link 打开应用时，一个 NSUserActivity 对象会与 URL 一起传递给应用。在处理此 URL 之前，验证和清理它以防止安全风险是至关重要的。以下是一个用 Swift 演示该过程的示例：

func application(_ application: UIApplication, continue userActivity: NSUserActivity,
restorationHandler: @escaping ([UIUserActivityRestoring]?) -> Void) -> Bool {
// Check for web browsing activity and valid URL
if userActivity.activityType == NSUserActivityTypeBrowsingWeb, let url = userActivity.webpageURL {
application.open(url, options: [:], completionHandler: nil)
}

return true
}

URLs 应该被仔细解析和验证，特别是当它们包含参数时，以防止潜在的欺骗或格式错误的数据。NSURLComponents API 对此非常有用，如下所示：

func application(_ application: UIApplication,
continue userActivity: NSUserActivity,
restorationHandler: @escaping ([Any]?) -> Void) -> Bool {
guard userActivity.activityType == NSUserActivityTypeBrowsingWeb,
let incomingURL = userActivity.webpageURL,
let components = NSURLComponents(url: incomingURL, resolvingAgainstBaseURL: true),
let path = components.path,
let params = components.queryItems else {
return false
}

if let albumName = params.first(where: { $0.name == "albumname" })?.value,
let photoIndex = params.first(where: { $0.name == "index" })?.value {
// Process the URL with album name and photo index

return true

} else {
// Handle invalid or missing parameters

return false
}
}

通过勤奋的配置和验证，开发者可以确保通用链接在增强用户体验的同时，维护安全和隐私标准。

工具

GetUniversal.link: 帮助简化应用程序的通用链接和AASA文件的测试和管理。只需输入您的域名以验证AASA文件的完整性，或使用自定义仪表板轻松测试链接行为。该工具还帮助您确定Apple何时会下次索引您的AASA文件。

参考

Support HackTricks

Check the subscription plans!
Join the 💬 Discord group or the telegram group or follow us on Twitter 🐦 @hacktricks_live.
Share hacking tricks by submitting PRs to the HackTricks and HackTricks Cloud github repos.

PreviousiOS UIActivity Sharing NextiOS UIPasteboard

Last updated 4 months ago

介绍

对于渗透测试人员来说，apple-app-site-association 文件特别引人关注，因为它可能会揭示敏感路径，可能包括与未发布功能相关的路径。

分析关联域名权限

<key>com.apple.developer.associated-domains</key>
<array>
<string>applinks:telegram.me</string>
<string>applinks:t.me</string>
</array>

如果使用编译的应用程序，可以按照本指南提取权限。

检索 Apple App Site Association 文件

在应用中处理 Universal Links

验证数据处理方法

func application(_ application: UIApplication, continue userActivity: NSUserActivity,
restorationHandler: @escaping ([UIUserActivityRestoring]?) -> Void) -> Bool {
// Check for web browsing activity and valid URL
if userActivity.activityType == NSUserActivityTypeBrowsingWeb, let url = userActivity.webpageURL {
application.open(url, options: [:], completionHandler: nil)
}

return true
}

URLs 应该被仔细解析和验证，特别是当它们包含参数时，以防止潜在的欺骗或格式错误的数据。NSURLComponents API 对此非常有用，如下所示：

func application(_ application: UIApplication,
continue userActivity: NSUserActivity,
restorationHandler: @escaping ([Any]?) -> Void) -> Bool {
guard userActivity.activityType == NSUserActivityTypeBrowsingWeb,
let incomingURL = userActivity.webpageURL,
let components = NSURLComponents(url: incomingURL, resolvingAgainstBaseURL: true),
let path = components.path,
let params = components.queryItems else {
return false
}

if let albumName = params.first(where: { $0.name == "albumname" })?.value,
let photoIndex = params.first(where: { $0.name == "index" })?.value {
// Process the URL with album name and photo index

return true

} else {
// Handle invalid or missing parameters

return false
}
}

通过勤奋的配置和验证，开发者可以确保通用链接在增强用户体验的同时，维护安全和隐私标准。