このページの内容

アカウントトークン

Markdown

Glossia API での認証に使用するアカウントトークンを作成、管理します。

アカウントトークンを使用すると、完全な OAuth フローを経由せずに API リクエストを簡単に認証できます。スクリプト、CI/CD パイプライン、個人用の自動化に適しています。

トークンの作成

  1. Glossia にサインインし、アカウントダッシュボードに移動します。
  2. サイドバーから API セクションを開きます。
  3. アカウントトークン、続いて 新規トークン をクリックします。
  4. トークンの用途が分かる 名前 を指定します。たとえば、「CI デプロイ」や「CLI アクセス」などです。
  5. トークンに必要な スコープ を選択します。必要最小限の権限のみを付与してください。
  6. 有効期限 を設定します。無期限のトークンにする場合は空欄のままにします。
  7. トークンを作成 をクリックします。

作成後、完全なトークン値は 一度だけ 表示されます。すぐにコピーし、安全に保管してください。完全な値を再度確認することはできません。

トークンの使用

HTTP リクエストの Authorization ヘッダーにトークンを含めます。

Authorization: Bearer glsa_abc123def456...

たとえば、curl を使用する場合は次のようになります。

curl -H "Authorization: Bearer glsa_abc123def456..." \

  https://glossia.ai/api/projects

アカウントトークンは、OAuth トークンと同じ認可モデルに従います。トークンのスコープによって実行可能な操作の最大範囲が決まり、リソースレベルのポリシーもアカウントの関係性に基づいて適用されます。

トークン形式

すべてのアカウントトークンは glsa_ プレフィックスで始まり、その後にランダムな16進文字列が続きます。このプレフィックスにより、ログやシークレットスキャナーで Glossia トークンを容易に識別できます。

スコープ

アカウントトークンは、OAuth トークンと同じスコープをサポートします。完全な一覧については、スコープのリファレンスを参照してください。

トークンを作成する際は、用途に必要なスコープのみを選択してください。例:

  • 読み取り専用の連携には project:read と voice:read が必要です。
  • プロジェクトを作成する CI パイプラインには project:read と project:write が必要です。
  • 組織メンバーを管理するスクリプトには members:read と members:write が必要です。

トークンの管理

トークンの確認

アカウントトークン ページには、すべての有効なトークンについて、名前、スコープ、最終使用日、有効期限が表示されます。一度も使用されていないトークンは、最終使用日の列に「未使用」と表示されます。

トークンの編集

トークン名をクリックすると、名前 と 説明 を編集できます。スコープと有効期限は作成後に変更できません。異なるスコープが必要な場合は、新しいトークンを作成して古いトークンを失効させてください。

トークンの失効

トークンを失効させるには、トークン一覧で 失効 をクリックするか、トークンの編集ページを開き、危険な操作の領域にある トークンを失効 ボタンを使用します。失効したトークンは直ちに使用できなくなり、復元できません。

セキュリティのベストプラクティス

  • トークンを安全に保管してください。 環境変数またはシークレット管理ツールを使用してください。トークンをソース管理にコミットしないでください。
  • 有効期間の短いトークンを使用してください。 可能な限り有効期限を設定してください。
  • スコープを最小限にしてください。 トークンに実際に必要な権限のみを付与してください。
  • 定期的にローテーションしてください。 スケジュールに従って新しいトークンを作成し、古いトークンを失効させてください。
  • 使用状況を監視してください。 「最終使用日」を定期的に確認してください。使用されなくなったトークンは失効させてください。
  • 連携ごとに1つのトークンを使用してください。 これにより、1つのトークンを失効させても、他のワークフローに影響しません。

API による管理

REST API と MCP サーバーからもアカウントトークンを管理できます。

REST API

メソッド エンドポイント 説明
GET /api/tokens 有効なトークンの一覧を取得
POST /api/tokens 新しいトークンを作成
DELETE /api/tokens/:id トークンを失効

MCP

MCPサーバーは、REST APIと同等の機能を提供するlist_tokens、create_token、revoke_tokenツールを公開します。