GitSync

O GitSync é uma integração criada para o Google SecOps que sincroniza recursos e componentes de automação de segurança com um repositório Git externo (como GitHub, GitLab ou Bitbucket). Ele facilita a sincronização bidirecional de conteúdo, fornecendo controle de versões automatizado, backup de configuração e promoção entre ambientes em todo o ciclo de vida das operações de segurança. O GitSync foi projetado para fazer backup e migrar recursos entre ambientes relacionados (como desenvolvimento, preparo e produção), em vez de distribuir recursos entre sistemas não relacionados em que os identificadores de banco de dados internos podem causar conflitos.

Casos de uso

A integração do GitSync é compatível com os seguintes casos de uso principais:

  • Controle de versões e auditabilidade (segurança como código): acompanhe modificações, analise diferenças e mantenha um histórico de versões completo das mudanças em playbooks, conectores, integrações e configurações do sistema.

  • Promoção de vários ambientes (pipeline de CI/CD): promova playbooks, mapeamentos de ontologia e configurações de integração de maneira sistemática dos ambientes de desenvolvimento e de preparo para a produção usando solicitações de pull e mesclagens de ramificações.

  • Backup e recuperação de desastres: restaure playbooks e configurações de plataforma excluídos acidentalmente, corrompidos ou mal configurados diretamente do repositório Git.

  • Padronização entre ambientes: distribua playbooks padronizados, famílias visuais personalizadas e definições de conectores em ambientes relacionados do Google SecOps de um repositório centralizado.

  • Isolamento de ramificação e de preparo: teste playbooks experimentais e ramificações de recursos em ambientes dedicados sem afetar os fluxos de trabalho ou as programações de produção.

  • Revisão e colaboração off-line: exporte definições de plataforma como JSON e Markdown para permitir a revisão por pares, a validação automatizada e a inspeção em ferramentas para desenvolvedores padrão.

  • Blocos de fluxo de trabalho reutilizáveis: sincronize blocos de fluxo de trabalho modulares junto com ou separadamente de roteiros completos para que as equipes possam compartilhar etapas de automação comuns.

Fluxos de trabalho de implementação por meta

Para acessar diretamente as orientações que correspondem ao seu objetivo atual, selecione seu fluxo de trabalho:

Antes de começar

Antes de configurar e executar operações do GitSync, verifique a versão da integração, consiga acesso ao repositório e conclua as seguintes tarefas de configuração:

  • Use um repositório Git particular com acesso de gravação: verifique se você tem permissões de gravação em um repositório Git remoto particular hospedado em um provedor Git compatível (como GitHub, GitLab ou Bitbucket). Embora os parâmetros do tipo Password sejam excluídos por padrão, a menos que Commit Passwords esteja ativado, todos os outros parâmetros (como IDs de aplicativo, IDs de cliente, nomes de usuário e endpoints) são exportados em texto simples. Nunca use um repositório público com o GitSync.

  • Inicialize o repositório remoto: confirme se o repositório remoto tem pelo menos um commit inicial (como um arquivo README.md ou .gitignore). O GitSync não pode sincronizar com um repositório vazio.

  • Prepare as credenciais de autenticação do Git: gere uma credencial de autenticação com permissões de gravação no repositório. O GitSync é compatível com chaves privadas SSH codificadas em Base64 (recomendado), tokens de acesso pessoal (PATs) e credenciais básicas de nome de usuário e senha.

    Para gerar e codificar uma chave SSH, consulte Gerar chaves SSH para o GitSync.

  • Verifique a conectividade de rede e o VPC Service Controls: confira se a instância do Google SecOps ou o executor remoto tem acesso de firewall de saída na porta TCP 443 (para HTTPS) ou na porta TCP 22 (para SSH) ao provedor do Git.

    Se o ambiente do Google Cloud usar um perímetro de serviço do VPC Service Controls, trabalhe com o administrador do Google Cloud para configurar regras de entrada e saída para que as integrações de resposta possam se comunicar com as APIs do Google Cloud e os endpoints externos necessários.

  • Obter a impressão digital do host do Git (recomendado): para se proteger contra ataques de person-in-the-middle (PITM), recupere a impressão digital da chave pública do servidor Git para fixação da impressão digital do host.

    Para ver as etapas de configuração, consulte Ativar a fixação de impressões digitais do host.

  • Conceder permissões de edição de playbook: se você pretende sincronizar playbooks com acesso padrão restrito (como permissões padrão definidas como Pode visualizar), conceda ao papel de SOC Administrator as permissões Pode editar no sistema de origem antes de executar jobs de sincronização.

    Para instruções detalhadas, consulte Configurar permissões do playbook.

Gerar chaves SSH para o GitSync

