快速入门：Secrets 管理

开始使用 Dapr 的 Secrets Management 构建块

Dapr 提供了一个专用的秘钥 API，允许开发者从秘钥存储中检索秘钥。在本快速入门中，您将：

使用密钥存储组件运行微服务。
在应用程序代码中使用 Dapr 密钥 API 检索密钥。

在继续快速入门之前，请选择您首选的特定语言 Dapr SDK。

Python
JavaScript
.NET
Java
Go

先决条件

对于此示例，您将需要：

第1步：设置环境

克隆在Quickstarts存储库中提供的示例。

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

第2步：检索密钥

在一个终端窗口中，导航到 order-processor 目录。

cd secrets_management/python/sdk/order-processor

安装依赖项：

pip3 install -r requirements.txt

与 Dapr sidecar 一起运行 order-processor 服务。

dapr run --app-id order-processor --resources-path ../../../components/ -- python3 app.py

注意：由于Python3.exe在Windows中未定义，您可能需要使用python app.py而不是python3 app.py。

在这个幕后

`order-processor 服务

请注意下面的 order-processor 服务指向：

DAPR_SECRET_STORE 定义于 local-secret-store.yaml 组件。
在 secrets.json 中定义的密钥。

# app.py
DAPR_SECRET_STORE = 'localsecretstore'
SECRET_NAME = 'secret'
with DaprClient() as client:
    secret = client.get_secret(store_name=DAPR_SECRET_STORE, key=SECRET_NAME)
    logging.info('Fetched Secret: %s', secret.secret)

local-secret-store.yaml 组件

DAPR_SECRET_STORE 在位于 secrets_management/components 的 local-secret-store.yaml 组件文件中定义：

apiVersion: dapr.io/v1alpha1
kind: Component
metadata:
  name: localsecretstore
  namespace: default
spec:
  type: secretstores.local.file
  version: v1
  metadata:
  - name: secretsFile
    value: secrets.json
  - name: nestedSeparator
    value: ":"

在 YAML 文件中：

metadata/name 是应用程序引用组件的方式（在代码示例中称为 DAPR_SECRET_STORE）。
spec/metadata定义了组件使用的密钥的连接。

secrets.json 文件

SECRET_NAME 在位于 secrets_management/python/sdk/order-processor 的 secrets.json 文件中定义：

{
    "secret": "YourPasskeyHere"
}

第3步：查看order-processor输出

如上面的应用程序代码中所指定的，order-processor服务通过Dapr密钥存储检索密钥，并在控制台中显示。

Order-processor输出：

== APP == INFO:root:Fetched Secret: {'secret': 'YourPasskeyHere'}

先决条件

对于此示例，您将需要：

第1步：设置环境

克隆在Quickstarts存储库中提供的示例。

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

第2步：检索密钥

在一个终端窗口中，导航到 order-processor 目录。

cd secrets_management/javascript/sdk/order-processor

安装依赖项：

npm install

与 Dapr sidecar 一起运行 order-processor 服务。

dapr run --app-id order-processor --resources-path ../../../components/ -- npm start

在这个幕后

`order-processor 服务

请注意下面的 order-processor 服务指向：

DAPR_SECRET_STORE 定义于 local-secret-store.yaml 组件。
在 secrets.json 中定义的密钥。

// index.js
const DAPR_SECRET_STORE = "localsecretstore";
const SECRET_NAME = "secret";
async function main() {
    // ...
    const secret = await client.secret.get(DAPR_SECRET_STORE, SECRET_NAME);
    console.log("Fetched Secret: " + JSON.stringify(secret));
}

local-secret-store.yaml 组件

DAPR_SECRET_STORE 在位于 secrets_management/components 的 local-secret-store.yaml 组件文件中定义：

apiVersion: dapr.io/v1alpha1
kind: Component
metadata:
  name: localsecretstore
  namespace: default
spec:
  type: secretstores.local.file
  version: v1
  metadata:
  - name: secretsFile
    value: secrets.json
  - name: nestedSeparator
    value: ":"

在 YAML 文件中：

