鑰匙環服務，打造無縫的跨設備登錄體驗

来源:https://www.cnblogs.com/hmscore/archive/2023/03/30/17272541.html
-Advertisement-
Play Games

近些年來，隨著手機技術迭代更新越來越快，用戶更換手機的周期也在縮短，在這樣的背景下，開發者不得不面臨以下問題： 同一開發者旗下常常有多個安卓應用和多形態應用（快應用和Web應用），用戶更換一個新的設備（手機或平板）後，在新設備上登錄各應用時每次都需要重覆輸入帳號和密碼，導致用戶在登錄階段流失率增加， ...


近些年來，隨著手機技術迭代更新越來越快，用戶更換手機的周期也在縮短，在這樣的背景下，開發者不得不面臨以下問題：

同一開發者旗下常常有多個安卓應用和多形態應用（快應用和Web應用），用戶更換一個新的設備（手機或平板）後，在新設備上登錄各應用時每次都需要重覆輸入帳號和密碼，導致用戶在登錄階段流失率增加，同時開發者還需要承擔額外的簡訊成本（如用戶使用簡訊登錄）。

華為HMS Core鑰匙環服務（Keyring）提供憑據管理介面（Credentials Management API），為Android手機、平板提供用戶登錄憑據存儲和跨應用、跨應用形態、跨設備共用的能力。

鑰匙環服務提供了Android API、Web API和快應用API，應用程式通過調用這些API來使用鑰匙環服務。無論調用哪種形式的介面，所有的用戶憑據最終都會存儲在HMS Core的鑰匙環服務中，以便實現統一的憑據管理能力和共用能力。

一、功能特點

鑰匙環服務提供登錄憑據本地儲存和跨形態、跨應用共用能力。鑰匙環服務將用戶登錄憑據加密儲存在本地設備，被保存的憑據通過鑰匙環服務共用至同一開發者旗下的其他快應用、Web應用和安卓應用；實現跨形態、跨應用無縫登錄體驗。

鑰匙環服務使用端到端加密同步技術實現登錄憑據跨設備同步能力。用戶在新老設備上打開“憑據多設備同步”功能，就可以在新設備上免密登錄同一開發者旗下的各形態應用，實現跨設備無縫登錄體驗。

例如，同一開發者將旗下的兩個安卓應用和兩個快應用接入鑰匙環服務後，用戶只需要在手機A和手機B上打開“憑據多設備同步”功能，手機A上登錄一個應用後，用手機B登錄時無需再輸入帳號和密碼，實現跨設備、跨應用、跨形態的無縫登錄體驗。

二、接入優勢

打造無縫登錄體驗

通過鑰匙環服務介面獲取本地存儲的用戶憑據，實現便捷登錄。

保障數據安全可靠

用戶登錄憑據在設備內加密存儲，在設備間通過端到端加密技術同步，雲端無法解密。

降低登錄流失率

簡化用戶登錄時操作流程，降低流失率

降低運營成本

減少使用簡訊登錄，降低運營成本

三、開發步驟

開發準備

詳細準備步驟可參考華為開發者聯盟官網。

集成Keyring客戶端

用戶登錄場景

1、使用一個Activity實例初始化CredentialClient，可以寫在Activity的onCreate方法中。

CredentialClient credentialClient = CredentialManager.getCredentialClient(this);

2、查詢是否存在可用的憑據。

List<AppIdentity> trustedAppList = new ArrayList<>();
trustedAppList.add(new AndroidAppIdentity("yourAppName", "yourAppPackageName", "yourAppCodeSigningCertHash"));
trustedAppList.add(new WebAppIdentity("youWebSiteName", "www.yourdomain.com"));
trustedAppList.add(new WebAppIdentity("youWebSiteName", "login.yourdomain.com"));
SharedCredentialFilter sharedCredentialFilter = SharedCredentialFilter.acceptTrustedApps(trustedAppList);
credentialClient.findCredential(sharedCredentialFilter, new CredentialCallback<List<Credential>>() {
    @Override
    public void onSuccess(List<Credential> credentials) {
        if (credentials.isEmpty()) {
            Toast.makeText(MainActivity.this, R.string.no_available_credential, Toast.LENGTH_SHORT).show();
        } else {
            for (Credential credential : credentials) {
            }
        }
    }
    @Override
    public void onFailure(long errorCode, CharSequence description) {
        Toast.makeText(MainActivity.this, R.string.query_credential_failed, Toast.LENGTH_SHORT).show();
    }
});

3、調用Credential.getContent獲取憑據內容，在CredentialCallback獲取結果。

