PowerShell スクリプトを使用した API 駆動型インバウンドプロビジョニング

[アーティクル]
02/28/2024

このチュートリアルでは、PowerShell スクリプトを使用して Microsoft Entra ID の API 駆動型インバウンドプロビジョニングを実装する方法について説明します。このチュートリアルの手順を使用して、人事データを含む CSV ファイルを一括要求ペイロードに変換して、Microsoft Entra のプロビジョニング /bulkUpload API エンドポイントに送信できます。この記事では、同じ統合パターンがレコードの任意のシステムでどのように使用できるかに関するガイダンスも提供します。

統合シナリオ

業務要件

お客様のレコードのシステムでは、ワーカーデータを含む CSV ファイルのエクスポートが定期的に生成されます。 CSV ファイルからデータを読み取り、ターゲットディレクトリにユーザーアカウントを自動的にプロビジョニングする統合を実装する必要があります (ハイブリッドユーザーの場合はオンプレミスの Active Directory、クラウド専用ユーザーの場合は Microsoft Entra ID)。

実装要件

実装の観点から:

自動 PowerShell スクリプトを使用して、CSV ファイルエクスポートからデータを読み取り、インバウンドプロビジョニング API エンドポイントに送信する必要があります。
PowerShell スクリプトでは、レコードのシステムとターゲットディレクトリの間で ID データを比較する複雑なロジックを実装したくはありません。
Microsoft Entra プロビジョニングサービスを使用して、IT マネージドプロビジョニングルールを適用して、ターゲットディレクトリ (オンプレミスの Active Directory または Microsoft Entra ID) でアカウントを自動的に作成、更新、有効化、無効化する必要があります。

統合シナリオのバリエーション

このチュートリアルでは CSV ファイルをレコードのシステムとして使用しますが、サンプル PowerShell スクリプトをカスタマイズして、レコードの任意のシステムからデータを読み取ることができます。 PowerShell スクリプトを使用して API 駆動型インバウンドプロビジョニングを実装できるエンタープライズ統合シナリオのバリエーションの一覧を次に示します。

#	レコードのシステム	PowerShell を使用したソースデータの読み取りに関する統合ガイダンス
1	[データベーステーブル]	Azure SQL データベースまたはオンプレミスの SQL Server を使用している場合は、Read-SqlTableData コマンドレットを使用して、SQL データベースのテーブルに保存されているデータを読み取ることができます。 Invoke-SqlCmd コマンドレットを使用して、Transact-SQL または XQuery スクリプトを実行できます。 Oracle/MySQL/Postgres データベースを使用している場合は、ベンダーによって公開されているか、PowerShell ギャラリーで入手可能な PowerShell モジュールを見つけることができます。モジュールを使用して、データベーステーブルからデータを読み取ります。
2	LDAP サーバー	`System.DirectoryServices.Protocols` .NET API または PowerShell ギャラリーで入手可能な LDAP モジュールのいずれかを使用して、LDAP サーバーに対してクエリを実行します。 LDAP サーバーからユーザーデータを取得するための LDAP スキーマと階層について理解します。
3	REST API を公開するすべてのシステム	PowerShell を使用して REST API エンドポイントからデータを読み取る場合は、`Microsoft.PowerShell.Utility` モジュールから Invoke-RestMethod コマンドレットを使用できます。 REST API のドキュメントを確認し、これが想定しているパラメーターとヘッダー、返す形式、および使用する認証方法を確認します。その後、それに応じて `Invoke-RestMethod` コマンドを調整できます。
4	SOAP API を公開する任意のシステム	PowerShell を使用して SOAP API エンドポイントからデータを読み取る場合は、`Microsoft.PowerShell.Management` モジュールから New-WebServiceProxy コマンドレットを使用できます。 SOAP API のドキュメントを確認し、これが想定しているパラメーターとヘッダー、返す形式、および使用する認証方法を確認します。その後、それに応じて `New-WebServiceProxy` コマンドを調整できます。

ソースデータを読み取った後、前処理ルールを適用し、レコードのシステムからの出力をMicrosoft Entra をプロビジョニングする bulkUpload API エンドポイントに送信できる一括要求に変換します。

重要

