YouTrack サーバー 2024.2 ヘルプ

Google 認証モジュール

この認証モジュールを使用すると、ユーザーは Google で管理しているメールアドレスとパスワードを使用して YouTrack にログインできます。

YouTrack で Google 認証を有効にした場合:

  • ユーザーは、自分の Google アカウントに使用する認証情報を使用して YouTrack にログインします。

  • YouTrack ユーザーは覚えるべきより少ないアカウントとパスワードを持っています。

  • Google アカウントを持つ新規ユーザーは YouTrack で自分のアカウントを作成できます。

Google 認証を有効にする

既存の Google アカウントを持つユーザーが YouTrack にログインできるようにするには、Google 認証モジュールを有効にします。

この手順は 3 つのステップで行われます。

  1. YouTrack でリダイレクト URI を生成します。Google 用の認証モジュールを作成すると、YouTrack はこのサービスで使用するためのリダイレクト URI を生成します。この URI は、Google への各ログイン要求の送信元を識別します。

  2. Google CloudPlatform でクライアント ID とシークレットを生成します。YouTrack から Google に送信されるすべてのログインリクエストには一意の識別子が含まれています。認証モジュールに保存した ID とシークレットは、各ログインリクエストが承認されたことを Google に伝えます。

  3. YouTrack で認証モジュールを有効にします。YouTrack が Google での認証に使用する情報を生成したら、値を YouTrack にコピーしてモジュールを有効にします。

YouTrack でリダイレクト URI を生成する

始めるには、YouTrack を開いて Google アカウント用の認証モジュールを作成してください。認証モジュールを作成すると、YouTrack は認証サービスで使用するためのリダイレクト URI を生成します。

YouTrack でリダイレクト URI を生成するには:

  1. 管理メニューから、アクセス管理> 認証モジュールを選択します。

  2. 新規モジュールドロップダウンリストから Google を選択します。

    • Auth モジュールページに新しい Google 認証モジュールの設定が表示されます。

    • YouTrack は、Google で使用するためのリダイレクト URI を生成します。

    Google auth module settings
  3. ページの指示に従ってリダイレクト URI をコピーします。

  4. リンクをクリックして、Google CloudPlatform にアクセスします。

Google CloudPlatform でクライアント ID とシークレットを生成する

  1. Google Cloud Platform を開き、Google アカウントでログインします。

  2. プロジェクトを選択または作成します。

  3. ナビゲーションメニューから、API とサービス> 資格情報を選択します。

  4. 認証情報を作成するメニューから OAuth クライアント ID を選択します。

    • OAuth クライアント ID を作成するページが開きます。

  5. アプリケーションタイプの場合は、Web アプリケーションを選択します。

    • クライアント ID を定義するための追加の入力フィールドが表示されます。

  6. 承認されたリダイレクト URI フィールドに、Hub の認証モジュールページからコピーしたリダイレクト URI を貼り付けます。

  7. 作成ボタンをクリックしてください。

    • Google は Hub モジュールの設定に必要な認証情報を生成し、ポップアップウィンドウに表示します。

    Google OAuth client created pop-up.

YouTrack で認証モジュールを有効にする

  1. Google からクライアント ID をコピーして、YouTrack のクライアント ID 入力フィールドに貼り付けます。

  2. Google からクライアントシークレットをコピーして、YouTrack のクライアントシークレット入力フィールドに貼り付けます。

  3. 認証モジュールのオプション設定を構成します。詳しくは、オプション設定を参照してください。

  4. モジュールを有効にするボタンをクリックしてください。

    • Google 認証モジュールが有効になっています。

    • ボタンイメージ設定に保存されているアイコンがログインダイアログウィンドウに追加されます。ユーザーはこのアイコンをクリックして自分の Google アカウントで認証できます。

    Login dialog with Google

設定

フィールド

説明

タイプ

YouTrack でサードパーティー認証が有効になっているアプリケーションまたはサービスの名前を表示します。

名前

認証モジュールの名前を格納します。この設定を使用して、このモジュールを Auth モジュールリスト内の他の認証モジュールと区別します。

ボタンイメージ

ユーザーが Google アカウントで YouTrack にログインするためにクリックするボタンに使用されるイメージを表示します。

承認されたリダイレクト URI

Google で YouTrack への接続を登録するために使用されるリダイレクト URI を表示します。

サーバー URL

ユーザーが Google アカウントでログインしたときに、YouTrack がログイン要求を送信するサーバーの URL を表示します。

このフィールドに表示される情報は、認証モジュールの構成に役立ちます。

クライアント ID

Google がログインリクエストの検証に使用する識別子を保存します。この値は、Web アプリケーションの認証設定を構成し、認証されたリダイレクト URI を入力するときに Google CloudPlatform で生成されます。

クライアントシークレット

クライアント ID の検証に使用されるシークレットまたはパスワードを格納します。この値は、クライアント ID とともに Google CloudPlatform で生成します。

追加設定

以下のオプションはページの下部にあります。これらの設定を使用して、YouTrack アカウントの作成とグループメンバーシップを管理し、アイドル接続によって消費される処理リソースの損失を減らします。

オプション

説明

ユーザー作成

接続された許可サービスに保管されているアカウントでログインしている未登録ユーザー用の YouTrack アカウントの作成を可能にします。YouTrack はユーザーに既存のアカウントがあるかどうかを判断するためにメールアドレスを使用します。

制限付きドメインとメール

ユーザーアカウントの作成を、指定されたドメインまたは特定のメールアドレスからのメールアドレスを持つユーザーに制限します。複数のドメインまたはメールアドレスを指定するには、新しい行に各値を入力します。

YouTrack は、@ 記号の有無にかかわらずドメインを認識します。つまり、ドメインを @domain.com または単に domain.com として指定できます。

このオプションは、ユーザー作成オプションを有効にした場合にのみアクティブになります。

ユーザーが指定されたドメインと一致しない JetBrains アカウントでログインしようとすると、次のようになります。

  1. YouTrack はユーザーのログインを許可せず、関連するエラーメッセージを表示します。

  2. YouTrack は、ユーザーの新しいアカウントを作成しません。

  3. YouTrack は、この JetBrains アカウントがシステムで見つかった場合、そのようなアカウントを既存のユーザーアカウントのログインリストに追加しません。

自動参加グループ

接続された承認サービスに保存されているアカウントでログインするときに、ユーザーをグループに追加します。1 つまたは複数のグループを選択できます。グループに自動参加する新しいユーザーは、このグループに割り当てられたすべての権限を継承します。

少なくとも 1 つのグループにユーザーを追加することをお勧めします。それ以外の場合、新しいユーザーには、現在すべてのユーザーグループに割り当てられているアクセス許可のみが付与されます。

接続タイムアウト

承認サービスへの接続を確立するために待機する期間を設定します。デフォルト設定は 5000 ミリ秒(5 秒)です。

読み取りタイムアウト

承認サービスからユーザープロファイルデータを読み取って取得するのを待機する期間を設定します。デフォルト設定は 5000 ミリ秒(5 秒)です。

監査

YouTrack のイベントの監査ページへのリンク。そこで、この認証モジュールに適用された変更のリストを表示できます。