TeamCity On-Premises 2026.2 Help

NTLM HTTP 認証

TeamCity NTLM HTTP 認証機能は統合 Windows 認証を使用し、NTLM と、NTLMv1、NTLMv2、Kerberos ロジックによるネゴシエート HTTP 認証をサポートするブラウザー / クライアントを使用する場合に、TeamCity ウェブ UI への透過的 / SSO ログインを可能にします。 この認証は、TeamCity サーバーが Windows OS で実行されている場合にサポートされます。 通常、ユーザーは資格情報を手動で入力しなくても、NT ドメインアカウントを使用して TeamCity サーバーのウェブ UI にログインできます。

構成

NTLM HTTP モジュールは、「HTTP 認証モジュール」セクションの 管理 | 認証 ページで構成されます。

TeamCity ユーザー名が Windows ドメインユーザー名と同じか、Windows ドメインユーザー名がユーザープロファイルで指定されている場合、任意のログインモジュールで NTLM ログインを有効化できます。

要件

  1. 認証ユーザーは、認証に使用されるドメインアカウントでクライアントワークステーションにログインする必要があります。

  2. ユーザーのウェブブラウザーは NTLM HTTP 認証をサポートしている必要があります(TeamCity サーバー URL が「信頼済みサイト」である必要がある、など)

NTLM HTTP 認証の有効化

NTLM HTTP 認証モジュールが構成された後、ユーザーはログイン画面にリンクが表示され、クリックするとブラウザーにドメイン認証データの送信が強制されます。

「プロトコルの強制」設定でプロトコルを指定することにより、サーバーに強制的に NTLM HTTP 認証を通知させることができます。 これにより、サーバーは TeamCity ウェブ UI へのすべてのリクエストに対してドメイン認証を要求します。 ユーザーのブラウザーがドメイン環境で実行されている場合、現在のユーザーは自動的にログインします。 そうでない場合、ブラウザーはドメイン資格情報を要求するダイアログをポップアップします。

この属性がない場合、NTLM HTTP 認証はクライアントが明示的に開始した場合(例: ログインページで「NT ドメインアカウントを使用してログイン」リンクをクリックする場合)にのみ機能し、通常は認証されていないユーザーは TeamCity ログインページに単にリダイレクトされます。

TeamCity サーバーは、デフォルトで Windows ユーザーに対してのみ NTLM HTTP 認証を強制します。 すべてのユーザーに対してこれを有効にするには、次の 内部プロパティを設定します。

teamcity.ntlm.ignore.user.agent=true

NTLM ログイン URL

特定の接続に対して NTLM 認証を強制するには、 <TeamCity サーバーの URL>/ntlmLogin.html にリクエストを送信すると、TeamCity が NTLM 認証を開始し、概要ページにリダイレクトします。 この場合、 forceProtocols 属性を設定する必要はありません。

LDAP 認証での NTLM HTTP 認証モジュールの使用

LDAP 認証を使用する場合、一部のユーザーのログインを拒否することができます。 NTLM HTTP 認証モジュール(および Windows ドメイン資格情報認証モジュール)にはそのような機能がないため、一部のユーザーは、LDAP を介したログインが許可されていない場合でも、Windows ドメインアカウントを使用してログインできます。 この問題を解決するには、対応する認証モジュールの 最初のログイン時に新しいユーザーの作成を許可する オプションを有効にする必要があります。

このプロパティを設定すると、TeamCity に既存のアカウントがあり (つまり、以前に LDAP 経由で TeamCity にログインしている)、そのアカウントの TeamCity ユーザー名が Windows ドメインユーザー名と同じか、ユーザーのプロファイルページでカスタム NT ドメインユーザー名が指定されている場合にのみ、NT ドメインアカウントでログインできます。

クライアントの構成

環境によっては、NTLM 認証が機能するようにクライアントを構成する必要がある場合があります。

インターネットエクスプローラー

  1. ツール | インターネット オプション を開きます。

  2. 詳細設定 タブで、オプション セキュリティ | 統合 Windows 認証の有効化 がチェックされていることを確認します。

  3. セキュリティ タブで ローカル イントラネット | サイト | 詳細設定 を選択し、TeamCity サーバー URL をリストに追加します。

Google Chrome

Windows では、Chrome は通常 IE の動作を使用します。詳細については こちらを参照してください。

Mozilla Firefox

  1. ブラウザーのアドレスバーに about:config と入力します。

  2. TeamCity サーバー URL を network.automatic-ntlm-auth.trusted-uris プロパティに追加します。

2026 年 9 月 11 日