文件Adobe PassAdobe Pass 驗證

頁首 — AP-Device-Identifier

最後更新: 2025年3月5日
  • 主題:
  • 驗證
注意
此頁面上的內容僅供參考。 使用此API需要Adobe的目前授權。 不允許未經授權的使用。

概觀

AP-Device-Identifier 要求標頭包含由使用者端應用程式建立的串流裝置識別碼。

語法

AP-Device-Identifier: <type> <identifier>
頁首型別請求標頭
標準否

指令

<型別>

裝置識別碼型別。

只有一種支援的型別,如下所示。

型別
指紋裝置識別碼是由使用者端應用程式針對每個裝置建立及管理的穩定且唯一識別碼。
使用者端應用程式應將裝置識別碼快取在永久儲存體中,因為遺失或變更它會使驗證失效。 使用者端應用程式應防止使用者動作(例如應用程式解除安裝、重新安裝或升級)所導致的值變更。

<識別碼>

裝置識別碼的Base64-encoded值。

範例

// device identifier
// ba23d141-d715-561c-94f4-e9e4c966b1eb

// Base64-encoded
// YmEyM2QxNDEtZDcxNS01NjFjLTk0ZjQtZTllNGM5NjZiMWVi

AP-Device-Identifier: fingerprint YmEyM2QxNDEtZDcxNS01NjFjLTk0ZjQtZTllNGM5NjZiMWVi

逐步指南

IMPORTANT
說明檔案資源僅供參考之用。
檔案資源並非詳盡無遺,且可能需要額外的修改才能在您的專案中運作。
無論您實際實作為何,AP-Device-Identifier標頭都必須包含格式化的值,如指示區段中所述。

瀏覽器

若要為瀏覽器中執行的裝置建置AP-Device-Identifier標頭,您的使用者端應用程式需要根據可用的資料(例如瀏覽器、裝置或使用者特定資料),運算穩定且唯一的識別碼。

(*)建議整合提供瀏覽器或裝置指紋識別機制的程式庫或服務。

行動裝置

iOS和iPadOS

若要為執行iOS或iPadOS的裝置建置AP-Device-Identifier標題,您可以參考下列檔案:

  • identifierForVendor的Apple開發人員檔案。

(*)建議在作業系統提供的值上套用SHA-256雜湊函式。

Android

若要為執行Android的裝置建置AP-Device-Identifier標頭,您可以參考下列檔案:

  • ANDROID_ID的Android開發人員檔案。

(*)建議在作業系統提供的值上套用SHA-256雜湊函式。

電視連線裝置

tvOS

若要為執行tvOS的裝置建置AP-Device-Identifier標題,您可以參考下列檔案:

  • identifierForVendor的Apple開發人員檔案。

(*)建議在作業系統提供的值上套用SHA-256雜湊函式。

Fire OS

若要為執行Fire OS的裝置建置AP-Device-Identifier標頭,您可以參考下列檔案:

  • ANDROID_ID的Android開發人員檔案。

(*)建議在作業系統提供的值上套用SHA-256雜湊函式。

Roku OS

若要為執行Roku OS的裝置建置AP-Device-Identifier標題,您可以參考下列檔案:

  • GetChannelClientId的Roku開發人員檔案。

(*)建議在作業系統提供的值上套用SHA-256雜湊函式。

其他

若是檔案未涵蓋的裝置平台,裝置識別碼應連結至任何可用的硬體識別碼,通常在裝置的硬體手冊中指定。

如果沒有可用的硬體識別碼,則應使用根據使用者端應用程式屬性的唯一產生識別碼,並在永久儲存空間中快取。

recommendation-more-help
3f5e655c-af63-48cc-9769-2b6803cc5f4b