# 自动化配置

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

## 入口界面

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

![](https://1609727380-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MGHaHpCAkpKvpxq5ZJn%2Fuploads%2FvuasXx4Fqo3beHWCBLQZ%2Fimage.png?alt=media\&token=db2c0035-02a5-4937-ae09-41115f9adc3d)

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

![](https://1609727380-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MGHaHpCAkpKvpxq5ZJn%2Fuploads%2FDGKKkoiar1U9FKfOJIsR%2Fimage.png?alt=media\&token=0ebb5976-3c85-4681-b545-5e24d6d8bc0b)

## 新建密钥

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

![](https://1609727380-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MGHaHpCAkpKvpxq5ZJn%2Fuploads%2FkmYMdG3vstwnLEoJXnIl%2Fimage.png?alt=media\&token=b4ac0e71-e882-42ff-8ebd-dba814796fe4)

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

![](https://1609727380-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MGHaHpCAkpKvpxq5ZJn%2Fuploads%2Fg6k3zia4X72OSEKO4Nid%2Fimage.png?alt=media\&token=983f0281-7ba6-46dc-b2dd-69ecc1343dd1)

## 密钥命名规范

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

## 密钥权限

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

## 管理密钥

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

![](https://1609727380-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MGHaHpCAkpKvpxq5ZJn%2Fuploads%2FNxwdZx9rZ2lYo3Hwf7JD%2Fimage.png?alt=media\&token=2f630bef-a45d-4aa8-b36e-bb9e6025807c)

### 更新密钥

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

![](https://1609727380-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MGHaHpCAkpKvpxq5ZJn%2Fuploads%2FU22gAKqTawdSkFKJ3BOt%2Fimage.png?alt=media\&token=62544fe0-7f2b-450f-adcd-c733a373e11f)

### 删除密钥

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

![](https://1609727380-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MGHaHpCAkpKvpxq5ZJn%2Fuploads%2FbPs4kOK7Ms7WsKnfkn0d%2Fimage.png?alt=media\&token=fbcf5251-f0ba-4e26-9e0c-168bf957533e)

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

## 使用密钥

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

![](https://1609727380-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MGHaHpCAkpKvpxq5ZJn%2Fuploads%2FmVgOyE6m9Cy2i4BspPhv%2Fimage.png?alt=media\&token=7cb00139-3f60-46c8-b042-52149ff931e2)

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

![](https://1609727380-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MGHaHpCAkpKvpxq5ZJn%2Fuploads%2FEyQjYdg81bVlwxF3q0lj%2Fimage.png?alt=media\&token=d7c4b0ac-e0ca-4471-8c28-605a38bbff0c)