属性値のクリア (プレビュー)

Microsoft Entraプロビジョニングでは、対応するソース属性が null または空の場合に、既存のターゲット属性値をクリアできます。 "null 値のプロビジョニング" とも呼ばれるこの機能は、レコードのシステムから値が削除され、対応する値もターゲット システムから削除する必要がある場合に便利です。

属性値をクリアするための構成は、サポートされているプロビジョニング統合全体で一貫しています。 ただし、ソース スキーマ エディターとソース システムが null 値を表す方法は、統合によって異なる場合があります。

プレビューのスコープと制限事項

• 属性値のクリアは、プレビューで次の目的で利用できます。
  • Microsoft Entra IDとオンプレミスの Active Directoryへの API 主導の受信プロビジョニング。
  • Workday から Microsoft Entra ID とオンプレミス Active Directory への受信型ユーザー プロビジョニング。
  • SAP SuccessFactors から Microsoft Entra ID とオンプレミスの Active Directory へのインバウンド ユーザー プロビジョニング
• 属性値のクリアは、単一値属性でのみサポートされます。
• この機能は、 カスタム セキュリティ属性のプロビジョニングに対して有効にすることができます。
• 現在、Workday ライトバックや SAP SuccessFactors ライトバックなどの送信アプリケーション プロビジョニング シナリオでは、属性値のクリアはサポートされていません。
• 複数値属性のクリアはサポートされていません。

属性値のクリア方法

属性値のクリアは既定で無効になっており、オプトイン機能です。 属性値をクリアするには、2 ゲートセーフガード メカニズムを使用して、偶発的なデータ損失を防ぎます。 ソース属性とそれに対応するターゲット マッピングの両方に対して、 オプション Flow null 値 を有効にする必要があります。

ユーザーの作成時に、null、空、または省略されたソース値は、 null の場合に既定値を構成しない限り、ターゲット属性を設定しません。 既定値は作成時にのみ適用されます。 更新中、プロビジョニング サービスは、作成時の既定値を適用するのではなく、ターゲット値をクリアします。

前提条件

開始する前に次の点を確認します。

• 少なくとも アプリケーション管理者 ロールがあります。
• プロビジョニング アプリケーションとその属性マッピングを構成しました。
• ソース属性はプロビジョニング アプリケーション スキーマに存在し、ターゲット属性マッピングがあります。 詳細については、「Microsoft Entra属性マッピングのカスタマイズ」を参照してください。

オンプレミスの Active Directory への API 駆動型インバウンド プロビジョニングでは、追加のロールとサーバーの前提条件を確認してから、プロビジョニング エージェントと Active Directory 接続を構成します。

HR ドリブン プロビジョニングの場合は、まず、サポートされている受信プロビジョニング アプリのいずれかを構成します。

• Workday からオンプレミスの Active Directory へ。
• Workday から Microsoft Entra ID へ。
• SAP SuccessFactors からオンプレミスの Active Directory へ。
• SAP SuccessFactors から Microsoft Entra ID へ。

ソース属性の null 値フローを有効にする

まず、null 値をフローするようにソース スキーマ属性を構成します。 ソース スキーマ エディターの名前は、プロビジョニング統合によって異なります。

1. 少なくともアプリケーション管理者としてMicrosoft Entra 管理センターにサインインします。
2. Entra ID>エンタープライズアプリケーションに移動します。
3. プロビジョニング アプリケーションを検索して選択します。
4. プロビジョニング>属性マッピング を選択します。
5. 構成するオブジェクトの属性マッピングを開きます。
6. [ 詳細オプション] を展開し、ソース属性リストを編集するオプションを選択します。 オプション名は、ソース システムまたはコネクタを識別します。
7. [フローの null 値] 列で、マッピングされたターゲット属性をクリアできる各ソースの属性のチェック ボックスをオンにします。
8. 保存を選びます。

ターゲット マッピングで null 値フローを有効にする

次に、対応する各ターゲット属性マッピングに対して null 値フローを有効にします。

1. [属性マッピング] ページに戻ります。
2. クリアするターゲット属性のマッピングを選択します。
3. フローの null 値 を選択します。
4. [ OK] を 選択してマッピング エディターを閉じます。
5. [ 保存] を 選択して属性マッピングを保存します。
6. null 値を受け入れる必要があるすべてのターゲット属性に対して、これらの手順を繰り返します。

両方の設定が必要です。 ソース スキーマ属性またはターゲット マッピングに対して Flow の null 値 が選択されていない場合、プロビジョニング サービスはターゲット属性をクリアするために null または空のソース値を使用しません。

API 駆動型のプロビジョニングの例

次の例では、API ドリブンの受信プロビジョニングを構成して属性値をクリアし、 /bulkUpload 要求で null または空の値を送信する方法を示します。

ソース スキーマで null 値フローを有効にする

