SuccessFactors スポーク v4.x.x の設定

  • リリースバージョン: Australia
  • 更新日 2026年03月12日
  • 所要時間：15分

    • OAuth クライアントアプリケーションと API キーを使用して、ServiceNow インスタンスを SuccessFactors インスタンスと統合します。

    始める前に

    • 統合ハブサブスクリプションを要求します。
    • SuccessFactors スポークを有効にします。
    • システムプロパティを有効にします：
      • glide.pf.rest.response_payload_max_size：最大値は 10240です。
      • com.snc.process_flow.reporting.serialized.val_size_limit：最大値は 16384です。
      • com.glide.transform.json.max-partial-length：最大値は 65536です。
    • 必要なロール：admin
    注:
    この手順は、 SuccessFactors スポーク v4.10.1 を初めて設定する場合に適用されます。以前のバージョンの SuccessFactors スポークを使用している場合、移行手順については、「SuccessFactors スポーク v4.10.1 への移行」を参照してください。

    スポークの設定の詳細については、「 SAP SuccessFactors スポーク - OAuth セットアップと移行 - Tokyo 以前、Tokyo 以降」 を参照してください。 ServiceNow コミュニティ.

    SuccessFactors への OAuth クライアントアプリケーションの登録

    送信通信のクライアント証明書認証を有効にします keystore.jks ファイルと keystore.cer ファイルを生成します。

    始める前に

    • 有効な JKS 証明書を生成します。JKS 証明書の作成については、の 「秘密キーと証明書チェーンを使用した Java Keystore (JKS) の作成 」を参照してください SAP ヘルプポータル、または、手順を実行します。
      1. コマンド openssl genrsa -out private.key 2048 を使用して、private.key ファイルを生成します。
      2. private.keyを使用して、公開鍵を含む x.509 証明書 (.cer ファイル) を作成します。

        コマンド openssl req -new -x509 -key private.key -out publickey.cer -days 365 を使用します

    • 公開鍵と秘密鍵を .p12 ファイルに変換します。

      上記の手順を実行するには、 openssl pkcs12 -export -in publickey.cer -inkey private.key -out successfactors.p12 -name "<カスタム名を指定>"。

    • .p12 ファイルを .jks に変換する

      上記の手順を実行するには、 keytool -importkeystore -srckeystore successfactors.p12 -srcstoretype pkcs12 -destkeystore successfactors.jksを実行します。

    • 必要なロール：admin。

    手順

    1. アドミニストレーターとして SuccessFactors アカウントにログインします。
    2. [アドミンセンター] に移動し、[会社設定 (Company Settings)] をクリックします。
    3. [OAuth2 クライアントアプリケーションの管理 (Manage OAuth2 Client Applications)] をクリックします。
    4. [クライアントアプリケーションの登録 (Register Client Application)] をクリックします。
      クライアントアプリケーションを登録する。
    5. フォームで必要な詳細を入力します。
      [X.509 証明書] フィールドに、ヘッダーなしで cert.pem ファイル (公開鍵) の内容を入力します。
    6. [送信] をクリックします。
      API キーが生成され、表示されます。後で使用するために値をコピーして記録します。

    ServiceNow インスタンスへの JKS 証明書のアップロード

    ServiceNow インスタンスに JKS 証明書をアップロードして、アウトバウンド通信のクライアント証明書の認証を有効にします。

    始める前に

    必要なロール：admin

    手順

    1. アドミニストレーターとして ServiceNow インスタンスにログインします。
    2. JKS 証明書を ServiceNow インスタンスにアップロードします。
      JKS 証明書をアップロードする手順については、「Upload a certificate to an instance (インスタンスへの証明書のアップロード) 」を参照してください。
      JKS 証明書をアップロードする。

    OAuth プロバイダーとしてSuccessFactorsを登録

    クライアントアプリケーションの構成中に生成された API キーを使用して、アプリケーションを OAuth プロバイダーとして登録します。

    始める前に

    必要なロール：admin

    手順

    1. ServiceNowインスタンスで、 システム OAuth > アプリケーションレジストリー.
    2. [New] をクリックします。
    3. フォームのフィールドに入力します。
      フィールド 説明
      名前 証明書を識別する一意の名前。例：SuccessFactors SAML。
      クライアント ID OAuth クライアントアプリケーションを SuccessFactors に登録した後、コピーした API キーの値。
      クライアントシークレット
      注:
      クライアントシークレットは、アプリケーションを OAuth プロバイダーとして登録する場合には必要ありません。このフィールドには任意の値を指定できます。
      OAuth API スクリプト OAuth API スクリプトの名前。OAuthUtilSuccessFactors を検索し、リストから選択します。
      デフォルトの権限許可タイプ トークンを確立するために使用するデフォルトの権限許可タイプです。[SAML2 ベアラー] を選択します。
      トークン URL 次の形式の会社 ID を含む SuccessFactors OAuth サーバーエンドポイント URL：https://<SuccessFactors_Instance_Name>/oauth/token?company_id=<Company_ID>。例：https://example.successfactors.eu/oauth/token?company_id=SFCPART123456。
      アプリケーションレジストリレコード。
    4. [送信] をクリックします。

    SAML2 アサーションプロデューサーレコードの作成

    SAML2 アサーションレコードを作成し、SAML2 アサーションを生成して、プロバイダーとアクセストークンのアサーションを交換します。

    始める前に

    必要なロール：admin

    手順

    1. ServiceNow インスタンスで、SAML2 アサーションプロデューサーレコードを作成します。
      1. 移動先 すべて > システム OAuth > SAML2 アサーションプロデューサー.
      2. [New] をクリックします。
      3. フォームに、これらの値を入力します。
        フィールド 説明
        名前 SAML2 アサーションプロデューサーレコードを一意に識別する名前です。例：Successfactor SAML OAuth。
        Issuer アサーション発行エンティティの一意の識別子。ServiceNow インスタンス URL を指定します。
        件名 NameID SuccessFactorsインスタンスにログインするためのユーザー名例：sfadmin。
        対象者 アサーションの対象者。値「www.successfactors.com」を入力します。
        受信者 アサーションの対象受信者。https://<SuccessFactors-Instance-Name>/oauth/token の形式で URL を入力します。
        SAML2 アサーションプロデューサーレコード。
      4. フォームヘッダーを右クリックし、 [保存] をクリックします。
      5. [SAML2 アサーションキーストア] タブで、[新規] をクリックします。
      6. フォームに、これらの値を入力します。
        フィールド 説明
        名前 SAML2 アサーションキーストアレコードを識別する一意の名前です。例：sap_successfactor。
        署名キーエイリアス アサーションの署名に使用するキーストアに保存されるキーエントリのエイリアス。例では、1。
        署名キーパスワード アサーションの署名に使用するキーストアに保存されるキーエントリのパスワード。
        署名キーストア 必要な X.509 証明書レコード。以前に作成した X.509 証明書レコードを選択します。詳細については、「ServiceNow インスタンスへの JKS 証明書のアップロード」を参照してください。
        SAML2 アサーションキーストアレコード。
      7. [送信] をクリックします。
      8. 移動先 すべて > システム OAuth > SAML2 アサーションプロデューサー.
      9. 作成した SAML2 アサーションプロデューサーレコードを開きます。
        例：Successfactor SAML OAuth。
      10. [SAML2 アサーション属性] タブで、[新規] をクリックします。
      11. フォームに、これらの値を入力します。
        フィールド 説明
        名前 SAML2 アサーション属性レコードを識別する名前です。「api_key」と入力します。
        タイプ [値] フィールドのタイプ。文字列を選択します。
        値 OAuth クライアントアプリケーションが SuccessFactors に作成された後に生成された API キー。
        SAML2 アサーション属性レコード。
      12. [送信] をクリックします。
    2. SAML2 アサーションプロデューサーをアプリケーションレジストリーレコードに関連付けます。
      1. 移動先 システム OAuth > アプリケーションレジストリー.
      2. 作成したアプリケーションレジストリーレコードを開きます。
        例：SuccessFactors OAuth Reg。アプリケーションレジストリの作成の詳細については、「OAuth プロバイダーとしてSuccessFactorsを登録」を参照してください。
      3. [OAuth エンティティプロファイル] タブで、デフォルトの OAuth エンティティプロファイルレコードを開きます。
        例：Successfactor SAML default_profile。
      4. [アサーションプロデューサー] フィールドで、作成した SAML2 アサーションプロデューサーレコードを選択します。
        例：Successfactor SAML OAuth。
        OAuth エンティティプロファイルレコード。
      5. [更新] をクリックします。

    OData API の認証情報レコードを作成

    SuccessFactorsに OData API の認証情報レコードを作成します。 SuccessFactors スポーク接続および資格情報エイリアスでは、これらの認証情報を使用して、OData API を使用したアクションを許可します。

    始める前に

    必要なロール：admin

    手順

    1. 移動先 すべて > 接続 & 認証情報 > 認証情報.
    2. [New] をクリックします。
      「作成する認証情報のタイプは？」というメッセージが表示されます。
    3. [OAuth 2.0 認証情報] を選択します。
      空の OAuth 2.0 認証情報フォームが表示されます。
    4. フォームに、これらの値を入力します。
      フィールド 必要な値
      名前 レコードを一意に識別する名前を入力します。たとえば、「SAML_SuccessFactors_OData_Cred」と入力します。
      OAuth エンティティ プロファイル 作成した OAuth アプリケーションレジストリーに関連付けられている OAuth エンティティプロファイルレコード。例：Successfactor SAML default_profile。

      アプリケーションレジストリの作成の詳細については、「OAuth プロバイダーとしてSuccessFactorsを登録」を参照してください。
      有効 認証情報レコードをアクティブに使用するオプション。
      順番 この認証情報を適用する順番。たとえば、「100」と入力します。
      OData 認証情報レコード。
    5. [送信] をクリックします。

    タスクの結果

    OData API を使用してアクションを許可する認証情報レコードが作成されます。

    OData API の認証情報レコードを作成

    SuccessFactorsに OData API の認証情報レコードを作成します。 SuccessFactors スポーク接続および資格情報エイリアスでは、これらの認証情報を使用して、SOAP API を使用したアクションを許可します。

    始める前に

    必要なロール：admin

    手順

    1. 移動先 すべて > 接続 & 認証情報 > 認証情報.
    2. [New] をクリックします。
      「作成する認証情報のタイプは？」というメッセージが表示されます。
    3. [OAuth 2.0 認証情報] を選択します。
      空の OAuth 2.0 認証情報フォームが表示されます。
    4. フォームに、これらの値を入力します。
      フィールド 必要な値
      名前 レコードを一意に識別する名前を入力します。たとえば、「SAML_SuccessFactors_SOAP_Cred」と入力します。
      OAuth エンティティ プロファイル 作成した OAuth アプリケーションレジストリーに関連付けられている OAuth エンティティプロファイルレコード。例：Successfactor SAML default_profile。

      アプリケーションレジストリの作成の詳細については、「OAuth プロバイダーとしてSuccessFactorsを登録」を参照してください。
      有効 認証情報レコードをアクティブに使用するオプション。
      順番 この認証情報を適用する順番。たとえば、「100」と入力します。
      SOAP 認証情報レコード。
    5. [送信] をクリックします。

    タスクの結果

    SOAP API を使用してアクションを許可する認証情報レコードが作成されます。

    OData API の接続レコードの作成

    SuccessFactorsに OData API の接続レコードを作成します。 SuccessFactors スポーク接続および資格情報エイリアスでは、これらの接続を使用してSuccessFactorsでアクションを実行します。

    始める前に

    必要なロール：admin

    手順

    1. 移動先 すべて > 接続 & 認証情報 > 接続と認証情報エイリアス.
    2. [SuccessFactors OData] のレコードを開きます。
      例：SuccessFactors_OData。
    3. [接続] タブで、[新規] をクリックします。
      空の HTTP(s) 接続フォームが表示されます。
    4. フォームに、これらの値を入力します。
      表 : 1. HTTP(S) 接続フォーム
      フィールド 説明
      名前 レコードを一意に識別する名前を入力します。例： SAML_SuccessFactors_OData_Conn。
      認証情報 REST API 用に作成された認証情報レコードです。例：SAML_SuccessFactors_OData_Cred。
      接続 URL https://<SuccessFactors_Instance_Name>/odata/v2 形式の SuccessFactors サービスルート URL。例：https://example.successfactors.eu/odata/v2。
      注:
      SAP Cloud アカウントを使用している場合は、SAP ヘルプポータルの SAP SuccessFactors API サーバーのリストを参照して、API サーバーをターゲットにするために必要な正しいエンドポイントを選択してください。
      アクティブ 接続レコードを積極的に使用にするオプションです。
      OData 接続レコード。
    5. [送信] をクリックします。

    タスクの結果

    SuccessFactors の REST API の接続レコードが作成されます。

    SOAP API の接続レコードを作成

    SuccessFactorsに SOAP API の接続レコードを作成します。 SuccessFactors スポーク接続および資格情報エイリアスでは、これらの接続を使用してSuccessFactorsでアクションを実行します。

    始める前に

    必要なロール：admin

    手順

    1. 移動先 すべて > 接続 & 認証情報 > 接続と認証情報エイリアス.
    2. [SuccessFactors SOAP API] のレコードを開きます。
      たとえば、[SuccessFactors_Comp_Emp] です。
    3. [接続] タブで、[新規] をクリックします。
      空の HTTP(s) 接続フォームが表示されます。
    4. フォームに、これらの値を入力します。
      表 : 2. HTTP(S) 接続フォーム
      フィールド 説明
      名前 レコードを一意に識別する名前を入力します。例：SAML_SuccessFactors_SOAP_Conn。
      認証情報 SOAP API 用に作成された認証情報レコードです。例：SAML_SuccessFactors_SOAP_Cred。
      接続 URL SuccessFactors 接続 URL。例：https://<SuccessFactors_Instance_Name>/sfapi/v1/soap。例：https://example.successfactors.eu/sfapi/v1/soap
      注:
      SAP Cloud アカウントを使用している場合は、SAP ヘルプポータルの SAP SuccessFactors API サーバーのリストを参照して、API サーバーをターゲットにするために必要な正しいエンドポイントを選択してください。
      アクティブ 接続レコードを積極的に使用にするオプションです。
    5. [属性] タブで、次のフィールドに入力します。
      フィールド 説明
      会社 ID SuccessFactorsインスタンスの不変の会社 ID
      フロータイムアウト (秒) フロー実行中にSuccessFactorsからデータを受信できる最大時間 (秒) です。SuccessFactors からデータを取得するのに要した時間がタイムアウト期間を超えると、フローまたはサブフローはキャンセルされます。デフォルト値は「30」です。
      SOAP 接続レコード。
    6. [送信] をクリックします。

    タスクの結果

    SuccessFactorsの SOAP API の接続レコードが作成されます。

    SuccessFactors と ServiceNow 間のデータ同期

    要件に応じてサンプルフローをカスタマイズし、SuccessFactors と ServiceNow のインスタンスの間でデータを同期します。

    To Do エンティティ

    SuccessFactors スポークでは、To Do エンティティのデータを双方向で同期するためのサンプルフローが提供されます。サンプルフローである「SuccessFactors データ連携を実行」フローは、SuccessFactorsからデータを取得するようにカスタマイズできます。一方、「To Do を作成」および「To Do を更新」フローは、ServiceNowでイベントが発生したときにSuccessFactorsの To Do レコードを作成または更新します。サンプルフローをカスタマイズするときは、変換マップを使用して将来の更新を取得して保存するための適切なトリガーを指定していることを確認してください。

    その他のデフォルトエンティティ

    これらのエンティティの場合、サンプルフローである「SuccessFactors データ連携を実行」フローをカスタマイズして、SuccessFactorsからデータを取得できます。
    • 部門
    • ロケーション
    • ジョブプロファイル
    • ワーカープロファイル
    • 有効なワーカープロファイル
    • セカンダリアサインを含むジョブ履歴

    ServiceNowでイベントが発生したときに、これらのエンティティのSuccessFactorsのレコードを作成または更新するには：

    • 選択に従ってフローまたはサブフローを作成するか、サンプルフローとサブフローをカスタマイズします。
    • フローでメタデータ取得アクションとレコード管理アクションを使用します。
    • 変換マップを使用して将来の更新を取得して保存するための適切なトリガーを指定していることを確認してください。

    その他のSuccessFactorsエンティティ

    SuccessFactors 権限と構成、および要件に応じて、その他のエンティティのデータを同期することもできます。