Configurer v4.x.x SuccessFactorsSpoke

Rversion finale: Zurich

Mis à jour 31 juil. 2025

10 minutes de lecture

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

Avant de commencer

Demandez un Centre d'intégration abonnement.
Activez le SuccessFactorsSpoke .
Activez ces propriétés système :
- glide.pf.rest.response_payload_max_size: la valeur maximale est 10240.
- com.snc.process_flow.reporting.serialized.val_size_limit: La valeur maximale est 16384.
- com.glide.transform.json.max-partial-length: la valeur maximale est 65536.
Rôle requis : admin.

Remarque :

Cette procédure s’applique si vous configurez le SuccessFactorsSpoke v4.6.0 pour la première fois. Si vous utilisez une version antérieure du , reportez-vous Migrer vers SuccessFactorsSpoke v4.6.0 à 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à dans ServiceNow Communauté.

Enregistrer l’application cliente OAuth dans SuccessFactors

Activez l’authentification par certificat client pour la communication sortante à partir du service de SAP données maîtres en générant les fichiers keystore.jks et keystore.cer.

Avant de commencer

Générez un 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 dans SAP Portail d’aideou, faites les étapes.
1. Utilisez la commande openssl genrsa -out private.key 2048 pour générer le fichier private.key.
2. Utilisez le private.key pour créer un certificat x.509 (fichier .cer) contenant votre clé publique.
  Utiliser la commande openssl req -new -x509 -key private.key -out publickey.cer -days 365
Convertir les clés publique et privée en fichier .p12.
Utilisez la commande pour effectuer l’étape ci-dessus openssl pkcs12 -export -in publickey.cer -inkey private.key -out successfactors.p12 -name « <fournir un nom personnalisé> ».
Convertir le fichier .p12 en .jks
Utilisez la commande pour effectuer l’étape ci-dessus : keytool -importkeystore -srckeystore successfactors.p12 -srcstoretype pkcs12 -destkeystore successfactors.jks.
Rôle requis : admin.

Procédure

Connectez-vous au SuccessFactors compte en tant qu’administrateur.
Accédez à l’Admin Center et cliquez sur Paramètres de l’entreprise.
Cliquez sur Gérer les applications clientes OAuth2.
Cliquez sur Enregistrer l’application cliente.
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.
Cliquez sur Envoyer.
La clé API est générée et affichée. Copiez et enregistrez la valeur pour une utilisation ultérieure.

Charger le certificat JKS dans votre ServiceNow instance

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 : admin

Procédure

Connectez-vous à votre ServiceNow instance en tant qu’administrateur.
Chargez le certificat JKS dans votre ServiceNow instance.
Pour obtenir des instructions sur le chargement du certificat JKS, consultez Charger un certificat sur une instance .

S’inscrire SuccessFactors en tant que fournisseur OAuth

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

Avant de commencer

Rôle requis : admin

Procédure

Dans votre ServiceNow instance, accédez à OAuth système > Registre d'application.
Cliquez sur Nouveau.

Renseignez ces champs dans le formulaire.


Champ	Description
Nom	Nom unique permettant d’identifier le certificat. Par exemple, `SuccessFactors SAML.`
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.
Script de l'API OAuth	Nom du script d’API OAuth. Recherchez `OAuthUtilSuccessFactors` et sélectionnez-le dans la liste.
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 : `https://<SuccessFactors_Instance_Name>/oauth/token ?company_id=<Company_ID>`. Par exemple, `https://example.successfactors.eu/oauth/token?company_id=SFCPART123456`.

Enregistrement du registre d’application.

Cliquez sur Envoyer.

Créer l’enregistrement du créateur d’assertion SAML2

Créez un enregistrement d’assertion SAML2 pour générer l’assertion SAML2 et échanger l’assertion contre les jetons d’accès auprès du fournisseur.

Avant de commencer

Rôle requis : admin

Procédure

Créez un enregistrement de créateur d’assertion SAML2 dans votre ServiceNow instance.

Accédez à la Tous > OAuth système > Créateurs d'assertions SAML2.
Cliquez sur Nouveau.

Renseignez ces valeurs sur le formulaire.


