Google은 AI 기술을 사용하여 콘텐츠를 사용자의 기본 언어로 번역합니다. AI 번역에는 오류가 있을 수 있습니다.

GitSync

GitSync는 보안 자동화 애셋 및 구성요소를 외부 Git 저장소 (예: GitHub, GitLab, Bitbucket)와 동기화하는 Google SecOps용으로 빌드된 통합입니다. 콘텐츠의 양방향 동기화를 지원하여 보안 운영 수명 주기 전반에 걸쳐 자동화된 버전 제어, 구성 백업, 환경 간 프로모션을 제공합니다. GitSync는 내부 데이터베이스 식별자가 충돌을 일으킬 수 있는 관련 없는 시스템 간에 애셋을 배포하는 것이 아니라 관련 환경 (예: 개발, 스테이징, 프로덕션) 간에 애셋을 백업하고 마이그레이션하도록 설계되었습니다.

사용 사례

GitSync 통합은 다음과 같은 기본 사용 사례를 지원합니다.

버전 제어 및 감사 가능성 (Security as Code): 플레이북, 커넥터, 통합, 시스템 설정 전반에서 수정사항을 추적하고, 차이점을 검토하고, 변경사항의 전체 버전 기록을 유지합니다.
다중 환경 승격 (CI/CD 파이프라인): pull 요청 및 브랜치 병합을 통해 개발 및 스테이징 환경에서 프로덕션으로 플레이북, 온톨로지 매핑, 통합 설정을 체계적으로 승격합니다.
백업 및 재해 복구: 실수로 삭제, 손상 또는 잘못 구성된 플레이북 및 플랫폼 구성을 Git 저장소에서 직접 복원합니다.
환경 간 표준화: 중앙 저장소에서 관련 Google SecOps 환경에 표준화된 플레이북, 커스텀 시각적 제품군, 커넥터 정의를 배포합니다.
브랜치 및 스테이징 격리: 프로덕션 워크플로 또는 일정에 영향을 주지 않고 전용 환경에서 실험용 플레이북 및 기능 브랜치를 테스트합니다.
오프라인 검토 및 공동작업: 플랫폼 정의를 JSON 및 Markdown으로 내보내 표준 개발자 도구에서 동료 검토, 자동 검증, 검사를 사용 설정합니다.
재사용 가능한 워크플로 블록: 팀이 공통 자동화 단계를 공유할 수 있도록 전체 플레이북과 함께 또는 별도로 모듈식 워크플로 블록을 동기화합니다.

목표별 구현 워크플로

현재 목표에 맞는 안내로 바로 이동하려면 워크플로를 선택하세요.

새 GitSync 배포 또는 새 브랜치: GitSync 통합을 처음 구성하거나 새 저장소 브랜치를 만드는 경우 다음 엔드 투 엔드 설정 시퀀스를 따르세요.
1. 기본 요건 및 사용자 인증 정보 설정을 완료합니다.
2. 공유 통합 인스턴스를 구성합니다.
3. 핑 작업으로 네트워크 연결 및 인증을 테스트합니다.
4. 가져오기 작업을 실행하기 전에 초기 콘텐츠 푸시 작업을 실행하여 브랜치를 채웁니다.
5. 자동화된 동기화 작업을 구성하고 예약합니다.
작업 및 저장소 참조:
- 구성 매개변수를 확인하고 특정 애셋 (플레이북, 커넥터, 통합 등)에 대해 독립형 푸시 또는 풀 작업을 실행하려면 작업을 참고하세요.
- 표준 저장소 레이아웃을 보려면 저장소 디렉터리 구조를 참조하세요.
동기화 문제 해결: 작업이 오류와 함께 실패하면 문제 해결을 참조하세요.

시작하기 전에

GitSync 작업을 구성하고 실행하기 전에 통합 버전을 확인하고 저장소 액세스 권한을 얻고 다음 설정 작업을 완료하세요.

쓰기 액세스 권한이 있는 비공개 Git 저장소 사용: 지원되는 Git 제공업체 (예: GitHub, GitLab, Bitbucket)에서 호스팅하는 비공개 원격 Git 저장소에 대한 쓰기 권한이 있는지 확인합니다. Commit Passwords가 사용 설정되지 않는 한 Password 유형 매개변수는 기본적으로 제외되지만 다른 모든 매개변수 (예: 애플리케이션 ID, 클라이언트 ID, 사용자 이름, 엔드포인트)는 일반 텍스트로 내보내집니다. GitSync에서 공개 저장소를 사용하지 마세요.
원격 저장소 초기화: 원격 저장소에 초기 커밋이 하나 이상 있는지 확인합니다 (예: README.md 또는 .gitignore 파일). GitSync는 빈 저장소에 동기화할 수 없습니다.
Git 인증 사용자 인증 정보 준비: 저장소 쓰기 권한이 있는 인증 사용자 인증 정보를 생성합니다. GitSync는 base64로 인코딩된 SSH 비공개 키 (권장), 개인 액세스 토큰 (PAT), 기본 사용자 이름 및 비밀번호 사용자 인증 정보를 지원합니다.

SSH 키를 생성하고 인코딩하려면 GitSync용 SSH 키 생성을 참조하세요.
네트워크 연결 및 VPC 서비스 제어 확인: Google SecOps 인스턴스 또는 원격 실행기에 Git 제공업체에 대한 TCP 포트 443 (HTTPS) 또는 TCP 포트 22 (SSH)의 아웃바운드 방화벽 액세스 권한이 있는지 확인합니다.

Google Cloud 환경에서 VPC 서비스 제어 서비스 경계를 사용하는 경우 Google Cloud 관리자와 협력하여 인그레스 및 이그레스 규칙을 구성하여 응답 통합이 필요한 Google Cloud API 및 외부 엔드포인트와 통신할 수 있도록 합니다.
Git 호스트 디지털 지문 가져오기 (권장): 중간자 (PITM) 공격을 방지하려면 호스트 디지털 지문 고정을 위해 Git 서버의 공개 키 디지털 지문을 가져옵니다.