Para configurar a autenticação segura e sem senha usando chaves SSH:

  1. Gere um par de chaves RSA ou Ed25519 no terminal. Quando uma senha longa for solicitada, pressione Enter para deixá-la em branco:

    ssh-keygen -b 2048 -t rsa -f ./id_rsa
    

    Esse comando cria dois arquivos: id_rsa (chave privada) e id_rsa.pub (chave pública).

  2. Adicione a chave pública (id_rsa.pub) ao serviço de hospedagem remota do Git como uma chave de implantação ou chave de acesso com permissões de gravação.

  3. Converta a chave privada em uma string codificada em base64 de linha única:

    • Linux / macOS:

      base64 -w 0 ./id_rsa
      
    • Windows (PowerShell):

      [Convert]::ToBase64String([System.IO.File]::ReadAllBytes(".\id_rsa"))
      
  4. Copie a string base64 resultante e cole-a no parâmetro Senha/token/chave SSH do Git ao configurar a instância de integração do GitSync.

Ativar a fixação de impressões digitais do host

A fixação de impressão digital do host verifica a identidade do servidor Git na conexão para proteger contra ataques de person-in-the-middle (PITM). Embora o parâmetro Impressão digital do servidor Git seja opcional, configurá-lo garante que o GitSync se conecte exclusivamente ao seu host Git verificado.

Para configurar a fixação de impressões digitais do host:

  1. Recupere a impressão digital do host: execute ssh-keyscan no terminal em relação ao nome do host do servidor Git:

    ssh-keyscan -t rsa <hostname>
    

    Por exemplo, para o GitHub, execute ssh-keyscan -t rsa github.com. A resposta ao comando gera uma linha de chave de host pública semelhante a esta:

    github.com ssh-rsa AAAAB3NzaC1yc2EAAAADAQABAAABgQC...
    
  2. Salve a impressão digital para configuração: copie a linha da chave pública do host. Insira esse valor no parâmetro Impressão digital do servidor Git ao configurar a instância de integração do GitSync (para aplicá-lo a todos os jobs) ou em jobs de sincronização individuais (para substituir a configuração de hosts específicos).

Configurar permissões do playbook

Ao sincronizar playbooks com permissões restritas (por exemplo, permissões padrão definidas como Pode visualizar), atribua permissões Pode editar à função do SOC Administrator:

  1. No Google SecOps, acesse Playbooks e selecione o playbook de destino.
  2. Abra as configurações de permissões do playbook.
  3. Adicione o papel SOC Administrator à lista de entidades e defina a permissão como Pode editar.

Reversão da versão 53.0

A versão 53.0 do GitSync introduziu mudanças na API Chronicle e modificou os esquemas de exportação JSON que causaram falhas de sincronização. Para resolver esses problemas, a versão 54.0 do GitSync reverte as mudanças da versão 53.0 e restaura a base de código da versão estável 52.0.

Siga estas etapas para migrar para a versão 52.0 ou 54.0 e restaurar uma ramificação de repositório compatível:

  1. Pausar jobs de sincronização programados: desative todos os jobs programados ativos do GitSync (como Enviar conteúdo e Extrair conteúdo) para que eles não sejam executados enquanto você troca de versão e ramificação.

  2. Mudar para a versão 54.0 ou reverter para a versão 52.0: no Hub de conteúdo, localize a integração do GitSync:

    • Se a versão 54.0 estiver disponível, faça upgrade da integração para ela.
    • Se a versão 54.0 ainda não tiver aparecido (os caches do Content Hub são sincronizados aproximadamente a cada 8 horas) ou se você preferir fazer o downgrade diretamente, reverter a versão da integração para a 52.0.
  3. Aponte o GitSync para a ramificação do repositório anterior: as ramificações do repositório preenchidas com a versão 53.0 usam um esquema JSON diferente que não é compatível com a versão 52.0 ou 54.0:

    • Se você criou uma ramificação separada para a versão 53.0 (por exemplo, gitsync-chronicle-api): acesse Configurações > Integrações > GitSync, mude o parâmetro Ramificação de volta para a ramificação original (por exemplo, main) e execute a ação Ping para verificar a conectividade.
    • Se você tiver substituído a ramificação atual na versão 53.0: restaure a ramificação da tag Git backup-legacy-pre-migration (ou do último commit anterior à v53) ou remova os diretórios exportados da versão 53.0 (Playbooks/, Connectors/, Integrations/, Jobs/, Ontology/, SimulatedCases/ e Settings/) e execute um job completo de Envio de conteúdo da versão 52.0 ou 54.0 para preencher novamente a ramificação.
  4. Retomar jobs programados: depois de confirmar que sua ramificação contém configurações exportadas pela versão 52.0 ou 54.0, reative os jobs programados do GitSync.

Configurar a integração

Configure a integração do GitSync como uma instância compartilhada no Google SecOps para que todos os componentes da plataforma e jobs programados possam acessar as configurações do repositório.

Parâmetros de integração do GitSync

Parâmetro Descrição
Repo URL

Obrigatório.

O URL do repositório Git remoto.

Ao usar a autenticação HTTPS, o URL precisa começar com https:// (por exemplo, https://github.com/organization/secops-platform.git).