Champ	Description
Nom	Nom unique pour identifier l’enregistrement du créateur d’assertion SAML2. Par exemple, `OAuth SAML Successfactor`.
Émetteur	Identificateur unique pour 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, `sfadmin`.
Audience	Public prévu pour l’assertion. Saisissez la valeur, `www.successfactors.com`.
Destinataire	Destinataire prévu pour l’assertion. Saisissez l’URL au format suivant `https://<SuccessFactors-Instance-Name>/oauth/token`.

Enregistrement du créateur d’assertion SAML2.

Cliquez avec le bouton droit sur l'en-tête du formulaire, puis cliquez sur Enregistrer.
Sous l’onglet Magasins de clés d’assertion SAML2 , cliquez sur Nouveau.

Renseignez ces valeurs sur le formulaire.


Champ	Description
Nom	Nom unique pour identifier l’enregistrement du magasin de clés d’assertion SAML2. Par exemple, `sap_successfactor`.
Signature avec l'alias de clé	Alias de l’entrée de clé stocké dans le magasin de clés utilisé pour signer l’assertion. Par exemple, `1`.
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 Charger le certificat JKS dans votre ServiceNow instance.

Enregistrement de magasin de clés d’assertion SAML2.

Cliquez sur Envoyer.
Accédez à la Tous > OAuth système > Créateurs d'assertions SAML2.
Ouvrez l’enregistrement du créateur d’assertion SAML2 que vous avez créé.
Par exemple, OAuth SAML Successfactor.
Sous l’onglet Attributs d’assertion SAML2 , cliquez sur Nouveau.

Renseignez ces valeurs sur le formulaire.


Champ	Description
Nom	Nom permettant d’identifier l’enregistrement d’attribut d’assertion SAML2. Entrez `api_key`.
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.

Enregistrement d’attribut d’assertion SAML2.

Cliquez sur Envoyer.

Associez le créateur d’assertion SAML2 à l’enregistrement du registre d’application.
1. Accédez à la OAuth système > Registre d'application.
2. Ouvrez l’enregistrement de 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.
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 de créateur d’assertion SAML2 que vous avez créé.
  Par exemple, OAuth SAML Successfactor.
5. Cliquez sur Mettre à jour.

Créer un enregistrement d’informations d’identification pour l’API OData

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

Accédez à la Tous > Connexions et informations d'identification > Informations d'identification.
Cliquez sur Nouveau.
Le système affiche le message Quel type d’informations d’identification voulez-vous créer ?.
Sélectionnez Informations d'identification OAuth 2.0.
Un formulaire d’informations d’identification OAuth 2.0 vide s’affiche.

Renseignez ces valeurs sur le formulaire.


Champ	Valeur requise
Nom	Nom permettant d'identifier l'enregistrement de façon unique. Par exemple, saisissez `SAML_SuccessFactors_OData_Cred`.
Profil de l'entité OAuth	Enregistrement de profil d’entité OAuth associé au registre d’application OAuth que vous avez créé. Par exemple, `Successfactor SAML default_profile`. Pour plus d’informations sur la création du registre d’application, reportez-vous à la section S’inscrire SuccessFactors 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 `100`.

Enregistrement d’informations d’identification OData.

Cliquez sur Envoyer.

Résultats

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

Créer un enregistrement d’informations d’identification pour l’API SOAP

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

Accédez à la Tous > Connexions et informations d'identification > Informations d'identification.
Cliquez sur Nouveau.
Le système affiche le message Quel type d’informations d’identification voulez-vous créer ?.
Sélectionnez Informations d'identification OAuth 2.0.
Un formulaire d’informations d’identification OAuth 2.0 vide s’affiche.

Renseignez ces valeurs sur le formulaire.


Champ	Valeur requise
Nom	Nom permettant d'identifier l'enregistrement de façon unique. Par exemple, saisissez `SAML_SuccessFactors_SOAP_Cred`.
Profil de l'entité OAuth	Enregistrement de profil d’entité OAuth associé au registre d’application OAuth que vous avez créé. Par exemple, `Successfactor SAML default_profile`. Pour plus d’informations sur la création du registre d’application, reportez-vous à la section S’inscrire SuccessFactors 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 `100`.

