加密金鑰聲明

encryptionKey 聲明是一項強大的功能，它允許您的應用程式向使用者的錢包請求一個秘密的加密金鑰。這個金鑰是根據錢包的主密鑰和您提供的 salt 確定性地派生出來的。它使應用程式能夠加密使用者特定的資料，而無需處理使用者的主私鑰，從而增強了安全性和隱私性。

運作方式

這個過程直接且安全：

1. 應用程式發起：

   您的應用程式請求一個 encryptionKey 聲明，並提供一個獨特的 salt 字串。

2. 錢包派生金鑰：

   使用者的錢包收到請求。它使用一個安全的金鑰派生函數（具體為 SHA3(Buffer.concat(keyPair.sk, salt), 3)）將其主密鑰與提供的 salt 結合起來。

3. 使用者批准：

   錢包會提示使用者批准該請求，並解釋應用程式想要產生一個加密金鑰。

4. 金鑰返回：

   經使用者批准後，派生的金鑰將作為 DID Connect 回應的一部分發送回您的應用程式。

這種方法確保了即使兩個不同的應用程式使用相同的 salt 請求金鑰，派生出的金鑰也會不同，因為它們與每個使用者獨特的主密鑰綁定。

參數

encryptionKey 聲明物件接受以下參數：

請求加密金鑰

以下是如何在您的應用程式中請求 encryptionKey 聲明的範例。您通常會在啟動 DID Connect 會話時在聲明物件中定義它。

DID Connect Claims

const claims = {
  encryptionKey: {
    description: '產生一個金鑰來加密您的應用程式設定',
    salt: 'a-unique-and-persistent-salt-for-this-user-and-context',
  },
};

// 這個 claims 物件將會被傳遞給您的 WalletAuthenticator 實例
const { authInfo } = await authenticator.sign({
  claims,
  // ... 其他上下文參數
});

在上面的範例中，應用程式請求一個金鑰，為使用者提供了一條描述性訊息和一個獨特的 salt。

錢包回應

使用者批准請求後，您的應用程式的回呼端點將會收到錢包的回應。一旦驗證通過，回應負載中的 claims 陣列將包含派生的加密金鑰。

Wallet Response Payload

{
  "userDid": "z1...",
  "userPk": "...",
  "claims": [
    {
      "type": "encryptionKey",
      "salt": "a-unique-and-persistent-salt-for-this-user-and-context",
      "delegation": "",
      "key": "...derived_encryption_key..."
    }
  ],
  "challenge": "...",
  "timestamp": 1678886400
}

您的應用程式隨後可以從回應中提取 key，並將其用於加密和解密任務。

使用案例

此聲明非常適用於需要保護由您的應用程式儲存的使用者資料的場景：

透過利用 encryptionKey 聲明，您可以建構更安全、更注重隱私的應用程式。要更深入地了解如何處理聲明，請前往 WalletAuthenticator API 參考。