구성 단계는 호스트 디지털 지문 고정 사용 설정을 참조하세요.
플레이북 수정 권한 부여: 기본 액세스가 제한된 플레이북 (예: 볼 수 있음으로 설정된 기본 권한)을 동기화하려면 동기화 작업을 실행하기 전에 소스 시스템에서 Administrator SOC 역할에 수정할 수 있음 권한을 부여합니다.

단계별 안내는 플레이북 권한 구성을 참조하세요.

GitSync용 SSH 키 생성

SSH 키를 사용하여 안전한 비밀번호 없는 인증을 구성하려면 다음 안내를 따르세요.

터미널에서 RSA 또는 Ed25519 키 쌍을 생성합니다. 암호를 묻는 메시지가 표시되면 Enter를 눌러 비워둡니다.
```
ssh-keygen -b 2048 -t rsa -f ./id_rsa
```
이 명령어는 id_rsa (비공개 키) 및 id_rsa.pub (공개 키)라는 두 개의 파일을 만듭니다.
공개 키 (id_rsa.pub)를 원격 Git 호스팅 서비스에 쓰기 권한이 있는 배포 키 또는 액세스 키로 추가합니다.
비공개 키를 한 줄로 된 base64로 인코딩된 문자열로 변환합니다.
- Linux / macOS:
```
base64 -w 0 ./id_rsa
```
- Windows (PowerShell):
```
[Convert]::ToBase64String([System.IO.File]::ReadAllBytes(".\id_rsa"))
```
결과 base64 문자열을 복사하여 GitSync 통합 인스턴스를 구성할 때 Git 비밀번호/토큰/SSH 키 매개변수에 붙여넣습니다.

호스트 디지털 지문 고정 사용 설정

호스트 디지털 지문 고정은 연결 시 Git 서버의 ID를 확인하여 중간자 (PITM) 공격으로부터 보호합니다. Git 서버 디지털 지문 매개변수는 선택사항이지만 이를 구성하면 GitSync가 확인된 Git 호스트에만 연결됩니다.

호스트 디지털 지문 고정을 구성하려면 다음 안내를 따르세요.

호스트 디지털 지문 가져오기: 터미널에서 Git 서버 호스트 이름을 대상으로 ssh-keyscan를 실행합니다.
```
ssh-keyscan -t rsa <hostname>
```
예를 들어 GitHub의 경우 ssh-keyscan -t rsa github.com을 실행합니다. 이 명령어는 다음과 유사한 공개 호스트 키 줄을 출력합니다.
```
github.com ssh-rsa AAAAB3NzaC1yc2EAAAADAQABAAABgQC...
```
구성을 위해 디지털 지문 저장: 공개 호스트 키 줄을 복사합니다. GitSync 통합 인스턴스를 구성할 때 (모든 작업에 적용) 또는 개별 동기화 작업에서 (특정 호스트의 설정을 재정의) 이 값을 Git 서버 디지털 지문 매개변수에 입력합니다.

플레이북 권한 구성

제한된 권한이 있는 플레이북을 동기화할 때 (예: 기본 권한이 볼 수 있음으로 설정됨) Administrator SOC 역할에 수정할 수 있음 권한을 할당합니다.

Google SecOps에서 플레이북으로 이동하여 대상 플레이북을 선택합니다.
플레이북 권한 설정을 엽니다.
Administrator SOC 역할을 항목 목록에 추가하고 권한을 수정할 수 있음으로 설정합니다.

버전 53.0 롤백

GitSync 버전 53.0에서는 Chronicle API 변경사항과 수정된 JSON 내보내기 스키마가 도입되어 동기화 실패가 발생했습니다. 이러한 문제를 해결하기 위해 GitSync 버전 54.0은 버전 53.0 변경사항을 되돌리고 안정화 버전 52.0 코드베이스를 복원합니다.

다음 단계를 완료하여 버전 52.0 또는 버전 54.0으로 이동하고 호환되는 저장소 브랜치를 복원합니다.

예약된 동기화 작업 일시중지: 버전과 브랜치를 전환하는 동안 작업이 실행되지 않도록 활성 상태의 예약된 GitSync 작업 (예: 콘텐츠 푸시 및 콘텐츠 가져오기)을 사용 중지합니다.
버전 54.0으로 전환하거나 버전 52.0으로 롤백: 콘텐츠 허브에서 GitSync 통합을 찾습니다.
- 버전 54.0을 사용할 수 있는 경우 통합을 버전 54.0으로 업그레이드합니다.
- 버전 54.0이 아직 표시되지 않거나 (콘텐츠 허브 캐시는 약 8시간마다 동기화됨) 직접 다운그레이드하려는 경우 통합 버전을 버전 52.0으로 롤백합니다.
GitSync를 이전 저장소 브랜치로 가리키기: 버전 53.0을 사용하여 채워진 저장소 브랜치는 버전 52.0 또는 54.0과 호환되지 않는 다른 JSON 스키마를 사용합니다.
- 버전 53.0에 대해 별도의 브랜치를 만든 경우 (예: gitsync-chronicle-api): 설정 > 통합 > GitSync로 이동하고 브랜치 매개변수를 원래 브랜치 (예: main)로 다시 변경하고 핑 작업을 실행하여 연결을 확인합니다.
- 버전 53.0에서 기존 브랜치를 덮어쓴 경우: backup-legacy-pre-migration Git 태그 (또는 마지막 v53 이전 커밋)에서 브랜치를 복원하거나 버전 53.0 내보내기 디렉터리 (Playbooks/, Connectors/, Integrations/, Jobs/, Ontology/, SimulatedCases/, Settings/)를 삭제하고 버전 52.0 또는 54.0에서 전체 콘텐츠 푸시 작업을 실행하여 브랜치를 다시 채웁니다.
예약된 작업 재개: 브랜치에 버전 52.0 또는 54.0에서 내보낸 구성이 포함되어 있는지 확인한 후 예약된 GitSync 작업을 다시 사용 설정합니다.