Enregistrement d’informations d’identification SOAP.

Cliquez sur Envoyer.

Résultats

L’enregistrement d’informations d’identification pour autoriser des actions à l’aide de l’API SOAP est créé.

Créer un enregistrement de connexion pour l’API OData

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

Accédez à la Tous > Connexions et informations d'identification > Alias de connexion et d'informations d'identification.
Ouvrir pour l’enregistrement pour SuccessFactors OData.
Par exemple, SuccessFactors_OData.
Dans l’onglet Connexions , cliquez sur Nouveau.
Le système affiche un formulaire de connexion HTTP(s) vide.

Renseignez ces valeurs sur le formulaire.

Tableau 1. Formulaire Connexion HTTP(s)
Champ	Description
Nom	Nom permettant d'identifier l'enregistrement de façon unique. Par exemple, `SAML_SuccessFactors_OData_Conn`.
Informations d'identification	Enregistrement d’informations d’identification que vous avez créé pour l’API REST. Par exemple, `SAML_SuccessFactors_OData_Cred`.
URL de connexion	SuccessFactors URL racine du service au format suivant : `https://<SuccessFactors_Instance_Name>/OData/v2`. Par exemple, `https://example.successfactors.eu/odata/v2`. Remarque : Si vous utilisez un compte SAP Cloud, consultez Liste des serveurs d’API SAP SuccessFactors dans le portail d’aide SAP pour sélectionner le point de terminaison correct nécessaire pour cibler le serveur d’API.
Actif	Option permettant d’utiliser activement l’enregistrement de connexion.

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

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

Accédez à la Tous > Connexions et informations d'identification > Alias de connexion et d'informations d'identification.
Ouvrir pour l’enregistrement de l’API SOAP SuccessFactors.
Par exemple, SuccessFactors_Comp_Emp.
Dans l’onglet Connexions , cliquez sur Nouveau.
Le système affiche un formulaire de connexion HTTP(s) vide.

Renseignez ces valeurs sur le formulaire.

Tableau 2. Formulaire Connexion HTTP(s)
Champ	Description
Nom	Nom permettant d'identifier l'enregistrement de façon unique. Par exemple, `SAML_SuccessFactors_SOAP_Conn`.
Informations d'identification	Enregistrement d’informations d’identification que vous avez créé pour l’API SOAP. Par exemple, `SAML_SuccessFactors_SOAP_Cred`.
URL de connexion	SuccessFactors URL de connexion. Par exemple, `https://<SuccessFactors_Instance_Name>/sfapi/v1/soap`. Par exemple, `https://example.successfactors.eu/sfapi/v1/soap`. Remarque : Si vous utilisez un compte SAP Cloud, consultez Liste des serveurs d’API SAP SuccessFactors dans le portail d’aide SAP pour sélectionner le point de terminaison correct nécessaire pour cibler le serveur d’API.
Actif	Option permettant d’utiliser activement l’enregistrement de connexion.

Dans l’onglet Attributs , renseignez ces champs.


Champ	Description
ID de société	ID de société immuable de votre SuccessFactors instance.
Délai d’expiration du flux (secondes)	Durée maximale en secondes jusqu’à 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 de SuccessFactors dépasse la durée du délai d’expiration, le flux ou le flux secondaire est annulé. Valeur par défaut : `30`.

Cliquez sur Envoyer.

Résultats

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

Synchroniser les données entre SuccessFactors et ServiceNow

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 pour synchroniser les données de façon 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 les données de , tandis que les flux Créer une tâche et Mettre à jour les tâches créent ou mettent à jour les enregistrements de SuccessFactorstâches lorsque SuccessFactors des événements se produisent dans ServiceNow. Lors de la personnalisation des exemples de flux, assurez-vous de fournir les 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 de :SuccessFactors

Département
Emplacement
Profil de poste
Profil d’agents
Profil d’agents effectifs
Historique d’emploi, y compris les affectations secondaires

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 les déclencheurs appropriés pour récupérer et enregistrer les mises à jour futures à l’aide de cartes de transformation.

Autres SuccessFactors entités

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