private Credential mCredential; 
//獲取的憑據
mCredential.getContent(new CredentialCallback<byte[]>() {
    @Override
    public void onSuccess(byte[] bytes) {
        String hint = String.format(getResources().getString(R.string.get_password_ok),
                new String(bytes));
        Toast.makeText(MainActivity.this, hint, Toast.LENGTH_SHORT).show();
        mResult.setText(new String(bytes));
    }
 
    @Override
    public void onFailure(long l, CharSequence charSequence) {
        Toast.makeText(MainActivity.this, R.string.get_password_failed,
                Toast.LENGTH_SHORT).show();
        mResult.setText(R.string.get_password_failed);
    }
});

4、用戶輸入了新憑據，調用憑據存儲介面。

AndroidAppIdentity app2 = new AndroidAppIdentity(sharedToAppName,
                sharedToAppPackage, sharedToAppCertHash);
List<AppIdentity> sharedAppList = new ArrayList<>();
sharedAppList.add(app2);

Credential credential = new Credential(username, CredentialType.PASSWORD, userAuth,
                password.getBytes());
credential.setDisplayName("user_niceday");
credential.setSharedWith(sharedAppList);
credential.setSyncable(true);

credentialClient.saveCredential(credential, new CredentialCallback<Void>() {
    @Override
    public void onSuccess(Void unused) {
        Toast.makeText(MainActivity.this,
                R.string.save_credential_ok,
                Toast.LENGTH_SHORT).show();
    }
 
    @Override
    public void onFailure(long errorCode, CharSequence description) {
        Toast.makeText(MainActivity.this,
                R.string.save_credential_failed + " " + errorCode + ":" + description,
                Toast.LENGTH_SHORT).show();
    }
});

用戶登出場景

1、使用一個Activity實例初始化CredentialClient，可以寫在Activity的onCreate方法中。

CredentialClient credentialClient = CredentialManager.getCredentialClient(this);

2、查詢是否存在可用的憑據。

List<AppIdentity> trustedAppList = new ArrayList<>();
trustedAppList.add(new AndroidAppIdentity("yourAppName", "yourAppPackageName", "yourAppCodeSigningCertHash"));
trustedAppList.add(new WebAppIdentity("youWebSiteName", "www.yourdomain.com"));
trustedAppList.add(new WebAppIdentity("youWebSiteName", "login.yourdomain.com"));
SharedCredentialFilter sharedCredentialFilter = SharedCredentialFilter.acceptTrustedApps(trustedAppList);
credentialClient.findCredential(sharedCredentialFilter, new CredentialCallback<List<Credential>>() {
    @Override
    public void onSuccess(List<Credential> credentials) {
        if (credentials.isEmpty()) {
            Toast.makeText(MainActivity.this, R.string.no_available_credential, Toast.LENGTH_SHORT).show();
        } else {
            for (Credential credential : credentials) {
                //可以對可用憑據進行進一步處理，包括：獲取憑據相關信息、獲取憑據內容、刪除
            }
        }
    }
 
    @Override
    public void onFailure(long errorCode, CharSequence description) {
        Toast.makeText(MainActivity.this, R.string.query_credential_failed, Toast.LENGTH_SHORT).show();
    }
});

3、調用deleteCredential刪除憑據，在CredentialCallback獲取結果。

credentialClient.deleteCredential(credential, new CredentialCallback<Void>() {
    @Override
    public void onSuccess(Void unused) {
        String hint = String.format(getResources().getString(R.string.delete_ok),
                credential.getUsername());
        Toast.makeText(MainActivity.this, hint, Toast.LENGTH_SHORT).show();
    }
 
    @Override
    public void onFailure(long errorCode, CharSequence description) {
        String hint = String.format(getResources().getString(R.string.delete_failed),
                description);
        Toast.makeText(MainActivity.this, hint, Toast.LENGTH_SHORT).show();
    }
});

憑據共用機制

通過API參數實現憑據共用

在調用saveCredential保存憑據時，您可以通過setSharedWith設置Credential對象的屬性實現憑據共用，最多支持共用給128個應用。

示例如下：

AndroidAppIdentity app1 = new AndroidAppIdentity("your android app name",
                "your android app package name", "3C:99:C3:....");
QuickAppIdentity app2 = new QuickAppIdentity("your quick app name",
                "your quick app package name", "DC:99:C4:....");
List<AppIdentity> sharedAppList = new ArrayList<>(); // 共用關係列表
sharedAppList.add(app1);
sharedAppList.add(app2);
Credential credential = new Credential("username", CredentialType.PASSWORD, true,
                "password".getBytes());
credential.setSharedWith(sharedAppList); // 設置共用關係
credentialClient.saveCredential(credential, new CredentialCallback<Void>() {
    @Override
    public void onSuccess(Void unused) {
        Toast.makeText(MainActivity.this,
                R.string.save_credential_ok,
                Toast.LENGTH_SHORT).show();
    }
    @Override
    public void onFailure(long errorCode, CharSequence description) {
        Toast.makeText(MainActivity.this,
                R.string.save_credential_failed + " " + errorCode + ":" + description,
                Toast.LENGTH_SHORT).show();
    }
});