브랜치 보호 규칙: GitSync는 커밋을 원격 저장소에 직접 푸시하며 pull 요청을 만들지 않습니다. 구성된 브랜치 (예: main)에서 pull 요청 또는 검토 승인이 필요한 브랜치 보호 규칙을 적용하는 경우 GitSync의 직접 푸시 작업이 실패합니다. 저장소 관리자가 GitSync 배포 키 또는 계정이 대상 브랜치에 직접 푸시할 수 있도록 예외를 구성하거나, GitSync가 전용 브랜치에 푸시하고 표준 pull 요청 워크플로를 통해 변경사항을 main에 병합하도록 구성해야 합니다.

통합 구성

모든 플랫폼 구성요소와 예약된 작업이 저장소 구성에 액세스할 수 있도록 Google SecOps에서 GitSync 통합을 공유 인스턴스로 구성합니다.

GitSync 통합 매개변수

매개변수	설명
`Repo URL`	필수 입력란입니다. 원격 Git 저장소 URL입니다. HTTPS 인증을 사용하는 경우 URL은 `https://`로 시작해야 합니다(예: `https://github.com/organization/secops-platform.git`). SSH 인증을 사용하는 경우 URL은 `git@` 또는 `ssh://`로 시작해야 합니다(예: `git@github.com:organization/secops-platform.git`).
`Branch`	필수 입력란입니다. 동기화할 Git 저장소 브랜치입니다 (예: `main`).
`Git Password/Token/SSH Key`	필수 입력란입니다. 원격 Git 저장소의 사용자 인증 정보입니다. 이 매개변수는 Git 계정 비밀번호, 개인 액세스 토큰 (PAT) 또는 base64로 인코딩된 SSH 비공개 키 (RSA 2048비트 또는 Ed25519)를 허용합니다.
`Git Username`	(선택사항) Git 계정 사용자 이름입니다. HTTPS를 통해 사용자 이름 및 비밀번호 인증을 사용할 때 필요합니다.
`Git Server Fingerprint`	(선택사항) 원격 Git 서버의 SSH 공개 호스트 키 (예: `github.com ssh-rsa AAAAB3NzaC1yc2EAAAADAQABAAABgQC...`) 이 매개변수를 구성하면 호스트 디지털 지문 고정이 사용 설정되어 GitSync가 확인된 Git 호스트에만 연결되고 PITM(person-in-the-middle) 위험이 완화됩니다. 이 값을 검색하려면 호스트 디지털 지문 고정 사용 설정을 참조하세요.
`Commit Author`	(선택사항) GitSync에서 생성된 발신 Git 커밋에 연결된 작성자 ID입니다. 형식은 표준 Git 작성자(`Name <email@domain.com>`)를 따라야 합니다(기본값은 `GitSync <gitsync@siemplify.co>`).
`Siemplify Verify SSL`	필수 입력란입니다. 선택하면 통합에서 Google SecOps API 엔드포인트의 SSL 인증서를 검증합니다. 기본적으로 사용 설정됩니다.
`Git Verify SSL`	필수 입력란입니다. 선택하면 통합에서 원격 Git 제공업체 서버의 SSL 인증서를 검증합니다. 기본적으로 사용 설정됩니다.
`SOAR Username`	(선택사항) 플레이북 수정 권한이 있는 계정의 Google SecOps 사용자 이름입니다. 권한 제한으로 인해 기본 API 키가 실패하는 경우 이 매개변수를 제공합니다.
`SOAR Password`	(선택사항) 구성된 `SOAR Username`에 해당하는 비밀번호입니다.

작업

작업에 대한 자세한 내용은 Workdesk의 대기 중인 작업에 응답 및 케이스에서 수동 작업 실행을 참고하세요.

핑

Ping 작업을 사용하여 네트워크 연결을 테스트하고 구성된 Git 저장소 및 브랜치에 대해 사용자 인증 정보를 확인합니다.

작업 입력

없음

작업 출력

핑 작업은 다음 출력을 제공합니다.

작업 출력 유형	가용성
케이스 월 연결	사용 불가
케이스 월 링크	사용 불가
케이스 월 테이블	사용 불가
보강 테이블	사용 불가
JSON 결과	사용 불가
출력 메시지	사용 가능
스크립트 결과	사용 가능

출력 메시지

Ping 작업은 다음 출력 메시지를 반환할 수 있습니다.

출력 메시지	메시지 설명
`Successfully executed action "Ping".`	작업이 성공하고 저장소 연결이 확인되었습니다.
`Error executing action "Ping". Reason: ERROR_REASON`	작업이 실패했습니다. 저장소 URL, 브랜치 이름, 사용자 인증 정보 또는 네트워크 경로를 확인하세요.

스크립트 결과

다음 표에는 핑 작업을 사용할 때의 스크립트 결과 값이 나와 있습니다.

스크립트 결과 이름	값
`is_success`	`true` 또는 `false`

작업

GitSync는 플랫폼 애셋을 관리하기 위해 16개의 동기화 작업 구성 (전체 인스턴스 작업 2개 및 독립형 작업 쌍 7개)을 제공합니다. 이러한 작업은 전체 인스턴스 수준 및 타겟팅된 독립형 동기화 범위를 지원합니다.

동기화 범위 및 지원되는 애셋

이 통합은 다양한 관리 및 자동화 요구사항을 충족하기 위해 동기화 작업을 두 가지 운영 범위로 구성합니다.

전체 인스턴스 동기화 (Push Content 및 Pull Content): 단일 일괄 작업으로 전체 Google SecOps 플랫폼을 동기화합니다.

