---
title: "建立個人存取權杖供 CLI 與自動化程式使用"
description: "於權杖管理頁面建立個人存取權杖、選擇操作權限與資料來源範圍，並妥善保存權杖明文"
canonical_url: "https://docs.ardge.com/zh-tw/knowledge/scribestt/access-tokens"
---
# 建立個人存取權杖供 CLI 與自動化程式使用

> 於權杖管理頁面建立個人存取權杖、選擇操作權限與資料來源範圍，並妥善保存權杖明文

## 概觀

CLI 與自建的自動化程式無法沿用網頁介面的登入狀態，須改以個人存取權杖（Personal Access Token，PAT）認證。權杖是長期有效的憑證，可指定操作權限、可存取的資料來源範圍與到期時間。

本文說明如何於 **權杖管理** 頁面建立權杖、選擇適當的授權範圍，以及權杖的保存與刪除。

## 你將學會什麼

- 建立個人存取權杖並指定其擁有者
- 依用途選擇操作權限與資料來源範圍
- 保存權杖明文，並於不再需要時刪除

**預計時間：約 5 分鐘**

## 適用版本

- ARX OS 1.0 及以上版本
- ScribeSTT 1.3.0 及以上版本

## 開始之前

- 你以管理員身分登入 ScribeSTT。**權杖管理** 位於左側導覽的 **管理員** 群組，一般成員看不到此頁面
- 若要將權杖限制在特定資料來源，該資料來源須已建立。系統尚無任何資料來源時，只能授權全部範圍

## 步驟 1：開啟建立個人存取權杖對話框

1. 於左側導覽的 **管理員** 群組，前往 **權杖管理** 頁面
2. 點擊右上方的 **新增**

畫面開啟 **建立個人存取權杖** 對話框。

## 步驟 2：填寫權杖設定

依下表填寫欄位：

<table>
<thead>
  <tr>
    <th>
      欄位
    </th>
    
    <th>
      設定值
    </th>
    
    <th>
      規則與注意事項
    </th>
  </tr>
</thead>

<tbody>
  <tr>
    <td>
      <strong>
        名稱
      </strong>
    </td>
    
    <td>
      此權杖的用途說明
    </td>
    
    <td>
      必填，最長 100 個字元。建議寫明使用者與使用位置，例如「Claude Desktop on MacBook」
    </td>
  </tr>
  
  <tr>
    <td>
      <strong>
        擁有者
      </strong>
    </td>
    
    <td>
      此權杖代表的帳號
    </td>
    
    <td>
      必填，自既有帳號中選擇。權杖的操作皆記於該帳號名下
    </td>
  </tr>
  
  <tr>
    <td>
      <strong>
        資料來源範圍
      </strong>
    </td>
    
    <td>
      此權杖可存取的資料來源
    </td>
    
    <td>
      必填。預設勾選 <strong>
        全部資料來源
      </strong>
    </td>
  </tr>
  
  <tr>
    <td>
      <strong>
        權限
      </strong>
    </td>
    
    <td>
      此權杖可執行的操作類型
    </td>
    
    <td>
      必填，三擇一。預設為 <strong>
        僅可讀取
      </strong>
    </td>
  </tr>
  
  <tr>
    <td>
      <strong>
        到期時間
      </strong>
    </td>
    
    <td>
      權杖的有效期限
    </td>
    
    <td>
      <strong>
        永不過期
      </strong>
      
      、<strong>
        30 天
      </strong>
      
      、<strong>
        90 天
      </strong>
      
       或 <strong>
        365 天
      </strong>
      
      。預設為 <strong>
        永不過期
      </strong>
    </td>
  </tr>
</tbody>
</table>

### 權限的三個等級

<table>
<thead>
  <tr>
    <th>
      等級
    </th>
    
    <th>
      可執行的操作
    </th>
  </tr>
</thead>

<tbody>
  <tr>
    <td>
      <strong>
        僅可讀取
      </strong>
    </td>
    
    <td>
      僅查詢：列出與檢視轉錄、任務、執行、資料來源與術語庫
    </td>
  </tr>
  
  <tr>
    <td>
      <strong>
        可讀寫、不可刪除
      </strong>
    </td>
    
    <td>
      查詢，加上建立、更新、取消、重試與觸發任務
    </td>
  </tr>
  
  <tr>
    <td>
      <strong>
        可讀寫與刪除
      </strong>
    </td>
    
    <td>
      上述全部，加上刪除
    </td>
  </tr>