自分の PowerShell 統合スクリプトをコミュニティと共有したい場合は、それを PowerShell ギャラリーで公開し、Microsoft がそれへの参照を追加できるように GitHub リポジトリ entra-id-inbound-provisioning 上で Microsoft に通知してください。

このチュートリアルの使用方法

Microsoft Entra インバウンドプロビジョニング GitHub リポジトリで公開されている PowerShell サンプルスクリプトは、いくつかのタスクを自動化します。これには、大きな CSV ファイルを処理し、一括要求をチャンクして要求ごとに 50 個のレコードを送信するためのロジックがあります。これをテストし、自分の統合要件に従ってカスタマイズする方法を次に示します。

注意

実装の参照のため、サンプルの PowerShell スクリプトはそのままの状態で提供されています。スクリプトに関する質問があるか、スクリプトを拡張する場合は、「GitHub プロジェクトリポジトリ」を使用してください。

#	自動化タスク	実装ガイダンス	高度なカスタマイズ
1	CSV ファイルからワーカーデータを読み取る。	PowerShell スクリプトをダウンロードします。任意の CSV ファイルからデータを読み取るためにすぐに使用できるロジックが含まれています。このスクリプトのさまざまな実行モードの詳細については、「CSV2SCIM PowerShell の使用の詳細」をご覧ください。	レコードのシステムが異なる場合は、「統合シナリオのバリエーション」セクションで提供されている、PowerShell スクリプトをカスタマイズする方法に関するガイダンスを確認してください。
2	データを前処理して SCIM 形式に変換する。	既定では、PowerShell スクリプトは CSV ファイル内の各レコードを SCIM コアユーザーとエンタープライズユーザー表現に変換します。このプロセスの詳細を把握するには、「標準スキーマを使用して一括要求ペイロードを生成する」のセクションの手順に従います。	CSV ファイルに異なるフィールドがある場合、AttributeMapping.psd ファイルを調整して有効な SCIM ユーザーを生成します。カスタム SCIM スキーマを使用して一括要求を生成することもできます。 PowerShell スクリプトを更新して、任意のカスタムの CSV データの入力規則ロジックを含めます。
3	Microsoft Entra ID への認証に証明書を使用する。	インバウンドプロビジョニング API にアクセスできるサービスプリンシパルを作成します。認証にクライアント証明書を使用する方法の詳細については、「サービスプリンシパル認証用にクライアント証明書を構成する」のセクションの手順をご覧ください。	認証にサービスプリンシパルではなくマネージド ID を使用する場合、サンプルスクリプトで `Connect-MgGraph` の使用を確認し、マネージド ID を使用するように更新します。
4	オンプレミスの Active Directory または Microsoft Entra ID でアカウントをプロビジョニングする。	API 駆動型インバウンドプロビジョニングアプリを構成します。これにより、一意の /bulkUpload API エンドポイントが生成されます。このエンドポイントにデータをアップロードする方法の詳細については、「管理者ユーザーとして一括要求ペイロードを生成してアップロードする」のセクションの手順をご覧ください。属性フローを検証して、統合の要件に従って属性マッピングをカスタマイズします。証明書ベースの認証でサービスプリンシパルを使用してスクリプトを実行するには、「クライアント証明書認証を使用して一括要求ペイロードをアップロードする」のセクションの手順をご覧ください	カスタム SCIM スキーマで一括要求を使用する場合、プロビジョニングアプリスキーマを拡張してカスタム SCIM スキーマ要素を含めます。
5	プロビジョニングログをスキャンして、失敗したレコードのプロビジョニングを再試行します。	プロビジョニングログのデータをフェッチして分析する方法の詳細については、「最新の同期サイクルのプロビジョニングログを取得する」のセクションの手順をご覧ください。失敗したユーザーレコードを特定し、次のアップロードサイクルに含めます。	-
6	運用環境に PowerShell ベースの自動化をデプロイする。	API 駆動型プロビジョニングフローを確認して要件を満たすように PowerShell スクリプトをカスタマイズしたら、その自動化を Azure Automation の PowerShell ワークフロー Runbook として、または Windows サーバーで実行されるようにスケジュールされたサーバープロセスとしてデプロイできます。	-

