Workday 認証情報でデータ エージェントおよびスクリプト エディタにログイン
この記事の一部のリンクは Workday Community に移動します。Community のアカウントをお持ちでない方は、リクエストしてください。
次の条件を満たす場合、エージェントの作成時に Workday 認証情報で Adaptive データ エージェントにログインすることができます。
- Workday テナントからユーザー同期が完了する。
- データ エージェントの API クライアントを登録し、Workday Adaptive Planning データ エージェント マネージャにその情報を提供する。
このプロセスでは、次の 2 つの異なる Workday API 登録付与タイプが必要です。
- Adaptive Planning ユーザーによるユーザー インターフェイス ログインのために、データ エージェントをプロビジョニングするための認証コード付与。
- エージェントをプロビジョニングした後、Adaptive Planning ユーザー インターフェイス ログインに依存しないインテグレーション サービス アカウントとして、非ユーザー インターフェイス トークンに対する JWT Bearer 付与が行われます。
前提条件
Adaptive Planning の場合
セキュリティ: "データ デザイナー" 権限
Workday の場合
- API クライアントを登録するには、セキュリティが必要です。
- "テナント設定" レポートの"Adaptive Planning"タブで公開 API を有効化します。ステップ: HCM と財務管理に向けた Adaptive Planning の設定を参照してください。
- Data Agent v12.0.240 以降の場合は、ISU を作成します。ステップ: ユーザーの同期後に Planning データ ソースを有効にする のISU のステップを参照してください。データ エージェント 12.0.240 以降では、サインインするユーザーに Workday の"Setup: Adaptive Planning API Access"ドメイン セキュリティ ポリシーは必要ありません。
- ISU を Adaptive ISU セキュリティ グループに割り当てます。
データ エージェントおよび Workday Adaptive Planning データ エージェント マネージャをホストするネットワークの場合
- ファイアウォールおよびネットワーク設定が Workday IP アドレスにアクセスできることを確認します。参照 Adaptive Planning のドメインおよび IP アドレス。
Workday Adaptive Planning データ エージェント マネージャに Workday API クライアントの詳細を入力
- Workday テナント設定の"Adaptive Insights"タブ内で、"公開 API の有効化" がオンにされていることを確認します。
- 特にデータ エージェントのために Workday で API クライアントを登録します。これにはBearerアクセス トークンと"承認コード付与"を使用します。この認証コード付与は、エージェント サービスへのログイン、およびユーザー インターフェイスでのエージェントのプロビジョニングに使用されます。API クライアントの登録を参照してください。
- "無期限のリフレッシュ トークン"を選択します。
- 適用範囲 (業務分野)を"システム"に設定し、"Adaptive Planning"を追加します。
- "OK"を選択すると、キー、シークレット、および新しいインテグレーション クライアントを識別するその他の詳細情報が生成されます。
- 認証エンド ポイント、トークン エンド ポイント、クライアント ID、およびクライアント シークレットをコピーし、データ エージェント マネージャが起動したら入力します。
- ローカル コンピュータ上で Workday Adaptive Planning データ エージェント マネージャを開始します。
- "Diagnose and Configure Network"を選択します。
- "Workday"タブを選択します。
- API クライアントを Workday で登録した時に生成された以下の情報を入力します。
- 認証エンド ポイント
- トークン エンド ポイント
- Workday からコピーされたクライアント ID
- Workday からコピーされたクライアント シークレット
- リダイレクト URL は、リダイレクト URIと一致している必要がありますhttps://www.workday.comAPI クライアントの登録時に入力したもの。
- "Sign in with Workday"を選択し、データ エージェント マネージャにサインインします。データ エージェント 12.0.240 以降では、サインインするユーザーに Workday の "Setup: Adaptive Planning API Access" ドメインのセキュリティ ポリシーは必要ありません。
- データ エージェント 12.0.239 以前を使用している場合は、ここまでです。データ エージェント 12.0.240 以降の場合は、次のステップに進みます。
- "Diagnose and Configure Network Options"を選択します。
- "Workday インテグレーション"タブを選択します。
- "Workday インテグレーション" タブを設定し、データ エージェント用に Workday で API クライアントを登録します。API クライアントの登録を参照してください。API クライアントを登録するとき、Adaptive Planning ユーザー インターフェイス ログイン ユーザーに依存しないユーザー インターフェイス以外のトークン交換には、JWT Bearerアクセス トークンを使用します。
- "x509 Certificate"セクションで"Create x509 Public Key"を選択して名前を指定し、Workday Adaptive Planning データ エージェント マネージャの"Workday インテグレーション"タブからコピーした証明書を貼り付けます。
- 適用範囲 (業務分野) を"システム"に設定し、"Adaptive Planning"を追加します。
- "OK"を選択すると、クライアント ID、トークン エンド ポイント、および新しいインテグレーション クライアントを識別するその他の詳細情報が生成されます。
- クライアント IDとトークン エンド ポイントをコピーします。Workday Adaptive Planning データ エージェント マネージャを開始すると、これらが必要になります。
- Workday で"JWT Bearer"アクセス トークンの API クライアントを登録したときに生成された以下の情報を入力します。
- クライアント ID(Workday からコピー)。
- からコピーされたISU(Adaptive Planning 公開 API)。必要に応じて、管理者に ISU の提供を依頼します。
- Workday からコピーされたトークン エンド ポイント。
- 証明書(読み取り専用)。
- "Workday インテグレーション設定の適用"を選択します。
- Workday 認証情報で Adaptive スクリプト エディタにログイン
- データ エージェントの API クライアント情報を入力すれば、それを Adaptive スクリプト エディタの Workday タブにコピーすることができます。
- ローカル コンピュータ上で Adaptive スクリプト エディタを起動します。"Adaptive Data Agent">"Adaptive Script Editor"に移動します。
- スクリプト エディタで"Workday" タブを選択します。
- データ エージェントから以下のフィールドに貼り付けます。
- 認証エンド ポイント
- トークン エンド ポイント
- クライアント ID(Workday からコピー)
- クライアント シークレット(Workday からコピー)
- リダイレクト URL は、リダイレクト URIと一致している必要がありますhttps://www.workday.comAPI クライアントの登録時に入力したもの。
- "インテグレーション" タブを選択します。
- "Sign In with Workday"を選択します。
- Workday 認証情報を入力します。
- データ エージェント 12.0.239 以前を使用している場合は、ここまでです。
- データ エージェント 12.0.240 以降の場合は、"Workday インテグレーション" タブを設定します。
- Workday で"JWT Bearer"アクセス トークンの API クライアントを登録したときに生成された以下の情報を入力します。
- クライアント ID(Workday からコピー)。
- からコピーされたISU(Adaptive Planning 公開 API)。必要に応じて、管理者に ISU の提供を依頼します。
- Workday からコピーされたトークン エンド ポイント。
- 証明書(読み取り専用)
- Workday 認証情報で Adaptive スクリプト エディタの Adaptive Planning Input および Output プラグインのインストール
- スクリプト エディタ内の Adaptive Planning Input および Output プラグインは、ユーザー インターフェイスを介さずに実行されます。Adaptive Planning Input および Output プラグインでは毎回サインインしないため、JWT bearer の付与とインテグレーション システム ユーザー (ISU) が必要です。
- ローカル コンピュータ上で Adaptive スクリプト エディタを開いてサインインします。
- 新しい変換またはジョブを作成、または既存のものを開きます。
- Adaptive Planning OutputまたはAdaptive Planning Inputプラグインをドラッグし、右クリックして"編集"を選択します。
- "Instance Connection" タブで、"Login method" を"Workday"に変更します。
- "証明書" フィールドの内容をすべてコピーします。この証明書は、このプラグインが Workday と通信するために認証済みであることを識別します。Workday で API クライアントの登録とエディタ プラグインの設定を完了するまで、スクリプト エディタを閉じないでください。
- Workday で API クライアントを登録
- ブラウザを開いてスーパー ユーザーとして Workday にサインインします。
- Workday で"API クライアントの登録"を検索します。
- "クライアントの付与タイプ"を"JWT Bearer Token"に設定します。
- "x509 Certificate"セクションで、"Create x509 Public Key"を選択して名前を指定し、Adaptive Planning データ エージェント サービス マネージャの"Workday インテグレーション"タブからコピーした証明書を貼り付けます。
- "適用範囲" を"Adaptive Planning"に設定します。
- 以下を入力します。https://www.workday.com"リダイレクト URL"に「.」を入力します。
- "OK"を選択して保存し、クライアント IDとトークン エンド ポイントをコピーできるように、このページを開いたままにします。
- スクリプト エディタでプラグインのセットアップを完了
- API クライアント ID、トークン エンド ポイント、および ISU を使用してプラグインのセットアップを完了します。
- Adaptive スクリプト エディタに戻り、"クライアント ID"および"トークン エンド ポイント" をWorkday から貼り付けます。
- からコピーされたISU(Adaptive Planning 公開 API)。必要に応じて、管理者に ISU の提供を依頼します。ISU の作成の詳細については 、ステップ: Adaptive Planning にデータをインポートするための Workday の設定 を 参照してください。
- "OK"を選択して保存します。
ユーザーの同期と既存のデータ エージェント
Workday とのユーザー同期を実行する前と後に以下のステップを実行することで、データ エージェントが中断されることなく実行し続けるようにします。
ユーザー同期の実行前
- ローカル コンピュータ上で Workday Adaptive Planning データ エージェント マネージャを開始します。
- "Diagnose and Configure Network"を選択します。
- "Workday"タブを選択します。
- API クライアントを Workday で登録した時に生成された以下の情報を入力します。
- 認証エンド ポイント
- トークン エンド ポイント
- クライアント ID (Workday からコピー)
- クライアント シークレット (Workday からコピー)
- リダイレクト URL は、リダイレクト URIと一致している必要がありますhttps://www.workday.comAPI クライアントの登録時に入力したもの。
ユーザー同期の実行後
ユーザーの同期後に
"Workday インテグレーション"
タブを設定します。- "Workday インテグレーション"タブを選択します。
- JWT Bearerアクセス トークンを使用して、データ エージェント用に Workday で API クライアントを登録します。API クライアントの登録を参照してください。
- x509 公開キーを作成し、Workday Adaptive Planning データ エージェント マネージャの"Workday インテグレーション" タブからコピーした証明書を貼り付けます。
- 適用範囲 (業務分野) に"システム"と"Adaptive Planning"を設定します。
- "OK"を選択すると、クライアント ID、トークン エンド ポイント、および新しいインテグレーション クライアントを識別するその他の詳細情報が生成されます。
- クライアント ID、ISU、トークン エンド ポイントをコピーします。Workday Adaptive Planning データ エージェント マネージャを開始すると、これらが必要になります。
- ローカル コンピュータ上で Workday Adaptive Planning データ エージェント マネージャを開始します。
- "Diagnose and Configure Network"を選択します。
- "Workday インテグレーション"タブを選択します。
- Workday で"JWT Bearer"アクセス トークンの API クライアントを登録したときに生成された以下の情報を入力します。
- クライアント ID(Workday からコピー)。
- からコピーされたISU(Adaptive Planning 公開 API)。必要に応じて、管理者に ISU の提供を依頼します。
- Workday からコピーされたトークン エンド ポイント。
- 証明書(読み取り専用)。
- データ エージェントを起動して"Sign in with Workday"を選択しサインインします