Ao usar a autenticação SSH, o URL precisa começar com git@ ou ssh:// (por exemplo, git@github.com:organization/secops-platform.git).

Branch

Obrigatório.

A ramificação do repositório Git com que sincronizar (por exemplo, main).

Git Password/Token/SSH Key

Obrigatório.

A credencial de autenticação do repositório Git remoto.

Esse parâmetro aceita uma senha de conta do Git, um token de acesso pessoal (PAT) ou uma chave privada SSH codificada em base64 (RSA de 2048 bits ou Ed25519).

Git Username

Opcional.

O nome de usuário da conta do Git.

Obrigatório ao usar a autenticação de nome de usuário e senha por HTTPS.

Git Server Fingerprint

Opcional.

A chave pública do host SSH do servidor Git remoto (por exemplo, github.com ssh-rsa AAAAB3NzaC1yc2EAAAADAQABAAABgQC...).

A configuração desse parâmetro ativa a fixação de impressões digitais do host, garantindo que o GitSync se conecte exclusivamente ao host do Git verificado e mitigando os riscos de ataques de interceptação (PITM, na sigla em inglês).

Para recuperar esse valor, consulte Ativar a fixação de impressão digital do host.

Commit Author

Opcional.

A identidade do autor anexada aos commits de saída do Git gerados pelo GitSync.

O formato precisa seguir a autoria padrão do Git: Name &lt;email@domain.com&gt; (o padrão é GitSync &lt;gitsync@siemplify.co&gt;).

Siemplify Verify SSL

Obrigatório.

Se selecionada, a integração valida o certificado SSL do endpoint de API do Google SecOps.

Ativado por padrão.

Git Verify SSL

Obrigatório.

Se selecionada, a integração valida o certificado SSL do servidor do provedor remoto do Git.

Ativado por padrão.

SOAR Username

Opcional.

O nome de usuário do Google SecOps de uma conta com permissões de edição de playbook.

Informe esse parâmetro se a chave de API padrão falhar devido a limites de permissão.

SOAR Password

Opcional.

A senha correspondente ao SOAR Username configurado.

Ações

Para mais informações sobre ações, consulte Responder a ações pendentes na sua mesa de trabalho e Executar uma ação manual no seu caso.

Ping

Use a ação Ping para testar a conectividade de rede e verificar as credenciais de autenticação no repositório e na ramificação do Git configurados.

Entradas da ação

Nenhuma.

Saídas da ação

A ação Ping fornece as seguintes saídas:

Tipo de saída da ação Disponibilidade
Anexo do Painel de Casos Indisponível
Link do Painel de Casos Indisponível
Tabela do painel de casos Indisponível
Tabela de enriquecimento Indisponível
Resultado JSON Indisponível
Mensagens de saída Disponível
Resultado do script Disponível
Mensagens de saída

A ação Ping pode retornar as seguintes mensagens de saída:

Mensagem de resposta Descrição da mensagem
Successfully executed action "Ping". A ação foi bem-sucedida, e a conectividade do repositório foi verificada.
Error executing action "Ping". Reason: ERROR_REASON Falha na ação. Verifique o URL do repositório, o nome da ramificação, as credenciais ou as rotas de rede.
Resultado do script

A tabela a seguir lista o valor do resultado do script ao usar a ação Ping:

Nome do resultado do script Valor
is_success true ou false

Jobs

O GitSync oferece 16 configurações de job de sincronização (2 jobs de instância completa e 7 pares de jobs independentes) para gerenciar recursos da plataforma. Esses jobs são compatíveis com os escopos de sincronização independentes completos no nível da instância e segmentados.

Escopo de sincronização e recursos compatíveis

A integração organiza os jobs de sincronização em dois escopos operacionais distintos para atender a diferentes necessidades administrativas e de automação:

  • Sincronização completa da instância (Push Content e Pull Content): sincroniza toda a plataforma do Google SecOps em uma única operação em massa.

    Isso abrange 21 categorias de recursos da plataforma em três áreas funcionais:

    • Configurações do sistema e do ambiente: ambientes, domínios, parâmetros dinâmicos, listas personalizadas, redes, listas de bloqueio, configurações de título de caso, modelos de e-mail e logotipo.

    • Gerenciamento de alertas e casos: tags de caso, etapas de caso, motivos de encerramento de caso, registros de SLA e casos simulados.

    • Automação e integrações de segurança: playbooks (incluindo blocos de fluxo de trabalho reutilizáveis), integrações, instâncias de integração, conectores, jobs programados, mapeamentos de ontologia e famílias visuais.

  • Sincronização granular de recursos (jobs de push e pull independentes):

    Oferece pares de jobs de push e pull dedicados para sete recursos específicos. Use jobs independentes ao desenvolver, atualizar ou testar componentes individuais sem sincronizar ou substituir o restante do ambiente:

    • Playbooks e blocos de fluxo de trabalho: Push Playbook e Pull Playbook

    • Conectores: Push Connectors e Pull Connector

    • Integrações: Push Integration e Pull Integration

    • Jobs programados: Push Job e Pull Jobs

    • Mapeamentos de ontologia: Push Mappings e Pull Mappings

    • Famílias visuais personalizadas: Push Custom Family e Pull Custom Family

    • Casos de teste simulados: Push Simulated Cases e Pull Simulated Cases

