Configurer Spoke Slack

  • Rversion finale: Washingtondc
  • Mis à jour 1 févr. 2024
  • 7 minutes de lecture

    • Intégrez l’instance ServiceNow et votre compte Slack en créant une application OAuth personnalisée dans Slack pour authentifier les ServiceNow demandes.

    Avant de commencer

    • Demandez Hub d'intégration un abonnement.
    • Activez Spoke Slack.
    • Compte Slack.
    • Ajoutez des utilisateurs Slack à la table Utilisateur [sys_user] de votre ServiceNow instance, en utilisant l’e-mail comme identificateur unique.
    • Rôle requis : admin

    Pourquoi et quand exécuter cette tâche

    la procédure de configuration du spoke décrite ici nécessite uniquement des jetons d’utilisateur de bot. Vous ne pouvez pas utiliser les actions Créer un utilisateur et Désactiver l’utilisateur lorsque vous utilisez les champs d’application de jeton d’agent. Pour utiliser ces actions, vous devez obtenir un jeton d’utilisateur à partir de votre compte Slack.

    Configurer l’application Slack

    Créez une application OAuth personnalisée dans votre espace de travail Slack pour activer l'authentification OAuth 2.0 avec le spoke Slack.

    Avant de commencer

    Rôle requis : admin

    Pourquoi et quand exécuter cette tâche

    Effectuez ces étapes à partir de votre compte Slack. Vous pouvez créer une application ou configurer une application existante selon les configurations décrites ici.

    Procédure

    1. Créez un Slack espace de travail.
      Pour apprendre à créer un espace de travail, consultez Créer un espace de travail Slack. L’image suivante montre un espace de travail Slack classique.Espace de travail Slack.
    2. Accédez à la console de l’API Slack .
    3. Cliquez sur Créer une application.
    4. Dans la fenêtre Créer une application, sélectionnez la méthode la plus appropriée pour créer l’application.Créez une application sur Slack.
    5. Copiez et enregistrez les valeurs ID client, Secret client et Secret de signature de votre application Slack sur la page Informations d’identification de l’application.Informations d’identification de l’application Slack.
      Pour plus d’informations, consultez la section Obtenir l’ID client et le secret pour une étape ultérieure .
    6. Sur la page OAuth et autorisations :
      1. Spécifiez l’URL d’instance ServiceNow dans URL de redirection au format suivant : https://<nom-instance>.service-now.com/oauth_redirect.do.
      2. Ajoutez ces champs d’application de jetons de bot :
        • canaux :historique
        • canaux :gérer
        • canaux :lecture
        • messagerie instantanée :write
        • messagerie instantanée :write.customize
        • groupes :lecture
        • im :read
        • mpim :lecture
        • groupes :historique
        • groupes :écriture
        • im :historique
        • im :write
        • mpim :historique
        • mpim :écriture
        • utilisateurs :lecture
        • utilisateurs :read.email
        • fichiers :lecture

        Pour plus d’informations, consultez Champs d’application et autorisations.

        Remarque :
        la procédure de configuration du spoke décrite ici nécessite uniquement des jetons d’utilisateur de bot. Vous ne pouvez pas utiliser les actions Créer un utilisateur et Désactiver l’utilisateur lorsque vous utilisez les champs d’application de jeton d’agent. Pour utiliser ces actions, vous devez obtenir un jeton d’utilisateur à partir de votre compte Slack.
    7. Sur la page Commandes à barre oblique, créez une commande et spécifiez les valeurs suivantes :
      Champ Valeur
      Commande /Maintenant
      Demander URL https://<nom-instance>.service-now.com/api/sn_slack_ah_v2/command_service/<nom-application-slack>
      Description courte Description de la commande.
      Conseil d’utilisation Liste des paramètres pouvant être transmis. Par exemple, [opération] [table].

      Pour plus d’informations, reportez-vous à l’étape de commande Création d’une barre oblique .

    8. Sur la page Interactivité et raccourcis :
      1. Activez l’interactivité et spécifiez l’URL d’instance dans l’URL ServiceNow de demande au format suivant : https://<nom-instance>.service-now.com/api/sn_slack_ah_v2/slack/<nom-application-slack>/charge utile interactive .
        Pour plus d’informations, consultez la section Préparation de votre application pour les interactions de l’utilisateur .
      2. Créez un raccourci qui apparaît sur les messages et saisissez la valeur post_message_now pour l’ID de rappel.
        Pour plus d’informations, consultez la section Création d’un raccourci .
    9. Créez un bot Slack et ajoutez-le à votre application Slack et aux canaux requis.
      Pour plus d’informations, consultez Créer un bot pour votre espace de travail.

    Ajouter une connexion Slack dans l’instance ServiceNow

    Ajoutez la connexion Slack pour Concepteur de flux configurer le spoke Slack.

    Avant de commencer

    Rôle requis : admin

    Procédure

    1. Accédez à la Tout > Concepteur de flux > Concepteur.
    2. Cliquez sur Connexions.
      Remarque :
      Vous pouvez ajouter plusieurs connexions pour votre spoke Slack ; une pour chaque espace de travail Slack.
      Connexion du spoke Slack.
    3. Sur la vignette du spoke Slack, cliquez sur Afficher les détails.
    4. Sur la page Connexions, cliquez sur Configurer.
      La fenêtre contextuelle affiche un formulaire Configurer la connexion vide.
    5. Renseignez ces valeurs sur le formulaire.
      Tableau 1. Formulaire Configurer la connexion
      Champ Description
      URL de connexion URL pour se connecter à Slack. Saisissez https://slack.com.
      Nom des informations d'identification Nom permettant d’identifier l’enregistrement des informations d’identification. Par exemple, Slack Cred.
      Nom OAuth Nom permettant d’identifier l’enregistrement OAuth. Par exemple, OAuth Slack.
      ID client OAuth ID client de votre application Slack.
      Secret client OAuth Secret client de votre application Slack.
      URL de redirection OAuth URL de redirection fournie dans votre application Slack. Cette valeur est renseignée automatiquement.
    6. Cliquez sur Configurer et obtenir le jeton OAuth.
    7. Dans la fenêtre contextuelle, cliquez sur Autoriser.
      Le jeton d’accès OAuth est généré pour le spoke Slack.

    Fournir une clé de signature dans l’instance ServiceNow

    Fournissez les Slack détails de l’application et une clé de signature dans votre ServiceNow instance pour authentifier les demandes à partir de ServiceNow.

    Avant de commencer

    Rôle requis : admin

    Procédure

    1. Accédez à la Tout > Slack > Configurations de Slack.
    2. Ouvrez l’enregistrement par défaut.
      Vous pouvez également créer un enregistrement pour fournir d’autres clés de signature.
    3. Renseignez ces valeurs sur le formulaire.
      Tableau 2. Formulaire de configuration de Slack
      Champ Description
      Slack Application Nom de votre Slack application.
      Remarque :
      Ce nom doit être identique au nom de l’application fournie lors de la création de l’application Slack .
      Alias de connexion Alias de connexion associé à l’application sélectionnée dans l’onglet Connexions .
      Nom de la propriété Nom de la Slack configuration. Entrez le secret de signature.
      Secret de connexion Secret de connexion de votre Slack application.
    4. Cliquez sur Mettre à jour.

    Configurer les configurations sortantes dans l’instance ServiceNow

    Spécifiez les événements dans l’instance ServiceNow pour lesquels des actions doivent être effectuées sur votre Spoke Slack application.

    Avant de commencer

    Rôle requis : admin

    Pourquoi et quand exécuter cette tâche

    Les configurations sortantes fournissent un modèle pour les actions et les flux secondaires Publier un message exploitable et Publier le message d’approbation. Vous pouvez personnaliser les configurations sortantes par défaut ou créer une configuration sortante selon vos besoins.

    Procédure

    1. Accédez à la Tout > Slack > Configurations sortantes.
    2. Cliquez sur Nouveau pour créer un modèle de configuration sortante ou cliquez sur la configuration sortante par défaut pour la configurer.
    3. Renseignez ces valeurs dans le formulaire Configuration sortante.
      Tableau 3. Formulaire Configuration sortante
      Champ Description
      Nom Nom permettant d’identifier l’enregistrement de configuration sortant.
      Titre du message Titre du message publié dans le Spoke Slack canal. Par exemple, En attente d’approbations pour {0}.
      Table cible ServiceNow Table à partir de laquelle les détails de l’enregistrement sont récupérés.
      Champs Champs de la table dont les ServiceNow valeurs doivent être affichées dans le message publié dans le Spoke Slack canal.
      Boutons Boutons permettant aux utilisateurs concernés de prendre des mesures dans le Spoke Slack canal. Par exemple, Approuver ou rejeter une demande. Pour plus d’informations sur les boutons et leur style, consultez Élément de bouton.
      Remarque :
      Les utilisateurs doivent disposer des autorisations requises pour effectuer les actions nécessaires. Par exemple, l’utilisateur doit avoir les autorisations requises pour approuver ou rejeter une demande. Ces autorisations sont basées sur les rôles d’utilisateur affectés aux utilisateurs de votre ServiceNow instance.
      Liste de choix Choix sortants Slack tels que Rejeter. Ces options sont affichées sous forme de liste dans le canal Slack.
      ID de l'action Identificateur unique de la configuration sortante.
      Remarque :
      L’ID d’action de la configuration sortante doit être utilisé dans la décision entrante pertinente pour terminer le flux. Par exemple, l’ID d’action de la configuration sortante du message d’approbation est fourni dans la décision entrante de la décision d’approbation. Cela garantit qu’en cas d’approbation ou de rejet de la demande, l’enregistrement approprié est mis à jour dans votre ServiceNow instance.
    4. Cliquez sur Envoyer.

    Configurer les décisions entrantes dans l’instance ServiceNow

    Spécifiez les événements de votre application pour lesquels des actions doivent être effectuées dans l’instance Spoke SlackServiceNow .

    Avant de commencer

    Rôle requis : admin

    Procédure

    1. Accédez à la Tout > Slack > Décisions entrantes.
    2. Cliquez sur Nouveau.
    3. Dans le formulaire Décision, renseignez ces valeurs.
      Tableau 4. Formulaire Décision
      Champ Description
      Étiquette Nom permettant d’identifier la décision entrante.
      Réponse Flux secondaire qui doit être déclenché lorsque les conditions spécifiées sont remplies.
      Réponse par défaut Option permettant de spécifier s’il s’agit de la réponse par défaut. La réponse par défaut s’applique lorsque les conditions ne sont pas remplies.
      1. Cliquez sur l'icône de recherche ( icône de recherche).
      2. Sélectionnez le flux secondaire requis dans la liste des documents.
        Remarque :
        Assurez-vous que le nom de la table est Flux [sys_hub_flow].
      Condition Conditions à remplir dans votre application pour lesquelles des actions doivent être effectuées dans l’instance SlackServiceNow .
      Pour mettre à jour l’enregistrement approprié dans votre ServiceNow instance, spécifiez la valeur d’ID d’action que vous avez fournie lors de la configuration des configurations sortantes dans la condition.
      Remarque :
      L’ID d’action de la configuration sortante doit être utilisé dans la décision entrante pertinente pour terminer le flux. Par exemple, l’ID d’action de la configuration sortante du message d’approbation est fourni dans la décision entrante de la décision d’approbation. Cela garantit qu’en cas d’approbation ou de rejet de la demande, l’enregistrement approprié est mis à jour dans votre ServiceNow instance.
    4. Cliquez sur Envoyer.
      Lorsque les événements remplissent les conditions spécifiées dans la politique, le flux secondaire associé est déclenché.
      Remarque :
      Ces décisions entrantes sont enregistrées dans les tables de décision. Les utilisateurs sont mis en garde contre la mise à jour ou la modification directe des données dans ces tables.
      Si vous souhaitez afficher des fenêtres modales dans Slack, consultez Configurer Slack les modaux dans ServiceNow l’instance.