この記事では、Harness に対してユーザーまたはグループを自動的にプロビジョニングおよびプロビジョニング解除するようにMicrosoft Entra IDを構成する方法について説明します。 自動プロビジョニングでは、ID プロバイダーから Harness にユーザー ライフサイクルの変更を同期することで、手動でのユーザー管理が不要になります。
注
この記事では、Microsoft Entra ユーザー プロビジョニング サービスの上に構築されたコネクタについて説明します。 このサービスの詳細については、「Microsoft Entra IDを使用して SaaS アプリケーションへのユーザー プロビジョニングとプロビジョニング解除を自動化する」を参照してください。
前提条件
この記事で説明するシナリオでは、次の前提条件があることを前提としています。
- アクティブなサブスクリプションを持つ Microsoft Entra ユーザー アカウント。 まだアカウントがない場合は、無料でアカウントを作成することができます。
- 次のいずれかのロール:
- Harness テナント
- 管理者アクセス許可がある Harness のユーザー アカウント
ユーザーを Harness に割り当てる
プロビジョニングを構成する前に、Microsoft Entra IDの Harness アプリケーションにユーザーまたはグループを割り当てる必要があります。 Microsoft Entra IDでは、割り当てを使用して、選択したアプリケーションへのアクセスを受け取るユーザーを決定します。 自動ユーザー プロビジョニングのコンテキストでは、Microsoft Entra ID でアプリケーションに割り当て済みのユーザーまたはグループのみが同期の対象になります。
自動ユーザー プロビジョニングを構成して有効にする前に、Microsoft Entra ID で Harness へのアクセスが必要なユーザーまたはグループを決定します。 その後、「エンタープライズ アプリにユーザーまたはグループを割り当てる」の手順に従って、これらのユーザーまたはグループを Harness に割り当てることができます。
ユーザー割り当ての推奨事項
組織全体にプロビジョニングをロールアウトする前に、小規模なテスト グループから始めます。 1 人のMicrosoft Entra ユーザーを Harness に割り当てて、自動ユーザー プロビジョニング構成をテストします。 プロビジョニングが正しく機能することを確認したら、追加のユーザーまたはグループを割り当てることができます。
Harness にユーザーを割り当てるときは、[ 割り当て ] ダイアログ ボックスで有効なアプリケーション固有のロール (使用可能な場合) を選択する必要があります。 既定のアクセス ロールのユーザーは、プロビジョニングから除外されます。
現在、Microsoft Entra IDに Harness アプリ統合のセットアップがあり、Harness 用に設定しようとしている場合は、SSO を使用して Harness にログインする前に、ユーザー情報もアプリ統合に含まれていることを確認してください。
プロビジョニングのための Harness の設定
Microsoft Entra IDでプロビジョニングを構成するには、Harness で SCIM API トークンを生成する必要があります。 このトークンにより、Microsoft Entra IDは Harness SCIM エンドポイントに安全に接続し、ユーザーをプロビジョニングできます。
Harness 管理コンソールにサインインし、ページの左下隅にあるプロファイルを選択して、[プロファイルの概要] に移動します。
![[プロファイルの概要] を開くために使用したプロファイル メニューを含む Harness 管理コンソールのスクリーンショット。](media/harness-provisioning-tutorial/admin.png)
[ マイ API キー] で 、[ +API キー] を選択します。 API キーを作成するウィンドウが開きます。
![[マイ API キー] の下の [+API キー] ボタンを示す [Harness Profile Overview]\(ハーネス プロファイルの概要\) ページのスクリーンショット。](media/harness-provisioning-tutorial/apikeys.png)
[名前] を指定し、[保存] を選択します。 Harness によって、アカウントの API キーが作成されます。
![[名前] ボックスと [保存] ボタンが表示された [Harness new API key]\(Harness の新しい API キー\) ダイアログのスクリーンショット。](media/harness-provisioning-tutorial/addkey.png)
API キーのトークンを作成するには、新しく作成した API キーの下にある [+Token ] を選択します。
a. 名前を指定し、[ トークンの生成] を選択します。
b。 トークン値を安全な場所にコピーします。 Microsoft Entra IDで接続を構成するには、このトークンが必要です。
c. を選択してを閉じます。
![[トークンの生成] ボタンと [閉じる] ボタンを示す [Harness token]\(ハーネス トークン\) ダイアログのスクリーンショット。](media/harness-provisioning-tutorial/api-token.png)
ギャラリーからの Harness の追加
自動ユーザー プロビジョニングを構成する前に、Microsoft Entra アプリケーション ギャラリーから Harness アプリケーションを追加する必要があります。 これにより、Harness がマネージド SaaS アプリケーションとしてMicrosoft Entra テナントに登録されます。
クラウド アプリケーション管理者以上として Microsoft Entra 管理センターにサインインします。
Entra ID>エンタープライズアプリケーションに移動します。
![[すべてのアプリケーション] リンク](common/enterprise-applications.png)
新しいアプリケーションを追加するには、ウィンドウの上部にある [新しいアプリケーション] ボタンを選びます。
![[新しいアプリケーション] ボタン](common/add-new-app.png)
検索ボックスに「Harness」と入力し、結果一覧から [Harness] を選択してから、 [追加] ボタンを選択してアプリケーションを追加します。
![Harness が選択され、[追加] ボタンが選択されているMicrosoft Entra ギャラリーの検索結果のスクリーンショット。](media/harness-provisioning-tutorial/search-new-app.png)
Harness への自動ユーザー プロビジョニングを構成する
ギャラリーから Harness を追加し、SCIM トークンを生成したら、プロビジョニング接続を構成できます。 このセクションでは、Microsoft Entra IDのユーザーまたはグループの割り当てに基づいて Harness でユーザーまたはグループを作成、更新、無効化するように Microsoft Entra プロビジョニング サービスを構成する手順について説明します。
ヒント
Harness のシングル サインオンに関する記事の手順に従って、Harness の SAML ベースの シングル サインオンを有効にすることもできます。 シングル サインオンは自動ユーザー プロビジョニングとは別に構成できますが、これらの 2 つの機能は相補的な関係にあります。
注
Harness の SCIM エンドポイントの詳細については、Harness の API キーの記事ご覧ください。
Microsoft Entra ID で Harness の自動ユーザー プロビジョニングを構成するには、以下の手順を実行します。
クラウド アプリケーション管理者以上として Microsoft Entra 管理センターにサインインします。
Entra ID>エンタープライズアプリケーションに移動します。
アプリケーションの一覧で [Harness] を選択します。
[プロビジョニング] タブを選択します。
[ + 新しい構成] を選択します。
![[プロビジョニング] タブの [自動] のスクリーンショット。](common/application-provisioning.png)
[管理者資格情報] で、次の操作を行います。
[テナント URL] ボックスに、「
https://app.harness.io/gateway/api/scim/account/<your_harness_account_ID>」と入力します。 Harness にログインすると、ブラウザーの URL から Harness アカウント ID を取得できます。[ シークレット トークン ] ボックスに、「プロビジョニング用の Harness のセットアップ」セクションの手順 3 で保存した SCIM 認証トークンの値を入力します。
[テスト接続] を選択して、Microsoft Entra ID が Harness に接続できることを確認します。 接続できない場合は、使用中の Harness アカウントに "管理者" アクセス許可があることを確認してから、もう一度試します。
[ 作成] を選択して構成を作成します。
[概要] ページで [プロパティ] を選択します。
鉛筆を選択してプロパティを編集します。 通知メールを有効にし、検疫メールを受信する電子メールを提供します。 誤削除防止を有効にします。 適用を選択して、変更を保存します。
左側のパネルで [属性マッピング ] を選択し、ユーザーを選択 します。
[属性マッピング] セクションで、Microsoft Entra ID から Harness に同期されるユーザー 属性 を確認します。 [照合プロパティ] として選択されている属性は、更新操作で Harness のユーザー アカウントとの照合に使用されます。 [保存] ボタンをクリックして変更をコミットします。
![Harness ユーザーの [属性マッピング] ウィンドウ](media/harness-provisioning-tutorial/userattributes.png)
[マッピング] で、[Harness に Microsoft Entra グループを同期する] を選択します。
[属性マッピング]セクションで、Microsoft Entra IDから Harness に同期されるグループ属性を確認します。 [Matching](照合) プロパティとして選択されている属性は、更新操作で Harness のグループとの照合に使用されます。 [保存] ボタンをクリックして変更をコミットします。
![Harness のグループの [属性マッピング] ウィンドウ](media/harness-provisioning-tutorial/groupattributes.png)
スコープ フィルターを構成するには、スコープ フィルターに関する記事に記載されている次の手順 を参照してください。
オンデマンド プロビジョニングを使用して、少数のユーザーとの同期を検証してから、組織内でより広範にデプロイします。
プロビジョニングの準備ができたら、[概要] ページから [プロビジョニングの開始] を選択します。
デプロイを監視する
プロビジョニングを開始したら、プロビジョニング ログを監視して、ユーザーとグループが Microsoft Entra ID と Harness の間で正しく同期されることを確認します。
プロビジョニングを構成したら、次のリソースを使用してデプロイを監視します。
- プロビジョニング ログを使用して、どのユーザーが正常にプロビジョニングされたか、または正常にプロビジョニングされなかったかを判断する
- 進行状況バーを確認して、プロビジョニング サイクルの状態と完了までの近さを確認します
- プロビジョニング構成が異常な状態にあると思われる場合、アプリケーションは検疫に入ります。 検疫状態についての詳細は、アプリケーションプロビジョニングの隔離状態に関する記事をご覧ください。