Estrutura de diretórios do repositório

A execução de um job inicial de envio de conteúdo (obrigatório antes de executar qualquer job de extração em uma ramificação nova ou migrada) cria a seguinte estrutura de diretório predefinida, arquivos de configuração JSON, arquivo de metadados GitSync.json raiz e documentação README.md gerada no repositório Git remoto.

├── Connectors/
│   └── <Integration_Name>/
│       └── <Connector_Name>/
│           ├── <Connector_Name>.json
│           └── README.md
├── Integrations/
│   └── <Integration_Identifier>/
│       ├── Actions/
│       ├── Connectors/
│       ├── Dependencies/
│       ├── Jobs/
│       ├── Managers/
│       ├── Resources/
│       ├── Integration-<Integration_Identifier>.def
│       └── README.md
├── Jobs/
│   ├── <Job_Name>.json
│   └── README.md
├── Ontology/
│   ├── Mappings/
│   │   └── <Source_Name>/
│   │       ├── <Source_Name>_Records.json
│   │       ├── <Source_Name>_Rules.json
│   │       └── README.md
│   └── VisualFamilies/
│       └── <Family_Name>/
│           ├── <Family_Name>.json
│           ├── <Family_Name>.png
│           └── README.md
├── Playbooks/
│   ├── README.md
│   └── <Folder_Name>/
│       └── <Playbook_Or_Block_Name>/
│           ├── <Playbook_Or_Block_Name>.json
│           └── README.md
├── Settings/
│   ├── blacklists.json
│   ├── caseCloseCauses.json
│   ├── caseTitles.json
│   ├── customLists.json
│   ├── domains.json
│   ├── dynamicParameters.json
│   ├── emailTemplates.json
│   ├── environments.json
│   ├── integrationInstances.json
│   ├── logo.json
│   ├── networks.json
│   ├── slaDefinitions.json
│   ├── stages.json
│   └── tags.json
├── SimulatedCases/
│   └── <Case_Name>.case
├── GitSync.json
└── README.md

Jobs de sincronização no nível da instância

Os jobs no nível da instância sincronizam as categorias de recursos selecionadas em uma instância inteira do Google SecOps.

Conteúdo push

Use o job Enviar conteúdo para exportar as categorias de recursos selecionadas da sua instância do Google SecOps e confirmá-las na ramificação do repositório Git configurada. Sempre execute Push Content primeiro ao inicializar uma nova ramificação.

Entradas de job

Para configurar o job Push Content, use os seguintes parâmetros:

Parâmetro Descrição
Commit

Obrigatório.

A mensagem de commit do Git que descreve as mudanças no conteúdo exportado.

Commit Passwords

Opcional.

Se selecionado, o job exporta parâmetros do tipo Password em texto simples para instâncias de integração, conectores e jobs configurados.

Parâmetros de seleção de recursos:
Integrations, Playbooks, Jobs, Connectors, Simulated Cases, Integration Instances, Visual Families, Mappings, Environments, Dynamic Parameters, Logo, Case Tags, Case Stages, Case Title Settings, Case Close Reasons, Networks, Domains, Custom Lists, Email Templates, Blacklists, SLA Records

Opcional (alternâncias booleanas).

Selecione cada categoria de recurso que você quer incluir na exportação.

Repo URL

Opcional.

Substitui o URL do repositório configurado na instância de integração.

Branch

Opcional.

Substitui a ramificação do repositório configurada na instância de integração.

Commit Author

Opcional.

Substitui o autor do commit configurado na instância de integração. Precisa usar o formato Name &lt;email@domain.com&gt;.

Git Server Fingerprint

Opcional.

Substitui a impressão digital do host SSH configurada na instância de integração.

Saídas de jobs

O job grava arquivos de configuração JSON e resumos de README.md na ramificação Git de destino na hierarquia de diretórios padrão (/Playbooks, /Connectors, /Integrations, /Jobs, /Ontology/Mappings, /Ontology/VisualFamilies, /SimulatedCases e /Settings) e gera registros de execução para o console do executor de jobs. As integrações personalizadas são exportadas como pacotes completos, enquanto as comerciais exportam apenas scripts personalizados ou modificações adicionadas à integração.

Extrair conteúdo

Use o job Extrair conteúdo para recuperar as categorias de configuração selecionadas da ramificação do repositório Git configurada e aplicá-las à plataforma do Google SecOps.

Entradas de job

Para configurar o job Extrair conteúdo, use os seguintes parâmetros:

Parâmetro Descrição
Parâmetros de seleção de recursos:
Integrations, Playbooks, Jobs, Connectors, Simulated Cases, Integration Instances, Visual Families, Mappings, Environments, Dynamic Parameters, Logo, Case Tags, Case Stages, Case Title Settings, Case Close Reasons, Networks, Domains, Custom Lists, Email Templates, Blacklists, SLA Records

Opcional (alternâncias booleanas).

Selecione cada categoria de recurso que você quer importar do repositório para seu ambiente.

Repo URL

Opcional.

Substitui o URL do repositório configurado na instância de integração.

Branch

Opcional.

Substitui a ramificação do repositório configurada na instância de integração.

Git Server Fingerprint

Opcional.

Substitui a impressão digital do host SSH configurada na instância de integração.

Saídas de jobs

O job importa as definições de repositório selecionadas para a plataforma, cria ou atualiza instâncias de integração, playbooks, conectores, jobs, mapeamentos de ontologia e configurações, além de gerar registros de execução para o console do executor de jobs.

Jobs de sincronização independentes

Os jobs independentes permitem a sincronização granular de recursos específicos sem exigir uma sincronização completa do repositório.

Playbook de push

Use o job Push Playbook para exportar playbooks individuais ou blocos de fluxo de trabalho reutilizáveis para o Git.

Entradas de job

Para configurar o job Push Playbook, use os seguintes parâmetros:

Parâmetro Descrição
Commit

Obrigatório.

A mensagem de commit do Git que descreve as mudanças no playbook.

Playbook Whitelist

Opcional.

Uma lista separada por vírgulas de nomes exatos de playbooks ou blocos que diferenciam maiúsculas de minúsculas para exportação. Forneça Playbook Whitelist ou Folders Whitelist.

Folders Whitelist

Opcional.

Uma lista separada por vírgulas de nomes de pastas (categorias) de playbook. Todos os playbooks e blocos que estão nessas pastas são exportados.

Include Playbook Blocks

Opcional.

Se selecionada, exporta blocos de fluxo de trabalho reutilizáveis com os playbooks selecionados, incluindo todos os blocos referenciados como etapas nesses playbooks.

Repo URL

Opcional.

Substitui o URL do repositório padrão.

Branch

Opcional.

Substitui a ramificação padrão.

Commit Author

Opcional.

Substitui o autor do commit padrão.

Git Server Fingerprint

Opcional.

Substitui a impressão digital do host SSH padrão.

Readme Addon

Opcional.

Conteúdo personalizado anexado ao README.md gerado para todos os playbooks enviados nesta execução e salvos no arquivo de metadados raiz GitSync.json.

Compatível com a sintaxe Markdown e os modelos Jinja.

Saídas de jobs

Exporta os playbooks selecionados e os blocos de fluxo de trabalho incluídos para /Playbooks/<Folder_Name>/<Playbook_Name>/ e atualiza /Playbooks/README.md.

Manual de migração

Use o job Pull Playbook para importar playbooks ou blocos específicos do Git.

Entradas de job

Para configurar o job Pull Playbook, use os seguintes parâmetros:

Parâmetro Descrição
Playbook Whitelist

Obrigatório.

Uma lista separada por vírgulas de nomes exatos de playbooks ou blocos para importar do repositório.

Include Playbook Blocks

Opcional.

Se selecionada, importa automaticamente todos os blocos de fluxo de trabalho reutilizáveis referenciados pelos playbooks selecionados.

Repo URL

Opcional.

Substitui o URL do repositório padrão.

Branch

Opcional.

Substitui a ramificação padrão.

Git Server Fingerprint

Opcional.

Substitui a impressão digital do host SSH padrão.

Saídas de jobs

Importa os playbooks e blocos especificados de /Playbooks (ou /Blocks) para a plataforma, instalando primeiro os blocos referenciados antes de instalar os playbooks pai.

Conectores push

Use o job Push Connectors para exportar as configurações do conector para o Git.

Entradas de job

Para configurar o job de conectores de push, use os seguintes parâmetros:

Parâmetro Descrição
Connectors

Obrigatório.

Uma lista separada por vírgulas de nomes de exibição de conectores para exportar.

Commit

Obrigatório.

A mensagem de commit do Git.

Include Mappings

Opcional.

Se selecionada, exporta os registros e as regras de mapeamento de ontologia associados à integração do conector com o /Ontology/Mappings.

Include Visual Families

Opcional.

Se selecionado, exporta as famílias visuais personalizadas associadas aos registros de ontologia do conector para o /Ontology/VisualFamilies.

Repo URL

Opcional.

Substitui o URL do repositório padrão.

Branch

Opcional.

Substitui a ramificação padrão.

Commit Author

Opcional.

Substitui o autor do commit padrão.

Git Server Fingerprint

Opcional.

Substitui a impressão digital do host SSH padrão.

Readme Addon

Opcional.

Conteúdo personalizado anexado ao README.md gerado para todos os conectores enviados nesta execução e salvos em GitSync.json.

Compatível com a sintaxe Markdown e os modelos Jinja.

Saídas de jobs