metadata/name 是应用程序引用组件的方式（在代码示例中称为 DAPR_SECRET_STORE）。
spec/metadata定义了组件使用的密钥的连接。

secrets.json 文件

SECRET_NAME 在位于 secrets_management/javascript/sdk/order-processor 的 secrets.json 文件中定义：

{
    "secret": "YourPasskeyHere"
}

第3步：查看order-processor输出

如上面的应用程序代码中所指定的，order-processor服务通过Dapr密钥存储检索密钥，并在控制台中显示。

Order-processor输出：

== APP ==
== APP == > order-processor@1.0.0 start
== APP == > node index.js
== APP ==
== APP == Fetched Secret: {"secret":"YourPasskeyHere"}

先决条件

对于此示例，您将需要：

第1步：设置环境

克隆在Quickstarts存储库中提供的示例。

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

第2步：检索密钥

在一个终端窗口中，导航到 order-processor 目录。

cd secrets_management/csharp/sdk/order-processor

安装依赖项：

dotnet restore
dotnet build

与 Dapr sidecar 一起运行 order-processor 服务。

dapr run --app-id order-processor --resources-path ../../../components/ -- dotnet run

在这个幕后

`order-processor 服务

请注意下面的 order-processor 服务指向：

DAPR_SECRET_STORE 定义于 local-secret-store.yaml 组件。
在 secrets.json 中定义的密钥。

// Program.cs
const string DAPR_SECRET_STORE = "localsecretstore";
const string SECRET_NAME = "secret";
var client = new DaprClientBuilder().Build();
var secret = await client.GetSecretAsync(DAPR_SECRET_STORE, SECRET_NAME);
var secretValue = string.Join(", ", secret);
Console.WriteLine($"Fetched Secret: {secretValue}");

local-secret-store.yaml 组件

DAPR_SECRET_STORE 在位于 secrets_management/components 的 local-secret-store.yaml 组件文件中定义：

apiVersion: dapr.io/v1alpha1
kind: Component
metadata:
  name: localsecretstore
  namespace: default
spec:
  type: secretstores.local.file
  version: v1
  metadata:
  - name: secretsFile
    value: secrets.json
  - name: nestedSeparator
    value: ":"

在 YAML 文件中：

metadata/name是您的应用程序引用组件的方式（在代码示例中称为DAPR_SECRET_NAME）。
spec/metadata定义了组件使用的密钥的连接。

secrets.json 文件

SECRET_NAME 在位于 secrets_management/csharp/sdk/order-processor 的 secrets.json 文件中定义：

{
    "secret": "YourPasskeyHere"
}

第3步：查看order-processor输出

如上面的应用程序代码中所指定的，order-processor服务通过Dapr密钥存储检索密钥，并在控制台中显示。

Order-processor输出：

== APP == Fetched Secret: [secret, YourPasskeyHere]

先决条件

对于此示例，您将需要：

Dapr CLI 和初始化环境.
Java JDK 11（或更高版本）：
- Oracle JDK，或者
- OpenJDK
Apache Maven，3.x版本。
Docker Desktop

第1步：设置环境

克隆在Quickstarts存储库中提供的示例。

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

第2步：检索密钥

在一个终端窗口中，导航到 order-processor 目录。

cd secrets_management/java/sdk/order-processor

安装依赖项：

mvn clean install

与 Dapr sidecar 一起运行 order-processor 服务。

dapr run --app-id order-processor --resources-path ../../../components/ -- java -jar target/OrderProcessingService-0.0.1-SNAPSHOT.jar

在这个幕后

`order-processor 服务

请注意下面的 order-processor 服务指向：

DAPR_SECRET_STORE 定义于 local-secret-store.yaml 组件。
在 secrets.json 中定义的密钥。

// OrderProcessingServiceApplication.java
private static final String SECRET_STORE_NAME = "localsecretstore";
// ...
    Map<String, String> secret = client.getSecret(SECRET_STORE_NAME, "secret").block();
    System.out.println("Fetched Secret: " + secret);

local-secret-store.yaml 组件

