# 自动化配置

密钥是您在数据集层级下创建的加密变量，用于保护您上传的机密数据和文件。当密钥配置完成后，您可以通过复制密钥名，在您指定的自动化工作流（YAML 文件）中以 `{{ secret.keyname }}` 引用该密钥。由于密钥值不会在 YAML 文件或代码中明文展示，引用密钥将能大大提高您在使用自动化工作流时的数据信息安全。

## 入口界面

* 在数据集详情页，选择【自动化】进入自动化工作流列表，在全部工作流列表中点击【配置】即进入密钥管理界面。

![](/files/MMqIve32ZXfxqo7aAACl)

* 您也可以通过数据集详情页的【设置】-【自动化配置】进入密钥管理界面。

![](/files/bdmYuY0dBpgRciSQZYe7)

## 新建密钥

* 进入密钥管理界面，点击【新建密钥】，在弹窗中分别填写密钥名及密钥值。

![](/files/S3kxyc5fzPb3ndYCPmZs)

* 密钥名及密钥值均输入完成后，点击【新建】即创建密钥成功。

![](/files/37M6IRLdxq3iYIW1ubU2)

## 密钥命名规范

* 密钥名只能包含字母/数字（\[a-z], \[A-Z], \[0-9]） 或下划线 （\_），不允许有空格，不允许有其他特殊字符。 
* 密钥名不可将数字作为开头。 
* 密钥名区分大小写。
* 密钥名在所创建的层级上（即当前数据集中）必须是唯一的。
* 密钥名不可少于2个字符，长度限制为40个字符。
* 密钥值无限制。

## 密钥权限

* 密钥权限与数据集管理权限保持一致，即对数据集有管理权限的用户可新建、更新和删除密钥。
* 对数据集无管理权限的用户仅可复制使用密钥。
* 密钥值仅在创建时展示，创建完成后所有用户均不可查看密钥值明文。

## 管理密钥

* 所有创建的密钥都将在密钥管理列表中展示，包括密钥名、密钥更新时间、以及对秘钥的操作，您可在当前列表对密钥进行更新和删除。

![](/files/JcKTGKYcsOqLiXZE7jMJ)

### 更新密钥

* 在密钥管理列表中选取需要更新的密钥，点击操作栏中的【更新】，在弹窗中输入新的密钥值。输入完成后继续点击【更新】即完成当前密钥的更新。在您下次引用该密钥时，会自动调用您更新后的密钥值。

![](/files/r4gMIDYnUkxff8XxFEYT)

### 删除密钥

* 在密钥管理列表中选取需要删除的密钥，点击操作栏中的【删除】，并在二次确认弹窗中继续点击【删除】即可成功删除密钥。

![](/files/ZydB5nkd5RaDSgykV7w9)

{% hint style="info" %}
删除可能导致使用该密钥的工作流无法正常工作，请谨慎操作。
{% endhint %}

## 使用密钥

* 当您要使用密钥时，首先请进入密钥管理列表复制密钥名称。

![](/files/rBHA6SGg8HztKi9BW9Hx)

* 名称复制成功后，您可将该密钥用于您指定的自动化工作流。具体方式为在YAML文件中使用下列格式`{{ secret.keyname }}` 进行引用。

![](/files/RE8IKIhqt0ktP13459yC)


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.graviti.cn/guide/tensorbay/action/secret.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.