PowerShell スクリプトをダウンロードする

GitHub リポジトリ entra-id-inbound-provisioning にアクセスします。
[コード] ->[複製] または [コード] ->[ZIP のダウンロード] オプションを使用して、このリポジトリのコンテンツをローカルフォルダーにコピーします。
PowerShell/CSV2SCIM のフォルダーに移動します。次のディレクトリ構造があります。
- src
  - CSV2SCIM.ps1 (メインスクリプト)
  - ScimSchemaRepresentations (AttributeMapping.psd1 ファイルを検証するための標準の SCIM スキーマ定義を含むフォルダー)
    - EnterpriseUser.json、Group.json、Schema.json、User.json
- サンプル
  - AttributeMapping.psd1 (CSV ファイル内の列の標準の SCIM 属性へのマッピングのサンプル)
  - csv-with-2-records.csv (2 つのレコードを含むサンプルの CSV ファイル)
  - csv-with-1000-records.csv (1000 個のレコードを含むサンプルの CSV ファイル)
  - Test-ScriptCommands.ps1 (使用コマンドのサンプル)
  - UseClientCertificate.ps1 (自己署名証明書を生成し、OAuth フローで使用するためのサービスプリンシパルとしてアップロードするスクリプト)
  - Sample1 (CSV ファイルの列を SCIM 標準属性にマップする方法のその他の例を含むフォルダー。従業員、請負業者、インターン用に異なる CSV ファイルを取得すると、エンティティごとに個別の AttributeMapping.psd1 ファイルを作成できます。)
最新バージョンの PowerShell をダウンロードしてインストールします。
コマンドを実行して、リモート署名済みのスクリプトの実行を有効にします。
```
set-executionpolicy remotesigned
```

次の前提条件モジュールをインストールします。

Install-Module -Name Microsoft.Graph.Applications,Microsoft.Graph.Reports

標準スキーマを使用して一括要求ペイロードを生成する

このセクションでは、CSV ファイルからの標準 SCIM コアユーザー属性およびエンタープライズユーザー属性を使用して一括要求ペイロードを生成する方法について説明します。手順を説明するために、CSV ファイル Samples/csv-with-2-records.csv を使用しましょう。

CSV ファイル Samples/csv-with-2-records.csv を Notepad++ または Excel で開き、ファイルに存在する列をチェックします。

Notepad++ または Visual Studio Code などのソースコードエディターで、CSV ファイルの列を SCIM 標準スキーマ属性にマッピングできるようにする PowerShell データファイル Samples/AttributeMapping.psd1 を開きます。すぐに使用できる状態で出荷されたファイルには、CSV ファイルの列の対応する SCIM スキーマ属性への事前構成済みのマッピングが既に含まれています。

    @{
    externalId   = 'WorkerID'
    name         = @{
        familyName = 'LastName'
        givenName  = 'FirstName'
    }
    active       = { $_.'WorkerStatus' -eq 'Active' }
    userName     = 'UserID'
    displayName  = 'FullName'
    nickName     = 'UserID'
    userType     = 'WorkerType'
    title        = 'JobTitle'
    addresses    = @(
        @{
            type          = { 'work' }
            streetAddress = 'StreetAddress'
            locality      = 'City'
            postalCode    = 'ZipCode'
            country       = 'CountryCode'
        }
    )
    phoneNumbers = @(
        @{
            type  = { 'work' }
            value = 'OfficePhone'
        }
    )
    "urn:ietf:params:scim:schemas:extension:enterprise:2.0:User" = @{
        employeeNumber = 'WorkerID'
        costCenter     = 'CostCenter'
        organization   = 'Company'
        division       = 'Division'
        department     = 'Department'
        manager        = @{
            value = 'ManagerID'
        }
    }
}

PowerShell を開き、ディレクトリ CSV2SCIM\src に変更します。

次のコマンドを実行して、AttributeMapping 変数を初期化します。

$AttributeMapping = Import-PowerShellDataFile '..\Samples\AttributeMapping.psd1'

