Configurer la SuccessFactorsSpoke version v4.x.x

  • Rversion finale: Washingtondc
  • Mis à jour 1 févr. 2024
  • 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
    • Activer le SuccessFactorsSpoke
    • Activez les propriétés système suivantes :
      • 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.2.1 pour la première fois. Si vous utilisez une version antérieure de , SuccessFactorsSpoke consultez Migrer vers SuccessFactorsSpoke v4.2.1 la procédure de migration.

    Pour plus d’informations sur la configuration du spoke, consultez Spoke SAP SuccessFactors - Configuration et migration OAuth - Pre-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 Master SAP Data en générant les fichiers keystore.jks et keystore.cer ;.

    Avant de commencer

    Procédure

    1. Connectez-vous au SuccessFactors compte en tant qu’administrateur.
    2. Accédez au Centre d’administration et cliquez sur Paramètres de l’entreprise.
    3. Cliquez sur Gérer les applications clientes OAuth2.
    4. Cliquez sur Enregistrer l’application client.
      Enregistrez une 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.

    Charger le certificat JKS dans votre ServiceNow instance

    Activez l’authentification du certificat client pour la communication sortante en téléchargeant le certificat JKS dans votre ServiceNow instance.

    Avant de commencer

    Rôle requis : admin

    Procédure

    1. Connectez-vous à votre ServiceNow instance en tant qu’administrateur.
    2. Chargez le certificat JKS sur votre ServiceNow instance.
      Pour savoir comment charger le certificat JKS, consultez Charger un certificat sur une instance .
      Chargez le certificat JKS.

    S’inscrire SuccessFactors en tant que fournisseur OAuth

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

    Procédure

    1. Dans votre ServiceNow instance, accédez à OAuth système > Registre d'application.
    2. Cliquez sur Nouveau.
    3. Renseignez les champs du 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.
      Type d'accord par défaut Type d’accord par défaut utilisé pour établir le jeton. Sélectionnez 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.
    4. 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 avec le fournisseur.

    Avant de commencer

    Rôle requis : admin

    Procédure

    1. Créez un enregistrement de créateur d’assertion SAML2 dans votre ServiceNow instance.
      1. Accédez à la Tout > OAuth système > Créateurs d'assertions SAML2.
      2. Cliquez sur Nouveau.
      3. Renseignez ces valeurs sur le formulaire.
        Champ Description
        Nom Nom unique permettant d’identifier l’enregistrement du créateur d’assertion SAML2. Par exemple, Successfactor SAML OAuth.
        É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 souhaité de l’assertion. Saisissez l’URL au format suivant : https://<SuccessFactors-Instance-Name>/oauth/token.
        Enregistrement du créateur d’assertion SAML2.
      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.
        Champ Description
        Nom Nom unique permettant d’identifier l’enregistrement du magasin de clés d’assertion SAML2. Par exemple, sap_successfactor.
        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, 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 précédemment créé. Pour plus d'informations, consultez Charger le certificat JKS dans votre ServiceNow instance.
        Enregistrement du magasin de clés d’assertion SAML2.
      7. Cliquez sur Envoyer.
      8. Accédez à la Tout > OAuth système > Cré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 Attributs d’assertion SAML2 , cliquez sur Nouveau.
      11. Renseignez ces valeurs sur le formulaire.
        Champ Description
        Nom Nom permettant d’identifier l’enregistrement de l’attribut d’assertion SAML2. Saisissez 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 de l’attribut d’assertion SAML2.
      12. Cliquez sur Envoyer.
    2. 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 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.
      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.
        Enregistrement du profil de l’intégrité OAuth.
      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. L’alias SuccessFactorsSpoke de connexion et d’informations d’identification utilise 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 Tout > Connexions et informations d'identification > Informations 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 Informations d’identification OAuth 2.0 vide s’affiche.
    4. Renseignez ces valeurs sur le formulaire.
      Champ Valeur requise
      Nom Nom permettant d'identifier l'enregistrement de façon unique. Par exemple, entrez SAML_SuccessFactors_OData_Cred.
      Profil de l'entité OAuth Enregistrement du profil de l’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.
    5. 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. L’alias SuccessFactorsSpoke de connexion et d’informations d’identification utilise 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 Tout > Connexions et informations d'identification > Informations 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 Informations d’identification OAuth 2.0 vide s’affiche.
    4. Renseignez ces valeurs sur le formulaire.
      Champ Valeur requise
      Nom Nom permettant d'identifier l'enregistrement de façon unique. Par exemple, entrez 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.
    5. Cliquez sur Envoyer.

    Résultats

    L’enregistrement d’informations d’identification permettant d’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. L’alias SuccessFactorsSpoke de connexion et d’informations d’identification utilise ces connexions pour effectuer des actions dans SuccessFactors.

    Avant de commencer

    Rôle requis : admin.

    Procédure

    1. Accédez à la Tout > Connexions et informations d'identification > Alias de connexion et d'informations d'identification.
    2. Ouvert pour l’enregistrement de 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.
      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.
      Actif Option permettant d’utiliser activement l’enregistrement de connexion.
      Enregistrement de connexion OData.
    5. Cliquez sur Envoyer.

    Résultats

    L’enregistrement de connexion de 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. L’alias SuccessFactorsSpoke de connexion et d’informations d’identification utilise ces connexions pour effectuer des actions dans SuccessFactors.

    Avant de commencer

    Rôle requis : admin.

    Procédure

    1. Accédez à la Tout > Connexions et informations d'identification > Alias de connexion et d'informations d'identification.
    2. Ouvert 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.
      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.
      Actif Option permettant d’utiliser activement l’enregistrement de connexion.
    5. Dans l’onglet Attributs , indiquez les champs suivants.
      Champ Description
      ID de la société ID de société immuable de votre SuccessFactors instance.
      Délai d’expiration du flux (en secondes) Durée maximale, en secondes, à partir de SuccessFactors laquelle les données peuvent être reçues 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é. La valeur par défaut est 30.
      Enregistrement d’une connexion SOAP.
    6. Cliquez sur Envoyer.

    Résultats

    L’enregistrement de connexion de 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 votre instance et ServiceNow vousSuccessFactors.

    Entité de l’action à faire

    Le SuccessFactors spoke fournit des exemples de flux pour synchroniser les données de manière bidirectionnelle pour l’entité de l’action à faire. L’exemple de flux Exécuter le flux d’intégration SuccessFactors peut être personnalisé pour récupérer les données de SuccessFactors, tandis que les flux Créer une action à faire et Mettre à jour l’action à faire créent ou mettent à jour les enregistrements d’action à faire dans SuccessFactors le cas où des événements se produisent dans ServiceNow. Lors de la personnalisation des échantillons 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 à partir de SuccessFactors:
    • Département
    • Adresse
    • Profil de poste
    • Profil des agents
    • Profil d’agents effectifs
    • Historique professionnel, 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 les 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.

    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.