Configurer le Spoke UKG

  • Rversion finale: Xanadu
  • Mis à jour 1 août 2024
  • 6 minutes de lecture

    • Intégrez votre application Kronos à votre instance ServiceNow. Enregistrez une application OAuth et Kronos authentifiez les demandes à partir de ServiceNow.

    Avant de commencer

    • Demander Hub d'intégration un abonnement
    • Activez l’option Spoke UKG
    • Kronos Informations d’identification d’utilisateur gestionnaire ou de superutilisateur
    • Rôle requis : administrateur
    Remarque :
    Assurez-vous que le registre d’application, les connexions et les informations d’identification se trouvent dans le périmètre de l’application.
    Vous pouvez choisir de le configurer Spoke UKG à l’aide du modèle de connexion ou à l’aide d’enregistrements de connexion et d’informations d’identification en fonction de vos besoins.

    Option 1 : Configurer une connexion pour le spoke UKG

    Ajoutez et configurez une connexion à l’aide du modèle de connexion pour authentifier les ServiceNow demandes dans le spoke UKG.

    Avant de commencer

    Rôle requis : administrateur

    Remarque :
    Si vous effectuez une mise à jour à partir d’une version précédente (antérieure à la version 3.3.0) du spoke, vous devez d’abord supprimer l’enregistrement de connexion actuel, l’enregistrement d’informations d’identification et les informations d’identification de l’utilisateur Kronos. Ensuite, vous pouvez configurer la connexion à l’aide du modèle.

    Procédure

    1. Accédez à la Tout > Automatisation des processus > Concepteur de flux.
    2. Sélectionnez l’onglet Connexions .
    3. Localisez l’alias de connexion UKG et cliquez sur Afficher les détails.
      Remarque :
      Ne cliquez pas sur Ajouter une connexion.
      Modèle de connexion pour le spoke UKG.
    4. Cliquez sur Modifier.
      Si vous configurez le spoke pour la première fois, cliquez sur Configurer.Configurer une connexion pour le spoke UKG
    5. Renseignez les champs du formulaire.
      Champ Description
      Nom de la connexion Nom permettant d’identifier de façon unique l’enregistrement de connexion. Par exemple, saisissez Kronos Conn.
      URL de connexion URL de l'instance Kronos
      Clé de l'application Clé d’application de l’instance Kronos .
      Nom de l’entité OAuth Nom unique permettant d’identifier le profil de l’entité OAuth du spoke UKG. Par exemple, sélectionnez Entité OAuth UKG.
      ID client OAuth ID client créé lors de la configuration de l’application dans Kronos.
      Secret client OAuth Secret client créé lors de la configuration de l’application dans Kronos.
      URL de jeton Point de terminaison de jeton du serveur OAuth. Par exemple, https://<Kronos-Instance>.com/api/authentication/access_token.
    6. Cliquez sur Configurer et obtenir le jeton OAuth.
      Une page modale s’affiche pour saisir vos Kronos informations d’identification.
    7. Entrez votre nom d’utilisateur et votre Kronos mot de passe, puis cliquez sur Obtenir un jeton OAuth.

    Résultats

    Une fois que votre jeton OAuth a été récupéré avec succès, vous pouvez commencer à utiliser votre connexion de spoke UKG.

    Option 2 : utilisation des enregistrements de connexion et d’informations d’identification pour la configuration du spoke UKG

    Créez un enregistrement de connexion et un enregistrement d’informations d’identification pour configurer le spoke UKG.

    Avant de commencer

    Rôle requis : administrateur
    Remarque :
    Si vous avez déjà configuré une connexion à l’aide du modèle de connexion, vous pouvez ignorer cette procédure.

    Enregistrer Kronos en tant que fournisseur OAuth

    Utilisez les informations générées lors de la création et de la configuration de l’application Kronos pour vous enregistrer Kronos en tant que fournisseur OAuth et permettre à l’instance de demander des jetons OAuth 2.0.

    Avant de commencer

    Rôle requis : administrateur

    Procédure

    1. Accédez à la Tout > OAuth système > Registre d'application.
    2. Ouvrez l’enregistrement du Kronosspoke.
    3. Renseignez les champs du formulaire.
      Champ Valeur requise
      Nom Nom permettant d'identifier l'enregistrement de façon unique. Par exemple, saisissez le profil Kronos OAuth.
      ID client ID client créé lors de la configuration de l’application dans Kronos.
      Secret client Secret client créé lors de la configuration de l’application dans Kronos.
      Type d'accord par défaut Type d'accord utilisé pour établir le jeton. Sélectionnez Informations d’identification du mot de passe du propriétaire de ressource.
      Application Périmètre de l'application qui contient cet enregistrement. Sélectionnez Kronos Spoke.
      Accessible depuis Périmètre de l'application à partir duquel ce registre est accessible.
      Actif Option permettant d’utiliser activement le registre d’application. Sélectionnez l’option.
      URL de jeton Point de terminaison de jeton du serveur OAuth. Par exemple, https://<Kronos-Instance>.com/api/authentication/access_token .
      URL de redirection Point de terminaison de rappel OAuth. Par exemple, https://<ServiceNow-Instance>.com/oauth_redirect.do.
    4. Cliquez avec le bouton droit de la souris sur l'en-tête du formulaire, puis cliquez sur Enregistrer.
    5. Dans l’onglet Périmètres de l’entité OAuth , insérez une ligne et fournissez ces valeurs.
      Champ Valeur
      Nom Kronos
      Périmètre OAuth givenName mail nonce profil openid sn uid
    6. Cliquez sur Mettre à jour.
    7. Dans l’onglet Profil de l’entité OAuth , cliquez sur le profil par défaut, Kronos oAuth default_profile.
    8. Insérez un enregistrement dans la liste connexe Périmètre de l’entité OAuth et sélectionnez le périmètre de l’entité par défaut pour le Kronos spoke, par exemple, Kronos.
    9. Cliquez sur Mettre à jour.

    Créer un enregistrement d’informations d’identification pour le Kronos spoke

    Autorisez les actions de Kronos spoke en créant des enregistrements d’informations d’identification pour l’application enregistrée dans Kronos. Les Kronos alias de connexion et d’informations d’identification du spoke utilisent ces informations d’identification pour autoriser des actions.

    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.
    4. Renseignez les champs du formulaire.
      Champ Valeur requise
      Nom Nom permettant d'identifier l'enregistrement de façon unique. Par exemple, Kronos Cred.
      Actif Option permettant d'utiliser activement l'enregistrement des informations d'identification. Sélectionnez l’option.
      Profil de l'entité OAuth Profil de l’entité OAuth par défaut du Kronos spoke. Par exemple, sélectionnez Kronos oAuth default_profile.
      Ordre Ordre dans lequel les informations d'identification sont utilisées. Par exemple, saisissez 100.
    5. Cliquez avec le bouton droit sur l'en-tête du formulaire, puis cliquez sur Enregistrer.

    Fournir Kronos les informations d’identification de l’utilisateur

    Créez un enregistrement pour fournir les détails et les informations d’identification de l’utilisateur requis Kronos . Le Kronos spoke utilise ces informations d’identification d’utilisateur pour effectuer des actions dans Kronos.

    Avant de commencer

    Rôle requis : admin.

    Pourquoi et quand exécuter cette tâche

    Assurez-vous de fournir les informations d’identification d’un gestionnaire, d’un utilisateur ou Kronos d’un superutilisateur. Ces informations d’identification permettent de gérer les demandes de congés des employés et des responsables.

    Procédure

    1. Accédez à la Tout > Kronos > Informations d'identification.
    2. Cliquez sur Nouveau.
    3. Renseignez ces valeurs sur le formulaire.
      Tableau 1. Formulaire d’informations d’identification Kronos
      Champ Descriptions
      Nom Nom permettant d'identifier l'enregistrement de façon unique.
      Clé de l'application Clé d’application de l’utilisateur Kronos .
      Nom d'utilisateur Nom d’utilisateur pour se connecter au compte de l’utilisateur dans Kronos.
      Mot de passe Mot de passe du Kronos compte utilisateur.
      Alias de connexion et d'informations d'identification Enregistrement d’alias Kronos par défaut associé au spoke.
      Expiration du jeton d'actualisation Date et heure auxquelles le jeton d’actualisation Kronos expire. Le Kronos spoke génère périodiquement un nouveau jeton d’actualisation avant l’expiration du jeton d’actualisation actuel.
    4. Cliquez sur Envoyer.
    5. Pour générer le Kronos jeton, cliquez sur le lien connexe Obtenir un jeton Kronos .

    Résultats

    Le flux secondaire Kronos - Obtenir un jeton Kronos est déclenché. Le flux secondaire utilise les détails fournis lors de la configuration du spoke pour récupérer un jeton d’actualisation valide à partir de Kronos. Le flux secondaire met ensuite à jour la valeur de l’option Expiration du jeton d’actualisation.
    Remarque :
    Pour accéder à plus de détails sur le jeton d’actualisation Kronos , accédez à OAuth système > Gérer les jetons.. Ici, un enregistrement est créé pour chaque jeton d’actualisation.

    Créer un enregistrement de connexion pour le Kronos spoke

    Créez des enregistrements de connexion à votre Kronos application. Les alias de connexion et d’informations d’identification Kronos du spoke utilisent ces connexions pour effectuer des actions dans Kronos.

    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. Ouvrez l’enregistrement du Kronos spoke.
    3. Dans l’onglet Connexions , cliquez sur Nouveau.
    4. Renseignez ces valeurs sur le formulaire.
      Tableau 2. Formulaire Connexion HTTP(s)
      Champ Valeur requise
      Nom Nom permettant d’identifier de façon unique l’enregistrement de connexion. Par exemple, saisissez Kronos Conn.
      Informations d'identification Enregistrement d’informations d’identification que vous avez créé pour Kronos. Par exemple, sélectionnez Kronos Cred. Consultez Créer un enregistrement d’informations d’identification pour le Kronos spoke pour plus d'informations.
      Alias de connexion Enregistrement d'alias associé à cette connexion.
      Générateur d'URL
      Remarque :
      ne cochez pas la case.
      URL de connexion URL de l'instance Kronos
      Utiliser un MID Server Ce champ n’est pas applicable.
      Actif Option permettant d'utiliser activement la connexion. Sélectionnez l’option.
      Domaine Domaine dans lequel l'action ou l'activité s'exécute.
    5. Renseignez ces valeurs dans l’onglet Attributs .
      Champ Description
      u_app_key Clé d’application de l’utilisateur Kronos .
      u_version Kronos Version de votre instance. Entrez v1.
    6. Cliquez sur Envoyer.