---
sourceDocument: Xanadu : créer des intégrations avec des applications
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/fr-FR/xanadu/integrate-applications

 Release :

    - xanadu

ft:locale :

    - fr-FR

ft:publication_title :

    - Xanadu : créer des intégrations avec des applications

ft:clusterId :

    - crint

bundleId :

    - crint

workflow :

    - Creator


---

# Configurer la SuccessFactorsSpoke version v4.x.x

# Configurer la SuccessFactorsSpoke version v4.x.x {#ariaid-title1}

* Rversion finale: Xanadu
* 
* Mis à jour 1 août 2024
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 9 minutes de lecture

Intégrez l'instance à votre SuccessFactors instance à l'aide de l'application ServiceNow cliente OAuth et de la clé API.

## Avant de commencer

* Demander Hub d'intégration un abonnement
* Activez l'option SuccessFactorsSpoke
* Activez ces propriétés système :
  * glide.pf.rest.response_payload_max_size: la valeur maximale est <kbd class="ph userinput">10240</kbd>.
  * com.snc.process_flow.reporting.serialized.val_size_limit: la valeur maximale est <kbd class="ph userinput">16384</kbd>.
  * com.glide.transform.json.max-partial-length: la valeur maximale est <kbd class="ph userinput">65536</kbd>.
  {#setup-successfactors__ul_w1q_fzp_5lb}
* Rôle requis : administrateur

{#setup-successfactors__ul_a2t_p2s_wkb}  
Remarque :  
Cette procédure s'applique si vous configurez le SuccessFactorsSpoke v4.2.2 pour la première fois. Si vous utilisez une version antérieure du , reportez-vous [Migrer vers SuccessFactorsSpoke v4.2.2](https://servicenow-prod.fluidtopics.net/XlgRjLk~Hi2dKx1DozwmEw "Migrer à partir d’une version antérieure du SuccessFactorsSpoke vers SuccessFactorsSpoke v4.2.2 en sélectionnant les enregistrements d’informations d’identification SuccessFactorsSpoke associés au v4.2.2.") à la procédure de SuccessFactorsSpoke migration.

Pour plus d'informations sur la configuration du spoke, consultez [Spoke SAP SuccessFactors - Configuration et migration OAuth - Pré-Tokyo, Tokyo et au-delà](https://www.servicenow.com/community/knowledge-managers/sap-successfactors-spoke-oauth-setup-amp-migration-pre-tokyo/ta-p/2468046) dans [ServiceNow Communauté](https://www.servicenow.com/community/).

## Enregistrer l'application cliente OAuth dans SuccessFactors {#ariaid-title2}

Activez l'authentification par certificat client pour la communication sortante à partir du service Master SAP Data en générant les fichiers keystore.jks et keystore.cer.

### Avant de commencer

* Certificat JKS valide. Pour plus d'informations sur la création d'un certificat JKS, consultez [Création d'un magasin de clés Java (JKS) avec une clé privée et une chaîne de certificats](https://help.sap.com/docs/SAP_Cloud_Platform_Master_Data_for_Business_Partners/246fb358c1c7413289c03b8c72734209/18f5bae37a664396b2ebbc1b3c384c53.html) dans [SAP Portail d'aide](https://help.sap.com/docs/).
* Rôle requis : admin.
{#cert-successfactors__ul_sq2_ztg_dwb}

### Procédure

1. Connectez-vous au SuccessFactors compte en tant qu'administrateur.
2. Accédez à Admin Center et cliquez sur Paramètres de l'entreprise.
3. Cliquez sur Gérer les applications clientes OAuth2.
4. Cliquez sur Enregistrer l'application cliente.  
5. Fournissez les détails requis sur le formulaire.  
   Dans le champ Certificat X.509 , fournissez le contenu du fichier cert.pem (clé publique) sans les en-têtes.
6. Cliquez sur Envoyer.  
   La clé API est générée et affichée. Copiez et enregistrez la valeur pour une utilisation ultérieure.

## Chargez le certificat JKS dans votre ServiceNow instance {#ariaid-title3}

Activez l'authentification par certificat client pour la communication sortante en chargeant le certificat JKS dans votre ServiceNow instance.

### Avant de commencer

Rôle requis : administrateur

### Procédure

1. Connectez-vous à votre ServiceNow instance en tant qu'administrateur.
2. Chargez le certificat JKS sur votre ServiceNow instance.  
   Pour obtenir des instructions sur le chargement du certificat JKS, consultez [Charger un certificat sur une instance](https://www.servicenow.com/docs/access?context=t_UploadACertificateToAnInstance&version=xanadu&pubname=xanadu-platform-security&ft:locale=en-US) .

## S'inscrire SuccessFactors en tant que fournisseur OAuth {#ariaid-title4}

Utilisez la clé API générée pendant la configuration de l'application cliente pour enregistrer l'application en tant que fournisseur OAuth.

### Avant de commencer

Rôle requis : administrateur

### Procédure

1. Dans votre ServiceNow instance, accédez à OAuth systèmeRegistre d'application.
2. Cliquez sur Nouveau.
3. Renseignez les champs suivants du formulaire.  
   {#app-reg-successfactors__table_yb3_bwh_dwb__entry__2}

   | Champ | Description |
   |-|-|
   | Nom | Nom unique permettant d'identifier le certificat. Par exemple, <kbd class="ph userinput">SuccessFactors SAML.</kbd> |
   | ID client | Valeur de la clé API que vous avez copiée après l'enregistrement de l'application cliente OAuth dans SuccessFactors. |
   | Secret client | Remarque : Le secret client n'est pas nécessaire pour enregistrer l'application en tant que fournisseur OAuth. Vous pouvez fournir n'importe quelle valeur pour ce champ. |
   | Type d'accord par défaut | Type d'accord par défaut utilisé pour établir le jeton. Sélectionnez le support SAML2. |
   | URL de jeton | SuccessFactors URL du point de terminaison du serveur OAuth qui inclut l'ID de société au format suivant : <kbd class="ph userinput">https://&lt;SuccessFactors_Instance_Name&gt;/oauth/token&nbsp;?company_id=&lt;Company_ID&gt;</kbd>. Par exemple, <kbd class="ph userinput">https://example.successfactors.eu/oauth/token?company_id=SFCPART123456</kbd>. |
   [ ]

   {#app-reg-successfactors__table_yb3_bwh_dwb}
4. Cliquez sur Envoyer.

## Créer l'enregistrement du créateur d'assertion SAML2 {#ariaid-title5}

Créez un enregistrement d'assertion SAML2 pour générer l'assertion SAML2 et échanger l'assertion contre les jetons d'accès avec le fournisseur.

### Avant de commencer

Rôle requis : administrateur

### Procédure

1. Créez un enregistrement de créateur d'assertion SAML2 dans votre ServiceNow instance.
   1. Accédez à la ToutOAuth systèmeCréateurs d'assertions SAML2.
   2. Cliquez sur Nouveau.
   3. Renseignez ces valeurs sur le formulaire.  
      {#conf-saml2-successfactors__table_fx3_ym3_dwb__entry__2}

      | Champ | Description |
      |-|-|
      | Nom | Nom unique permettant d'identifier l'enregistrement du créateur d'assertion SAML2. Par exemple, <kbd class="ph userinput">Successfactor SAML OAuth</kbd>. |
      | Émetteur | Identificateur unique de l'entité émettrice de l'assertion. Indiquez l'URL de l'instance ServiceNow . |
      | NameID de l'objet | Nom d'utilisateur pour se connecter à l'instance SuccessFactors . Par exemple, <kbd class="ph userinput">sfadmin</kbd>. |
      | Audience | Public prévu pour l'assertion. Saisissez la valeur <kbd class="ph userinput">www.successfactors.com</kbd>. |
      | Destinataire | Destinataire souhaité de l'assertion. Saisissez l'URL au format <kbd class="ph userinput">suivant : https://&lt;SuccessFactors-Instance-Name&gt;/oauth/token</kbd>. |
      [ ]

      {#conf-saml2-successfactors__table_fx3_ym3_dwb}
   4. Cliquez avec le bouton droit sur l'en-tête du formulaire, puis cliquez sur Enregistrer.
   5. Sous l'onglet Magasins de clés d'assertion SAML2 , cliquez sur Nouveau.
   6. Renseignez ces valeurs sur le formulaire.  
      {#conf-saml2-successfactors__table_zqv_kp3_dwb__entry__2}

      | Champ | Description |
      |-|-|
      | Nom | Nom unique permettant d'identifier l'enregistrement du magasin de clés d'assertion SAML2. Par exemple, <kbd class="ph userinput">sap_successfactor</kbd>. |
      | Signature avec l'alias de clé | Alias de saisie de clé stocké dans le magasin de clés utilisé pour signer l'assertion. Par exemple, <kbd class="ph userinput">1</kbd>. |
      | Signature avec le mot de passe de clé | Mot de passe de l'entrée de clé stocké dans le magasin de clés utilisé pour signer l'assertion. |
      | Magasin de clés de signature | Enregistrement de certificat X.509 requis. Sélectionnez l'enregistrement de certificat X.509 que vous avez créé précédemment. Pour plus d'informations, consultez [Chargez le certificat JKS dans votre ServiceNow instance](https://servicenow-prod.fluidtopics.net/iavFBVnKyM1D7kQLm9Vngw#successfactors-upload-cert "Activez l’authentification par certificat client pour la communication sortante en chargeant le certificat JKS dans votre ServiceNow instance."). |
      [ ]

      {#conf-saml2-successfactors__table_zqv_kp3_dwb}
   7. Cliquez sur Envoyer.
   8. Accédez à la ToutOAuth systèmeCréateurs d'assertions SAML2.
   9. Ouvrez l'enregistrement du créateur d'assertion SAML2 que vous avez créé.  
      Par exemple, Successfactor SAML OAuth.
   10. Sous l'onglet SAML2 Assertion Attributes (Attributs d'assertion SAML2 ), cliquez sur New (Nouveau).
   11. Renseignez ces valeurs sur le formulaire.  
       {#conf-saml2-successfactors__table_e2p_w1j_dwb__entry__2}

       | Champ | Description |
       |-|-|
       | Nom | Nom permettant d'identifier l'enregistrement de l'attribut d'assertion SAML2. Saisissez <kbd class="ph userinput">api_key</kbd>. |
       | Type | Type du champ Valeur . Sélectionnez Chaîne. |
       | Valeur | Clé API générée après la création de l'application cliente OAuth dans SuccessFactors. |
       [ ]

       {#conf-saml2-successfactors__table_e2p_w1j_dwb}
   12. Cliquez sur Envoyer.
   {#conf-saml2-successfactors__substeps_zx3_vm3_dwb}
2. Associez le créateur d'assertion SAML2 à l'enregistrement du registre d'application.
   1. Accédez à la OAuth systèmeRegistre d'application.
   2. Ouvrez l'enregistrement du registre d'application que vous avez créé.  
      Par exemple, SuccessFactors OAuth Reg. Pour plus d'informations sur la création du registre d'application, reportez-vous à la section [S'inscrire SuccessFactors en tant que fournisseur OAuth](https://servicenow-prod.fluidtopics.net/iavFBVnKyM1D7kQLm9Vngw#app-reg-successfactors "Utilisez la clé API générée pendant la configuration de l’application cliente pour enregistrer l’application en tant que fournisseur OAuth.").
   3. Sous l'onglet Profils des entités OAuth , ouvrez l'enregistrement de profil d'entité OAuth par défaut.  
      Par exemple, Successfactor SAML default_profile.
   4. Pour le champ Créateur d'assertion , sélectionnez l'enregistrement du créateur d'assertion SAML2 que vous avez créé.  
      Par exemple, Successfactor SAML OAuth.
   5. Cliquez sur Mettre à jour.
   {#conf-saml2-successfactors__substeps_y1k_y2j_dwb}

## Créer un enregistrement d'informations d'identification pour l'API OData {#ariaid-title6}

Créez un enregistrement d'informations d'identification pour les API OData dans SuccessFactors. Les SuccessFactorsSpoke alias de connexion et d'informations d'identification utilisent ces informations d'identification pour autoriser des actions à l'aide de l'API OData.

### Avant de commencer

Rôle requis : admin.

### Procédure

1. Accédez à la ToutConnexions et informations d'identificationInformations d'identification.
2. Cliquez sur Nouveau.  
   Le système affiche le message Quel type d'informations d'identification voulez-vous créer ?
3. Sélectionnez Informations d'identification OAuth 2.0.  
   Un formulaire d'informations d'identification OAuth 2.0 vide s'affiche.
4. Renseignez ces valeurs sur le formulaire.  
   {#create-cred-sfsap-rest__table_twl_mk2_5kb__entry__2}

   | Champ | Valeur requise |
   |-|-|
   | Nom | Nom permettant d'identifier l'enregistrement de façon unique. Par exemple, saisissez <kbd class="ph userinput">SAML_SuccessFactors_OData_Cred</kbd>. |
   | Profil de l'entité OAuth | Enregistrement de profil d'entité OAuth associé au registre d'application OAuth que vous avez créé. Par exemple, <kbd class="ph userinput">Successfactor SAML default_profile</kbd>. Pour plus d'informations sur la création du registre d'application, reportez-vous à la section [S'inscrire SuccessFactors en tant que fournisseur OAuth](https://servicenow-prod.fluidtopics.net/iavFBVnKyM1D7kQLm9Vngw#app-reg-successfactors "Utilisez la clé API générée pendant la configuration de l’application cliente pour enregistrer l’application en tant que fournisseur OAuth."). |
   | Actif | Option permettant d'utiliser activement l'enregistrement des informations d'identification. |
   | Ordre | Ordre dans lequel appliquer ces informations d'identification. Par exemple, saisissez <kbd class="ph userinput">100</kbd>. |
   [ ]

   {#create-cred-sfsap-rest__table_twl_mk2_5kb}
5. Cliquez sur Envoyer.

### Résultats

L'enregistrement d'informations d'identification permettant d'autoriser les actions à l'aide de l'API OData est créé.

## Créer un enregistrement d'informations d'identification pour l'API SOAP {#ariaid-title7}

Créez un enregistrement d'informations d'identification pour les API SOAP dans SuccessFactors. Les SuccessFactorsSpoke alias de connexion et d'informations d'identification utilisent ces informations d'identification pour autoriser des actions à l'aide des API SOAP.

### Avant de commencer

Rôle requis : admin.

### Procédure

1. Accédez à la ToutConnexions et informations d'identificationInformations d'identification.
2. Cliquez sur Nouveau.  
   Le système affiche le message Quel type d'informations d'identification voulez-vous créer ?
3. Sélectionnez Informations d'identification OAuth 2.0.  
   Un formulaire d'informations d'identification OAuth 2.0 vide s'affiche.
4. Renseignez ces valeurs sur le formulaire.  
   {#create-cred-sfsap-odata__table_twl_mk2_5kb__entry__2}

   | Champ | Valeur requise |
   |-|-|
   | Nom | Nom permettant d'identifier l'enregistrement de façon unique. Par exemple, saisissez <kbd class="ph userinput">SAML_SuccessFactors_SOAP_Cred</kbd>. |
   | Profil de l'entité OAuth | Enregistrement de profil d'entité OAuth associé au registre d'application OAuth que vous avez créé. Par exemple, <kbd class="ph userinput">Successfactor SAML default_profile</kbd>. Pour plus d'informations sur la création du registre d'application, reportez-vous à la section [S'inscrire SuccessFactors en tant que fournisseur OAuth](https://servicenow-prod.fluidtopics.net/iavFBVnKyM1D7kQLm9Vngw#app-reg-successfactors "Utilisez la clé API générée pendant la configuration de l’application cliente pour enregistrer l’application en tant que fournisseur OAuth."). |
   | Actif | Option permettant d'utiliser activement l'enregistrement des informations d'identification. |
   | Ordre | Ordre dans lequel appliquer ces informations d'identification. Par exemple, saisissez <kbd class="ph userinput">100</kbd>. |
   [ ]

   {#create-cred-sfsap-odata__table_twl_mk2_5kb}
5. Cliquez sur Envoyer.
{#create-cred-sfsap-odata__steps_lxz_nlt_wkb}

### Résultats

L'enregistrement d'informations d'identification permettant d'autoriser les actions à l'aide de l'API SOAP est créé.

## Créer un enregistrement de connexion pour l'API OData {#ariaid-title8}

Créez un enregistrement de connexion pour l'API OData dans SuccessFactors. Les SuccessFactorsSpoke alias de connexion et d'informations d'identification utilisent ces connexions pour effectuer des actions dans SuccessFactors.

### Avant de commencer

Rôle requis : admin.

### Procédure

1. Accédez à la ToutConnexions et informations d'identificationAlias de connexion et d'informations d'identification.
2. Ouvrir pour l'enregistrement pour SuccessFactors OData.  
   Par exemple, SuccessFactors_OData.
3. Dans l'onglet Connexions , cliquez sur Nouveau.  
   Le système affiche un formulaire de connexion HTTP(s) vide.
4. Renseignez ces valeurs sur le formulaire.  
   {#create-conn-sf-rest__table_ol3_3nt_wkb__entry__2}

   | Champ | Description |
   |-|-|
   | Nom | Nom permettant d'identifier l'enregistrement de façon unique. Par exemple, <kbd class="ph userinput">SAML_SuccessFactors_OData_Conn</kbd>. |
   | Informations d'identification | Enregistrement d'informations d'identification que vous avez créé pour l'API REST. Par exemple, <kbd class="ph userinput">SAML_SuccessFactors_OData_Cred</kbd>. |
   | URL de connexion | SuccessFactors URL racine du service au format suivant : <kbd class="ph userinput">https://&lt;SuccessFactors_Instance_Name&gt;/odata/v2</kbd>. Par exemple, <kbd class="ph userinput">https://example.successfactors.eu/odata/v2</kbd>. |
   | Actif | Option permettant d'utiliser activement l'enregistrement de connexion. |
   [Tableau 1. Formulaire Connexion HTTP(s)]

   {#create-conn-sf-rest__table_ol3_3nt_wkb}
5. Cliquez sur Envoyer.

### Résultats

L'enregistrement de connexion pour l'API REST dans SuccessFactors est créé.

## Créer un enregistrement de connexion pour l'API SOAP {#ariaid-title9}

Créez un enregistrement de connexion pour l'API SOAP dans SuccessFactors. Les SuccessFactorsSpoke alias de connexion et d'informations d'identification utilisent ces connexions pour effectuer des actions dans SuccessFactors.

### Avant de commencer

Rôle requis : admin.

### Procédure

1. Accédez à la ToutConnexions et informations d'identificationAlias de connexion et d'informations d'identification.
2. Ouvrir pour l'enregistrement de l'API SOAP SuccessFactors.  
   Par exemple, SuccessFactors_Comp_Emp.
3. Dans l'onglet Connexions , cliquez sur Nouveau.  
   Le système affiche un formulaire de connexion HTTP(s) vide.
4. Renseignez ces valeurs sur le formulaire.  
   {#create-conn-sapsf-soap__table_ol3_3nt_wkb__entry__2}

   | Champ | Description |
   |-|-|
   | Nom | Nom permettant d'identifier l'enregistrement de façon unique. Par exemple, <kbd class="ph userinput">SAML_SuccessFactors_SOAP_Conn</kbd>. |
   | Informations d'identification | Enregistrement d'informations d'identification que vous avez créé pour l'API SOAP. Par exemple, <kbd class="ph userinput">SAML_SuccessFactors_SOAP_Cred</kbd>. |
   | URL de connexion | SuccessFactors URL de connexion. Par exemple, <kbd class="ph userinput">https://&lt;SuccessFactors_Instance_Name&gt;/sfapi/v1/soap</kbd>. Par exemple, <kbd class="ph userinput">https://example.successfactors.eu/sfapi/v1/soap</kbd>. |
   | Actif | Option permettant d'utiliser activement l'enregistrement de connexion. |
   [Tableau 2. Formulaire Connexion HTTP(s)]

   {#create-conn-sapsf-soap__table_ol3_3nt_wkb}
5. Renseignez les champs suivants dans l'onglet Attributs .  
   {#create-conn-sapsf-soap__table_lyn_wtt_wkb__entry__2}

   | Champ | Description |
   |-|-|
   | ID de la société | ID de société immuable de votre SuccessFactors instance. |
   | Délai d'expiration du flux (secondes) | Durée maximale, en secondes, pendant laquelle des données peuvent être reçues SuccessFactors pendant l'exécution du flux. Si le temps nécessaire pour récupérer les données à partir de SuccessFactors dépasse la durée du délai d'expiration, le flux ou le flux secondaire est annulé. La valeur par défaut est <kbd class="ph userinput">30</kbd>. |
   [ ]

   {#create-conn-sapsf-soap__table_lyn_wtt_wkb}
6. Cliquez sur Envoyer.
{#create-conn-sapsf-soap__steps_mmz_ftt_wkb}

### Résultats

L'enregistrement de connexion de l'API SOAP dans SuccessFactors est créé.

## Synchroniser les données entre SuccessFactors et ServiceNow {#ariaid-title10}

Personnalisez les échantillons de flux selon vos besoins pour synchroniser les données entre vos SuccessFactors instances et ServiceNow

### Entité des tâches

Le SuccessFactors spoke fournit des exemples de flux permettant de synchroniser les données de manière bidirectionnelle pour l'entité des tâches. L'exemple de flux Exécuter le flux d'intégration SuccessFactors peut être personnalisé pour récupérer des données à partir de SuccessFactors, tandis que les flux Créer une tâche et Mettre à jour une tâche créent ou mettent à jour les enregistrements de tâches dans SuccessFactors lorsque des événements se produisent dans ServiceNow. Lors de la personnalisation des exemples de flux, assurez-vous de fournir des déclencheurs appropriés pour récupérer et enregistrer les futures mises à jour à l'aide de cartes de transformation.

### Autres entités par défaut

Pour ces entités, l'exemple de flux Exécuter le flux d'intégration SuccessFactors peut être personnalisé pour récupérer les données depuis SuccessFactors:

* Département
* Emplacement
* Profil de poste
* Profil d'agents
* Profil d'agents effectifs
* Historique professionnel, y compris les affectations secondaires
{#sync-data-sapsf__ul_q5q_qvp_5lb}

Pour créer ou mettre à jour des enregistrements pour SuccessFactors ces entités lorsque des événements se produisent dans ServiceNow:  
* Créez des flux ou des flux secondaires selon votre choix ou personnalisez les échantillons de flux et de flux secondaires.
* Utilisez des actions de récupération des métadonnées et de gestion des enregistrements dans vos flux.
* Assurez-vous de fournir des déclencheurs appropriés pour récupérer et enregistrer les futures mises à jour à l'aide de cartes de transformation.
{#sync-data-sapsf__ul_ih1_w1y_nsb}

### Autres SuccessFactors entités

En fonction SuccessFactors des autorisations et des configurations, vous pouvez également synchroniser les données d'autres entités selon vos besoins.