Mettre à niveau la version de Python

Compatible avec :

Ce document explique comment mettre à niveau les intégrations certifiées et personnalisées, les agents distants et les connecteurs du Content Hub vers la dernière version de Python. Les anciennes versions de Python étant obsolètes, les intégrations qui utilisent des versions non compatibles doivent être mises à jour pour continuer à fonctionner. Une fois l'intégration mise à jour 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 obsolète de Python, vous devez la mettre à jour manuellement. Utilisez le mode IDE Staging pour mettre à jour le code d'intégration sans affecter 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 la section Utiliser des groupes d'autorisations.

Mettre à niveau les intégrations

  1. Accédez à Response > IDE. Si des intégrations utilisent des versions obsolètes de Python, une bannière s'affiche dans les pages IDE, Content Hub 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 à mettre à niveau.
  5. Cliquez sur more_vert Plus > Envoyer en 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 à Préproduction.
  7. Sur la même intégration, cliquez sur more_vert Plus > Configurer l'instance.
  8. Suivez l'une des procédures de mise à niveau suivantes :

Pour savoir comment configurer des instances, lisez Configurer des instances. Cela crée une instance de préproduction 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 Response > IDE, 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 Tests, saisissez les paramètres requis, y compris l'instance de préproduction que vous avez configurée précédemment.
  4. Vérifiez que la sortie de débogage ne contient aucune erreur.
  5. Sur la même intégration, cliquez sur more_vert Plus > Envoyer en production.
  6. Si nécessaire, cliquez à nouveau 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 la boîte de dialogue, remplacez la valeur du champ Exécuter sur Python par la dernière version de Python (par exemple, Python 3.11).
  3. Sous Dépendances de script, copiez et enregistrez les noms des dépendances localement.
  4. Supprimez ces dépendances de la liste, puis cliquez sur Enregistrer.
  5. Copiez chacun des noms de dépendance (sans la version ni le système d'exploitation 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 à la fois l'agent et ses intégrations, comme suit :

  1. Accédez à SOAR Settings > Advanced > Remote Agents (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. Une fois l'agent mis à niveau, 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 à SOAR Settings > Ingestion > Connectors (Paramètres SOAR > Ingestion > Connecteurs).
  2. Cliquez sur le bouton jaune Mettre à niveau en haut de l'écran.
  3. Cliquez sur Enregistrer.

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