次のコマンドを実行して、AttributeMapping ファイルに有効な SCIM スキーマ属性があるかどうかを検証します。検証に成功すると、このコマンドは True を返します。
```
.\CSV2SCIM.ps1 -Path '..\Samples\csv-with-2-records.csv' -AttributeMapping $AttributeMapping -ValidateAttributeMapping
```
AttributeMapping ファイルに userId という無効な SCIM 属性があり、ValidateAttributeMapping モードに次のエラーが表示されるとします。
AttributeMapping ファイルが有効であることを確認したら、次のコマンドを実行して、CSV ファイルに存在する 2 つのレコードを含む一括要求を BulkRequestPayload.json というファイルに生成します。
```
.\CSV2SCIM.ps1 -Path '..\Samples\csv-with-2-records.csv' -AttributeMapping $AttributeMapping > BulkRequestPayload.json
```
ファイル BulkRequestPayload.json のコンテンツを開いて、SCIM 属性がファイル AttributeMapping.psd1 で定義されているマッピングに従って設定されているかどうかを確認できます。
上記で生成されたファイルは、Graph Explorer、Postman または cURL を使用して、プロビジョニングアプリに関連付けられている /bulkUpload API エンドポイントにそのままの状態で投稿できます。リファレンス:
同じ PowerShell スクリプトを使用して、生成されたペイロードを API エンドポイントに直接アップロードするには、次のセクションをご覧ください。

管理者ユーザーとして一括要求ペイロードを生成してアップロードする

このセクションでは、生成された一括要求ペイロードをインバウンドプロビジョニング API エンドポイントに送信する方法について説明します。

少なくともアプリケーション管理者として Microsoft Entra 管理センターにログインしてください。
[プロビジョニングアプリ]>[プロパティ]>[オブジェクト ID] の順に参照し、プロビジョニングアプリに関連付けられている ServicePrincipalId をコピーします。
全体管理者ロールを持つユーザーとして、次のコマンドの ServicePrincipalId と TenantId に正しい値を指定して実行します。このテナントに対して認証済みセッションがまだ存在しない場合、認証を求めるメッセージが表示されます。認証時に求められるアクセス許可に同意します。
```
.\CSV2SCIM.ps1 -Path '..\Samples\csv-with-2-records.csv' -AttributeMapping $AttributeMapping -ServicePrincipalId <servicePrincipalId> -TenantId "contoso.onmicrosoft.com"
```
上記の要求の処理を確認するには、プロビジョニングアプリの [プロビジョニングログ] ブレードにアクセスします。

サービスプリンシパル認証用にクライアント証明書を構成する

注意

こちらの手順では、自己署名証明書を生成する方法を示します。自己署名証明書は、既定では信頼されないため、管理が困難になる可能性があります。また、強力でない可能性のある旧式のハッシュや暗号スイートが使用される場合もあります。セキュリティを強化するには、よく知られている証明機関によって署名された証明書を購入してください。

次の PowerShell スクリプトを実行して、新しい自己署名証明書を生成します。既知の証明機関によって署名された証明書を購入した場合、この手順をスキップできます。
```
$ClientCertificate = New-SelfSignedCertificate -Subject 'CN=CSV2SCIM' -KeyExportPolicy 'NonExportable' -CertStoreLocation Cert:\CurrentUser\My
$ThumbPrint = $ClientCertificate.ThumbPrint
```
生成された証明書は Current User\Personal\Certificates に保存されます。 [コントロールパネル] ->[ユーザー証明書の管理] オプションを使用して表示できます。
この証明書を有効なサービスプリンシパルに関連付けるには、アプリケーション管理者として Microsoft Entra 管理センターにログインします。
[アプリの登録] で構成したサービスプリンシパルを開きます。
[概要] ブレードから [オブジェクト ID] をコピーします。この値を使用して文字列 <AppObjectId> を置き換えます。 [アプリケーション (クライアント) ID] をコピーします。この ID は後で使用し、<AppClientId> として参照します。
次のコマンドを実行して、登録済みのサービスプリンシパルに証明書をアップロードします。
```
Connect-MgGraph -Scopes "Application.ReadWrite.All"
Update-MgApplication -ApplicationId '<AppObjectId>' -KeyCredentials @{
   Type = "AsymmetricX509Cert"
   Usage = "Verify"
   Key = $ClientCertificate.RawData
}
```
証明書は、登録済みアプリの [証明書とシークレット] ブレードに表示されます。
Application.Read.All および Synchronization.Read.All の 2 つのアプリケーション アクセス許可スコープをサービスプリンシパルアプリに追加します。これらは、PowerShell スクリプトがプロビジョニングアプリを ServicePrincipalId で検索し、プロビジョニング JobId をフェッチするために必要です。

