# General Translation Platform: API キー URL: https://generaltranslation.com/ja/docs/platform/api-keys.mdx --- title: API キー description: きめ細かな権限設定で認証キーを管理します --- API キーは、アプリケーション、CI ジョブ、各種自動化から General Translation のサービスを認証するために使用します。1 つのプロジェクトだけで使う場合はプロジェクトレベルでキーを作成し、より広いアクセスが必要な自動化には組織レベルでキーを作成します。 キー全体は、作成したらすぐにコピーしてください。ダッシュボードで表示されるのはその 1 回だけです。 ## キーのスコープ | スコープ | 最適な用途 | | ---------------- | -------------------------------------------- | | **Project** | 単一プロジェクト、デプロイ済みアプリ、ローカル開発、プレビュー、プロジェクト単位のツール | | **Organization** | 組織レベルの自動化、プロジェクト横断で動作するCI、カスタム権限が必要なツール | プロジェクトキーと組織キーでは、作成手順が異なります。プロジェクトキーは本番キーまたは開発キーとして作成します。組織キーでは権限セレクターを使用します。 ## プロジェクトキー **Project -> API キー** からプロジェクトキーを作成します。 | 種別 | プレフィックス | 用途 | | ------ | ---------- | ---------------------- | | **本番** | `gtx-api-` | デプロイ済みアプリケーションと本番用の自動化 | | **開発** | `gtx-dev-` | ローカル開発、プレビュー環境、テスト自動化 | プロジェクトキーは、選択したプロジェクトに関連付けられています。ほとんどのプロジェクト SDK / CLI ワークフローでは、プロジェクト ID とあわせてこのキーを使用します。 ```bash GT_API_KEY=gtx-api-... GT_PROJECT_ID=... ``` ## 組織キー 組織キーは **Organization -> API キー** から作成できます。 組織キーは `gtx-org-` プレフィックスを使用し、カスタムの権限セットを設定できます。組織レベルの自動化や、組織内の複数プロジェクトにまたがって動作する必要があるワークフローに使用してください。 ## Organizationキーの権限 権限はリソースごとに設定されます。`Write` には `Read` が含まれます。 | リソース | Read | Write または enabled | | ----------------------- | ------------------- | ------------------------------ | | **Files** | プロジェクトファイルと翻訳を読む | ソースコンテンツをアップロードし、翻訳済みファイルを書き込む | | **Context** | プロジェクトと組織のコンテキストを読む | コンテキストグループ、用語集、ディレクティブを管理する | | **Runtime translation** | 該当なし | 必要に応じてコンテンツを翻訳する | | **Translation queue** | 該当なし | バックグラウンド処理用にファイル翻訳ジョブをキューに追加する | | **Project settings** | 該当なし | デフォルトロケールなどのプロジェクト設定を更新する | 各キーには、必要な権限だけを付与してください。 ## キーをローテーションまたは失効する プロジェクトまたは組織のキー一覧を開き、既存のキーを確認します。現在使用していないキーは失効させ、認証情報をローテーションする際は置き換え用のキーを作成します。 ## セキュリティ対策 * キーをソース管理にコミットしない * キーは環境変数またはシークレットマネージャーに保存する * 開発、ステージング、本番環境ではそれぞれ別のキーを使用する * キーは定期的にローテーションし、未使用のものは無効化する * 連携に必要な最小限のスコープを優先する