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:
Nova implantação do GitSync ou nova ramificação: se você estiver configurando a integração do GitSync pela primeira vez ou criando uma nova ramificação de repositório, siga esta sequência de configuração completa:
- Conclua os pré-requisitos e a configuração de credenciais.
- Configure a instância de integração compartilhada.
- Teste a conectividade de rede e a autenticação com a ação Ping.
- Execute um job de envio de conteúdo inicial para preencher a ramificação antes de executar qualquer job de extração.
- Configurar e programar jobs de sincronização automatizados.
Referência de job e repositório:
- Para ver os parâmetros de configuração e executar jobs de push ou pull independentes para recursos específicos (playbooks, conectores, integrações etc.), consulte Jobs.
- Para ver o layout padrão do repositório, consulte Estrutura de diretórios do repositório.
Resolver problemas de sincronização: se uma ação ou um job falhar com um erro, consulte Solução de problemas.
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
Passwordsejam excluídos por padrão, a menos queCommit Passwordsesteja 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.mdou.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
Administratoras 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:
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_rsaEsse comando cria dois arquivos:
id_rsa(chave privada) eid_rsa.pub(chave pública).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.Converta a chave privada em uma string codificada em base64 de linha única:
Linux / macOS:
base64 -w 0 ./id_rsaWindows (PowerShell):
[Convert]::ToBase64String([System.IO.File]::ReadAllBytes(".\id_rsa"))
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:
Recupere a impressão digital do host: execute
ssh-keyscanno 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...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:
- No Google SecOps, acesse Playbooks e selecione o playbook de destino.
- Abra as configurações de permissões do playbook.
- 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:
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.
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.
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/eSettings/) e execute um job completo de Envio de conteúdo da versão 52.0 ou 54.0 para preencher novamente a ramificação.
- Se você criou uma ramificação separada para a versão 53.0 (por exemplo,
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 Ao usar a autenticação SSH, o URL precisa começar com |
Branch |
Obrigatório. A ramificação do repositório Git com que sincronizar (por exemplo, |
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,
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: |
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 |
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 ContentePull 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 PlaybookePull PlaybookConectores:
Push ConnectorsePull ConnectorIntegrações:
Push IntegrationePull IntegrationJobs programados:
Push JobePull JobsMapeamentos de ontologia:
Push MappingsePull MappingsFamílias visuais personalizadas:
Push Custom FamilyePull Custom FamilyCasos de teste simulados:
Push Simulated CasesePull 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 |
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
|
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 |
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 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 |
Include Visual Families |
Opcional. Se selecionado, exporta as famílias visuais personalizadas associadas aos registros de ontologia do conector para o |
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 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 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 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 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 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. |
|
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. |
|
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.