クライアント証明書認証を使用して一括要求ペイロードをアップロードする

このセクションでは、信頼されたクライアント証明書を使用して、生成された一括要求ペイロードをインバウンドプロビジョニング API エンドポイントに送信する方法について説明します。

構成した API 駆動型プロビジョニングアプリを開きます。プロビジョニングアプリに関連付けられている ServicePrincipalId を [プロビジョニングアプリ]>[プロパティ]>[オブジェクト ID] からコピーします。

ServicePrincipalId、ClientId、TenantId に正しい値を指定して、次のコマンドを実行します。

$ClientCertificate = Get-ChildItem -Path cert:\CurrentUser\my\ | Where-Object {$_.Subject -eq "CN=CSV2SCIM"}  
$ThumbPrint = $ClientCertificate.ThumbPrint

.\CSV2SCIM.ps1 -Path '..\Samples\csv-with-2-records.csv' -AttributeMapping $AttributeMapping -TenantId "contoso.onmicrosoft.com" -ServicePrincipalId "<ProvisioningAppObjectId>" -ClientId "<AppClientId>" -ClientCertificate (Get-ChildItem Cert:\CurrentUser\My\$ThumbPrint)

上記の要求の処理を確認するには、プロビジョニングアプリの [プロビジョニングログ] ブレードにアクセスします。

カスタム SCIM スキーマを使用して一括要求を生成する

このセクションでは、カスタム SCIM スキーマ名前空間を使用して、CSV ファイル内のフィールドから成る一括要求を生成する方法について説明します。

Notepad++ または Visual Studio Code などのソースコードエディターで、CSV ファイルの列を SCIM 標準スキーマ属性にマッピングできるようにする PowerShell データファイル Samples/AttributeMapping.psd1 を開きます。すぐに使用できる状態で出荷されたファイルには、CSV ファイルの列の対応する SCIM スキーマ属性への事前構成済みのマッピングが既に含まれています。
PowerShell を開き、ディレクトリ CSV2SCIM\src に変更します。

次のコマンドを実行して、AttributeMapping 変数を初期化します。

$AttributeMapping = Import-PowerShellDataFile '..\Samples\AttributeMapping.psd1'

次のコマンドを実行して、AttributeMapping ファイルに有効な SCIM スキーマ属性があるかどうかを検証します。検証に成功すると、このコマンドは True を返します。
```
.\CSV2SCIM.ps1 -Path '..\Samples\csv-with-2-records.csv' -AttributeMapping $AttributeMapping -ValidateAttributeMapping
```
SCIM コアユーザー属性およびエンタープライズユーザー属性に加えて、カスタム SCIM スキーマ名前空間 urn:ietf:params:scim:schemas:extension:contoso:1.0:User ですべての CSV フィールドのフラットリストを取得するには、次のコマンドを実行します。
```
 .\CSV2SCIM.ps1 -Path '..\Samples\csv-with-2-records.csv' -AttributeMapping $AttributeMapping -ScimSchemaNamespace "urn:ietf:params:scim:schemas:extension:contoso:1.0:User"  > BulkRequestPayloadWithCustomNamespace.json
```
カスタム SCIM スキーマ名前空間の下に CSV フィールドが表示されます。

プロビジョニングジョブスキーマを拡張する

多くの場合、人事チームによって送信されるデータファイルには、標準 SCIM スキーマで直接表現されていない属性が多く含まれています。このような属性を表現するために、SCIM 拡張スキーマを作成して、この名前空間の下に属性を追加することをお勧めします。

CSV2SCIM スクリプトは、UpdateSchema という実行モードを提供します。これは、CSV ファイル内のすべての列を読み取り、拡張スキーマ名前空間の下に追加し、プロビジョニングアプリスキーマを更新します。

注意