Exporta as configurações e programações do conector para o /Connectors/<Integration_Name>/<Connector_Name>/ (junto com os mapeamentos de ontologia e as famílias visuais associadas, se selecionados).

Conector de extração

Use o job Pull Connector para importar uma configuração de conector do Git. Antes de executar esse job, verifique se a integração subjacente do conector já está instalada no ambiente de destino.

Entradas de job

Para configurar o job do Pull Connector, use os seguintes parâmetros:

Parâmetro Descrição
Connector Name

Obrigatório.

O nome de exibição do conector a ser importado do repositório.

Include Mappings

Opcional.

Se selecionada, importa os mapeamentos de ontologia associados à integração do conector.

Include Visual Families

Opcional.

Se selecionado, importa as famílias visuais personalizadas associadas à integração do conector.

Repo URL

Opcional.

Substitui o URL do repositório padrão.

Branch

Opcional.

Substitui a ramificação padrão.

Git Server Fingerprint

Opcional.

Substitui a impressão digital do host SSH padrão.

Saídas de jobs

Instala ou atualiza o conector no ambiente de destino (junto com os mapeamentos ou as famílias visuais associadas, se selecionados).

Integração por push

Use o job Push Integration para exportar integrações personalizadas ou scripts personalizados adicionados a integrações comerciais para o Git. As integrações personalizadas são exportadas como pacotes de integração completos, enquanto as integrações comerciais exportam apenas scripts personalizados ou modificações adicionadas à integração.

Entradas de job

Para configurar o job de integração por push, use os seguintes parâmetros:

Parâmetro Descrição
Push Whitelist

Obrigatório.

Uma lista separada por vírgulas de identificadores de integração a serem exportados.

Commit

Obrigatório.

A mensagem de commit do Git.

Repo URL

Opcional.

Substitui o URL do repositório padrão.

Branch

Opcional.

Substitui a ramificação padrão.

Commit Author

Opcional.

Substitui o autor do commit padrão.

Git Server Fingerprint

Opcional.

Substitui a impressão digital do host SSH padrão.

Readme Addon

Opcional.

Conteúdo personalizado anexado ao README.md gerado para todas as integrações enviadas nesta execução e salvas em GitSync.json.

Compatível com a sintaxe Markdown e os modelos Jinja.

Saídas de jobs

Exporta definições de integração, scripts personalizados (Actions/, Connectors/, Jobs/, Managers/), dependências e documentação de README.md para /Integrations/<Integration_Identifier>/.

Integração de pull

Use o job Pull Integration para importar integrações ou scripts personalizados para integrações comerciais do Git. Para integrações comerciais, o GitSync instala a versão mais recente da integração do Content Hub e salva os scripts personalizados nela.

Entradas de job

Para configurar o job de integração de pull, use os seguintes parâmetros:

Parâmetro Descrição
Install Whitelist

Obrigatório.

Uma lista separada por vírgulas de identificadores de integração a serem importados do repositório.

Repo URL

Opcional.

Substitui o URL do repositório padrão.

Branch

Opcional.

Substitui a ramificação padrão.

Git Server Fingerprint

Opcional.

Substitui a impressão digital do host SSH padrão.

Saídas de jobs

Instala pacotes de integração personalizados ou integrações comerciais do Content Hub e atualiza os scripts personalizados no ambiente de destino.

Job de push

Use o job Push Job para exportar configurações de jobs programados da plataforma para o Git.

Entradas de job

Para configurar o job Push Job, use os seguintes parâmetros:

Parâmetro Descrição
Job Whitelist

Obrigatório.

Uma lista separada por vírgulas de nomes de jobs programados para exportação.

Commit

Obrigatório.

A mensagem de commit do Git.

Repo URL

Opcional.

Substitui o URL do repositório padrão.

Branch

Opcional.

Substitui a ramificação padrão.

Commit Author

Opcional.

Substitui o autor do commit padrão.

Git Server Fingerprint

Opcional.

Substitui a impressão digital do host SSH padrão.

Readme Addon

Opcional.

Conteúdo personalizado anexado ao README.md gerado para todos os jobs enviados nesta execução e salvos em GitSync.json.

Compatível com a sintaxe Markdown e os modelos Jinja.

Saídas de jobs

Exporta parâmetros de job e intervalos de programação para /Jobs/<Job_Name>.json e atualiza /Jobs/README.md.

Jobs de pull

Use o job Pull Jobs para importar jobs programados da plataforma do Git.

Entradas de job

Para configurar o job Pull Jobs, use os seguintes parâmetros:

Parâmetro Descrição
Job Whitelist

Obrigatório.

Uma lista separada por vírgulas de nomes de jobs programados para importar do repositório.

Repo URL

Opcional.

Substitui o URL do repositório padrão.

Branch

Opcional.

Substitui a ramificação padrão.

Git Server Fingerprint

Opcional.

Substitui a impressão digital do host SSH padrão.

Saídas de jobs

Configura e registra os jobs programados especificados no programador de jobs da plataforma.