여기에는 세 가지 기능 영역에 걸친 21가지 플랫폼 자산 카테고리가 포함됩니다.
- 시스템 및 환경 구성: 환경, 도메인, 동적 매개변수, 커스텀 목록, 네트워크, 블랙리스트 (차단 목록), 케이스 제목 설정, 이메일 템플릿, 로고
- 알림 및 케이스 관리: 케이스 태그, 케이스 단계, 케이스 종료 이유, SLA 기록, 시뮬레이션 케이스
- 보안 자동화 및 통합: 플레이북 (재사용 가능한 워크플로 블록 포함), 통합, 통합 인스턴스, 커넥터, 예약된 작업, 온톨로지 매핑, 시각적 제품군
세분화된 애셋 동기화 (독립형 푸시 및 풀 작업):

7가지 특정 저작물에 대한 전용 푸시 및 풀 작업 쌍을 제공합니다. 환경의 나머지 부분을 동기화하거나 덮어쓰지 않고 개별 구성요소를 개발, 업데이트 또는 테스트할 때는 독립형 작업을 사용합니다.
- 플레이북 및 워크플로 블록: Push Playbook 및 Pull Playbook
- 커넥터: Push Connectors 및 Pull Connector
- 통합: Push Integration 및 Pull Integration
- 예약된 작업: Push Job 및 Pull Jobs
- 온톨로지 매핑: Push Mappings 및 Pull Mappings
- 커스텀 시각적 계열: Push Custom Family 및 Pull Custom Family
- 시뮬레이션된 테스트 사례: Push Simulated Cases 및 Pull Simulated Cases

저장소 디렉터리 구조

초기 콘텐츠 푸시 작업을 실행하면 (새 브랜치 또는 이전된 브랜치에서 가져오기 작업을 실행하기 전에 필요) 원격 Git 저장소에 다음과 같은 사전 정의된 디렉터리 구조, JSON 구성 파일, 루트 GitSync.json 메타데이터 파일, 생성된 README.md 문서가 생성됩니다.

저장소 구조를 수동으로 수정하지 마세요. GitSync는 이 사전 정의된 디렉터리 레이아웃과 루트 GitSync.json 메타데이터 파일을 사용하여 플랫폼 애셋을 추적하고 해결합니다. 커스텀 커밋을 통해 수동으로 파일 이름을 바꾸거나 디렉터리를 이동하거나 저장소를 재구성하면 동기화 작업이 실패할 수 있습니다.

├── 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

인스턴스 수준 동기화 작업

인스턴스 수준 작업은 전체 Google SecOps 인스턴스에서 선택한 애셋 카테고리를 동기화합니다.

푸시 콘텐츠

콘텐츠 내보내기 작업을 사용하여 Google SecOps 인스턴스에서 선택한 애셋 카테고리를 내보내고 구성된 Git 저장소 브랜치에 커밋합니다. 새 브랜치를 초기화할 때는 항상 콘텐츠 푸시를 먼저 실행합니다.

작업 입력

콘텐츠 푸시 작업을 구성하려면 다음 매개변수를 사용합니다.

매개변수	설명
`Commit`	필수 입력란입니다. 내보낸 콘텐츠 변경사항을 설명하는 Git 커밋 메시지입니다.
`Commit Passwords`	(선택사항) 선택하면 작업이 구성된 통합 인스턴스, 커넥터, 작업에 대해 일반 텍스트 `Password` 유형 매개변수를 내보냅니다. 주의: 이 옵션은 일반 텍스트 사용자 인증 정보를 노출하므로 공개 또는 공유 저장소에서 사용 설정하면 안 됩니다. `Commit Passwords`가 사용 중지된 경우에도 `Password` 유형이 아닌 매개변수(예: 애플리케이션 ID, 클라이언트 ID, 사용자 이름, URL)는 항상 일반 텍스트로 내보내집니다.
애셋 선택 매개변수: `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`	선택사항 (불리언 전환)입니다. 내보내기에 포함할 각 애셋 카테고리를 선택합니다.
`Repo URL`	(선택사항) 통합 인스턴스에 구성된 저장소 URL을 재정의합니다.
`Branch`	(선택사항) 통합 인스턴스에 구성된 저장소 브랜치를 재정의합니다.
`Commit Author`	(선택사항) 통합 인스턴스에 구성된 커밋 작성자를 재정의합니다. `Name <email@domain.com>` 형식을 사용해야 합니다.
`Git Server Fingerprint`	(선택사항) 통합 인스턴스에 구성된 SSH 호스트 디지털 지문을 재정의합니다.

작업 출력

이 작업은 JSON 구성 파일과 README.md 요약을 표준 디렉터리 계층 구조 (/Playbooks, /Connectors, /Integrations, /Jobs, /Ontology/Mappings, /Ontology/VisualFamilies, /SimulatedCases, /Settings)에 따라 대상 Git 브랜치에 작성하고 실행 로그를 작업 실행기 콘솔에 출력합니다. 커스텀 통합은 전체 패키지로 내보내지는 반면 상용 통합은 통합에 추가된 커스텀 스크립트 또는 수정사항만 내보냅니다.

콘텐츠 가져오기

콘텐츠 가져오기 작업을 사용하여 구성된 Git 저장소 브랜치에서 선택한 구성 카테고리를 검색하고 Google SecOps 플랫폼에 적용합니다.

작업 입력

콘텐츠 가져오기 작업을 구성하려면 다음 매개변수를 사용합니다.

매개변수	설명
애셋 선택 매개변수: `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`	선택사항 (불리언 전환)입니다. 저장소에서 환경으로 가져올 각 애셋 카테고리를 선택합니다.
`Repo URL`	(선택사항) 통합 인스턴스에 구성된 저장소 URL을 재정의합니다.
`Branch`	(선택사항) 통합 인스턴스에 구성된 저장소 브랜치를 재정의합니다.
`Git Server Fingerprint`	(선택사항) 통합 인스턴스에 구성된 SSH 호스트 디지털 지문을 재정의합니다.

