Workdayの電子メールおよび電話のライトバック

Oktaにメールおよび電話番号の属性をWorkdayに書き戻す機能が追加されました。この新しいライトバック機能により、Okta、Active Directory、またはその他のプロファイルソースが電話番号とメールのWorkday属性を更新できるようになります。現時点では、他のWorkday属性はサポートされていません。

前提条件

Workdayのプロビジョニングを設定します。「Workday」を参照してください。

手順

Workdayの構成

ライトバック機能を正常に機能させるには、統合システムユーザー/システムグループに追加の必要な権限を付与する必要があります。次に、権限をアクティブ化します。

  1. ドメインセキュリティポリシーのアクセス許可。

    "Worker Data: Maintain Contact Information" – Get and Putドメインについては、「統合システムユーザーに権限を付与する」手順のa~e(ステップ7の一部)に従います。

  2. ビジネスプロセスセキュリティポリシーのアクセス許可。

    • bp:contact changeを検索し、ビジネスプロセスポリシーを編集します。

      workday_writeback1

    • 「Workdayでの統合システムユーザーの作成」で作成した統合システムユーザーのセキュリティグループを[Initiating Action: Maintain Contact Information (Web Service)(開始するアクション:連絡先情報の更新(Webサービス))]に割り当てます。

      workday_writeback2

  3. 「統合システムユーザーに権限を付与する」のステップ7に従って、WorkdayでのIntegratorシステムユーザーの作成の要件に記載されている上記のセキュリティポリシーをアクティブにします。

Oktaの構成

  1. Oktaで、Workdayアプリを開き、[Provisioning(プロビジョニング)]タブに移動します。

  2. 左側のパネルの[SETTINGS(設定)]の下にある[To App(アプリへ)]を選択し、次に[Workday Attribute Mappings(Workday属性マッピング)]の下で、[Go to Profile Editor(プロファイルエディターに進む)]を選択します。

  3. 現在ライトバックでサポートされているWorkday属性を追加します。これは、Workdayから属性を検出し、関連するOkta属性にマッピングすることによって行われます。[Add Attribute(属性を追加)]をクリックします。

  4. [Refresh Attribute(属性を更新)]をクリックします。

  5. 必要なWorkday属性を追加し、[Save(保存)]をクリックします。

    各属性には、以下で説明する3つの異なるデータ型があります。この表では、例として属性Work Emailを使用しています。

    属性名 タイプ 必須/任意 コメント サンプル値
    EmailAddressData Work EmailAddress 文字列 必須 Oktaユーザー属性にマップ OktaCustomWorkEmail
    EmailAddressData Work Primary ブール値 必須 プッシュされた仕事用メールをプライマリとして設定する必要がある場合は、値をtrueに設定します。デフォルトはfalseです。 true
    EmailAddressData Work Public ブール値 必須 プッシュされた業務用メールを公開に設定する必要がある場合は、値をtrueに設定します。デフォルトはfalseです。 false

    Workdayの連絡先情報には[Primary(プライマリ)]と[Public(パブリック)]の2つのパラメータがあります。

    [Primary(プライマリ)]:このパラメーターは、連絡先情報のタイプがPrimaryであるかAdditionalであるかを定義します。

    [Public(パブリック)]:このパラメーターは、連絡先情報の可視性がパブリックかプライベートかを定義します。

    workday6

    現在サポートされているWorkday属性のリストについては、「リソース」 を参照してください。

  6. 新しく追加された属性を関連するOkta属性にマップします。[Map Attributes(属性をマッピング)]をクリックします。

  7. [Okta to Workday(OktaからWorkdayへ)]を選択し、以下に示すように属性をマップしてから、[Save Mappings(マッピングを保存)]をクリックします。

    workdayenhancements1

  8. 式言語関数の例

    注:参考として、「Okta Expression Language」を参照してください。

    電話番号を解析するには:

    user.mobilePhone = +1 (415) 123-4567 x 12345の場合:

    Work Mobile Phone AreaCode: String.substringBefore(String.substringAfter(user.mobilePhone, "(" ), ")" ) -> 415

    Work Mobile Phone InternationalPhoneCode: String.removeSpaces(String.substringBefore(String.substringAfter(user.mobilePhone, "+" ), "(" )) -> 1

    Work Mobile Phone PhoneNumber: String.removeSpaces(String.substringBefore(String.substringAfter(user.mobilePhone, ")" ), "x" )) --> 123-4567

    Work Mobile Phone PhoneExtension: String.removeSpaces(String.substringAfter(user.mobilePhone, "x")) -> 12345

  9. 属性レベルのソーシング

    典型的なWorkdayライトバックのユースケースでは、Workdayは全体的なプロファイルソースとして設定されます。ただし、メールや電話番号をWorkdayに書き戻すには、Okta、Active Directory、またはその他のアプリを使用して、これらの特定の属性のプロファイルソースとして属性レベルのソーシングを構成します。次の例を参照してください。

    • [Directory(ディレクトリ)]>[Profile Editor(プロファイルエディタ)]の順に進みます。

    • 左側のフィルターパネルでOktaを選択し、[Profile(プロファイル)]をクリックします。

    • [Edit(編集)]をクリックします。

    • 選択したプロファイルソースを選択し、[Save Profile(プロファイルの保存)]をクリックします。

    • [Attributes(属性)]に移動し、[Custom(カスタム)]>[Filter(フィルター)]の順に選択します。

    • [User permission(ユーザー権限)]および[Source priority(ソース優先度)]を選択します。

    • [Save attribute(属性を保存)]をクリックして、セットアップを完了します。

