> ## 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-Hant/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.