작업 출력

작업은 선택한 저장소 정의를 플랫폼으로 가져오고, 통합 인스턴스, 플레이북, 커넥터, 작업, 온톨로지 매핑, 설정을 만들거나 업데이트하고, 실행 로그를 작업 실행기 콘솔에 출력합니다.

독립형 동기화 작업

독립형 작업을 사용하면 전체 저장소 동기화 없이 특정 애셋을 세부적으로 동기화할 수 있습니다.

푸시 플레이북

플레이북 푸시 작업을 사용하여 개별 플레이북 또는 재사용 가능한 워크플로 블록을 Git으로 내보냅니다.

작업 입력

플레이북 푸시 작업을 구성하려면 다음 매개변수를 사용합니다.

매개변수	설명
`Commit`	필수 입력란입니다. 플레이북 변경사항을 설명하는 Git 커밋 메시지입니다.
`Playbook Whitelist`	(선택사항) 내보낼 플레이북 또는 블록의 정확한 대소문자 구분 이름이 쉼표로 구분된 목록입니다. `Playbook Whitelist` 또는 `Folders Whitelist`를 제공합니다.
`Folders Whitelist`	(선택사항) 플레이북 폴더 (카테고리) 이름을 쉼표로 구분한 목록입니다. 이러한 폴더 내에 있는 모든 플레이북과 블록을 내보냅니다.
`Include Playbook Blocks`	(선택사항) 선택하면 선택한 플레이북과 함께 재사용 가능한 워크플로 블록을 내보냅니다. 여기에는 해당 플레이북 내에서 단계로 참조되는 모든 블록이 포함됩니다.
`Repo URL`	(선택사항) 기본 저장소 URL을 재정의합니다.
`Branch`	(선택사항) 기본 브랜치를 재정의합니다.
`Commit Author`	(선택사항) 기본 커밋 작성자를 재정의합니다.
`Git Server Fingerprint`	(선택사항) 기본 SSH 호스트 디지털 지문을 재정의합니다.
`Readme Addon`	(선택사항) 이 실행에서 푸시되고 루트 `GitSync.json` 메타데이터 파일에 저장된 모든 플레이북에 대해 생성된 `README.md`에 추가된 맞춤 콘텐츠입니다. 마크다운 문법과 Jinja 템플릿을 모두 지원합니다.

작업 출력

선택한 플레이북과 포함된 워크플로 블록을 /Playbooks/<Folder_Name>/<Playbook_Name>/에 내보내고 /Playbooks/README.md를 업데이트합니다.

플레이북 가져오기

플레이북 가져오기 작업을 사용하여 Git에서 특정 플레이북 또는 블록을 가져옵니다.

작업 입력

플레이북 가져오기 작업을 구성하려면 다음 매개변수를 사용합니다.

매개변수	설명
`Playbook Whitelist`	필수 입력란입니다. 저장소에서 가져올 정확한 플레이북 또는 블록 이름의 쉼표로 구분된 목록입니다.
`Include Playbook Blocks`	(선택사항) 선택하면 선택한 플레이북에서 참조하는 재사용 가능한 워크플로 블록을 자동으로 가져옵니다.
`Repo URL`	(선택사항) 기본 저장소 URL을 재정의합니다.
`Branch`	(선택사항) 기본 브랜치를 재정의합니다.
`Git Server Fingerprint`	(선택사항) 기본 SSH 호스트 디지털 지문을 재정의합니다.

작업 출력

지정된 플레이북과 블록을 /Playbooks (또는 /Blocks)에서 플랫폼으로 가져오고, 상위 플레이북을 설치하기 전에 참조된 블록을 먼저 설치합니다.

푸시 커넥터

커넥터 푸시 작업을 사용하여 커넥터 구성을 Git으로 내보냅니다.

작업 입력

Push Connectors 작업을 구성하려면 다음 매개변수를 사용합니다.

매개변수	설명
`Connectors`	필수 입력란입니다. 내보낼 커넥터 표시 이름을 쉼표로 구분한 목록입니다.
`Commit`	필수 입력란입니다. Git 커밋 메시지입니다.
`Include Mappings`	(선택사항) 선택하면 커넥터 통합과 연결된 온톨로지 매핑 레코드 및 규칙을 `/Ontology/Mappings`로 내보냅니다.
`Include Visual Families`	(선택사항) 선택하면 커넥터의 온톨로지 레코드와 연결된 커스텀 시각적 계열을 `/Ontology/VisualFamilies`로 내보냅니다.
`Repo URL`	(선택사항) 기본 저장소 URL을 재정의합니다.
`Branch`	(선택사항) 기본 브랜치를 재정의합니다.
`Commit Author`	(선택사항) 기본 커밋 작성자를 재정의합니다.
`Git Server Fingerprint`	(선택사항) 기본 SSH 호스트 디지털 지문을 재정의합니다.
`Readme Addon`	(선택사항) 이 실행에서 푸시되고 `GitSync.json`에 저장된 모든 커넥터에 대해 생성된 `README.md`에 추가된 커스텀 콘텐츠입니다. 마크다운 문법과 Jinja 템플릿을 모두 지원합니다.

작업 출력

커넥터 설정 및 일정을 /Connectors/<Integration_Name>/<Connector_Name>/로 내보냅니다(선택한 경우 연결된 온톨로지 매핑 및 시각적 계열 포함).

풀 커넥터

커넥터 가져오기 작업을 사용하여 Git에서 커넥터 구성을 가져옵니다. 이 작업을 실행하기 전에 커넥터의 기본 통합이 대상 환경에 이미 설치되어 있는지 확인하세요.

작업 입력

Pull Connector 작업을 구성하려면 다음 매개변수를 사용합니다.

