ユーザーの作成と管理

TeamCity のユーザーアカウントとは

ユーザーアカウントは、ユーザー名とパスワードの組み合わせで、TeamCity ユーザーがサーバーにサインインしてその機能を使用できるようにします。ユーザーアカウントは、使用される認証スキームに応じて手動で作成することも、サインイン時に自動的に作成することもできます (詳細については、認証モジュールセクションを参照してください)。

各ユーザーアカウント:

対応する権限を通じてすべてまたは特定の TeamCity 機能へのアクセスを保証する関連するロールがあります。ロールと権限の詳細を参照してください。
少なくとも 1 つのユーザーグループに属します。ユーザーグループの詳細を参照してください。

認証されたユーザーに加えて、ゲストユーザーと呼ばれる未登録ユーザー用の特別なユーザーアカウントがあります。許可なく TeamCity プロジェクトを閲覧できます。デフォルトでは、ゲストログインは無効になっています。

それぞれの権限を持つユーザーのみが、TeamCity サーバーで他のユーザーアカウントを作成および編集できます。

新しいユーザーを作成する

管理 | ユーザーページには、ユーザーアカウントを作成するオプションがあります。

サーバー上で複数の認証モードが有効になっている場合にユーザーアカウントを作成する場合は、ユーザー名のみが必要です。

デフォルトの認証のみが使用される場合は、パスワードも必要です。新しいユーザーは自動的にすべてのユーザーグループに追加され、このグループに定義されたロールと権限を継承します。

プロジェクトごとの権限を使用しない場合は、ユーザーに管理権限を与えるかどうかをここで指定できます。それ以外の場合は、後でこのユーザーにロールを割り当てることができます。

ユーザーアカウントの編集

既存のユーザーアカウントを編集するには、管理 | ユーザーページに移動し、ユーザーの名前をクリックします。このページには、さまざまなユーザーアカウント設定を変更できるいくつかのタブがあります

一般

一般タブでは、ユーザー名、メールアドレス、パスワードを変更できます。サーバーで無料登録が許可されている場合にのみ、ユーザーは自分のユーザー名を変更できます。管理者は、いつでも任意のユーザーのユーザー名を変更できます。

認証設定

サーバーで複数の認証モジュールが有効になっている場合、認証設定セクションが表示されます。ここでは、LDAP や Windows ドメインなどのさまざまな認証モジュールのユーザー名を編集できます。

外部 OAuth ユーザー名を既存の TeamCity ユーザーにマッピングできます。それぞれのユーザー名を持つユーザーが OAuth 経由で TeamCity にサインインすると、TeamCity はそれらを認識できるようになります。

VCS ユーザー名

このタブでは、現在のユーザーが使用するさまざまな VCS のデフォルトのユーザー名を表示および編集できます。
VCS ルートタイプと別の VCS ルートでは複数のユーザー名がサポートされています: 各 VCS ユーザー名には、改行で区切られた複数の値を使用できます。

ここで設定される名前は、次の目的で使用されます。

変更ページにそのような VCS ユーザー名を持つユーザーによってコミットされた変更を含むビルドを表示します
適切なオプションが選択されている場合は、プロジェクトページでそのようなビルドをハイライトします。
通知設定で変更の影響を受けるビルドオプションが選択されている場合は、このようなビルドについてユーザーに通知します。

グループにユーザーを追加

グループタブを使用して、ユーザーが属するグループを表示し、ユーザーをグループに追加 / グループから削除します。

特定のグループ (たとえば、特定のプロジェクトの開発者のグループ) にユーザーを追加するには、次のいずれかの権限が必要です。

プロジェクト内のユーザーのロールを変更する ( プロジェクト管理者ロールに含まれる) - この権限は、管理する同じプロジェクトに取り組んでいるユーザーのグループに新しいユーザーを追加するのに十分です。例: プロジェクト A のみを管理する場合、プロジェクト B の「プロジェクト開発者」ロールを持つグループにユーザーを追加することはできません。
ユーザープロファイルとロールを変更する ( システム管理者ロールに含まれる) — 任意のユーザーを任意のグループに追加できます。

プロジェクトにユーザーを追加

特定のプロジェクトにユーザーを追加し、そのユーザーが持つ権限を管理するには、特定のロールをプロジェクトに割り当てる必要があります。ロールを管理する方法を参照してください。

ユーザーのロールタブは、サーバー管理 | 認証 page_ でプロジェクトごとのアクセス許可が有効になっている場合にのみ使用できます。このタブを表示して、ユーザーに直接割り当てられたロールとグループから継承されたロールを表示できます。直接割り当てられたロールは、ここで変更 / 削除できます。

ユーザーへのロールの割り当て

プロジェクトごとにユーザーにロールを付与できるようにするには、管理 | 認証ページでプロジェクトごとのアクセス許可を有効にします。管理 | ロールページには、アクセス許可の詳細を示す既存のすべてのロールが一覧表示されます。

1 人または複数のユーザーにロールを割り当てる方法はいくつかあります。

特定のユーザーにロールを割り当てるには、ユーザーのユーザータブで、対応する列のロールを表示をクリックします。ロールタブで、ロールを割り当てるをクリックします。
複数のユーザーにロールを割り当てるには、ユーザータブで、ユーザー名の横にあるボックスをオンにし、ページの下部にあるロールを割り当てるボタンを使用します。
グループ内のすべてのユーザーにロールを割り当てるには、グループタブで、問題のグループのロールを表示をクリックしてから、グループレベルでロールを割り当てます。

ロールを割り当てるとき、次のことができます。

ロールをグローバルに付与するか、特定のプロジェクトで付与するかを選択します。
既存のロールを新しく選択したロールに置き換えます。これにより、ユーザー / グループに割り当てられているすべてのロールが削除され、代わりに選択されたロールに置き換えられます。

プロジェクト管理者としてログインしている場合は、同じプロジェクトのスコープ内でのみロールを割り当てることができることに注意してください。例: プロジェクト A の管理者は、ユーザーにプロジェクト B のロールを付与できません。それを実行できるのはプロジェクト B 管理者 (およびシステム管理者) だけです。

通知ルール

このタブには、ユーザーの通知ルールが表示されます。

独自のルール : ユーザーが設定したルールがここに表示され、変更できます。
継承されたルール : ユーザーが属するグループから継承されたルール。

グループに複数のユーザーを追加する

管理 | ユーザーページで、ユーザーを選択し、下部にあるグループに追加ボタンをクリックして、ユーザーを追加するグループを指定します。これらのユーザーはすべて、グループに定義されたロールを継承することに注意してください。

ユーザーをブロックして削除する

現在、ユーザーアカウントを一時的に停止できる機能はありません。ただし、ユーザーのすべての権限を取り消すことで同様の効果が得られ、実質的にプロジェクトを表示したり重要なアクションを実行したりできなくなります。たとえば、デフォルトの TeamCity すべてのユーザーグループにはロールが割り当てられていません。そのままにしておくと、このグループに所属しているだけで追加のロールを持たないユーザーは、ログインできますが、プロジェクトにアクセスできなくなります。

Empty TeamCity UI for users with no permissions

誰かが組織を離れる場合は、必ずその人のユーザーアカウントを削除してください。これは、複数の認証モジュールが構成されている場合に特に重要です。Google、GitHub、GitLab、その他のリンクされたプラットフォームからユーザーを削除すると、それらのアカウントを使用してログインできなくなりますが、ユーザーアカウントが完全に削除されない限り、標準のユーザー名 / パスワード方式を使用して TeamCity に引き続きアクセスできます。