プロビジョニングアプリスキーマに属性拡張機能が既に存在する場合、このモードでは属性拡張機能が既に存在するという警告だけが出力されます。そのため、新しいフィールドが CSV ファイルに追加され、それらを拡張機能として追加する場合、UpdateSchema モードで CSV2SCIM スクリプトを実行しても問題ありません。

手順を説明するために、CSV2SCIM フォルダーに存在する CSV ファイル Samples/csv-with-2-records.csv を使用します。

CSV ファイル Samples/csv-with-2-records.csv を Notepad、Excel または TextPad で開いて、ファイルに存在する列を確認します。

次のコマンドを実行します。

.\CSV2SCIM.ps1 -Path '..\Samples\csv-with-2-records.csv' -UpdateSchema -ServicePrincipalId <servicePrincipalId> -TenantId "contoso.onmicrosoft.com" -ScimSchemaNamespace "urn:ietf:params:scim:schemas:extension:contoso:1.0:User"

[属性マッピング] ページを開き、[詳細オプション] の [API の属性リストの編集] にアクセスして、プロビジョニングアプリスキーマの更新を確認できます。
[属性リスト] には、新しい名前空間の下に属性が表示されます。

付録

CSV2SCIM PowerShell の使用の詳細

CSV2SCIM PowerShell スクリプトで受け入れられるコマンドラインパラメーターの一覧を次に示します。

PS > CSV2SCIM.ps1 -Path <path-to-csv-file> 
[-ScimSchemaNamespace <customSCIMSchemaNamespace>] 
[-AttributeMapping $AttributeMapping] 
[-ServicePrincipalId <spn-guid>] 
[-ValidateAttributeMapping]
[-UpdateSchema]
[-ClientId <client-id>]
[-ClientCertificate <certificate-object>]
[-RestartService]

注意

AttributeMapping と ValidateAttributeMapping のコマンドラインパラメーターは、CSV 列属性の標準 SCIM スキーマ要素へのマッピングを参照します。ソース SCIM スキーマ要素とターゲット Microsoft Entra/オンプレミスの Active Directory 属性の間で Microsoft Entra 管理センターのプロビジョニングアプリで実行する属性マッピングは参照しません。

