---
title: "CLI と自動化のためのパーソナルアクセストークンを作成する"
description: "Token management ページでパーソナルアクセストークンを作成し、権限レベルとデータソース範囲を選択して、平文を安全に保管します"
canonical_url: "https://docs.ardge.com/ja/knowledge/scribestt/access-tokens"
---
# CLI と自動化のためのパーソナルアクセストークンを作成する

> Token management ページでパーソナルアクセストークンを作成し、権限レベルとデータソース範囲を選択して、平文を安全に保管します

## 概要

CLI や独自の自動化処理は、Web インターフェイスのサインイン状態を再利用できません。代わりにパーソナルアクセストークン（PAT）で認証します。トークンは長期間有効な資格情報で、権限レベル、アクセス可能なデータソースの集合、有効期限で範囲を絞り込みます。

この記事では、**Token management** ページでのトークン作成、適切な範囲の選択、トークンの保管と削除について説明します。

## この記事で学べること

- パーソナルアクセストークンを作成し、その所有者を割り当てる
- 用途に応じた権限レベルとデータソース範囲を選択する
- トークンの平文を保管し、不要になったら削除する

**所要時間の目安：約 5 分**

## 対象バージョン

- ARX OS 1.0 以降
- ScribeSTT 1.3.0 以降

## 事前準備

- 管理者として ScribeSTT にサインインしていること。**Token management** は左ナビゲーションの **Administrator** グループにあり、メンバーにはこのページが表示されません
- トークンを特定のデータソースに限定するには、それらのデータソースが既に存在している必要があります。システムにデータソースが 1 つもない場合は、全範囲のみ許可できます

## ステップ 1：トークン作成ダイアログを開く

1. 左ナビゲーションの **Administrator** グループから **Token management** ページに移動します
2. 右上の **New** をクリックします

**Create personal access token** ダイアログが開きます。

## ステップ 2：トークンの設定を入力する

次のように各項目を入力します。

<table>
<thead>
  <tr>
    <th>
      フィールド
    </th>
    
    <th>
      値
    </th>
    
    <th>
      ルールと注意点
    </th>
  </tr>
</thead>

<tbody>
  <tr>
    <td>
      <strong>
        Name
      </strong>
    </td>
    
    <td>
      このトークンの用途
    </td>
    
    <td>
      必須、最大 100 文字。利用者と場所がわかる名称にしてください。例：「Claude Desktop on MacBook」
    </td>
  </tr>
  
  <tr>
    <td>
      <strong>
        Owner
      </strong>
    </td>
    
    <td>
      このトークンが代理するアカウント
    </td>
    
    <td>
      必須、既存のアカウントから選択します。トークンによる操作はすべてそのアカウントの記録として残ります
    </td>
  </tr>
  
  <tr>
    <td>
      <strong>
        Data source scope
      </strong>
    </td>
    
    <td>
      このトークンがアクセスできるデータソース
    </td>
    
    <td>
      必須。既定では <strong>
        All data sources
      </strong>
      
       が選択されています
    </td>
  </tr>
  
  <tr>
    <td>
      <strong>
        Permissions
      </strong>
    </td>
    
    <td>
      このトークンが実行できる操作の種類
    </td>
    
    <td>
      必須、3 つのうち 1 つ。既定は <strong>
        Read only
      </strong>
    </td>
  </tr>
  
  <tr>
    <td>
      <strong>
        Expires
      </strong>
    </td>
    
    <td>
      トークンの有効期間
    </td>
    
    <td>
      <strong>
        Never expires
      </strong>
      
      、<strong>
        30 days
      </strong>
      
      、<strong>
        90 days
      </strong>
      
      、<strong>
        365 days
      </strong>
      
      。既定は <strong>
        Never expires
      </strong>
    </td>
  </tr>
</tbody>
</table>

### 3 つの権限レベル

<table>
<thead>
  <tr>
    <th>
      レベル
    </th>
    
    <th>
      できること
    </th>
  </tr>
</thead>

