使用入门

概览

借助 Digital Asset Links 协议和 API,应用或网站可以发布有关其他应用或网站的公开、可验证的声明。例如,网站可以声明自己与特定 Android 应用相关联,也可以声明希望与其他网站共享用户凭据。

以下是 Digital Asset Links 的一些可能用途:

  • 网站 A 声明,应在移动设备上的指定应用中打开指向其网站的链接(如果已安装该应用)。
  • 网站 A 声明可与网站 B 共享其 Chrome 用户凭据,这样一来,用户在登录网站 A 后无需登录网站 B。
  • 应用 A 声明它可以与网站 B 共享设备设置(例如位置信息)。

关键术语

  • 主账号:主账号是做出该声明的应用或网站。在 Digital Asset Links 中,主账号始终是托管声明列表的应用或网站。
  • 语句列表:语句包含在包含一个或多个语句的语句列表中。声明列表是明文且可公开访问的位置,位于由主账号控制且难以仿冒或篡改的位置。该文件可以是独立文件,也可以是其他较大内容的一部分。例如,在网站上,它是整个文件;在 Android 应用中,它是应用清单中的一个部分。 任何人都可以使用非专有方法查看和验证声明。如需了解详情,请参阅对帐单列表文档
  • 语句: 语句是一种结构紧凑的 JSON 结构,由“关系”(语句所说的事项,例如“启用凭据共享”)和目标(关系适用的网站或应用)组成。relationrelation因此,每个语句都像是一个句子,其中“principal”表示与“目标”有关的关系。
  • 语句使用者:语句使用者向主账号请求语句列表,检查是否存在针对指定主账号的语句,如果存在,则可以执行指定的操作。如需了解详情,请参阅恢复文档的语句.

快速使用示例

下面是一个简化的示例,展示了 www.example.com 网站如何使用 Digital Asset Links 来指定指向该网站中所有网址的链接应在指定的应用(而不是浏览器)中打开:

  1. 网站 www.example.com 在 https://www.example.com/.well-known/assetlinks.json 上发布了一份声明列表。这是声明列表在网站上的官方名称和位置;任何其他位置或具有任何其他名称的声明列表对于此网站均无效。在我们的示例中,语句列表包含一个语句,允许其 Android 应用在其网站上打开链接:
    [{
      "relation": ["delegate_permission/common.handle_all_urls"],
      "target" : { "namespace": "android_app", "package_name": "com.example.app",
                   "sha256_cert_fingerprints": ["hash_of_app_certificate"] }
    }]
    语句列表支持 [ ] 标记内的语句数组,但我们的示例文件仅包含一条语句。 sha256_cert_fingerprints 是应用签名证书的 SHA256 指纹。如需了解详情,请参阅 Android App Links 文档
  2. 上述语句中列出的 Android 应用具有一个 intent 过滤器,用于指定它要处理的网址的架构、主机和路径模式:在本例中为 https://www.example.com。该 intent 过滤器包含 Android M 中新增的一个特殊属性 android:autoVerify,它表示 Android 应在安装应用时验证 intent 过滤器中所述的网站上的语句。
  3. 用户安装应用。Android 会看到具有 autoVerify 属性的 intent 过滤器,并检查指定网站上是否存在语句列表;如果存在,Android 会检查该文件是否包含向应用授予链接处理的语句,并根据证书哈希验证应用。如果检查了所有结果,Android 会将所有 https://www.example.com intent 转发到 example.com 应用。
  4. 用户点击其设备上的 https://www.example.com/puppies 链接。此链接可以是任何位置中:浏览器、Google Search Appliance 建议中或其他位置。Android 会将 intent 转发到 example.com 应用。
  5. example.com 应用收到该 intent 并选择处理该 intent,从而在应用中打开 puppies 页面。如果应用由于某种原因拒绝处理该链接,或者该应用未安装在设备上,则系统会将该链接发送到符合该 intent 模式的下一个默认 intent 处理程序(通常是浏览器)。

重要注意事项和限制:

  • 该协议不会对做出该语句的主帐号进行身份验证,但该语句位于与主帐号高度关联的特定位置,并且受主帐号控制。
  • 该协议不会对语句目标进行身份验证,但它会为调用方提供一种方式来对目标进行身份验证(例如,语句通过证书哈希和软件包名称标识移动应用目标)。
  • 该协议本身不会执行任何语句操作;相反,它支持公开语句,使用方应用必须验证这些语句,然后决定是否执行相应操作以及如何执行操作。Android M 会以原生方式为您执行这些步骤;例如,如果网站将链接处理委托给特定应用,则 Android 会检查并验证该声明,验证目标应用,然后为应用提供处理给定链接的选项。
  • 该协议不允许对两个第三方做出陈述:也就是说,网站 A 可以就网站 B 发表陈述,而网站 A 不能对网站 B 与网站 C 的关系做出陈述。但是,如果网站 B 信任网站 A,它可以查看网站 A 中是否有向网站 C 授予权限的声明,并决定实施该声明。

后续步骤

  1. 查看是否有适用于您的用例的明确文档。
  2. 了解如何创建对账单