매개변수	설명
`Connector Name`	필수 입력란입니다. 저장소에서 가져올 커넥터의 표시 이름입니다.
`Include Mappings`	(선택사항) 선택하면 커넥터 통합과 연결된 온톨로지 매핑을 가져옵니다.
`Include Visual Families`	(선택사항) 선택하면 커넥터 통합과 연결된 커스텀 시각적 계열을 가져옵니다.
`Repo URL`	(선택사항) 기본 저장소 URL을 재정의합니다.
`Branch`	(선택사항) 기본 브랜치를 재정의합니다.
`Git Server Fingerprint`	(선택사항) 기본 SSH 호스트 디지털 지문을 재정의합니다.

작업 출력

대상 환경에 커넥터를 설치하거나 업데이트합니다 (선택한 경우 연결된 매핑 또는 시각적 계열 포함).

푸시 통합

푸시 통합 작업을 사용하여 상용 통합에 추가된 커스텀 통합 또는 커스텀 스크립트를 Git으로 내보냅니다. 커스텀 통합은 전체 통합 패키지로 내보내지는 반면 상용 통합은 통합에 추가된 커스텀 스크립트 또는 수정사항만 내보냅니다.

작업 입력

푸시 통합 작업을 구성하려면 다음 매개변수를 사용합니다.

매개변수	설명
`Push Whitelist`	필수 입력란입니다. 내보낼 통합 식별자의 쉼표로 구분된 목록입니다.
`Commit`	필수 입력란입니다. Git 커밋 메시지입니다.
`Repo URL`	(선택사항) 기본 저장소 URL을 재정의합니다.
`Branch`	(선택사항) 기본 브랜치를 재정의합니다.
`Commit Author`	(선택사항) 기본 커밋 작성자를 재정의합니다.
`Git Server Fingerprint`	(선택사항) 기본 SSH 호스트 디지털 지문을 재정의합니다.
`Readme Addon`	(선택사항) 이 실행에서 푸시되고 `GitSync.json`에 저장된 모든 통합에 대해 생성된 `README.md`에 추가된 커스텀 콘텐츠입니다. 마크다운 문법과 Jinja 템플릿을 모두 지원합니다.

작업 출력

통합 정의, 커스텀 스크립트 (Actions/, Connectors/, Jobs/, Managers/), 종속 항목, README.md 문서를 /Integrations/<Integration_Identifier>/로 내보냅니다.

풀 통합

가져오기 통합 작업을 사용하여 Git에서 상용 통합을 위한 커스텀 통합 또는 커스텀 스크립트를 가져옵니다. 상업용 통합의 경우 GitSync는 콘텐츠 허브에서 최신 버전의 통합을 설치하고 커스텀 스크립트를 여기에 저장합니다.

작업 입력

가져오기 통합 작업을 구성하려면 다음 매개변수를 사용합니다.

매개변수	설명
`Install Whitelist`	필수 입력란입니다. 저장소에서 가져올 통합 식별자의 쉼표로 구분된 목록입니다.
`Repo URL`	(선택사항) 기본 저장소 URL을 재정의합니다.
`Branch`	(선택사항) 기본 브랜치를 재정의합니다.
`Git Server Fingerprint`	(선택사항) 기본 SSH 호스트 디지털 지문을 재정의합니다.

작업 출력

커스텀 통합 패키지를 설치하거나 콘텐츠 허브에서 상용 통합을 설치하고 대상 환경에서 커스텀 스크립트를 업데이트합니다.

푸시 작업

Push Job 작업을 사용하여 예약된 플랫폼 작업 구성을 Git으로 내보냅니다.

작업 입력

작업 푸시 작업을 구성하려면 다음 매개변수를 사용합니다.

매개변수	설명
`Job Whitelist`	필수 입력란입니다. 내보낼 예약된 작업 이름의 쉼표로 구분된 목록입니다.
`Commit`	필수 입력란입니다. Git 커밋 메시지입니다.
`Repo URL`	(선택사항) 기본 저장소 URL을 재정의합니다.
`Branch`	(선택사항) 기본 브랜치를 재정의합니다.
`Commit Author`	(선택사항) 기본 커밋 작성자를 재정의합니다.
`Git Server Fingerprint`	(선택사항) 기본 SSH 호스트 디지털 지문을 재정의합니다.
`Readme Addon`	(선택사항) 이 실행에서 푸시되고 `GitSync.json`에 저장된 모든 작업에 대해 생성된 `README.md`에 추가된 맞춤 콘텐츠입니다. 마크다운 문법과 Jinja 템플릿을 모두 지원합니다.

작업 출력

작업 매개변수 및 일정 간격을 /Jobs/<Job_Name>.json로 내보내고 /Jobs/README.md를 업데이트합니다.

가져오기 작업

작업 가져오기 작업을 사용하여 Git에서 예약된 플랫폼 작업을 가져옵니다.

작업 입력

작업 가져오기 작업을 구성하려면 다음 매개변수를 사용합니다.

매개변수	설명
`Job Whitelist`	필수 입력란입니다. 저장소에서 가져올 예약된 작업 이름의 쉼표로 구분된 목록입니다.
`Repo URL`	(선택사항) 기본 저장소 URL을 재정의합니다.
`Branch`	(선택사항) 기본 브랜치를 재정의합니다.
`Git Server Fingerprint`	(선택사항) 기본 SSH 호스트 디지털 지문을 재정의합니다.

작업 출력

플랫폼 작업 스케줄러에서 지정된 예약된 작업을 구성하고 등록합니다.

푸시 매핑

매핑 푸시 작업을 사용하여 특정 소스의 온톨로지 이벤트 매핑 레코드 및 규칙을 Git으로 내보냅니다.

작업 입력

매핑 푸시 작업을 구성하려면 다음 매개변수를 사용합니다.