既知の制限

  • Workday v.15の場合:Workdayユーザーインターフェイスとは異なり、Workday APIには電話番号または電子メールの形式の検証/ルールがありません(例:電話番号の形式は3桁+オプションのダッシュ(またはドット)+ 4桁である必要があります)。

    Workday v29は、電話番号と電子メールの形式の検証/ルールを実施します。

  • OktaがWorkdayプライマリ属性を設定すると、それをNULLに戻すことはできなくなります。これは、NULL値を許可しないWorkday検証ルールが原因です。

リソース

サポートされる属性

S. No

属性名

タイプ

説明

1 EmailAddressData Home EmailAddress 文字列 emailAddressDataHomeEmailAddress
2 EmailAddressData Home Primary ブール値 emailAddressDataHomePrimary
3 EmailAddressData Home Public ブール値 emailAddressDataHomePublic
4 EmailAddressData Work EmailAddress 文字列 emailAddressDataWorkEmailAddress
5 EmailAddressData Work Primary ブール値 emailAddressDataWorkPrimary
6 EmailAddressData Work Public ブール値 emailAddressDataWorkPublic
7 PhoneData Home Fax AreaCode 文字列 phoneDataHomeFaxAreaCode
8 PhoneData Home Fax InternationalPhoneCode 文字列 phoneDataHomeFaxInternationalPhoneCode
9 PhoneData Home Fax PhoneExtension 文字列 phoneDataHomeFaxPhoneExtension
10 PhoneData Home Fax PhoneNumber 文字列 phoneDataHomeFaxPhoneNumber
11 PhoneData Home Fax Primary ブール値 phoneDataHomeFaxPrimary
12 PhoneData Home Fax Public ブール値 phoneDataHomeFaxPublic
13 PhoneData Home Mobile AreaCode 文字列 phoneDataHomeMobileAreaCode
14 PhoneData Home Mobile InternationalPhoneCode 文字列 phoneDataHomeMobileInternationalPhoneCode
15 PhoneData Home Mobile PhoneExtension 文字列 phoneDataHomeMobilePhoneExtension
16 PhoneData Home Mobile PhoneNumber 文字列 phoneDataHomeMobilePhoneNumber
17 PhoneData Home Mobile Primary ブール値 phoneDataHomeMobilePrimary
18 PhoneData Home Mobile Public ブール値 phoneDataHomeMobilePublic
19 PhoneData Home Pager AreaCode 文字列 phoneDataHomePagerAreaCode
20 PhoneData Home Pager InternationalPhoneCode 文字列 phoneDataHomePagerInternationalPhoneCode
21 PhoneData Home Pager PhoneExtension 文字列 phoneDataHomePagerPhoneExtension
22 PhoneData Home Pager PhoneNumber 文字列 phoneDataHomePagerPhoneNumber
23 PhoneData Home Pager Primary ブール値 phoneDataHomePagerPrimary
24 PhoneData Home Pager Public ブール値 phoneDataHomePagerPublic
25 PhoneData Home Telephone AreaCode 文字列 phoneDataHomeTelephoneAreaCode
26 PhoneData Home Telephone InternationalPhoneCode 文字列 phoneDataHomeTelephoneInternationalPhoneCode
27 PhoneData Home Telephone PhoneExtension 文字列 phoneDataHomeTelephonePhoneExtension
28 PhoneData Home Telephone PhoneNumber 文字列 phoneDataHomeTelephonePhoneNumber
29 PhoneData Home Telephone Primary ブール値 phoneDataHomeTelephonePrimary
30 PhoneData Home Telephone Public ブール値 phoneDataHomeTelephonePublic
31 PhoneData Work Fax AreaCode 文字列 phoneDataWorkFaxAreaCode
32 PhoneData Work Fax InternationalPhoneCode 文字列 phoneDataWorkFaxInternationalPhoneCode
33 PhoneData Work Fax PhoneExtension 文字列 phoneDataWorkFaxPhoneExtension
34 PhoneData Work Fax PhoneNumber 文字列 phoneDataWorkFaxPhoneNumber
35 PhoneData Work Fax Primary ブール値 phoneDataWorkFaxPrimary
36 PhoneData Work Fax Public ブール値 phoneDataWorkFaxPublic
37 PhoneData Work Mobile AreaCode 文字列 phoneDataWorkMobileAreaCode
38 PhoneData Work Mobile InternationalPhoneCode 文字列 phoneDataWorkMobileInternationalPhoneCode
39 PhoneData Work Mobile PhoneExtension 文字列 phoneDataWorkMobilePhoneExtension
40 PhoneData Work Mobile PhoneNumber 文字列 phoneDataWorkMobilePhoneNumber
41 PhoneData Work Mobile Primary ブール値 phoneDataWorkMobilePrimary
42 PhoneData Work Mobile Public ブール値 phoneDataWorkMobilePublic
43 PhoneData Work Pager AreaCode 文字列 phoneDataWorkPagerAreaCode
44 PhoneData Work Pager InternationalPhoneCode 文字列 phoneDataWorkPagerInternationalPhoneCode
45 PhoneData Work Pager PhoneExtension 文字列 phoneDataWorkPagerPhoneExtension
46 PhoneData Work Pager PhoneNumber 文字列 phoneDataWorkPagerPhoneNumber
47 PhoneData Work Pager Primary ブール値 phoneDataWorkPagerPrimary
48 PhoneData Work Pager Public ブール値 phoneDataWorkPagerPublic
49 PhoneData Work Telephone AreaCode 文字列 phoneDataWorkTelephoneAreaCode
50 PhoneData Work Telephone InternationalPhoneCode 文字列 phoneDataWorkTelephoneInternationalPhoneCode
51 PhoneData Work Telephone PhoneExtension 文字列 phoneDataWorkTelephonePhoneExtension
52 PhoneData Work Telephone PhoneNumber 文字列 phoneDataWorkTelephonePhoneNumber
53 PhoneData Work Telephone Primary ブール値 phoneDataWorkTelephonePrimary
54 PhoneData Work Telephone Public ブール値 phoneDataWorkTelephonePublic