Fazer upgrade da versão do Python

Compatível com:

Este documento explica como fazer upgrade de integrações certificadas e personalizadas, agentes remotos e conectores no Hub de conteúdo para a versão mais recente do Python. Como as versões mais antigas do Python foram descontinuadas, as integrações que usam versões sem suporte precisam ser atualizadas para continuar funcionando. Depois de atualizar a integração para a versão mais recente do Python, faça o upgrade de cada conector também.

Se o código de integração certificada ou personalizada usar uma versão descontinuada do Python, atualize-o manualmente. Use o modo Teste do ambiente de desenvolvimento integrado para atualizar o código de integração sem afetar os ambientes de produção.

Antes de começar

Verifique se o grupo de permissões inclui acesso a Todos os ambientes. Para mais informações, consulte Trabalhar com grupos de permissões.

Fazer upgrade das integrações

  1. Acesse Resposta > IDE. Se alguma integração estiver usando versões desatualizadas do Python, um banner vai aparecer nas páginas do IDE, do Hub de conteúdo e dos playbooks.
  2. Clique em Ver integração para conferir uma lista de integrações.
  3. Clique em Fechar para dispensar o banner.
  4. Na lista de integrações, selecione a que você quer atualizar.
  5. Clique em more_vert Mais > Enviar para a área de teste. Essa etapa cria uma cópia da integração para teste.
  6. Clique no botão Produção para alternar de Produção para Teste.
  7. Na mesma integração, clique em more_vert Mais > Configurar instância.
  8. Siga um destes caminhos de upgrade:

Para saber como configurar instâncias, leia Configurar instâncias. Isso cria uma instância de preparo que não aparece na lista de configuração principal. Só é permitida uma instância de preparo por integração.

Não se esqueça de atualizar cada conector também.

Fazer upgrade das integrações certificadas para a versão mais recente do Python

  1. Em Resposta > IDE, clique em Fazer upgrade para mudar a integração e as dependências dela para a versão mais recente do Python.
  2. Se essa integração incluir elementos personalizados, atualize o código deles de acordo.
  3. Na seção Teste, insira os parâmetros necessários, incluindo a instância de preparo que você configurou anteriormente.
  4. Verifique se não há erros na Saída de depuração.
  5. Na mesma integração, clique em more_vert Mais > Enviar para produção.
  6. Clique no botão Produção para voltar ao modo Produção, se necessário.

Fazer upgrade das integrações personalizadas para a versão mais recente do Python

Siga este procedimento para atualizar as dependências de script em integrações personalizadas.

  1. Clique em more_vert Mais > Configurar integração personalizada.
  2. Na caixa de diálogo Executando em Python, mude o campo Executando em Python para a versão mais recente do Python (por exemplo, Python 3.11).
  3. Em Dependências do script, copie e salve os nomes das dependências localmente.
  4. Exclua essas dependências da lista e clique em Salvar.
  5. Copie cada um dos nomes de dependência (sem a versão ou o SO de destino) do seu arquivo para o campo Bibliotecas e clique em Adicionar. Por exemplo, mude requests-2.27.1-none-any.whl para requests e adicione ao campo Bibliotecas. A plataforma baixa cada dependência com a versão mais recente do Python já configurada.

Fazer upgrade de agentes remotos

Se você estiver trabalhando com agentes remotos, faça upgrade do agente e das integrações dele, executando-os da seguinte maneira:

  1. Acesse Configurações do SOAR > Avançado > Agentes remotos.
  2. Clique em Atualização disponível.
  3. Faça upgrade do agente usando o método apropriado:
  4. Depois de fazer upgrade do agente, siga as etapas de upgrade da integração descritas neste documento.

Fazer upgrade dos conectores

É necessário fazer upgrade dos conectores, personalizados e comerciais, para as versões mais recentes do Python.

  1. Acesse Configurações do SOAR > Ingestão > Conectores.
  2. Clique no botão amarelo Atualizar na parte de cima da tela.
  3. Clique em Salvar.

Precisa de mais ajuda? Receba respostas de membros da comunidade e profissionais do Google SecOps.