DAPR_SECRET_STORE 在位于 secrets_management/components 的 local-secret-store.yaml 组件文件中定义：

apiVersion: dapr.io/v1alpha1
kind: Component
metadata:
  name: localsecretstore
  namespace: default
spec:
  type: secretstores.local.file
  version: v1
  metadata:
  - name: secretsFile
    value: secrets.json
  - name: nestedSeparator
    value: ":"

在 YAML 文件中：

metadata/name是您的应用程序引用组件的方式（在代码示例中称为DAPR_SECRET_NAME）。
spec/metadata定义了组件使用的密钥的连接。

secrets.json 文件

SECRET_NAME 在位于 secrets_management/java/sdk/order-processor 的 secrets.json 文件中定义：

{
    "secret": "YourPasskeyHere"
}

第3步：查看order-processor输出

如上面的应用程序代码中所指定的，order-processor服务通过Dapr密钥存储检索密钥，并在控制台中显示。

Order-processor输出：

== APP == Fetched Secret: {secret=YourPasskeyHere}

先决条件

对于此示例，您将需要：

第1步：设置环境

克隆在Quickstarts存储库中提供的示例。

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

第2步：检索密钥

在一个终端窗口中，导航到 order-processor 目录。

cd secrets_management/go/sdk/order-processor

安装依赖项：

go build .

与 Dapr sidecar 一起运行 order-processor 服务。

dapr run --app-id order-processor --resources-path ../../../components/ -- go run .

在这个幕后

`order-processor 服务

请注意下面的 order-processor 服务指向：

DAPR_SECRET_STORE 定义于 local-secret-store.yaml 组件。
在 secrets.json 中定义的密钥。

const DAPR_SECRET_STORE = "localsecretstore"
const SECRET_NAME = "secret"
// ...
secret, err := client.GetSecret(ctx, DAPR_SECRET_STORE, SECRET_NAME, nil)
if secret != nil {
    fmt.Println("Fetched Secret: ", secret[SECRET_NAME])
}

local-secret-store.yaml 组件

DAPR_SECRET_STORE 在位于 secrets_management/components 的 local-secret-store.yaml 组件文件中定义：

apiVersion: dapr.io/v1alpha1
kind: Component
metadata:
  name: localsecretstore
  namespace: default
spec:
  type: secretstores.local.file
  version: v1
  metadata:
  - name: secretsFile
    value: secrets.json
  - name: nestedSeparator
    value: ":"

在 YAML 文件中：

metadata/name是您的应用程序引用组件的方式（在代码示例中称为DAPR_SECRET_NAME）。
spec/metadata定义了组件使用的密钥的连接。

secrets.json 文件

SECRET_NAME 在位于 secrets_management/go/sdk/order-processor 的 secrets.json 文件中定义：

{
    "secret": "YourPasskeyHere"
}

第3步：查看order-processor输出

如上面的应用程序代码中所指定的，order-processor服务通过Dapr密钥存储检索密钥，并在控制台中显示。

Order-processor输出：

== APP == Fetched Secret:  YourPasskeyHere

告诉我们您的想法

我们一直在努力改进我们的快速入门示例，并重视您的反馈。您觉得此快速入门有帮助吗？您有改进的建议吗？

加入我们的discord频道参与讨论。

下一步

使用 HTTP 而不是 SDK 的 Dapr Secrets Management。
了解有关Secrets Management构建块

探索 Dapr 教程 >>

密钥管理

快速入门：Secrets 管理

先决条件

第1步：设置环境

第2步：检索密钥

在这个幕后

第3步：查看order-processor输出

先决条件

第1步：设置环境

第2步：检索密钥

在这个幕后

第3步：查看order-processor输出

先决条件

第1步：设置环境

第2步：检索密钥

在这个幕后

第3步：查看order-processor输出

先决条件

第1步：设置环境

第2步：检索密钥

在这个幕后

第3步：查看order-processor输出

先决条件

第1步：设置环境

第2步：检索密钥

在这个幕后

第3步：查看order-processor输出

告诉我们您的想法

下一步