Pour configurer le provisionnement, vous aurez besoin d'accéder à la console de configuration de la plateforme.

1. Ouvrez la zone d'administration (symbole d'engrenage).
2. Ouvrez la vue Connecteurs.
3. Choisissez « Nouveau connecteur »

4. Sélectionnez REST API générique » comme type de source de données

5. Donnez un nom au connecteur et ajoutez les paramètres de connexion :

• Nom du connecteur - donnez un nom convivial à votre connecteur (ce nom peut être modifié ultérieurement).
• URL de l'hôte - URL de base pour REST API . Elle peut être utilisée comme préfixe pour l'URL finale à appeler.
• Type de connecteur REST - sélectionnez Générique
• Méthode d'authentification - Sélectionnez Jeton dynamique

• URL de connexion : https://login.microsoftonline.com/2b6a6dc0-a6f1-47ff-8818-bafda12d454c/oauth2/v2.0/token
• Corps de la requête de connexion (modifiez votre client_id et client_secret, les deux autres attributs ont des valeurs constantes) : client_id=123abc&client_secret=abcde&grant_type=client_credentials&scope=499b84ac-1321-427f-aa17-267ca6975798/.default
• Méthode de connexion : POST
• Type de contenu de connexion : application/x-www-form-urlencoded
• Jeton de connexion valide pendant (en secondes) : 3598
• En-têtes de connexion : Content-Type = application/x-www-form-urlencoded
• Utilisation du jeton : Bearer @TOKEN@
• Attribut Token dans la réponse : access_token

6. Configurez correctement la pagination si vous comptez utiliser cette connexion avec des tâches planifiées.

7. Fournir les informations utilisateur WebAPI

• Utilisateur WebAPI - sélectionnez l'utilisateur WebAPI approprié qui sera utilisé lors de l'écriture de données provenant d'un système externe vers les solutions Matrix42 Core , Pro and IGA
• Mot de passe WebAPI - mot de passe de l'utilisateur WebAPI

8. Enregistrer les informations du connecteur

9. Ajoutez le certificat racine HTTPS externe Microsoft Azure DevOps à la liste de confiance de la gestion des connecteurs (EPE). Cette opération ne peut être effectuée que via Matrix42 : Ajouter un certificat.

10. Les solutions Matrix42 Core , Pro and IGA peuvent désormais se connecter à Microsoft Azure DevOps.

• L'étape suivante consiste à configurer une tâche planifiée pour la lecture des données ou une tâche événementielle pour l'écriture des données et les actions à entreprendre dans Microsoft Azure DevOps.

La lecture des données de Microsoft Azure DevOps via les tâches planifiées n'est pas prise en charge actuellement. En effet, Microsoft Azure DevOps utilise une méthode de pagination non compatible avec notre connecteur REST API générique. L'en-tête de réponse Azure DevOps contient le jeton x-ms-continuationtoken nécessaire à la pagination.

Mais vous pouvez toujours lire un objet depuis Azure DevOps en utilisant des tâches basées sur des événements et un nœud d'orchestration de flux de travail avec l'action GET.

Voici un exemple basique de tâche d'événement et de nœud d'orchestration, utilisés pour créer des tickets dans Microsoft Azure DevOps.

1. Ajoutez une tâche événementielle sous le connecteur approprié en cliquant sur « Nouvelle tâche ».

2. Définir les attributs de la tâche

Nom de la tâche - nom unique descriptif
Utilisation de la tâche - Événement
Type de mappage - Modèle générique
Requête : URL de l’ API à appeler. Dans cet exemple, nous créons un ticket ; nous utilisons donc la requête suivante : vous pouvez la laisser vide. Nous allons définir l’URL de l’API dans l’attribut URL REST du nœud Orchestration.

En-têtes de requête : configurez ces trois en-têtes comme indiqué sur la capture d’écran.
Accepter / application/json
X-TFS-FedAuthRedirect / Supprimez
Type de contenu / application/json-patch+json

Formateur d'attributs de date - définissez le format correct si vous configurez des attributs de date : aaaa-MM-jj
Formateur d'attributs de date et d'heure : définissez le format correct si vous configurez des attributs de date et d'heure : aaaa-MM-jjTHH:mm:ssZ

Définir les mappages génériques

Modèle cible - modèle à partir duquel vous allez appeler cette tâche dans le workflow
Dossier cible - dossier contenant vos données

Les attributs ne sont pas définis dans la table de correspondance (attribut externe - attribut local). La correspondance des attributs est effectuée sur le nœud d'orchestration du flux de travail.

3. Enregistrer la tâche

4. Créez un nœud d'orchestration dans votre flux de travail pour appeler cette tâche événementielle.

Orchestrate - Moteur de vision Pro
Source de données - REST API générique
Activité - Appel REST générique
Cible - Créer un ticket AD O (nom de votre tâche basée sur un événement)
Action - Dans cet exemple, une requête POST est utilisée pour la création des tickets.
URL REST - dans cet exemple /$Bug?api-version=7.1 puisque nous créons des tickets de type Bug, vous pouvez modifier ce type Bug pour en faire un autre pris en charge par Azure DevOps afin de créer des tickets de types différents.
Corps de REST : vous pouvez générer le corps de l'appel API directement ici. Dans les cas plus complexes, vous pouvez le générer séparément (dans un nœud de script) dans un attribut, puis utiliser cet attribut ici. Dans ce cas, le corps de l'appel pour la création d'un ticket est généré directement ici.
Le corps de texte utilisé dans cet exemple contient les valeurs Title et ReproSteps lues à partir des attributs subject et details des datacards. L'effort est codé en dur pour la version 3.0. Les balises MyTESTTag et AreaPath sont codées en dur sur Test\\My team1. En réalité, areaPath ne contient qu'une seule barre oblique inverse (\), mais il en faudrait deux pour être compatible JSON.
[
{ "op": "add", "path": "/fields/System.Title", "value": "$subject$" },
{ "op": "add", "path": "/fields/Microsoft.VSTS.TCM.ReproSteps", "value": "$details$" },
{ "op": "add", "path": "/fields/Microsoft.VSTS.Scheduling.Effort", "value": 3.0 },
{ "op": "add", "path": "/fields/System.Tags", "value": "MyTESTTag" },
{ "op": "add", "path": "/fields/System.AreaPath", "value": "Test\\My team1" }
]

Attribut de réponse REST - la réponse de l'appel API sera stockée dans cet attribut
Exception de planification Pro - en cas de problème avec l'appel API , l'exception sera enregistrée dans cet attribut

Finalisez votre flux de travail, les autres nœuds et le flux

Enregistrez le flux de travail et publiez-le.

5. Test du flux de travail et des tâches événementielles

Ce flux de travail d'exemple crée un ticket de bug et y ajoute une sous-tâche.

Ajouter un ticket AD O

Obtenez le numéro de billet AD O

Ajouter une sous-tâche AD O

utilise le numéro de ticket de bogue créé, que nous avons stocké comme attribut sur le nœud « obtenir le numéro de ticket AD O ».

Restrictions en 2025.3

Pour des raisons de performance, il n'est pas possible d'utiliser plus d'un niveau de sous-requêtes pour les tâches planifiées.

Les tâches planifiées de lecture de grandes quantités de données depuis Microsoft Azure DevOps ne sont pas prises en charge, car Microsoft Azure DevOps utilise une méthode de pagination qui n'est pas prise en charge par notre connecteur REST API générique.