サービスプリンシパルを使ってエージェントを登録する

[アーティクル]
04/29/2024

エージェント認証オプションとして [SP] を指定することで、エージェントバージョン 3.227.1 以降でサービスプリンシパルを使ってエージェントを登録できます。

エージェントプールへのアクセス権をサービスプリンシパルに付与する

サービスプリンシパルを使ってエージェントを登録する前に、サービスプリンシパルを作成し、エージェントプールにアクセスできるアクセス許可を付与する必要があります。

重要

エージェントプールへのアクセス権をサービスプリンシパルに付与するには、エージェントプール管理者、Azure DevOps 組織の所有者、または TFS または Azure DevOps Server 管理者である必要があります。

お使いのエージェントが配置グループエージェントの場合、配置グループ管理者、Azure DevOps 組織所有者、または TFS または Azure DevOps Server 管理者の場合があります。

ブラウザーを開き、Azure Pipelines 組織の [エージェントプール] タブに移動します。
1. 組織にサインインします (https://dev.azure.com/{yourorganization})。
2. [Azure DevOps]、[組織の設定] の順に選びます。
3. [エージェントプール] を選択します。
ページの右側にある必要なエージェントプールを選び、[セキュリティ] を選びます。 [追加] を選び、管理者ロールを持つサービスプリンシパルを追加します。
使う予定のサービスプリンシパルが表示されない場合は、管理者に追加するように依頼し、エージェントプールの管理者ロールをサービスプリンシパルに付与します。管理者は、エージェントプール管理者、Azure DevOps 組織所有者、または TFS または Azure DevOps Server 管理者の場合があります。

配置グループエージェントの場合、管理者は、配置グループ管理者、Azure DevOps 組織所有者、または TFS または Azure DevOps Server 管理者の場合があります。

Azure Pipelines の [配置グループ] ページの [セキュリティ] タブで、配置グループ管理者ロールにサービスプリンシパルを追加できます。

Note

"申し訳ございません。ID を追加できませんでした。別の ID を試してください。" や"セルフ ID のロールを変更できません。別の ID を使用してみてください。" のようなメッセージが表示される場合は、組織所有者や TFS または Azure DevOps Server の管理者向けの上記の手順に従った可能性があります。何もする必要はありません。エージェントプールを管理するアクセス許可が既にあります。

プロジェクト設定、エージェントプールを使ってサービスプリンシパルをエージェントプールセキュリティグループに追加する場合は、まず、Basic アクセスレベル (推奨) 以上の組織ユーザーとしてサービスプリンシパルを追加する必要があります。