Azure AD コネクタを使用して従業員をインポートする
この機能では、Azure AD は Web スクリプトを使用して動作しますが、これはまもなく廃止される予定です。 Azure AD インポート機能を引き続き使用するには、「 Azure AD インポート」を参照してください。
役割: ヘルプ デスク管理者
最小バージョン: 2022.4.
パッケージのインストール: 既存のお客様 - Ivanti Marketplace から最新のパッケージをインポートします - Service Manager 用の Azure AD 従業員のインポート。
Azure ポータルから必要な権限を構成および設定する
アプリケーションを作成するには:
- Azure ポータルから、 Azure Active Directory > アプリの登録に移動します。
- 新規登録 をクリックし、アプリケーションの名前を入力します。
- 登録 ボタンをクリックします。
- アプリケーションが作成されると、次の詳細が表示されます。
- クライアント ID - クライアント ID を安全な場所に書き留めておいてください。
- テナント ID - テナント ID を安全な場所に書き留めておいてください。
- クライアントシークレット ID: 一意のクライアントシークレット ID。 作成方法については次の手順を参照してください。
クライアントシークレットIDを作成するには:
- 証明書またはシークレットを追加しますをクリックします。
- クライアント シークレットの下で、新しいクライアント シークレットをクリックし、説明を入力します。
- この クライアント シークレット ID を追加するには、[ 追加] ボタンを選択します。ただし、その前に有効期限が切れるかどうかを確認してください。有効期限を過ぎると、新しい クライアント シークレットを作成する必要があります。
後でアクセスできないように、クライアント シークレットの値を必ずメモして安全な場所に保存してください。
必要な権限を追加するには:
アプリケーションが作成され、前のセクションの情報が記録されたら、次のステップでは、「 権限 」タブで必要な権限を追加します。
- 「オーナー アプリケーション」の「 アプリ登録 」で、前のセクションで作成したアプリケーションを開きます。
- 左側のパネルの「 管理」の下で、「 API 権限」を開きます。
- アクセス許可の追加 > Microsoft Graph > アプリケーションのアクセス許可 > ディレクトリ > Directory.Read.All > アクセス許可の追加を選択します。
- Azure Active Directory > アプリ登録 > 所有者アプリケーションに移動します。
- 所有者アプリケーションの下で、現在のアプリケーションをクリックすると、 クライアント ID、 テナント ID、および クライアント シークレット IDが表示されます。
クライアント シークレット ID を忘れた場合や紛失した場合は、新しい ID を作成する必要があります。
Azure の構成が完了したら、次の手順は 給与責任者 プラットフォームを構成することです。
- 給与責任者に管理者としてログインします。
- 構成コンソールを開きます。
- API キーを生成します:
a. セキュリティ コントロール > API キーに移動します。
b. キー グループの追加 をクリックし、コンテキスト名を入力します。
c. 作成したグループの下の「 API キーの追加 」をクリックし、説明を入力します。
キーを作成するときは、管理者ロールを持つユーザーで作成し、 In Role フィールドが管理者ロールに設定されていることを確認してください。
- [保存]をクリックします。
Azure AD コネクタを使用した従業員のインポートについて包括的に理解するには、Azure AD 従業員コネクタの各フィールドの機能を理解することが重要です。
分野 | 説明 |
|---|---|
有効 | これにより、コネクタは従業員をインポートできるようになります。 |
テストモード | これは、コネクタをテストし、10 人の従業員を同期する場合にのみ使用されます。 テストを実行するたびに、最初の 10 人の従業員のみが同期されます。 |
クライアントID | Azure Portal の「必要な構成/アクセス許可」セクションで説明したとおりです。 |
テナントID | Azure Portal の「必要な構成/アクセス許可」セクションで説明したとおりです。 |
クライアントシークレット | Azure Portal の「必要な構成/アクセス許可」セクションで説明したとおりです。 |
APIキー | これは、Ivanti ITSM から生成され、ITSM と Azure AD 間の通信を認証するために使用される API キーです。 |
主キー | このキーは、Azure から ITSM にデータを同期するための一意の識別子として使用されます。 |
ADフィルター | これは、Azure AD から取得された結果をフィルター処理するために使用されます。 例: 非アクティブなユーザーをインポートしないようにフィルターを追加する場合、フィルター値は次のようになります。 {Azure AD Field} アカウントが有効です フィルターの使用に関する詳細については、Microsoft ドキュメント「 フィルター クエリ パラメーターの使用」を参照してください。 ここで示す例では、* でマークされているものはサポートされていません。これらは高度なクエリ機能の一部です。 |
ISM従業員フィールド | このドロップダウンには、従業員ビジネス オブジェクト内のフィールドのリストが表示されます。 |
Azure AD フィールド | このドロップダウンには、現在 Azure AD から同期できるフィールドのリストが表示されます。 |
固定値 | チェックすると、従業員を同期するための固定値を設定できます。 例: チームは ITSM の必須フィールドですが、Azure からチームに同期する実際の値はないため、同期が機能するように固定値を追加できます。 |
フィールドを更新しない | 追加されたマッピングに対して「 更新しない 」を有効にすると、マッピングで選択された従業員フィールドは、従業員の最初の挿入後に更新されなくなります。 |
- Azure AD 従業員コネクタワークスペースを開きます。
- 有効 チェックボックスをオンにします。
- 管理者アクセス権を持つテナントに API キーを作成します。
- クライアント ID、 クライアント テナント ID、および クライアント シークレットフィールドに値を入力します。
これらの値は、Azure クライアント アカウントから取得できます。
- API キーを入力します。
- 「 以下のオプションを 1 つだけ選択してください 」セクションで、リストされているオプションのいずれかを主キーとして選択します。
必ず 1 つのオプションのみを選択してください。
- AD フィルター - このフィールドを使用して、Azure AD から取得された結果をフィルターするためのフィルターの詳細を入力します。
たとえば、非アクティブなユーザーをインポートから除外するには、次のクエリを入力します。
{Azure AD Field} {Operator} {Value}
アカウントが有効です
フィルターの使用に関する詳細については、Microsoft ドキュメント「 フィルター クエリ パラメーターの使用」を参照してください。
現在、Azure AD ディレクトリ オブジェクトに対する高度なクエリ機能はサポートされていません。 Microsoft ドキュメント 「Azure AD ディレクトリ オブジェクトの高度なクエリ機能」を参照してください。 ドキュメントは利用可能になると更新されます。
- 事前にマップされたフィールドのリストが表示されます。 次の方法でカスタム フィールドを追加できます。
- ISM 従業員フィールド - マップする必要がある ITSM 内のフィールド。
- Azure AD フィールド - マップする必要がある Azure AD 内のフィールド。
- サービス マネージャフィールドに関して Azure AD フィールド に値がない場合は、 固定値フィールドを選択し、値を入力します。
- マッピングの追加をクリックします。 マッピングされたフィールドは、「 フィールド マッピング 」タブに表示されます。
インポートが機能するには、従業員の必須フィールドにマッピングを追加します。
例:
- ISM 従業員フィールド で チーム を選択します。
- では固定されています - 本当です
- 固定値 - QA
QA が組織内のチームでない場合は、既存のチームを既定値として入力します。
フィールドを更新しない - このチェックボックスをオンにすると、フィールドは挿入時に初めてのみ更新されます。 次回以降は無視されます。
- リスト ビューをクリックして保存して終了します。
- アクション メニュー ドロップダウンから、 従業員のインポートの実行を選択します。
- レコードを開いてインポートステータスを確認します。
インポート後、レコードはレコードの「 キュー 」タブに取得されます。 その後、 従業員 ワークスペースに移動します。
- キュー タブをクリックします。 RunOutPut フィールドに エラーなしで完了しましたと表示された場合、インポートは成功しています。
従業員レコードは、 従業員 ワークスペースで取得されます。
IvantiAzure AD Daily Schedule は毎日実行するようにスケジュールされているため、レコードは毎日更新されます。
Azure AD 従業員をインポートしようとしたときに、「 無効な入力 」というエラー メッセージが表示された場合、インポートは失敗したことを意味します。 これは、 Azure AD 従業員コネクタ ワークスペースの サーバー URL フィールド (UI には表示されませんが、バックエンドに存在します) に適切な値が入力されていない場合に発生します。
問題を解決するには:
- Azure AD 従業員コネクタワークスペース リスト ビューから、 SET SERVER URLクイック アクションを実行します。
これにより、「 サーバー URL 」フィールドに適切な値が設定され、問題が解決されます。
