Aller au contenu

Linear

Configurer l'intégration Linear

Ostorlab offre la possibilité de gérer facilement les vulnérabilités en utilisant les tickets Ostorlab et de les synchroniser de manière transparente avec Linear.

La configuration Linear est effectuée au niveau de l'organisation : une fois connectés, les tickets Ostorlab sont synchronisés de manière unidirectionnelle ou bidirectionnelle vers Linear.

Configuration Linear :

Pour activer l'intégration Linear, l'organisation doit disposer d'un abonnement d'entreprise.

Ostorlab se connecte à Linear en utilisant une clé API personnelle : il n'y a pas de nom d'utilisateur ou d'URL d'espace de travail séparés à configurer.

Créer une clé API Linear :

  1. Accédez à vos paramètres API Linear. Clés API personnelles Linear
  2. Créez une clé API personnelle. Créer une clé API Linear
  3. Copiez la clé générée.

Connecter l'intégration Linear :

Allez dans le menu d'intégration Linear Library -> Integrations -> Linear -> Configuration.

  1. Ouvrez le menu principal d'Ostorlab. Ouvrir le menu principal d'Ostorlab
  2. Cliquez sur "Library". Cliquer sur Library
  3. Cliquez sur "Integrations". Cliquer sur Integrations
  4. Sélectionnez l'intégration Linear. Sélectionner l'intégration Linear
  5. Activez le bouton pour activer l'intégration Linear. Activer l'intégration Linear
  6. Ajoutez la clé API Linear. Ajouter la clé API Linear
  7. Sélectionnez l'équipe Linear avec laquelle synchroniser les tickets. La liste des équipes est récupérée en temps réel depuis Linear une fois qu'une clé API valide est saisie. Sélectionner l'équipe Linear

Vous pouvez enregistrer la configuration et tester la connexion à Linear. Tous les tests doivent réussir. Tester la configuration Linear

NOTE : Si vous souhaitez ajouter les clients Linear d'Ostorlab communiquant avec votre instance Linear à la liste blanche, contactez l'équipe de support.

Créer automatiquement des tickets Linear à partir des tickets Ostorlab :

Assurez-vous que les étapes de Connecter l'intégration Linear sont terminées et que la vérification de connexion réussit.

Pour activer la création automatique de tickets Linear, activez le bouton "Automatically create Ticket". Créer automatiquement des tickets

Vous pouvez également choisir de :

  • Synchroniser les mises à jour d'Ostorlab vers Linear.
  • Synchroniser les mises à jour de Linear vers Ostorlab. Synchroniser depuis/vers Linear

Une fois les modes de synchronisation configurés, vous devez choisir :

  • L'équipe Linear à utiliser pour les tickets (voir Connecter l'intégration Linear ci-dessus).
  • Si vous souhaitez créer les tickets en tant que ticket enfant d'un ticket existant, vous pouvez définir l'identifiant du ticket parent à utiliser. Ce champ est optionnel. Identifiant du ticket parent
  • Les champs à synchroniser : Linear ne prend en charge que la synchronisation automatique du titre et de la description du ticket ; tout le reste nécessite un mappage de champ (voir ci-dessous).
  • Les niveaux de risque des tickets à synchroniser vers Linear. Niveaux de risque à synchroniser
  • Cliquez sur Save.

Vous pouvez cliquer sur le bouton de test pour vérifier si l'intégration est capable d'écrire un ticket dans l'équipe Linear.

Types de mappage de champs

Lors de la configuration des mappages de champs entre Ostorlab et Linear, vous pouvez utiliser trois types de mappage différents :

  1. Field Mapping (Mappage de champ) : Mappe directement les champs Ostorlab aux champs Linear (ex. titre, description, priorité, statut, assigné, étiquettes, date d'échéance)
  2. Value Mapping (Mappage de valeur) : Définit une valeur statique pour un champ Linear
  3. Template Mapping (Mappage de modèle) : Fournit un modèle personnalisé pour les champs Linear en utilisant les variables du ticket Ostorlab

Tableau de mappage de champs

Mappage de modèles

Le mappage par modèle vous permet de créer des valeurs de champs personnalisées en utilisant les variables de tickets d'Ostorlab. Utilisez des doubles accolades pour référencer les variables de tickets : {{variable_name}}

Variables disponibles : - {{title}} : Titre du ticket - {{description}} : Description du ticket - {{risk_rating}} : Niveau de risque du ticket - {{status}} : Statut du ticket - {{assigned}} : Nom d'utilisateur de la personne assignée - {{due_date}} : Date d'échéance du ticket - {{target}} : Actif cible du ticket - {{tags.<tag_name>}} : Valeur d'une balise de ticket nommée <tag_name>

Exemple de modèle : 

Assigned to {{assigned}}