> ## Documentation Index
> Fetch the complete documentation index at: https://docs.kasoftware.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 全局配置库

> 如何管理知行之桥配置库中的可重用值，以便在整个管理控制台中使用。

**配置库**选项卡使您能够添加和管理可以在整个 知行之桥 管理控制台中重复使用的值。在配置重复使用某些数据的端口时，此功能可以节省时间并防止错误。

知行之桥 支持外部配置库提供程序（用于引用在 知行之桥 外部管理的机密），也支持内置的本地配置库。两种类型的项目都会显示在配置库表中。

## 管理配置库提供程序

配置库提供程序决定 知行之桥 从何处解析配置库项目的值。本地配置库始终存在，并且是唯一可以写入的提供程序。外部提供程序为只读，可让您直接使用基础设施中已有的机密，而无需在 知行之桥 中重复存储。

要打开提供程序列表，请在配置库选项卡上点击**配置库提供程序配置**。随即打开**配置库提供程序配置**窗格，其中列出每个已配置提供程序的**名称**和**提供程序**类型。**本地**提供程序始终位于第一行，无法编辑或删除。

![Vault Providers Config pane showing the Local provider and the Add dropdown](https://mintcdn.com/qiao/V5zXPPmcRAz2rNUe/26.4/images/vault-providers-config.png?fit=max\&auto=format\&n=V5zXPPmcRAz2rNUe\&q=85\&s=daf37d0377f3b9e46d1e5235c5c5f775)

### 添加 Azure Key Vault 提供程序

1. 在**配置库提供程序配置**窗格中，点击**添加 > Azure Key Vault**。

2. 填写以下必填字段：

   * **名称：** 此提供程序的显示名称，必须唯一。
   * **配置库 URI：** Azure 门户“概述”页面中的 Vault URL。创建提供程序后不可修改。
   * **应用程序 ID：** Azure 门户“概述”页面中的客户端 ID（Client Id）。
   * **客户端密钥：** 分配给该应用程序的客户端密钥。
   * **目录 ID：** Azure 门户“概述”页面中的租户 ID（Tenant Id）。

3. 点击**添加并测试**，保存提供程序并验证连接。

   ![Add Azure Key Vault form](https://mintcdn.com/qiao/V5zXPPmcRAz2rNUe/26.4/images/vault-add-azure-key-vault.png?fit=max\&auto=format\&n=V5zXPPmcRAz2rNUe\&q=85\&s=8566bf5e2e9067d90595ec17dbea526c)

所连接的 Key Vault 中的每个机密都会显示在 知行之桥 中，并归类为**加密**项目。如有需要，可以添加多个 Azure Key Vault 提供程序。例如，您可能需要为不同的环境分别连接不同的 Key Vault。

> [!NOTE]
>
> 外部提供程序（例如 Azure Key Vault）仅在企业版许可证中提供。

### 添加环境变量提供程序

环境变量提供程序会将主机上的环境变量作为配置库项目提供。

1. 在**配置库提供程序配置**窗格中，点击**添加 > 环境变量**。**名称**和**类型**会自动生成。

2. 在**包含模式**下，勾选相应的复选框，并在**标准值模式**、**加密值模式**或这两者中至少输入一个模式。每个字段都接受以逗号分隔的名称列表，或使用 `*` 和 `?` 的通配符模式。

   ![Add Environment Variable form](https://mintcdn.com/qiao/V5zXPPmcRAz2rNUe/26.4/images/vault-add-environment-variable.png?fit=max\&auto=format\&n=V5zXPPmcRAz2rNUe\&q=85\&s=d6ed4eb49c5b29e66a85463294b27f1c)

3. 点击**添加**保存提供程序。只允许配置一个环境变量提供程序。

> [!NOTE]
>
> 只有名称与至少一个模式匹配的变量才会在 知行之桥 中显示，并且添加提供程序时至少需要一个模式（标准值或加密值）。如果添加环境变量提供程序后配置库表为空，请检查输入的模式是否确实与主机上存在的环境变量名称匹配。

模式类型决定匹配变量的分类方式：

* **标准值模式：** 匹配的变量被视为标准项目，可用于任何非敏感字段。
* **加密值模式：** 匹配的变量被视为加密项目，只能用于敏感字段。

如果变量名称同时与两个列表匹配，则精确名称匹配优先于通配符匹配。如果两个匹配属于同一种类（例如都是通配符匹配），则加密优先于标准。

在 Windows 上，变量名称匹配不区分大小写；在其他平台上则区分大小写。

## 管理本地库项目

### 添加本地库项目

有两种方法可以将项目添加到本地配置库：

1. 导航到**系统设置 > 配置库**，然后点击配置库表顶部的**添加库项目**。

2. 在 知行之桥 的其他字段中输入一个值，点击钥匙符号，然后选择**添加到配置库**。

![Add vault item from a field using the key symbol](https://mintcdn.com/qiao/V5zXPPmcRAz2rNUe/26.4/images/vault-add-item-from-field.png?fit=max\&auto=format\&n=V5zXPPmcRAz2rNUe\&q=85\&s=d6879cc967b3d07ff127d0ff7e6153c6)

任一选项都会打开**添加库项目**窗格。填写以下字段：

* **名称：** 使用时显示的配置库项目名称。

* **类型：** 配置库项目的分类。

  * *标准*项目可用于所有非敏感字段。标准项目的示例包括 URL、用户名和端口。

  * *加密*项目只能用于敏感字段。加密项目的示例包括密码和授权令牌。

* **值：** 配置库项目包含的实际值。例如，选择此配置库项目时要使用的 URL、用户名或密码。

* **标签：**（可选）配置库项目的标签，可以更轻松地管理和搜索大型配置库。用逗号或换行符分隔每个标签。

  ![Add vault item pane](https://mintcdn.com/qiao/V5zXPPmcRAz2rNUe/26.4/images/vault-add-modal.png?fit=max\&auto=format\&n=V5zXPPmcRAz2rNUe\&q=85\&s=4824e365e204d86fa77c2f12f6b454ad)

点击**添加库项目**将项目保存到您的配置库。

### 编辑库项目

要编辑配置库项目，请点击其名称，或将鼠标悬停在该项目上，然后点击省略号并选择**编辑**。**编辑库项目**窗格会打开，允许您编辑项目的名称、值和标签。请注意，项目 ID 和类型（标准或加密）在创建后无法编辑。

要删除多个配置库项目，请选中每个项目旁边的框，然后点击**删除**。

来自外部提供程序的项目无法在 知行之桥 中编辑或删除。将鼠标悬停在外部项目上会显示以下提示：*“此项目由外部配置库提供程序管理，无法编辑或移除。”* 要更改或删除外部项目，请在其来源系统中进行更新。

## 使用库项目

将项目添加到配置库后，可以在匹配项目类型（标准或加密）且在 知行之桥 UI 中显示钥匙符号的字段中使用它：

![Key symbol on a connector field](https://mintcdn.com/qiao/V5zXPPmcRAz2rNUe/26.4/images/vault-key-symbol.png?fit=max\&auto=format\&n=V5zXPPmcRAz2rNUe\&q=85\&s=70b43a17e8aa731dd8a24ffafbf31712)

点击钥匙图标会打开该字段的匹配配置库值列表。

![Vault item selection dropdown](https://mintcdn.com/qiao/V5zXPPmcRAz2rNUe/26.4/images/vault-selecting-item.png?fit=max\&auto=format\&n=V5zXPPmcRAz2rNUe\&q=85\&s=f26efcb981139be462dc7e4497e06b05)

该列表包含所有已配置提供程序中的项目，每个项目都会显示其来源提供程序。使用配置库表顶部的**提供程序**筛选器，可以将列表范围缩小到特定提供程序中的项目。

选择一个值即可将其填充到字段中。

> [!NOTE]
>
> 如果该字段中已有值，可以点击**添加到配置库**打开**添加库项目**窗格，如[上文](#添加本地库项目)所述。

### 脚本

库项目可以在 ArcScript 上下文中使用。有关详细信息，请参阅[函数](https://docs.kasoftware.com/26.4/self-hosted/zh/scripting/value-formatters/function-formatters.md#vault-itemname-ifnotexists-provider)。

> [!NOTE]
>
> 在脚本上下文中引用加密配置库项目时请务必小心，以确保日志中不包含敏感信息。


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.