パラメーター	説明	処理に関する解説
パス	CSV ファイルへの完全パスまたは相対パス。例: `.\Samples\csv-with-1000-records.csv`	必須: はい
ScimSchemaNamespace	CSV ファイル内のすべての列を、特定の名前空間に属するカスタム SCIM 属性として送信するために使用するカスタム SCIM スキーマ名前空間。たとえば、`urn:ietf:params:scim:schemas:extension:csv:1.0:User`	必須: 次のことを実行する場合のみ: - プロビジョニングアプリスキーマを更新するか、カスタム SCIM 属性をペイロードに含める場合。
AttributeMapping	CSV ファイル内の列を SCIM コアユーザー属性およびエンタープライズユーザー属性にマップする PowerShell データ (.psd1 拡張機能) ファイルを指します。 CSV2SCIM スクリプトの AttributeMapping.psd ファイルの例をご覧ください。たとえば、次のように入力します。 powershell $AttributeMapping = Import-PowerShellDataFile '.\Samples\AttributeMapping.psd1'`-AttributeMapping $AttributeMapping	必須: はいこれを指定する必要がない唯一のシナリオは、`UpdateSchema` スイッチを使用する場合のみです。
ValidateAttributeMapping	スイッチフラグを使用して、AttributeMapping ファイルに SCIM コアおよびエンタープライズユーザースキーマに準拠した属性が含まれていることを検証します。	必須: いいえコンプライアンスを確保するために使用することをお勧めします。
ServicePrincipalId	[プロビジョニングアプリ]>[プロパティ]>[オブジェクト ID] で取得できる、プロビジョニングアプリのサービスプリンシパル ID の GUID 値	必須: 次のことを実行する場合のみ: - プロビジョニングアプリスキーマを更新するか、生成された一括要求を API エンドポイントに送信する場合。
UpdateSchema	このスイッチを使用して、CSV 列を読み取り、プロビジョニングアプリスキーマにカスタム SCIM 属性として追加するようにスクリプトに指示します。
ClientId	OAuth 認証フローに使用する Microsoft Entra 登録済みアプリのクライアント ID。このアプリには、有効な証明書の資格情報が必要です。	必須: 証明書ベースの認証を実行する場合のみ。
ClientCertificate	OAuth フロー中に使用するクライアント認証証明書。	必須: 証明書ベースの認証を実行する場合のみ。
GetPreviousCycleLogs	最新の動機サイクルのプロビジョニングログを取得します。
NumberOfCycles	取得する必要がある同期サイクルの数を指定します。既定では、この値は 1 です。
RestartService	このオプションを使用すると、スクリプトはデータをアップロードする前にプロビジョニングジョブを一時停止し、データをアップロードしてからジョブを再開して、ペイロードが即時処理されるようにします。	このオプションは、テスト中にのみ使用します。

AttributeMapping.psd ファイル

このファイルは、CSV ファイル内の列を標準の SCIM コアユーザー属性およびエンタープライズユーザー属性スキーマ要素にマップするために使用されます。また、このファイルは、CSV ファイルの内容を一括要求ペイロードとして適切に表現します。

次の例では、CSV ファイルの次の列が対応する SCIM コアユーザー属性およびエンタープライズユーザー属性にマップされています。

    @{
    externalId   = 'WorkerID'
    name         = @{
        familyName = 'LastName'
        givenName  = 'FirstName'
    }
    active       = { $_.'WorkerStatus' -eq 'Active' }
    userName     = 'UserID'
    displayName  = 'FullName'
    nickName     = 'UserID'
    userType     = 'WorkerType'
    title        = 'JobTitle'
    addresses    = @(
        @{
            type          = { 'work' }
            streetAddress = 'StreetAddress'
            locality      = 'City'
            postalCode    = 'ZipCode'
            country       = 'CountryCode'
        }
    )
    phoneNumbers = @(
        @{
            type  = { 'work' }
            value = 'OfficePhone'
        }
    )
    "urn:ietf:params:scim:schemas:extension:enterprise:2.0:User" = @{
        employeeNumber = 'WorkerID'
        costCenter     = 'CostCenter'
        organization   = 'Company'
        division       = 'Division'
        department     = 'Department'
        manager        = @{
            value = 'ManagerID'
        }
    }
}

PowerShell スクリプトを使用した API 駆動型インバウンドプロビジョニング

統合シナリオ

業務要件

実装要件

統合シナリオのバリエーション

このチュートリアルの使用方法

PowerShell スクリプトをダウンロードする

標準スキーマを使用して一括要求ペイロードを生成する

管理者ユーザーとして一括要求ペイロードを生成してアップロードする

サービスプリンシパル認証用にクライアント証明書を構成する

クライアント証明書認証を使用して一括要求ペイロードをアップロードする

カスタム SCIM スキーマを使用して一括要求を生成する

プロビジョニングジョブスキーマを拡張する

最新の同期サイクルのプロビジョニングログを取得する

付録

CSV2SCIM PowerShell の使用の詳細

AttributeMapping.psd ファイル

次のステップ

その他のリソース

PowerShell スクリプトを使用した API 駆動型インバウンド プロビジョニング

統合シナリオ

業務要件

実装要件

統合シナリオのバリエーション

このチュートリアルの使用方法

PowerShell スクリプトをダウンロードする

標準スキーマを使用して一括要求ペイロードを生成する

管理者ユーザーとして一括要求ペイロードを生成してアップロードする

サービス プリンシパル認証用にクライアント証明書を構成する

クライアント証明書認証を使用して一括要求ペイロードをアップロードする

カスタム SCIM スキーマを使用して一括要求を生成する

プロビジョニング ジョブ スキーマを拡張する

最新の同期サイクルのプロビジョニング ログを取得する

付録

CSV2SCIM PowerShell の使用の詳細

AttributeMapping.psd ファイル

次のステップ

その他のリソース

PowerShell スクリプトを使用した API 駆動型インバウンドプロビジョニング

サービスプリンシパル認証用にクライアント証明書を構成する

プロビジョニングジョブスキーマを拡張する

最新の同期サイクルのプロビジョニングログを取得する