<tbody>
  <tr>
    <td>
      <strong>
        Read only
      </strong>
    </td>
    
    <td>
      照会のみ。文字起こし、タスク、実行、データソース、用語集の一覧表示と閲覧
    </td>
  </tr>
  
  <tr>
    <td>
      <strong>
        Read and write, no delete
      </strong>
    </td>
    
    <td>
      照会に加えて、タスクの作成、更新、キャンセル、再試行、トリガー
    </td>
  </tr>
  
  <tr>
    <td>
      <strong>
        Read, write, and delete
      </strong>
    </td>
    
    <td>
      上記すべてに加えて、削除
    </td>
  </tr>
</tbody>
</table>

<warning>

**3 つのレベルは独立しており、継承関係はありません：**

**Read, write, and delete** を選択しても、**Read only** のチェックを自動的に満たすわけではありません。常に最も広いレベルを選ぶのではなく、そのトークンが実際に必要とする操作に合致する 1 つのレベルを選択してください。

</warning>

### データソース範囲

**All data sources** を選択したままにすると、このトークンは後から追加されるものを含め、すべてのデータソースにアクセスできます。

選択を解除するとデータソースの一覧が表示されるので、許可するものを選択します。何も選択せずに送信すると「Select at least one data source」と表示されます。

システムにデータソースが 1 つもない場合、**All data sources** は無効になり、「There are no data sources yet, so only the full scope can be authorized. Create a data source first to scope individual ones.」と表示されます。

<warning>

**バッチタスクにはソースとターゲットの両方を範囲に含める必要があります：**

トークンがバッチタスクを操作するには、そのタスクのソースデータソースとターゲットデータソースの両方が許可範囲に含まれていなければなりません。片方だけを許可した場合、そのタスクはそのトークンから見えません。

</warning>

## ステップ 3：トークンの平文を保管する

1. **Create** をクリックします
2. **「」created** ダイアログでコピーアイコンをクリックし、トークンをパスワードマネージャーまたはデプロイ設定に保存します
3. **I've stored it** をクリックします

<warning>

**平文が表示されるのは 1 回だけです：**

ダイアログを閉じると、平文は取得できなくなります。このダイアログは Esc キーや外側のクリックでは閉じません。**I've stored it** が唯一の閉じ方です。保管せずに閉じてしまった場合、トークンを削除して作り直すしかありません。

</warning>

平文は `arxstt_pat_` で始まります。ダイアログを閉じると **Token management** の一覧に戻り、新しいトークンが表示されます。

## トークンの確認と削除

**Token management** の一覧には次の列があります。

<table>
<thead>
  <tr>
    <th>
      列
    </th>
    
    <th>
      表示内容
    </th>
  </tr>
</thead>

<tbody>
  <tr>
    <td>
      <strong>
        Name
      </strong>
    </td>
    
    <td>
      作成時に付けた名称
    </td>
  </tr>
  
  <tr>
    <td>
      <strong>
        Owner
      </strong>
    </td>
    
    <td>
      トークンが属するアカウント
    </td>
  </tr>
  
  <tr>
    <td>
      <strong>
        Permissions
      </strong>
    </td>
    
    <td>
      <strong>
        Read only
      </strong>
      
      、<strong>
        Read and write, no delete
      </strong>
      
      、<strong>
        Read, write, and delete
      </strong>
      
       のいずれか
    </td>
  </tr>
  
  <tr>
    <td>
      <strong>
        Data source scope
      </strong>
    </td>
    
    <td>
      <strong>
        All data sources
      </strong>
      
      、または許可されているデータソースの数
    </td>
  </tr>
  
  <tr>
    <td>
      <strong>
        Status
      </strong>
    </td>
    
    <td>
      <strong>
        Valid
      </strong>
      
       または <strong>
        Expired
      </strong>
    </td>
  </tr>
  
  <tr>
    <td>
      <strong>
        Expires
      </strong>
    </td>
    
    <td>
      有効期限の日時。未設定の場合は <strong>
        Never expires
      </strong>
    </td>
  </tr>
  
  <tr>
    <td>
      <strong>
        Actions
      </strong>
    </td>
    
    <td>
      削除
    </td>
  </tr>
</tbody>
</table>

行の削除アイコンをクリックして確認すると、そのトークンは即座に使用できなくなります。削除は取り消せません。そのトークンを使用している CLI や自動化処理には、新しいトークンが必要です。

## 関連記事

- [NAS データソースを接続してバッチ文字起こしタスクを作成する](https://docs.ardge.com/ja/knowledge/scribestt/nas-batch-transcription)


## Sitemap

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