API ドリブン プロビジョニングの場合は、[ 詳細オプション] を展開し、[ API ユーザー属性の編集] を選択します。 [フローの null 値] 列を見つけて、null または空の値を送信できるソース属性を選択します。 次の例では、SCIM 拡張属性のdivisionとdepartmentに対して Flow null 値が有効になっています。 この設定は、これらの属性の null 値または空の値を処理し、null フローのターゲット属性マッピングを評価するようにプロビジョニング サービスに指示します。

ターゲット マッピングで null 値フローを有効にする

対応する各ターゲット属性マッピングを開き、[ フローの null 値] を選択します。 次の例では、ソース SCIM 拡張属性departmentをActive Directory属性departmentにマップし、フローの null 値を有効にして、ソース SCIM 属性が null または空の場合、department属性値がActive Directoryでクリアされるようにします。

null または空の値を送信する

/bulkUpload要求に属性を含め、その値を JSON nullまたは空の文字列に設定します。

次の抜粋は、一致したユーザーの既存の department と division 値をクリアします。

{
  "schemas": [
    "urn:ietf:params:scim:api:messages:2.0:BulkRequest"
  ],
  "Operations": [
    {
      "method": "POST",
      "bulkId": "00aa00aa-bb11-cc22-dd33-44ee44ee44ee",
      "path": "/Users",
      "data": {
        "schemas": [
          "urn:ietf:params:scim:schemas:core:2.0:User",
          "urn:ietf:params:scim:schemas:extension:enterprise:2.0:User"
        ],
        "externalId": "701984",
        "userName": "bjensen@example.com",
        "urn:ietf:params:scim:schemas:extension:enterprise:2.0:User": {
          "department": null,
          "division": ""
        }
      }
    }
  ],
  "failOnErrors": null
}

プロビジョニング アプリ スキーマのソース属性名を使用します。 externalIdなど、構成に必要な一致する属性が要求に含まれていることを確認します。

要求を送信する手順については、「Graph Explorer を使用した API 主導の受信プロビジョニングのクイック スタート 」または cURL を使用した API 駆動型受信プロビジョニングのクイック スタートを参照してください。

Workday と SAP SuccessFactors のプロビジョニング

Workday と SAP SuccessFactors の受信プロビジョニングの場合、コネクタはプロビジョニング サイクル中に HR システムから属性値を直接取得します。 属性値をクリアする /bulkUpload 要求は送信しません。

1. ソース属性の null 値フローを有効にするの手順に従います。
2. [ 詳細オプション] で、[ Workday の属性リストの編集] または [SuccessFactors の属性リストの編集] を選択します。
3. マップされたターゲット 値を 削除する必要がある null または空の値を持つソース属性ごとに、フローの null 値のみを選択します。
4. 対応する各ターゲット属性の ターゲット マッピングで null 値フローを有効にする の手順に従います。
5. Workday または SAP SuccessFactors の値をクリアします。
6. 次のプロビジョニング サイクルでソースの変更を処理するか、 オンデマンドでプロビジョニング を使用して特定のユーザーをテストできるようにします。

Workday は XPath 式を使用し、SAP SuccessFactors は JSONPath 式を使用してソース属性を取得します。 プロビジョニング サービスが null または空の値を評価するには、この属性がプロビジョニング アプリ スキーマに存在し、コネクタによって取得される必要があります。

null 値または空の値が、値をクリアする代わりにフォールバック値で補完されるか、既存のターゲット値を保持する必要がある場合は、「HR ユーザー更新の問題のトラブルシューティング」を参照してください。

属性がクリアされたことを確認する

プロビジョニング サービスがソースの更新を処理した後、プロビジョニング ログとターゲット ディレクトリの結果を確認します。

1. プロビジョニング アプリで、[ プロビジョニング ログ] を選択します。

2. ユーザーのプロビジョニング イベントを開きます。

3. [ 変更されたプロパティ ] タブを選択します。

4. ターゲット属性に空の新しい値が表示されていることを確認します。

   

5. 属性がターゲット システムのオブジェクトに値を持たなくなったことを確認します。

このオンプレミスの Active Directory例では、API ソース属性divisionターゲット属性companyにマップされます。 オンプレミスの Active Directoryの場合、プロビジョニング サービスは空の文字列を書き込む代わりに属性値を削除します。

属性値のクリアに関するトラブルシューティング

ターゲット属性がクリアされない場合は、次のガイダンスを使用します。

次のステップ

• Microsoft Entra属性マッピングをカスタマイズする
• API 駆動インバウンド プロビジョニングの概念
• API 駆動型のインバウンド プロビジョニングに関するよくあるご質問
• API 主導の受信プロビジョニングのトラブルシューティング
• Microsoft Entra IDと Workday の統合リファレンス
• Microsoft Entra ID と SAP SuccessFactors の統合リファレンス
• HR ユーザー作成に関する問題のトラブルシューティング
• HR ユーザーの更新に関する問題のトラブルシューティング