Configurer Spoke Slack

Rversion finale: Xanadu

Mis à jour 1 août 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 ServiceNow les demandes.

Avant de commencer

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

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 du jeton de bot. 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 : administrateur

Pourquoi et quand exécuter cette tâche

Suivez 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

Créez un Slack espace de travail.
Pour savoir comment créer un espace de travail, consultez Créer un espace de travail Slack. L’image suivante montre un espace de travail Slack classique.
Accédez à la console de l’API Marge .
Cliquez sur Créer une application.
Dans la fenêtre Créer une application, sélectionnez la méthode la plus appropriée pour créer l’application.
À partir de la page Informations d’identification de l’application sur la page Informations de base, copiez et enregistrez les valeurs ID client, Secret client et Secret de connexion de votre application Slack.
Pour plus d’informations, consultez la section Obtenir l’ID client et le secret pour une étape ultérieure .
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 jeton 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 :écrire
  - 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 du jeton de bot. Pour utiliser ces actions, vous devez obtenir un jeton d’utilisateur à partir de votre compte Slack.

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 brève	Description de la commande.
Conseil d’utilisation	Liste des paramètres qui peuvent être transmis. Par exemple, `[opération] [table].`

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

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

Ajouter une connexion Slack dans l’instance ServiceNow

Ajoutez la connexion Slack pour Studio de workflow configurer le spoke Slack.

Avant de commencer

Rôle requis : administrateur

Procédure

Accédez à la Tout > Concepteur de flux > Concepteur.
Cliquez sur Connexions.

Remarque :
Vous pouvez ajouter plusieurs connexions pour votre spoke Slack ; une pour chaque espace de travail Marge.
Sur la vignette du spoke Slack, cliquez sur Afficher les détails.
Sur la page Connexions, cliquez sur Configurer.
La fenêtre contextuelle affiche un formulaire Configurer la connexion vide.

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 d’informations d’identification. Par exemple, `Slack Cred`.
Nom OAuth	Nom permettant d’identifier l’enregistrement OAuth. Par exemple, `Slack OAuth`.
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.

Cliquez sur Configurer et obtenir le jeton OAuth.
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 des Slack détails de l’application et une clé de signature dans votre ServiceNow instance pour authentifier les demandes provenant de ServiceNow.

Avant de commencer

Rôle requis : administrateur

Procédure

Accédez à la Tout > Slack > Configurations de Slack.
Ouvrez l’enregistrement par défaut.
Vous pouvez également créer un nouvel enregistrement pour fournir d’autres clés de signature.

Renseignez ces valeurs sur le formulaire.

Tableau 2. Formulaire de configuration de Slack
Champ	Description
Slack Appli	Nom de votre Slack application. Remarque : Ce nom doit être identique au nom de l’application fourni 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. `Saisissez le secret de signature`.
Secret de connexion	Secret de connexion de votre Slack application.

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 un message d’approbation. Vous pouvez personnaliser les configurations sortantes par défaut ou créer une configuration sortante selon vos besoins.

Procédure

Accédez à la Tout > Slack > Configurations sortantes.
Cliquez sur Nouveau pour créer un modèle de configuration sortante ou cliquez sur la configuration sortante par défaut pour la configurer.

Renseignez ces valeurs sur le formulaire Configuration sortante.

Tableau 3. Formulaire de 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’approbation 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 qui est publié dans le Spoke Slack canal.
Boutons	Boutons permettant aux utilisateurs concernés d’effectuer une action dans le Spoke Slack canal. Par exemple, Approuver ou rejeter une demande. Pour plus d’informations sur les boutons et leur style, reportez-vous à la rubrique Élément de bouton. Remarque : Les utilisateurs doivent disposer des autorisations requises pour effectuer les actions nécessaires. Par exemple, l’utilisateur doit disposer des 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 décision d’approbation. Cela garantit qu’après l’approbation ou le rejet de la demande, une mise à jour est effectuée sur l’enregistrement pertinent dans votre ServiceNow instance.

Cliquez sur Envoyer.

Configurer les décisions entrantes dans l’instance ServiceNow

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

Avant de commencer

Rôle requis : administrateur

Procédure

Accédez à la Tout > Slack > Décisions entrantes.
Cliquez sur Nouveau.

Renseignez ces valeurs dans le formulaire Décision.

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. Cliquez sur l'icône de recherche ( ). Sélectionnez le flux secondaire requis dans la liste Document. 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 ServiceNow l’instanceSlack. Pour mettre à jour l’enregistrement pertinent 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 décision d’approbation. Cela garantit qu’après l’approbation ou le rejet de la demande, une mise à jour est effectuée sur l’enregistrement pertinent dans votre ServiceNow instance.

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 de ces tables.
Si vous souhaitez afficher des fenêtres modales dans Slack, reportez-vous à la section Configurer Slack les modaux dans ServiceNow l’instance.