iOS Universal Links

Learn & practice AWS Hacking:HackTricks Training AWS Red Team Expert (ARTE) Learn & practice GCP Hacking: HackTricks Training GCP Red Team Expert (GRTE)

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.

介绍

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

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

分析关联域名权限

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

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

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

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

检索 Apple 应用网站关联文件

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

在应用中处理通用链接

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

验证数据处理方法

当通用链接打开应用时，一个 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 7 days 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 应用网站关联文件

在应用中处理通用链接

验证数据处理方法

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
}
}

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