매개변수	설명
`Source`	필수 입력란입니다. 매핑 레코드와 규칙을 내보내려는 온톨로지 소스 (통합 이름)입니다.
`Commit`	필수 입력란입니다. Git 커밋 메시지입니다.
`Repo URL`	(선택사항) 기본 저장소 URL을 재정의합니다.
`Branch`	(선택사항) 기본 브랜치를 재정의합니다.
`Commit Author`	(선택사항) 기본 커밋 작성자를 재정의합니다.
`Git Server Fingerprint`	(선택사항) 기본 SSH 호스트 디지털 지문을 재정의합니다.
`Readme Addon`	(선택사항) 이 실행에서 푸시되고 `GitSync.json`에 저장된 모든 매핑에 대해 생성된 `README.md`에 추가된 커스텀 콘텐츠입니다. 마크다운 문법과 Jinja 템플릿을 모두 지원합니다.

작업 출력

온톨로지 레코드 (<Source>_Records.json), 매핑 규칙 (<Source>_Rules.json), README.md를 /Ontology/Mappings/<Source>/에 씁니다.

매핑 가져오기

매핑 가져오기 작업을 사용하여 Git에서 특정 소스의 온톨로지 매핑 레코드 및 규칙을 가져옵니다.

작업 입력

매핑 가져오기 작업을 구성하려면 다음 매개변수를 사용합니다.

매개변수	설명
`Source`	필수 입력란입니다. 매핑 레코드와 규칙을 가져오려는 온톨로지 소스 (통합 이름)입니다.
`Repo URL`	(선택사항) 기본 저장소 URL을 재정의합니다.
`Branch`	(선택사항) 기본 브랜치를 재정의합니다.
`Git Server Fingerprint`	(선택사항) 기본 SSH 호스트 디지털 지문을 재정의합니다.

작업 출력

플랫폼 온톨로지 설정에서 온톨로지 매핑 규칙과 시각적 계열 할당을 등록합니다. 해당 이벤트가 수집되면 매핑이 온톨로지 상태 표에 표시됩니다.

커스텀 계열 푸시

커스텀 계열 푸시 작업을 사용하여 커스텀 시각적 계열 정의 및 아이콘을 Git으로 내보냅니다.

작업 입력

Push Custom Family 작업을 구성하려면 다음 매개변수를 사용합니다.

매개변수	설명
`Family Name`	필수 입력란입니다. 내보낼 커스텀 시각적 계열 이름을 쉼표로 구분한 목록입니다.
`Commit`	필수 입력란입니다. Git 커밋 메시지입니다.
`Repo URL`	(선택사항) 기본 저장소 URL을 재정의합니다.
`Branch`	(선택사항) 기본 브랜치를 재정의합니다.
`Commit Author`	(선택사항) 기본 커밋 작성자를 재정의합니다.
`Git Server Fingerprint`	(선택사항) 기본 SSH 호스트 디지털 지문을 재정의합니다.
`Readme Addon`	(선택사항) 이 실행에서 푸시되고 `GitSync.json`에 저장된 모든 커스텀 시각적 계열에 대해 생성된 `README.md`에 추가된 커스텀 콘텐츠입니다. 마크다운 문법과 Jinja 템플릿을 모두 지원합니다.

작업 출력

시각적 계열 정의 (<Family_Name>.json), 아이콘 이미지 파일 (<Family_Name>.png), README.md를 /Ontology/VisualFamilies/<Family_Name>/로 내보냅니다.

커스텀 계열 가져오기

커스텀 계열 가져오기 작업을 사용하여 Git에서 커스텀 시각적 계열 정의 및 아이콘을 가져옵니다.

작업 입력

Pull Custom Family 작업을 구성하려면 다음 매개변수를 사용합니다.

매개변수	설명
`Family Name`	필수 입력란입니다. 가져올 커스텀 시각적 계열의 정확한 이름입니다.
`Repo URL`	(선택사항) 기본 저장소 URL을 재정의합니다.
`Branch`	(선택사항) 기본 브랜치를 재정의합니다.
`Git Server Fingerprint`	(선택사항) 기본 SSH 호스트 디지털 지문을 재정의합니다.

작업 출력

커스텀 시각적 계열 정의 및 아이콘을 플랫폼 온톨로지 설정으로 가져옵니다.

시뮬레이션 케이스 푸시

시뮬레이션된 케이스 푸시 작업을 사용하여 시뮬레이션된 테스트 사례를 Git으로 내보냅니다.

작업 입력

시뮬레이션된 케이스 푸시 작업을 구성하려면 다음 매개변수를 사용합니다.

매개변수	설명
`Simulated Cases`	필수 입력란입니다. 내보낼 시뮬레이션 케이스 이름을 쉼표로 구분한 목록입니다.
`Commit`	필수 입력란입니다. Git 커밋 메시지입니다.
`Repo URL`	(선택사항) 기본 저장소 URL을 재정의합니다.
`Branch`	(선택사항) 기본 브랜치를 재정의합니다.
`Commit Author`	(선택사항) 기본 커밋 작성자를 재정의합니다.
`Git Server Fingerprint`	(선택사항) 기본 SSH 호스트 디지털 지문을 재정의합니다.

작업 출력

시뮬레이션된 케이스를 .case 파일로 /SimulatedCases/<Case_Name>.case에 내보냅니다.

시뮬레이션 케이스 가져오기

시뮬레이션된 케이스 가져오기 작업을 사용하여 Git에서 시뮬레이션된 테스트 사례를 가져옵니다.

작업 입력

시뮬레이션된 케이스 가져오기 작업을 구성하려면 다음 매개변수를 사용합니다.

매개변수	설명
`Simulated Cases`	필수 입력란입니다. 저장소에서 가져올 시뮬레이션 케이스 이름을 쉼표로 구분한 목록입니다.
`Repo URL`	(선택사항) 기본 저장소 URL을 재정의합니다.
`Branch`	(선택사항) 기본 브랜치를 재정의합니다.
`Git Server Fingerprint`	(선택사항) 기본 SSH 호스트 디지털 지문을 재정의합니다.

