ロールと権限の管理

認証モード

TeamCity 認証は、シンプルモードと 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」です。