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

来源: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
  • .NET 6 Entity Framework Core Db First（1） 創建模型
    .Net8.0 Blazor Hybird 桌面端 (WPF/Winform) 實測可以完整運行在 win7sp1/win10/win11. 如果用其他工具打包,還可以運行在mac/linux下, 傳送門BlazorHybrid 發佈為無依賴包方式 安裝 WebView2Runtime 1.57 M ...
  • 資料庫升級PostgreSql+Garnet
    目錄前言PostgreSql安裝測試額外Nuget安裝Person.cs模擬運行Navicate連postgresql解決方案Garnet為什麼要選擇Garnet而不是RedisRedis不再開源Windows版的Redis是由微軟維護的Windows Redis版本老舊，後續可能不再更新Garne ...
  • 如何基於surging架設流媒體視頻推流（視頻講解）
    C#TMS系統代碼-聯表報表學習 領導被裁了之後很快就有人上任了，幾乎是無縫銜接，很難讓我不想到這早就決定好了。我的職責沒有任何變化。感受下來這個系統封裝程度很高，我只要會調用方法就行。這個系統交付之後不會有太多問題，更多應該是做小需求，有大的開發任務應該也是第二期的事，嗯？怎麼感覺我變成運維了？而 ...
  • EAV模型（實體-屬性-值）的設計和低代碼的處理方案（2）--數據的查詢處理
    我在隨筆《EAV模型（實體-屬性-值）的設計和低代碼的處理方案（1）》中介紹了一些基本的EAV模型設計知識和基於Winform場景下低代碼（或者說無代碼）的一些實現思路，在本篇隨筆中，我們來分析一下這種針對通用業務，且只需定義就能構建業務模塊存儲和界面的解決方案，其中的數據查詢處理的操作。 ...
  • C# 程式集、模塊和類型概念及關係
    對某個遠程伺服器啟用和設置NTP服務(Windows系統) 打開註冊表 HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\W32Time\TimeProviders\NtpServer 將 Enabled 的值設置為 1，這將啟用NTP伺服器功 ...
  • Django信號與擴展：深入理解與實踐
    title: Django信號與擴展：深入理解與實踐 date: 2024/5/15 22:40:52 updated: 2024/5/15 22:40:52 categories: 後端開發 tags: Django 信號 松耦合 觀察者 擴展 安全 性能 第一部分：Django信號基礎 Djan ...
  • Django3.2安裝源碼xadmin2步驟以及遇到的問題
    使用xadmin2遇到的問題&解決 環境配置： 使用的模塊版本： 關聯的包 Django 3.2.15 mysqlclient 2.2.4 xadmin 2.0.1 django-crispy-forms >= 1.6.0 django-import-export >= 0.5.1 django-r ...
  • 原創->CommonsCollections1-DefaultMap鏈
    今天我打算整點兒不一樣的內容，通過之前學習的TransformerMap和LazyMap鏈，想搞點不一樣的，所以我關註了另外一條鏈DefaultedMap鏈，主要調用鏈為： 調用鏈詳細描述： ObjectInputStream.readObject() DefaultedMap.readObject ...
  • 05-應用級開發者 AI 時代破局點
    後端應用級開發者該如何擁抱 AI GC？就是在這樣的一個大的浪潮下，我們的傳統的應用級開發者。我們該如何選擇職業或者是如何去快速轉型，跟上這樣的一個行業的一個浪潮? 0 AI金字塔模型 越往上它的整個難度就是職業機會也好，或者說是整個的這個運作也好,它的難度會越大,然後越往下機會就會越多,所以這是一 ...
  • Java面試題：讓依賴註入變得簡單，面對@Autowired和@Resource，該如何選擇？
    @Autowired是Spring框架提供的註解，@Resource是Java EE 5規範提供的註解。 @Autowired預設按照類型自動裝配，而@Resource預設按照名稱自動裝配。 @Autowired支持@Qualifier註解來指定裝配哪一個具有相同類型的bean，而@Resourc... ...
所有分類