작업 출력

지정된 시뮬레이션 케이스를 플랫폼의 시뮬레이션 케이스 카탈로그로 가져옵니다.

문제 해결

다음 표에서는 일반적인 동기화 오류에 대한 해결 단계를 제공합니다.

확인된 오류 메시지	운영 원인	해결 절차
GitSync 버전 53.0의 `AttributeError: 'OnePlatformSoarApi' object has no attribute 'update_ide_item'` 또는 동기화 실패	맞춤 IDE 항목 및 수정된 JSON 스키마와 관련된 알려진 동기화 문제가 포함된 회귀 GitSync 버전 53.0 패키지를 실행합니다.	콘텐츠 허브에서 GitSync를 버전 52.0으로 롤백하거나 버전 54.0으로 업그레이드하고 Branch 매개변수가 v53 이전 저장소 브랜치를 가리키는지 확인합니다. 단계별 안내는 버전 53.0 롤백 및 버전 52.0/54.0 호환성을 참고하세요.
`Permission denied (publickey)` 또는 `Host key verification failed` (또는 `Authentication failed for 'https://...'`)	잘못된 사용자 인증 정보 형식, 배포 키 쓰기 권한 누락 또는 일치하지 않는 호스트 디지털 지문으로 인해 Git 인증에 실패했습니다.	SSH 인증: 비공개 SSH 키가 후행 줄바꿈이나 공백 없이 한 줄 base64 문자열로 변환되었는지 확인합니다. 해당 공개 키가 쓰기 액세스 권한으로 Git 저장소에 등록되어 있는지 확인합니다. 호스트 디지털 지문: 호스트 디지털 지문 고정이 사용 설정된 경우 `ssh-keyscan -t rsa <hostname>`를 사용하여 디지털 지문 문자열을 확인하고 Git 서버 디지털 지문 매개변수를 업데이트합니다. HTTPS 인증: 개인 액세스 토큰 (PAT)이 만료되지 않았고 저장소 쓰기 범위가 있는지 확인합니다.
`403 Forbidden: Insufficient permissions to modify playbook`(또는 `Failed to push playbook: Access denied`)	대상 플레이북에 기본 액세스 권한 (예: 보기 가능)이 제한되어 있으며 `Administrator` SOC 역할에 소스 시스템에 대한 수정 가능 권한이 부여되지 않았습니다.	Google SecOps에서 플레이북으로 이동하여 영향을 받는 플레이북을 선택하고 권한 설정을 연 다음 수정 가능 권한이 있는 `Administrator` SOC 역할을 추가합니다 (또는 GitSync 통합 인스턴스에서 선택적 SOAR 사용자 이름 및 SOAR 비밀번호 매개변수 구성). 자세한 단계는 플레이북 권한 구성을 참조하세요.
5분 후 콘텐츠 가져오기 또는 통합 가져오기 작업이 타임아웃됨	단일 가져오기 작업 중에 콘텐츠 허브에서 여러 상업용 통합을 설치하면 5분 작업 실행 제한 시간을 초과했습니다.	콘텐츠 가져오기를 실행하기 전에 콘텐츠 허브에서 필요한 상업용 통합을 수동으로 설치하거나 콘텐츠 가져오기 작업을 다시 실행하여 나머지 애셋을 계속 가져옵니다.
`General error performing Job Pull Content` (또는 저장소 브랜치에서 가져올 때 `400 Bad Request` / `404 Not Found`)	초기화되지 않은 저장소 브랜치 또는 호환되지 않는 GitSync 버전 53.0 스키마를 사용하여 JSON 파일을 내보낸 브랜치에서 가져오려고 합니다.	GitSync 버전 53.0을 사용하여 브랜치를 수정한 경우 브랜치 매개변수를 v53 이전 저장소 브랜치로 다시 전환하거나 v53 이전 브랜치 백업을 복원합니다(버전 53.0 롤백 및 버전 52.0/54.0 호환성 참고). 버전 52.0 또는 54.0에서 새 브랜치를 설정하는 경우 가져오기 작업을 실행하기 전에 먼저 전체 콘텐츠 푸시 작업을 실행하여 브랜치를 채웁니다.
`Playbook '<Playbook_Name>' is assigned to environment(s) that don't exist`	가져오는 플레이북 또는 블록이 대상 인스턴스에 생성되지 않은 환경 또는 환경 그룹에 할당되었습니다.	환경 옵션을 먼저 선택한 상태에서 콘텐츠 가져오기를 실행하거나 플레이북을 가져오기 전에 대상 인스턴스의 설정 > 환경에서 누락된 환경을 수동으로 만듭니다.
`Commit Author parameter must be in the following format: Name <example@gmail.com>`	통합 인스턴스 또는 작업 구성의 커밋 작성자 매개변수에 꺾쇠괄호로 묶인 이메일 주소가 누락되었습니다.	커밋 작성자 매개변수를 필수 형식인 `Name <email@domain.com>` (예: `GitSync <gitsync@example.com>`)에 맞게 업데이트합니다.
온톨로지 매핑을 가져올 때 `400 Bad Request` 또는 `409 Conflict`	저장소의 이벤트 매핑 규칙이 기존 플랫폼 온톨로지 규칙과 충돌하거나 호환되지 않는 GitSync 버전을 사용하여 내보내졌습니다.	GitSync 버전 54.0 또는 52.0을 사용하여 새로운 매핑 푸시 작업을 실행하여 매핑 정의를 다시 내보내거나 작업을 다시 실행하기 전에 설정 > 온톨로지 > 매핑 규칙에서 중복 이벤트 매핑 규칙을 해결하세요.

도움이 더 필요하신가요? 커뮤니티 회원 및 Google SecOps 전문가에게 문의하여 답변을 받으세요.