Mettre à niveau la version de Python

Compatible avec :

Ce document explique comment mettre à niveau les intégrations certifiées et personnalisées, les agents à distance et les connecteurs du Hub de contenu vers la dernière version de Python. Les anciennes versions de Python étant obsolètes, les intégrations utilisant des versions non compatibles doivent être mises à jour pour continuer à fonctionner. Après avoir mis à jour l'intégration vers la dernière version de Python, vous devez également mettre à niveau chaque connecteur.

Si le code de votre intégration certifiée ou personnalisée utilise une version Python obsolète, vous devez le mettre à jour manuellement. Utilisez le mode Préproduction de l'IDE pour mettre à jour le code d'intégration sans impacter les environnements de production.

Avant de commencer

Assurez-vous que votre groupe d'autorisations inclut l'accès à Tous les environnements. Pour en savoir plus, consultez Utiliser des groupes d'autorisations.

Mettre à niveau les intégrations

  1. Accédez à Réponse > IDE. Si des intégrations utilisent des versions obsolètes de Python, une bannière s'affiche sur les pages IDE, Hub de contenu et Playbooks.
  2. Cliquez sur Afficher l'intégration pour afficher la liste des intégrations.
  3. Cliquez sur Fermer pour fermer la bannière.
  4. Dans la liste des intégrations, sélectionnez celle que vous souhaitez mettre à niveau.
  5. Cliquez sur more_vert Plus > Envoyer vers la plate-forme de préproduction. Cette étape crée une copie de l'intégration à des fins de test.
  6. Cliquez sur le bouton Production pour passer de Production à Staging.
  7. Sur la même intégration, cliquez sur more_vert Plus > Configurer l'instance.
  8. Choisissez l'une des options de mise à niveau suivantes :

Pour savoir comment configurer des instances, consultez Configurer des instances. Cela crée une instance intermédiaire qui n'apparaît pas dans la liste de configuration principale. Une seule instance de préproduction est autorisée par intégration.

Veillez également à mettre à jour chaque connecteur.

Mettre à niveau les intégrations certifiées vers la dernière version de Python

  1. Dans l'IDE > Réponse, cliquez sur Mettre à niveau pour passer l'intégration et ses dépendances à la dernière version de Python.
  2. Si cette intégration inclut des éléments personnalisés, mettez à jour leur code en conséquence.
  3. Dans la section Test, saisissez les paramètres requis, y compris l'instance intermédiaire que vous avez configurée précédemment.
  4. Vérifiez qu'il n'y a pas d'erreur dans la sortie de débogage.
  5. Sur la même intégration, cliquez sur more_vert Plus > Passer en production.
  6. Si nécessaire, cliquez sur le bouton Production pour revenir au mode Production.

Mettre à niveau les intégrations personnalisées vers la dernière version de Python

Suivez cette procédure pour mettre à jour les dépendances de script dans les intégrations personnalisées.

  1. Cliquez sur more_vert Plus > Configurer l'intégration personnalisée.
  2. Dans le champ Exécution sur Python de la boîte de dialogue, remplacez la version de Python par la dernière version (par exemple, Python 3.11).
  3. Sous Script Dependencies (Dépendances du script), copiez et enregistrez les noms des dépendances en local.
  4. Supprimez ces dépendances de la liste, puis cliquez sur Enregistrer.
  5. Copiez chacun des noms de dépendance (sans la version ni l'OS cible) de votre fichier dans le champ Bibliothèques, puis cliquez sur Ajouter. Par exemple, remplacez requests-2.27.1-none-any.whl par requests, puis ajoutez-le au champ Bibliothèques. La plate-forme télécharge chaque dépendance avec la dernière version de Python déjà configurée.

Mettre à niveau les agents distants

Si vous utilisez des agents distants, vous devez mettre à niveau l'agent et ses intégrations, en les exécutant comme suit :

  1. Accédez à Paramètres SOAR> Avancé> Agents distants.
  2. Cliquez sur Mise à jour disponible.
  3. Mettez à niveau l'agent à l'aide de la méthode appropriée :
  4. Après avoir mis à niveau l'agent, suivez les étapes de mise à niveau de l'intégration décrites dans ce document.

Mettre à niveau les connecteurs

Vous devez mettre à niveau les connecteurs, qu'ils soient personnalisés ou commerciaux, vers les dernières versions de Python.

  1. Accédez à Paramètres SOAR> Ingestion> Connecteurs.
  2. Cliquez sur le bouton jaune Mettre à jour en haut de l'écran.
  3. Cliquez sur Enregistrer.

Vous avez encore besoin d'aide ? Obtenez des réponses de membres de la communauté et de professionnels Google SecOps.