プロジェクトアクセストークン

プロジェクトアクセストークンは、特定のプロジェクトへの認証されたアクセスを提供します。これらはグループアクセストークンやパーソナルアクセストークンに似ていますが、グループやユーザーではなく関連するプロジェクトにスコープされています。他のプロジェクトのプロジェクトアクセストークンを使用してリソースにアクセスしたり、他のグループアクセストークン、プロジェクトアクセストークン、またはパーソナルアクセストークンを作成したりすることはできません。

プロジェクトアクセストークンを使用して認証できるのは以下のとおりです:

• GitLab APIで認証。
• HTTPS経由でのGit。使用方法:
  • 任意の空白以外の値をユーザー名として使用します。
  • パスワードとしてプロジェクトアクセストークンを使用します。

前提条件:

• プロジェクトのメンテナーまたはオーナーのロール。

アクセストークンを表示

プロジェクトアクセストークンページには、アクセストークンに関する情報が表示されます。

このページから、以下の操作を実行できます:

• プロジェクトアクセストークンの作成、ローテーション、および失効。
• すべてのアクティブおよび非アクティブなプロジェクトアクセストークンを表示。
• トークン情報（スコープ、割り当てられたロール、有効期限を含む）を表示。
• 利用状況の情報（利用日、および過去5件の固有の接続IPアドレスを含む）を表示。
  トークンがGit操作を実行するか、RESTまたはGraphQL APIで操作を認証すると、GitLabはトークンの使用情報を定期的に更新します。トークンの使用時間は10分ごとに、トークンの使用IPアドレスは1分ごとに更新されます。

プロジェクトアクセストークンを表示するには:

1. 上部のバーで、検索または移動先を選択して、プロジェクトを見つけます。
2. 設定 > アクセストークンを選択します。

アクティブで利用可能なアクセストークンは、アクティブなプロジェクトアクセストークンセクションに保存されます。期限切れ、ローテーションされた、または失効されたトークンは、無効なプロジェクトアクセストークンセクションに保存されます。

プロジェクトアクセストークンを作成する

プロジェクトアクセストークンを作成するには:

1. 上部のバーで、検索または移動先を選択して、プロジェクトを見つけます。
2. 設定 > アクセストークンを選択します。
3. 新しいトークンを追加を選択します。
4. トークン名に名前を入力します。トークン名は、プロジェクトを表示する権限を持つすべてのユーザーに表示されます。
5. オプション。トークンの説明に、トークンの説明を入力します。
6. 有効期限に、トークンの有効期限を入力します。
   • トークンは、その日付のUTC真夜中に期限切れになります。
   • 日付を入力しない場合、有効期限は今日から365日後に設定されます。
   • デフォルトでは、有効期限は今日から365日を超えることはできません。GitLab 17.6以降、管理者はアクセストークンの最大ライフタイムを修正できます。
7. トークンのロールを選択します。
8. 1つ以上のプロジェクトアクセストークンのスコープを選択します。
9. プロジェクトアクセストークンを作成を選択します。

プロジェクトアクセストークンが表示されます。プロジェクトアクセストークンを安全な場所に保存します。ページを離れるか更新すると、再度表示することはできません。

すべてのプロジェクトアクセストークンは、パーソナルアクセストークン用に設定されたデフォルトのプレフィックス設定を継承します。

プロジェクトアクセストークンのスコープ

スコープは、プロジェクトアクセストークンで認証する際に利用できるアクションを定義します。

プロジェクトアクセストークンをローテーションする

元のトークンと同じ権限とスコープを持つ新しいトークンを作成するために、トークンをローテーションします。元のトークンはすぐに非アクティブになり、GitLabは監査目的で両方のバージョンを保持します。アクティブおよび非アクティブなトークンの両方を、アクセストークンページで表示できます。

GitLab Self-ManagedおよびGitLab Dedicatedでは、非アクティブなトークンの保持期間を変更できます。