通過Digital Asset Links資源實現憑據共用

您可以在Android應用的AndroidManifest.xml中添加憑據共用關係，方法如下：

1、在AndroidManifest.xml的節點中添加以下內容：

<application>
           <meta-data
            android:name="asset_statements"
            android:value="@string/asset_statements" />
</application>
  1. 在res\values\strings.xml中添加以下內容：
<string name="asset_statements">your digital asset links statements</string>

Digital asset links statements是一個遵循Digital Asset links規範的JSON字元串，示例如下：

[{
                   "relation": ["delegate_permission/common.get_login_creds"],
                   "target": {
                            "namespace": "web",
                            "site": "https://developer.huawei.com" // 您的網站功能變數名稱
                   }
         },
         {
                   "relation": ["delegate_permission/common.get_login_creds"],
                   "target": {
                            "namespace": "android_app",
                            "package_name": "your android app package name",
                            "sha256_cert_fingerprints": [
                                     "F2:52:4D:..."
                            ]
                   }
         },
         {
                   "relation": ["delegate_permission/common.get_login_creds"],
                   "target": {
                            "namespace": "quick_app",
                            "package_name": "your quick app package name",
                            "sha256_cert_fingerprints": [
                                     "C3:68:9F:..."
                            ]
                   }
         }
]

relation屬性的值固定為["delegate_permission/common.get_login_creds"]，表示把憑據共用給target屬性所描述的應用。

案例分享

航班管家和高鐵管家集成華為鑰匙環服務，為兩億用戶打造無縫登錄體驗。

瞭解更多詳情>>

訪問華為開發者聯盟官網
獲取開髮指導文檔
華為移動服務開源倉庫地址：GitHub、Gitee

關註我們，第一時間瞭解 HMS Core 最新技術資訊~


您的分享是我們最大的動力!

-Advertisement-
Play Games
更多相關文章
  • Linux 修改系統時間的兩種方式
    一：更新系統時間的方式 1、手動修改 通過相關工具來手動修改系統的時間。 2、自動同步 使用NTP自動同步系統時間。 二：手動修改系統時間 1、date工具 作用：顯示和設置系統時間 選項： -d <字元串> 顯示字元串所指的日期與時間，比如："-1 day" 表示當前日期的前一天,必須要加雙引號 ...
  • 更優雅的OrientDB Java API
    OrientDB API v1.0.0（OrientDB 3.x） Gitee OrientDB介紹 OrientDB是一個開源的NoSQL資料庫管理系統，同時也是一款高性能的圖資料庫，支持ACID事務以及原子操作。 官網 圖資料庫介紹 圖資料庫是以點、邊為基礎存儲單元，以高效存儲、查詢圖數據為設計 ...
  • mysqldump詳解
    GreatSQL社區原創內容未經授權不得隨意使用，轉載請聯繫小編並註明來源。 GreatSQL是MySQL的國產分支版本，使用上與MySQL一致。 作者： 楊延昭 文章來源：GreatSQL社區投稿 在進行資料庫備份的時候主要分為了邏輯備份和物理備份這兩種方式。在數據遷移和備份恢復中使用mysqld ...
  • mysql面試小結
    MySQL 1. 索引 1.1 什麼是索引 索引是一種特殊的文件(InnoDB數據表上的索引是表空間的一個組成部分)，它們包含著對數據表裡所有記錄的引用指針。 索引是一種數據結構。資料庫索引，是資料庫管理系統中一個排序的數據結構，以協助快速查詢、更新資料庫表中數據。索引的實現通常使用B樹及其變種B+ ...
  • 雲圖說 | MSSI之應用業務模型ABM，搭建業務與技術的數據治理橋梁
    摘要：應用業務模型ABM（Application Business Model）是MSSI為客戶提供的統一模型管理服務。 本文分享自華為雲社區《【雲圖說】 | 第274期 MSSI之應用業務模型ABM，搭建業務與技術的數據治理橋梁》，作者：閱識風雲。 應用業務模型ABM（Application Bu ...
  • 數倉安全測試之SSRF漏洞
    摘要：SSRF (Server-Side Request Forgery，伺服器端請求偽造)是指由攻擊者構造請求，然後利用伺服器的漏洞以服務端的身份向內網發送請求對內網發起攻擊。 本文分享自華為雲社區《GaussDB(DWS)安全測試之SSRF漏洞》，作者： ACBD。 1. 什麼是SSRF漏洞 S ...
  • 一種自平衡解決數據傾斜的分表方法
    這篇主要描述了B端令牌系統應用數據分表解決業務數據量增大，且存在的數據傾斜問題，主要面向的場景是一對多數據傾斜問題 ...
  • MySQL 8.0數據字典有什麼變化
    GreatSQL社區原創內容未經授權不得隨意使用，轉載請聯繫小編並註明來源。 GreatSQL是MySQL的國產分支版本，使用上與MySQL一致。 作者： 葉金榮 文章來源：GreatSQL社區原創 1. MySQL 8.0數據字典有什麼變化 從MySQL 8.0開始，採用獨立表空間模式的每個Inn ...
