ロールと権限の管理

認証モード

TeamCity 認可は、simple と per-project の 2 つのモードをサポートしています。

• シンプルモードでは、ゲスト、ログインユーザー、管理者の 3 種類の認証レベルしかありません。

• per-project モードでは、プロジェクトまたはサーバー全体でユーザーのロールを割り当てることができます。ロールのパーミッションのセットは編集可能です。

プロジェクトレベルで付与されたロール内の権限は、このプロジェクトのすべてのサブプロジェクトに自動的に伝達されます。
プロジェクトとすべての親プロジェクトを表示する権限では、プロジェクト（およびそのサブプロジェクト）だけでなく、その親プロジェクトも表示できます。

認証モードの変更

明示的に構成されていない限り、TeamCity Professional では単純認証モードが使用され、TeamCity Enterprise ではプロジェクトごとに使用されます。

許可モードを変更するには、管理 | 認証に移動し、「プロジェクトごとの許可を有効にする」オプションを有効 / 無効にします。

簡易認証モード

プロジェクトごとの承認モード

ロールは、管理者によってプロジェクトごとにユーザーに割り当てられます。ユーザーはプロジェクトごとに異なるロールを持つことができるため、権限はプロジェクトベースです。ユーザーは、特定のプロジェクトまたは使用可能なすべてのプロジェクトでロールを持つことも、ロールをまったく持たないこともできます。ユーザーアカウントを一連のロールに関連付けることができます。ユーザーグループにロールを付与することもできます。これは、グループに含まれるすべてのユーザーに（直接または他のグループを介して）ロールが自動的に付与されることを意味します。

管理 | ロールでロールを追加し、それらにパーミッションを割り当てることができます。ロールの許可を追加をクリックして、使用可能なすべての許可のリストを表示し、必要な許可を選択して、追加をクリックします。複数の権限を追加するには、Ctrl キーを押しながら選択します。

デフォルトでは、TeamCity は次のプロジェクトごとのロールを提供します。

プロジェクトごとの権限が有効になっている場合、サーバー管理者は、TeamCity 管理 Web UI で、または <TeamCity Data Directory>/config ディレクトリに保管されている roles-config.xml ファイルを変更することにより、ロールを変更、削除、権限の任意の組み合わせで新しいロールを追加できます。ユーザーにロールを割り当てる場合、Web UI のロールのアクセス許可の表示リンクには、現在の構成に従って各ロールのアクセス許可のリストが表示されます。

プロジェクトレベルのエージェント管理権限

TeamCity には、エージェントでタスクを実行するための以下のプロジェクトレベルの権限があります。

• プロジェクトに関連付けられたエージェントの有効化 / 無効化

• プロジェクトのクラウドエージェントの開始 / 停止

• プロジェクトのエージェント実行構成ポリシーを変更する

• プロジェクトエージェントマシンの管理 (たとえば、再起動、エージェントログの表示)

• プロジェクトエージェントを削除

• プロジェクト担当者の承認

すべてのプロジェクトレベルのエージェント管理権限は、デフォルトでプロジェクト管理者ロールに追加されます。

このプールに関連付けられているすべてのプロジェクトでこの権限がユーザーに付与されている場合、ユーザーは、これらの権限のいずれかによって制御されるタスクを、そのプールに属するすべてのエージェントに対して実行できます。例: 一部のプロジェクトで「プロジェクトに関連付けられたエージェントを有効化 / 無効化」権限を持つユーザーは、プールに関連付けられたすべてのプロジェクトで権限が付与されている場合、関連するプロジェクトのプールに属するエージェントを有効または無効にすることができます。

ロールを管理する

インストールでプロジェクトごとのアクセス許可が有効になっている場合は、TeamCity UI（管理 | ロールページ）で既存のロールを表示、変更、新しいロールを作成できます。それは可能にします:

• 新しいロールの作成。

• 既存のロールを削除します。

• 既存のロールからのアクセス許可の追加 / 削除。

• ロールからの権限の包含 / 除外。

ロール設定はグローバルであることに注意してください。

権限の継承

ユーザー権限は、親プロジェクトからそのサブプロジェクトに、また親ユーザーグループから子グループに共有されます。

プロジェクトの継承

プロジェクト「Main」に 2 つのサブプロジェクト「Project A」と「Project B」があるとします。各プロジェクトには、対応するユーザーグループがあります。

• 「Main Project Users」グループは、そのユーザーにプロジェクト「Main」の「プロジェクト管理者」ロールを付与します。

• 「グループ A」と「グループ B」は、対応する子プロジェクトの「プロジェクト閲覧者」ロールをユーザーに与えます。

「メインプロジェクトユーザー」と「グループ A」に追加されたユーザーは、両方の子プロジェクトで「プロジェクト管理者」ロールを持ちます。これは、このロールが「メインプロジェクトユーザー」グループから継承されるためです。

グループの継承

ユーザーグループにロールを割り当てると、このグループのすべての子グループに同じ権限が与えられます。管理 | グループページでは、ロールが継承されたグループの「ロール」列に「N/M」カウンターが表示されます。「N」はこのグループに直接割り当てられたロールの数、「M」は親グループから継承されたロールの数です。

以下の図では、「Tier 3」グループには、親の「Tier 1」および「Tier 2」グループから継承された 2 つのロールがあります。このグループには直接割り当てられたロールがないため、そのカウンタは「0/2」です。