Mapeamentos de push

Use o job Push Mappings para exportar registros e regras de mapeamento de eventos de ontologia de uma origem específica para o Git.

Entradas de job

Para configurar o job Push Mappings, use os seguintes parâmetros:

Parâmetro Descrição
Source

Obrigatório.

A origem da ontologia (nome da integração) com os registros e as regras de mapeamento que você quer exportar.

Commit

Obrigatório.

A mensagem de commit do Git.

Repo URL

Opcional.

Substitui o URL do repositório padrão.

Branch

Opcional.

Substitui a ramificação padrão.

Commit Author

Opcional.

Substitui o autor do commit padrão.

Git Server Fingerprint

Opcional.

Substitui a impressão digital do host SSH padrão.

Readme Addon

Opcional.

Conteúdo personalizado anexado ao README.md gerado para todos os mapeamentos enviados nesta execução e salvos em GitSync.json.

Compatível com a sintaxe Markdown e os modelos Jinja.

Saídas de jobs

Grava registros de ontologia (<Source>_Records.json), regras de mapeamento (<Source>_Rules.json) e README.md em /Ontology/Mappings/<Source>/.

Extrair mapeamentos

Use o job Pull Mappings para importar registros e regras de mapeamento de ontologia de uma origem específica do Git.

Entradas de job

Para configurar o job Extrair mapeamentos, use os seguintes parâmetros:

Parâmetro Descrição
Source

Obrigatório.

A origem da ontologia (nome da integração) com os registros e as regras de mapeamento que você quer importar.

Repo URL

Opcional.

Substitui o URL do repositório padrão.

Branch

Opcional.

Substitui a ramificação padrão.

Git Server Fingerprint

Opcional.

Substitui a impressão digital do host SSH padrão.

Saídas de jobs

Registra regras de mapeamento de ontologia e atribuições de famílias visuais nas configurações de ontologia da plataforma. Os mapeamentos aparecem na tabela "Status da ontologia" depois que os eventos correspondentes são ingeridos.

Família personalizada de push

Use o job Push Custom Family para exportar definições e ícones de famílias visuais personalizadas para o Git.

Entradas de job

Para configurar o job Push Custom Family, use os seguintes parâmetros:

Parâmetro Descrição
Family Name

Obrigatório.

Uma lista separada por vírgulas de nomes de famílias visuais personalizadas para exportar.

Commit

Obrigatório.

A mensagem de commit do Git.

Repo URL

Opcional.

Substitui o URL do repositório padrão.

Branch

Opcional.

Substitui a ramificação padrão.

Commit Author

Opcional.

Substitui o autor do commit padrão.

Git Server Fingerprint

Opcional.

Substitui a impressão digital do host SSH padrão.

Readme Addon

Opcional.

Conteúdo personalizado anexado ao README.md gerado para todas as famílias visuais personalizadas enviadas nesta execução e salvas em GitSync.json.

Compatível com a sintaxe Markdown e os modelos Jinja.

Saídas de jobs

Exporta definições de família visual (<Family_Name>.json), arquivos de imagem de ícone (<Family_Name>.png) e README.md para /Ontology/VisualFamilies/<Family_Name>/.

Família personalizada de pull

Use o job Pull Custom Family para importar uma definição de família visual personalizada e um ícone do Git.

Entradas de job

Para configurar o job Pull Custom Family, use os seguintes parâmetros:

Parâmetro Descrição
Family Name

Obrigatório.

O nome exato da família visual personalizada a ser importada.

Repo URL

Opcional.

Substitui o URL do repositório padrão.

Branch

Opcional.

Substitui a ramificação padrão.

Git Server Fingerprint

Opcional.

Substitui a impressão digital do host SSH padrão.

Saídas de jobs

Importa a definição e o ícone da família visual personalizada para as configurações de ontologia da plataforma.

Enviar casos simulados

Use o job Enviar casos simulados para exportar casos de teste simulados para o Git.

Entradas de job

Para configurar o job Enviar casos simulados, use os seguintes parâmetros:

Parâmetro Descrição
Simulated Cases

Obrigatório.

Uma lista separada por vírgulas de nomes de casos simulados para exportação.

Commit

Obrigatório.

A mensagem de commit do Git.

Repo URL

Opcional.

Substitui o URL do repositório padrão.

Branch

Opcional.

Substitui a ramificação padrão.

Commit Author

Opcional.

Substitui o autor do commit padrão.

Git Server Fingerprint

Opcional.

Substitui a impressão digital do host SSH padrão.

Saídas de jobs

Exporta casos simulados como arquivos .case para /SimulatedCases/<Case_Name>.case.

Extrair casos simulados

Use o job Extrair casos simulados para importar casos de teste simulados do Git.

Entradas de job

Para configurar o job Extrair casos simulados, use os seguintes parâmetros:

Parâmetro Descrição
Simulated Cases

Obrigatório.

Uma lista separada por vírgulas de nomes de casos simulados para importar do repositório.

Repo URL