一周排行
    -Advertisement-
    Play Games
  • Spectre.Console-實現自己的CLI
    ## 引言 最近發現自己喜歡用的 Todo 軟體總是差點意思，畢竟每個人的習慣和工作流不太一樣，我就想著自己寫一個小的[Todo 項目]( https://github.com/circler3/TodoTrack )，核心的功能是自動記錄 Todo 執行過程中消耗的時間（尤其面向程式員），按照自己 ...
  • 在 Net Core 開發中如何解決 Cannot access a disposed object 這個問題
    ### 前言 當我們編寫 C# 代碼時，經常需要處理大量的數據集合。在傳統的方式中，我們往往需要先將整個數據集合載入到記憶體中，然後再進行操作。但是如果數據集合非常大，這種方式就會導致記憶體占用過高，甚至可能導致程式崩潰。 C# 中的`yield return`機制可以幫助我們解決這個問題。通過使用`y ...
  • Ado.Net 資料庫訪問技術(.Net 6版本)
    1. ADO.NET的前世今生 ADO.NET的名稱起源於ADO（ActiveX Data Objects），是一個COM組件庫，用於在以往的Microsoft技術中訪問數據。之所以使用ADO.NET名稱，是因為Microsoft希望表明，這是在NET編程環境中優先使用的數據訪問介面。 ADO.NE ...
  • 第一單元 單元測試
    1. 為什麼需要單元測試 在我們之前，測試某些功能是否能夠正常運行時，我們都將代碼寫到Main方法中，當我們測試第二個功能時，我們只能選擇將之前的代碼清掉，重新編寫。此時，如果你還想重新測試你之前的功能時，這時你就顯得有些難為情了，因為代碼都被你清掉了。當然你完全可以把代碼寫到一個記事本中進行記錄， ...
  • 開源.NetCore通用工具庫Xmtool使用連載 - 發送簡訊篇
    1. 透過現象看本質 反射被譽為是 c#中的黑科技 ，在很多領域中都有反射的身影，例如，我們經常使用的ORM框架，ABP框架 等。 反射指程式可以訪問、檢測和修改它本身狀態或行為的一種能力。. 程式集包含模塊，而模塊包含類型，類型又包含成員。. 反射則提供了封裝程式集、模塊和類型的對象。. 您可以使 ...
  • Rust Web 全棧開發之 Web Service 中的錯誤處理
    # Rust Web 全棧開發之 Web Service 中的錯誤處理 ## Web Service 中的統一錯誤處理 ### Actix Web Service 自定義錯誤類型 -> 自定義錯誤轉為 HTTP Response - 資料庫 - 資料庫錯誤 - 串列化 - serde 錯誤 - I/ ...
  • Java中泛型詳解，非常詳細
    在前面的幾篇文章中，詳細地給大家介紹了Java里的集合。但在介紹集合時，我們涉及到了泛型的概念卻並沒有詳細學習，所以今天我們要花點時間給大家專門講解什麼是泛型、泛型的作用、用法、特點等內容 ...
  • BIO、NIO、AIO區別詳解
    ###BIO：同步阻塞 主線程發起io請求後，需要等待當前io操作完成，才能繼續執行。 ###NIO：同步非阻塞 引入selector、channel、等概念，當主線程發起io請求後，輪詢的查看系統是否準備好執行io操作，沒有準備好則主線程不會阻塞會繼續執行，準備好主線程會阻塞等待io操作完成。 # ...
  • StampedLock：高併發場景下一種比讀寫鎖更快的鎖
    摘要：在讀多寫少的環境中，有沒有一種比ReadWriteLock更快的鎖呢？有，那就是JDK1.8中新增的StampedLock！ 本文分享自華為雲社區《【高併發】高併發場景下一種比讀寫鎖更快的鎖》，作者： 冰 河。 什麼是StampedLock? ReadWriteLock鎖允許多個線程同時讀取共 ...
  • Golang掃盲式學習——GO併發 | （一）
    ## 併發與並行😣 ### 併發與並行的概念和區別 並行：同一個時間段內多個任務同時在不同的CPU核心上執行。強調同一時刻多個任務之間的”**同時執行**“。 併發：同一個時間段內多個任務都在進展。強調多個任務間的”**交替執行**“。 ![](https://img2023.cnblogs.co ...
所有分類