快速入门：密码学

Dapr 密码学构建块入门

Alpha

密码学构建块目前处于 alpha 阶段。

让我们来看看 Dapr 密码学构建块。在这个快速入门中，你将创建一个使用 Dapr 密码学 API 加密和解数据的应用程序。你将：

加密然后解密一个短字符串（使用 RSA 密钥），在 Go 字节切片中读取内存中的结果。
加密然后解密一个大文件（使用 AES 密钥），使用流将加密和解密的数据存储到文件中。

注意

此示例使用 Dapr SDK，它利用 gRPC，在使用密码学 API 加密和解密消息时强烈推荐这样做。

目前，你可以使用 Go SDK 体验密码学 API。

此快速入门包含一个名为 crypto-quickstart 的 JavaScript 应用程序。

前置条件

对于此示例，你需要：

Docker Desktop

系统上可用的 OpenSSL

步骤 1：设置环境

克隆 Quickstarts 仓库中提供的示例

git clone https://github.com/dapr/quickstarts.git

在终端中，从根目录导航到密码学示例。

cd cryptography/javascript/sdk

导航到包含源代码的文件夹：

cd ./crypto-quickstart

安装依赖项：

npm install

步骤 2：使用 Dapr 运行应用程序

应用程序代码定义了两个必需的密钥：

私有 RSA 密钥
一个 256 位对称（AES）密钥

使用 OpenSSL 生成两个密钥，一个 RSA 密钥和一个 AES 密钥，并将它们写入两个文件：

mkdir -p keys
# 生成私有 RSA 密钥，4096 位密钥
openssl genpkey -algorithm RSA -pkeyopt rsa_keygen_bits:4096 -out keys/rsa-private-key.pem
# 为 AES 生成 256 位密钥
openssl rand -out keys/symmetric-key-256 32

使用 Dapr 运行 Go 服务应用程序：

dapr run --app-id crypto-quickstart --resources-path ../../../components/ -- npm start

预期输出

== APP == 2023-10-25T14:30:50.435Z INFO [GRPCClient, GRPCClient] Opening connection to 127.0.0.1:58173
== APP == == Encrypting message using buffers
== APP == Encrypted the message, got 856 bytes
== APP == == Decrypting message using buffers
== APP == Decrypted the message, got 24 bytes
== APP == The secret is "passw0rd"
== APP == == Encrypting message using streams
== APP == Encrypting federico-di-dio-photography-Q4g0Q-eVVEg-unsplash.jpg to encrypted.out
== APP == Encrypted the message to encrypted.out
== APP == == Decrypting message using streams
== APP == Decrypting encrypted.out to decrypted.out.jpg
== APP == Decrypted the message to decrypted.out.jpg

发生了什么？

`local-storage.yaml`

早些时候，你在 crypto-quickstarts 内创建了一个名为 keys 的目录。在 local-storage 组件 YAML 中，path 元数据映射到新创建的 keys 目录。

apiVersion: dapr.io/v1alpha1
kind: Component
metadata:
  name: localstorage
spec:
  type: crypto.dapr.localstorage
  version: v1
  metadata:
    - name: path
      # Path is relative to the folder where the example is located
      value: ./keys

`index.mjs`

应用程序文件使用你生成的 RSA 和 AES 密钥加密和解密消息和文件。应用程序创建一个新的 Dapr SDK 客户端：

async function start() {
  const client = new DaprClient({
    daprHost,
    daprPort,
    communicationProtocol: CommunicationProtocolEnum.GRPC,
  });

  // Encrypt and decrypt a message from a buffer
  await encryptDecryptBuffer(client);

  // Encrypt and decrypt a message using streams
  await encryptDecryptStream(client);
}

使用 RSA 密钥加密和解密字符串

创建客户端后，应用程序加密一条消息：

async function encryptDecryptBuffer(client) {
  // Message to encrypt
  const plaintext = `The secret is "passw0rd"`

  // First, encrypt the message
  console.log("== Encrypting message using buffers");

  const encrypted = await client.crypto.encrypt(plaintext, {
    componentName: "localstorage",
    keyName: "rsa-private-key.pem",
    keyWrapAlgorithm: "RSA",
  });

  console.log("Encrypted the message, got", encrypted.length, "bytes");

然后应用程序解密消息：

  // Decrypt the message
  console.log("== Decrypting message using buffers");
  const decrypted = await client.crypto.decrypt(encrypted, {
    componentName: "localstorage",
  });

  console.log("Decrypted the message, got", decrypted.length, "bytes");
  console.log(decrypted.toString("utf8"));

  // ...
}

使用 AES 密钥加密和解密大文件

接下来，应用程序加密一个大的图像文件：

async function encryptDecryptStream(client) {
  // First, encrypt the message
  console.log("== Encrypting message using streams");
  console.log("Encrypting", testFileName, "to encrypted.out");

  await pipeline(
    createReadStream(testFileName),
    await client.crypto.encrypt({
      componentName: "localstorage",
      keyName: "symmetric-key-256",
      keyWrapAlgorithm: "A256KW",
    }),
    createWriteStream("encrypted.out"),
  );

  console.log("Encrypted the message to encrypted.out");

然后应用程序解密大的图像文件：

  // Decrypt the message
  console.log("== Decrypting message using streams");
  console.log("Decrypting encrypted.out to decrypted.out.jpg");
  await pipeline(
    createReadStream("encrypted.out"),
    await client.crypto.decrypt({
      componentName: "localstorage",
    }),
    createWriteStream("decrypted.out.jpg"),
  );

  console.log("Decrypted the message to decrypted.out.jpg");
}

此快速入门包含一个名为 crypto-quickstart 的 Go 应用程序。