プロジェクトアクセストークンをローテーションするには:

1. 上部のバーで、検索または移動先を選択して、プロジェクトを見つけます。
2. 設定 > アクセストークンを選択します。
3. 該当するトークンについて、ローテーション（ ）を選択します。
4. 確認ダイアログで、ローテーションを選択します。

プロジェクトアクセストークンを失効させる

トークンを失効すると、直ちにそのトークンが無効になり、それ以降の使用を防ぎます。失効されたトークンはすぐに削除されませんが、トークンリストをフィルタリングしてアクティブなトークンのみを表示できます。デフォルトでは、GitLabは失効されたグループアクセストークンおよびプロジェクトアクセストークンを30日後に削除します。詳細については、非アクティブなトークンの保持を参照してください。

プロジェクトアクセストークンを失効するには:

1. 上部のバーで、検索または移動先を選択して、プロジェクトを見つけます。
2. 設定 > アクセストークンを選択します。
3. 該当するトークンについて、取り消し（ ）を選択します。
4. 確認ダイアログで、取り消しを選択します。

アクセストークンの有効期限

パーソナルアクセストークン、グループアクセストークン、およびプロジェクトアクセストークンは、有効期限日のUTC真夜中に期限切れになります。期限切れになると、それらのトークンはリクエストの認証に利用できなくなります。

GitLab 16.0以降では、新しいアクセストークンには有効期限が必要です。トークン作成時に有効期限が明示的に設定されていない場合、現在の日付から365日間の有効期限が適用されます。Ultimateプランでは、管理者はアクセストークンの最大許容ライフタイムを設定できます。

お使いのGitLabのバージョンと提供内容によっては、GitLabのバージョンをアップグレードする際に、既存のアクセストークンに有効期限が自動的に適用される場合があります。詳細については、期限切れにならないアクセストークンを参照してください。

プロジェクトアクセストークンの有効期限に関するメール

GitLabは毎日UTC午前1時にチェックを実行し、まもなく期限切れになるプロジェクトアクセストークンを特定します。オーナーまたはメンテナーロールを持つ直接のメンバーには、トークンの期限が切れる7日前にメールで通知されます。GitLab 17.6以降では、トークンの期限が切れる30日前と60日前にも通知が送信されます。

GitLab 17.7以降では、継承されたオーナーまたはメンテナーロールを持つメンバーもこれらのメールを受信できます。これは、GitLabインスタンス上のすべてのグループとプロジェクト、または特定の親グループに対して設定できます。親グループに適用された場合、この設定はすべての子孫グループおよびプロジェクトに継承されます。

期限切れのトークンは、自動的に削除されるまで非アクティブなプロジェクトアクセストークンセクションに表示されます。GitLab Self-Managedでは、この保持期間を変更できます。

プロジェクトのボットユーザー

プロジェクトアクセストークンを作成すると、GitLabはボットユーザーを作成し、それをトークンに関連付けます。

ボットユーザーには以下のプロパティがあります:

• 関連付けられたアクセストークンのロールとスコープに対応する権限が付与されます。
• それらはプロジェクトのメンバーですが、プロジェクトから削除したり、他のグループやプロジェクトに直接追加したりすることはできません。
• それらは非請求対象ユーザーであり、ライセンス制限には含まれません。
• 彼らのコントリビュートはボットユーザーアカウントに関連付けられています。
• 削除されると、彼らのコントリビュートはゴーストユーザーに移動されます。

ボットユーザーが作成されると、以下の属性が定義されます:

プロジェクトアクセストークンの作成を制限する

悪用を防ぐため、トップレベルグループ内のプロジェクトに対するアクセストークンの作成をユーザーに制限できます。既存のトークンは、期限切れになるか手動で失効されるまで有効です。

詳細については、グループおよびプロジェクトアクセストークンの作成を制限するを参照してください。

関連トピック

• パーソナルアクセストークン
• グループアクセストークン
• プロジェクトアクセストークンAPI