</tbody>
</table>

<warning>

**三個等級彼此獨立，沒有繼承關係：**

選擇 **可讀寫與刪除** 並不會自動涵蓋 **僅可讀取** 的判定。請依該權杖實際要執行的操作選擇單一等級，而非一律選擇權限最大者。

</warning>

### 資料來源範圍

保持 **全部資料來源** 勾選，代表此權杖可存取目前及日後新增的所有資料來源。

取消勾選後，畫面出現資料來源清單，逐一勾選要授權的項目即可。一個都未勾選時，送出會顯示「請至少選擇一個資料來源」。

系統尚無任何資料來源時，**全部資料來源** 為停用狀態並顯示「系統尚無資料來源，僅能授權全部範圍；請先建立資料來源後才能指定個別範圍。」。

<warning>

**批次任務需要來源與目標兩端都在範圍內：**

權杖要能操作某個批次任務，該任務的來源資料來源與目標資料來源必須都在授權範圍中。只授權其中一端時，該任務對此權杖不可見。

</warning>

## 步驟 3：保存權杖明文

1. 點擊 **建立**
2. 於 **「<名稱>」已建立** 對話框點擊複製圖示，將權杖存入密碼管理工具或部署設定
3. 點擊 **我已保存**

<warning>

**權杖明文僅顯示這一次：**

對話框關閉後即無法再取回明文。此對話框不會因按下 Esc 或點擊外部而關閉，**我已保存** 是唯一的離開方式。未保存即關閉時，只能刪除該權杖並重新建立一組。

</warning>

權杖明文以 `arxstt_pat_` 開頭。關閉對話框後回到 **權杖管理** 清單，新建立的權杖出現於其中。

## 檢視與刪除權杖

**權杖管理** 清單的欄位如下：

<table>
<thead>
  <tr>
    <th>
      欄位
    </th>
    
    <th>
      內容
    </th>
  </tr>
</thead>

<tbody>
  <tr>
    <td>
      <strong>
        名稱
      </strong>
    </td>
    
    <td>
      建立時填寫的名稱
    </td>
  </tr>
  
  <tr>
    <td>
      <strong>
        擁有者
      </strong>
    </td>
    
    <td>
      該權杖所屬的帳號
    </td>
  </tr>
  
  <tr>
    <td>
      <strong>
        權限
      </strong>
    </td>
    
    <td>
      <strong>
        僅可讀取
      </strong>
      
      、<strong>
        可讀寫、不可刪除
      </strong>
      
       或 <strong>
        可讀寫與刪除
      </strong>
    </td>
  </tr>
  
  <tr>
    <td>
      <strong>
        資料來源範圍
      </strong>
    </td>
    
    <td>
      <strong>
        全部資料來源
      </strong>
      
      ，或授權的資料來源筆數
    </td>
  </tr>
  
  <tr>
    <td>
      <strong>
        狀態
      </strong>
    </td>
    
    <td>
      <strong>
        有效
      </strong>
      
       或 <strong>
        已過期
      </strong>
    </td>
  </tr>
  
  <tr>
    <td>
      <strong>
        到期時間
      </strong>
    </td>
    
    <td>
      到期的日期時間；未設定時顯示 <strong>
        永不過期
      </strong>
    </td>
  </tr>
  
  <tr>
    <td>
      <strong>
        操作
      </strong>
    </td>
    
    <td>
      刪除
    </td>
  </tr>
</tbody>
</table>

點擊該列的刪除圖示並確認後，該權杖立即失效。刪除操作無法復原，使用該權杖的 CLI 與自動化程式須改用新的權杖。

## 相關文章

- [連接 NAS 資料來源並建立批次轉錄任務](https://docs.ardge.com/zh-tw/knowledge/scribestt/nas-batch-transcription)


## Sitemap

See the full [sitemap](https://docs.ardge.com/sitemap.md) for all pages.