﻿# 如何在 Azure DevOps 的 Wikis 頁面中遮蔽敏感的資料內容

由於我們公司所有專案都採用 [Azure DevOps Services](https://azure.microsoft.com/zh-tw/products/devops?WT.mc_id=DT-MVP-4015686) 來做管理，所有專案的文件也都寫在 Wikis 頁面中，但我經常會看到許多人會把一些敏感的資料也寫在裡面，例如服務的帳號密碼、金鑰等等。其實這些資料不是不能寫在 Wikis 頁面中，畢竟就是專案會需要參考的文件，但這麼直白的寫在文件中，開會時若有外人在場，或是線上會議有人截圖或錄影，一不小心機密資訊就外洩了。這篇文章我來分享一個小技巧，教大家怎樣在 Azure DevOps 的 Wikis 頁面中遮蔽敏感的資料內容。

![representing the idea of masking or concealing sensitive information within a digital or technical environment](https://stwillblogassets.blob.core.windows.net/files/images/external/stwillblogassets.blob.core.windows.net/2880483cb3dd901b579f-5d61690f-6297-49b2-b2c8-58a9f8c7b34d.webp)

## 建立可折疊的區段內容

在 Wikis 頁面中，我們可以使用 HTML5 的 `details` 標籤來建立可折疊的區段內容，以下是一個簡易範例：

-   定義 Markdown 內容：
    
    ```markdown
    <details>
      <summary>Click to expand!</summary>
    
    ## Heading
    1. A numbered
    2. list
        * With some
        * Sub bullets
    </details>
    ```
    
    > 注意: 在 `</summary>` 後面，記得要加上一個空白行，否則可能會無法正確顯示部分 Markdown 語法。
    
-   顯示結果：
    
    | 折疊收起 | 展開內容 |
    | --- | --- |
    | ![image](https://stwillblogassets.blob.core.windows.net/files/images/external/github.com/c3a069ba6ee9f2d8d214-c7f77d63-a038-46c9-85d6-a44b76d02e38.png) | ![image](https://stwillblogassets.blob.core.windows.net/files/images/external/github.com/c8d4df7ce744d6361cd2-336df4ec-e52f-4acf-a740-26260a3ad38d.png) |
    

這個語法我其實經常使用，尤其是在寫文件時，有時候會有一些內容是不是每個人都需要看到的。例如操作手冊可能就有許多截圖，但是圖片很大，每張圖都展開的時候，會導致閱讀體驗變差，不容易瞭解操作的順序，因為一頁的內容可能就被一張圖片蓋掉了。

這時候我們可以使用 `details` 標籤來預設隱藏這些圖片，只有點擊 `<summary>` 標籤的內容時，才會展開並顯示圖片，這樣就非常好用了。

## 遮蔽敏感的資料內容

只要瞭解 `details` 與 `summary` 標籤的用法，我們就可以利用這個技巧將敏感的資料內容隱藏起來，只有點擊才會展開。

例如以下這段內容：

```markdown
| 帳號    | 密碼     |
| ------- | -------- |
| `admin` | `123456` |
```

直接顯示密碼就不太好，若使用這個技巧，內容就會變成這樣：

```markdown
| 帳號    | 密碼                                                   |
| ------- | ------------------------------------------------------ |
| `admin` | <details><summary>`******`</summary>`123456`</details> |
```

| 折疊收起 | 展開內容 |
| --- | --- |
| ![image](https://stwillblogassets.blob.core.windows.net/files/images/external/github.com/477f2089ad9ba4637e9f-a77dc453-9943-459f-a051-faeb1f38a973.png) | ![image](https://stwillblogassets.blob.core.windows.net/files/images/external/github.com/57b9f7c00f516149e20f-99582397-baa1-4692-a4f7-55333516bec1.png) |

### 相關連結

-   [Use Markdown in Azure DevOps](https://learn.microsoft.com/en-us/azure/devops/project/wiki/markdown-guidance?view=azure-devops&WT.mc_id=DT-MVP-4015686)
-   [Keyboard shortcuts to manage wiki pages](https://learn.microsoft.com/en-us/azure/devops/project/navigation/keyboard-shortcuts?view=azure-devops&WT.mc_id=DT-MVP-4015686#wiki-keyboard-shortcuts)
