Mapper la réponse API aux SPC attributs

Mappez les propriétés de réponse API aux SPC attributs. Une fois que vous avez mappé les attributs, vous publiez votre connecteur afin qu’il importe des données.

Avant de commencer

Pour cette étape, vous mappez les paramètres aux attributs et politiques SPC à partir des données que vous avez importées avec votre connecteur d’API.

• Sélectionnez et utilisez l’exemple de réponse API dans la liste de la section Référence pour SPC les attributs.
• Sélectionnez l’exemple de schéma de réponse API dans la liste des attributs d’API pour vous aider à mapper les propriétés à des attributs dédiés SPC .

Ces schémas et exemples vous sont fournis une fois que vous avez saisi les valeurs et enregistré vos modifications à l’étape précédente. Le schéma de réponse est agrégé. Pour afficher toutes les propriétés observées, remplacez la liste de référence par schéma de réponse API.

Vous avez la possibilité d’obtenir des conseils pour sélectionner un modèle avec une Now Assist compétence pour cette étape. Consultez Explorer les Now Assist pour Réponses aux vulnérabilités compétences de l’IA et les workflows agentiques pour plus d’informations sur la compétence d’IA générative et Création d’un connecteur d’API avec Now Assist pour Réponses aux vulnérabilités sur son utilisation dans le cadre de travail du connecteur.

Remarque :

Que vous entriez vos paramètres manuellement ou que vous choisissiez d’utiliser Now Assist pour générer automatiquement vos paramètres, vous devez le faire Valider votre connecteur d’API avant de pouvoir le publier.

Rôles requis :

• sn_sec_spc_core.développeur
• sn_spc_cxf.admin : requis pour le scripting avancé

Procédure

1. Ajoutez les attributs requis.

   Sélectionnez les info-bulles pour obtenir plus d’informations et de contexte sur les champs de cette page.

   Les attributs Nom d’hôte et Identificateur d’actif sont nécessaires. D’autres champs sont facultatifs. Toutes les valeurs d’attribut peuvent être scriptées avec l’activation/désactivation de script. Pour valider votre script, vous devez sélectionner Enregistrer et fermer le script. Si vous ne souhaitez plus scripter un attribut, sélectionnez le bouton bascule de scripting pour le désactiver.

   Le champ Collection applique la même collection à tous les attributs, et cette valeur vous aide à remplir le formulaire rapidement. Ce champ remplit automatiquement tous les champs qui ne sont pas encore mappés.

   1. Ajoutez un identificateur d’actif.

      Un identificateur d’actif est une combinaison unique de propriétés renvoyées par l’API pour identifier les éléments de configuration.

   2. Ajoutez un attribut de nom d’hôte.
   3. Facultatif : Créez un SPC attribut personnalisé si vous souhaitez ajouter une propriété.
      Créez uniquement des propriétés personnalisées si elles ne sont pas incluses dans les attributs par défaut fournis. Suivez les étapes ci-dessous pour créer des propriétés personnalisées.
2. Par exemple, créez un attribut, osName , pour le système d’exploitation d’une ressource à partir des exemples de référence.
   1. Sélectionnez un exemple de réponse API dans la fenêtre de référence.
   2. Localisez l’objet, par exemple « operatingSystem », et notez qu’il peut avoir une propriété telle que « osName ».
   3. Sélectionnez Ajouter un attribut.
   4. Sélectionnez le champ Collection pour appliquer un filtre à la liste d’attributs d’API, dans cet exemple, il peut s’agir de quelque chose comme $.operatingSystem.
   5. Sélectionnez le champ d’attribut d’API et osName dans la liste.

      La liste Type conserve la valeur mappée dans ce type. Sélectionnez le type sous lequel vous souhaitez stocker cet attribut. Ce champ est obligatoire.

      Utilisez le champ Transformateur pour augmenter la valeur renvoyée par l’API. Par exemple, si vous sélectionnez Date pour le type, vous pouvez utiliser le champ Transformateur pour effectuer une conversion entre les types. L’utilisation du transformateur est facultative.

   6. Facultatif : Ajoutez des propriétés afin de pouvoir filtrer les données afin qu’elles identifient des types spécifiques d’actifs avec cet attribut.
   7. Sélectionnez le champ Asset identifier attributes (Attributs d’identificateur d’actif) et ajoutez les propriétés souhaitées, par exemple, address et assetType.
      L’ajout de ces propriétés vous aide non seulement à identifier des actifs spécifiques, mais aussi à identifier un actif signalé différemment par plusieurs outils de sécurité. Un outil peut l’importer à l’aide d’une adresse, par exemple, et un autre peut signaler l’assetType. L’ajout de ces attributs peut vous aider à éviter de créer des résultats en double pour le même actif.
3. Une fois le mappage terminé, sélectionnez Enregistrer et continuez à enregistrer vos modifications.
   Vous devez enregistrer vos changements pour pouvoir continuer.