Opcional.

Substitui o URL do repositório padrão.

Branch

Opcional.

Substitui a ramificação padrão.

Git Server Fingerprint

Opcional.

Substitui a impressão digital do host SSH padrão.

Saídas de jobs

Importa os casos simulados especificados para o catálogo de casos simulados da plataforma.

Solução de problemas

A tabela a seguir mostra as etapas de correção para erros comuns de sincronização:

Mensagem de erro observado Causa operacional Procedimento de correção
Falhas de AttributeError: 'OnePlatformSoarApi' object has no attribute 'update_ide_item' ou de sincronização no GitSync versão 53.0 Executar o pacote regressivo do GitSync versão 53.0, que contém problemas conhecidos de sincronização com itens personalizados do ambiente de desenvolvimento integrado e esquemas JSON modificados. Reverta o GitSync para a versão 52.0 ou faça upgrade para a versão 54.0 no Content Hub e verifique se o parâmetro Branch aponta para a ramificação do repositório anterior à v53. Para instruções detalhadas, consulte Reversão da versão 53.0 e compatibilidade com as versões 52.0 / 54.0.
Permission denied (publickey) ou Host key verification failed (ou Authentication failed for 'https://...') Falha na autenticação do Git causada por um formato de credencial inválido, falta de permissões de gravação da chave de implantação ou impressão digital do host incompatível.
  • Autenticação SSH: verifique se a chave SSH privada foi convertida em uma string base64 de linha única sem novas linhas ou espaços em branco no final. Confirme se a chave pública correspondente está registrada no repositório do Git com acesso de gravação.
  • Impressão digital do host: se a fixação da impressão digital do host estiver ativada, verifique a string da impressão digital usando ssh-keyscan -t rsa <hostname> e atualize o parâmetro Impressão digital do servidor Git.
  • Autenticação HTTPS: verifique se o token de acesso pessoal (PAT) não expirou e se tem escopo de gravação no repositório.
403 Forbidden: Insufficient permissions to modify playbook (ou Failed to push playbook: Access denied) O playbook de destino tem permissões de acesso padrão restritas (como Pode visualizar), e a função SOC Administrator não recebeu permissões Pode editar no sistema de origem. No Google SecOps, acesse Playbooks, selecione o playbook afetado, abra as configurações de conjunto de permissões e adicione o papel SOC Administrator com permissões Pode editar (ou configure os parâmetros opcionais Nome de usuário do SOAR e Senha do SOAR na instância de integração do GitSync). Para ver as etapas detalhadas, consulte Configurar permissões de playbook.
O job Pull Content ou Pull Integration expira após 5 minutos A instalação de várias integrações comerciais do Content Hub durante uma única operação de extração excedeu o tempo limite de execução do job de 5 minutos. Instale as integrações comerciais necessárias manualmente no Hub de Conteúdo antes de executar Extrair conteúdo ou execute novamente o job Extrair conteúdo para continuar importando os recursos restantes.
General error performing Job Pull Content (ou 400 Bad Request / 404 Not Found ao extrair de uma ramificação de repositório) Tentativa de extrair de uma ramificação de repositório não inicializada ou de uma ramificação com arquivos JSON exportados usando o esquema incompatível do GitSync versão 53.0.
  • Se a ramificação foi modificada usando o GitSync versão 53.0, mude o parâmetro Branch de volta para a ramificação do repositório anterior à v53 ou restaure o backup da ramificação anterior à v53 (consulte Reversão da versão 53.0 e compatibilidade com as versões 52.0 / 54.0).
  • Se você estiver configurando uma nova ramificação na versão 52.0 ou 54.0, execute um job completo de envio de conteúdo para preencher a ramificação antes de executar qualquer job de extração.
Playbook '<Playbook_Name>' is assigned to environment(s) that don't exist Um playbook ou bloco que está sendo importado é atribuído a um ambiente ou grupo de ambientes que não foi criado na instância de destino. Execute Extrair conteúdo com a opção Ambientes selecionada primeiro ou crie manualmente o ambiente ausente em Configurações > Gerenciamento de acesso > Ambientes na instância de destino antes de extrair os playbooks.
Commit Author parameter must be in the following format: Name <example@gmail.com> O parâmetro Autor do commit na instância de integração ou na configuração do job não tem um endereço de e-mail entre colchetes angulares. Atualize o parâmetro Autor do commit para corresponder ao formato exigido: Name <email@domain.com> (por exemplo, GitSync <gitsync@example.com>).
400 Bad Request ou 409 Conflict ao importar mapeamentos de ontologia As regras de mapeamento de eventos no repositório entram em conflito com as regras de ontologia da plataforma ou foram exportadas usando uma versão incompatível do GitSync. Execute um novo job de Push Mappings usando o GitSync versão 54.0 ou 52.0 para reexportar as definições de mapeamento ou resolva as regras de mapeamento de eventos duplicadas em Configurações > Ontologia > Regras de mapeamento antes de executar o job novamente.

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