開始使用

總覽

Digital Asset Links 通訊協定和 API 可讓應用程式或網站對其他應用程式或網站建立可驗證的公開聲明。舉例來說,網站可以宣告其與特定 Android 應用程式相關聯,也可以宣告要與其他網站共用使用者憑證。

以下列舉 Digital Asset Links 的幾種用途:

  • 如果已安裝網站,網站 A 就會聲明,該網站連結應在行動裝置上透過指定應用程式開啟。
  • 網站 A 宣告可與網站 B 共用 Chrome 使用者憑證,因此如果使用者已登入網站 A,就不必登入網站 B。
  • 應用程式 A 宣告可以與網站 B 共用裝置設定 (例如位置)。

重要詞彙

  • 主體:主體是指做出聲明的應用程式或網站。在 Digital Asset Links 中,主體一律為代管陳述清單的應用程式或網站。
  • 陳述式清單:陳述式會出現在包含一或多個陳述式的陳述式清單中。陳述式清單屬於明文,可公開存取,位置在主體控管的位置,不容易遭人假冒或竄改。 可以是獨立檔案,也可以是另一個大型項目的區段。舉例來說,在網站上,這個檔案是完整的檔案,在 Android 應用程式中,則是應用程式資訊清單中的部分。任何人都能透過非專屬方式查看及驗證對帳單。詳情請參閱陳述式清單說明文件
  • 陳述: 陳述式是結構緊密的 JSON 結構,其中包含「關係」relation (聲明內容為「啟用共用憑證」的聲明) 和「目標」relation (與關聯相關的網站或應用程式)。因此,每個陳述就像一個句子,主體表示與相關相關目標
  • 陳述使用者:陳述式使用者向主體要求陳述式清單,檢查是否針對指定主體執行陳述式,如果存在,則可執行指定的動作。詳情請參閱聲明的陳述式說明文件.

快速使用範例

以下是一個簡單的範例,說明 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 應用程式連結說明文件
  2. 上述陳述式中的 Android 應用程式擁有意圖篩選器,用於指定所處理網址的配置、主機和路徑模式:在本範例中為 https://www.example.com。意圖篩選器包含一個特殊屬性 android:autoVerify,這是 Android M 的新屬性,代表 Android 應在應用程式安裝時於意圖篩選器中描述的網站上驗證聲明。
  3. 使用者安裝應用程式。Android 查看具有 autoVerify 屬性的意圖篩選器,並檢查指定網站是否存在陳述式清單。如果有,Android 會檢查該檔案是否包含授予應用程式連結處理的陳述式,並根據憑證雜湊來驗證應用程式。如果一切檢查完畢,Android 就會將所有 https://www.example.com 意圖轉送至 example.com 應用程式。
  4. 使用者在自己的裝置上點選 https://www.example.com/puppies 連結。這類連結沒有位置:瀏覽器、Google Search Appliance 建議頁面或其他位置。Android 會將意圖轉送至 example.com 應用程式。
  5. example.com 應用程式會收到意圖,並選擇處理該意圖,然後在應用程式中開啟小狗頁面。如果應用程式因故拒絕處理連結,或者應用程式不在裝置上,系統就會將連結傳送至符合該意圖模式 (通常是瀏覽器) 的下一個預設意圖處理常式。

重要注意事項和限制:

  • 通訊協定不會驗證產生陳述式的主體,但該陳述式位於與主體密切相關的特定位置,且該陳述式是由主體控管。
  • 通訊協定不會驗證陳述式目標,但可讓呼叫端驗證目標。舉例來說,陳述式可透過憑證雜湊和套件名稱來識別行動應用程式目標。
  • 此通訊協定不會原生執行任何陳述式動作,而是能夠公開陳述式。使用此陳述式時,使用的應用程式必須驗證並決定是否採取行動。Android M 會以原生方式執行這些步驟;舉例來說,如果網站將連結處理作業委派給特定應用程式,Android 會檢查並驗證陳述式、驗證目標應用程式,然後為應用程式提供處理指定連結的選項。
  • 這個通訊協定並不會啟用對兩方的陳述:網站 A 可以發表關於網站 B 的聲明,但網站 A 無法就網站 B 和網站 C 之間的關係發表聲明。不過,如果網站 B 信任網站 A,就能檢查網站 A 是否有授予網站 C 權限的聲明,並決定實作網站 C。

後續步驟

  1. 看看是否有適用於您的用途的明確說明文件。
  2. 瞭解如何建立對帳單。