Configuration de la synchronisation des actifs
Outre la synchronisation des clients et des contacts vers les organisations et les clients Jira, DYCE Connector for Jira Service Management peut synchroniser des clients, des contacts, des projets et des Service Assets vers Jira en tant qu'objets Jira Assets (Insight). La synchronisation des actifs repose sur le même mécanisme OAuth2 que celui décrit dans Configuration, mais nécessite ses propres portées et un élément de configuration supplémentaire.
Conditions préalables
- Jira Assets (Insight) est activé sur le site Jira Service Management.
- La configuration générale de DYCE Connector for Jira Service Management est déjà terminée ou est effectuée en même temps que celle de la synchronisation des actifs.
- Droits de modification de l'application OAuth 2.0 utilisée dans la Atlassian Developer Console.
Configuration OAuth2 pour les actifs
La synchronisation des actifs utilise la même table Configuration OAuth2 Jira que la synchronisation des organisations et des clients, généralement avec son propre enregistrement de configuration, car elle nécessite un autre ensemble de portées. Sur la page Liste des configurations OAuth2 Jira, sélectionner Créer la configuration Assets crée une configuration prête à l'emploi avec le code de configuration ASSETS-OAUTH, l'URL de base par défaut (https://api.atlassian.com) et toutes les portées requises déjà appliqués. Si une configuration portant ce code existe déjà, confirmez pour l'écraser.
Ajoutez les mêmes portées à l'application OAuth 2.0 dans l'Atlassian Developer Console ; les étapes générales sont décrites dans Enregistrement de l'application OAuth 2.0 dans Atlassian. Il est possible d'enregistrer une application distincte pour les actifs ou d'étendre l'application existante avec les portées supplémentaires ci-dessous.
Portées requises
| Portée | Objet |
|---|---|
offline_access | Obtenir un jeton d'actualisation afin que les jetons d'accès puissent être renouvelés automatiquement |
read:jira-user | Lire les informations des utilisateurs Jira (utilisé pour tester la connexion) |
read:jira-work | Accès général en lecture à Jira |
read:servicedesk-request | Lire les demandes du service desk |
read:cmdb-object:jira | Lire les objets Jira Assets |
write:cmdb-object:jira | Créer et mettre à jour des objets Jira Assets (synchronisation de Customer, Customer Employee, Project et Service Asset) |
read:cmdb-schema:jira | Lire les schémas Jira Assets |
write:cmdb-schema:jira | Créer et mettre à jour des schémas Jira Assets |
read:cmdb-type:jira | Lire les types d'objets Jira Assets |
write:cmdb-type:jira | Créer et mettre à jour des types d'objets Jira Assets |
read:cmdb-attribute:jira | Lire les définitions d'attributs Jira Assets |
write:cmdb-attribute:jira | Créer et mettre à jour des définitions d'attributs Jira Assets |
read:cmdb-config:jira | Lire la configuration de l'espace de travail Jira Assets (utilisé pour rechercher l'ID de l'espace de travail) |
L'action Créer la configuration Assets de la page Liste des configurations OAuth2 Jira applique déjà toutes les portées ci-dessus ; il n'est nécessaire de les ajouter manuellement que si la configuration est créée d'une autre manière.
Autorisation et recherche de l'ID de l'espace de travail
L'autorisation fonctionne de la même manière que pour toute autre configuration OAuth2 ; voir Autorisation auprès d'Atlassian.
Jira Assets identifie en outre l'espace de travail cible par un ID de l'espace de travail Assets, affiché sur la fiche de configuration OAuth2. Une fois l'autorisation effectuée, sélectionnez Rechercher l'ID de l'espace de travail pour le déterminer et le renseigner automatiquement. Tant que ce champ n'est pas renseigné, la synchronisation des actifs échoue avec une erreur signalant l'absence d'espace de travail.
Autorisations
La synchronisation des actifs utilise les mêmes ensembles d'autorisations que le reste du connecteur (Lecture, Édition et Admin), étendus pour couvrir également les tables des schémas d'actifs, des types d'objets, des attributs et des mappages de champs, ainsi que la table des Service Assets. Aucun ensemble d'autorisations distinct n'est nécessaire.