AlgoSec을 Google SecOps와 통합
이 문서에서는 AlgoSec을 Google Security Operations와 통합하는 방법을 설명합니다.
사용 사례
AlgoSec 통합은 Google SecOps 기능을 사용하여 다음 사용 사례를 지원합니다.
자동화된 위협 차단: 보안 조사 중에 자동화된 트래픽 삭제 변경 요청을 제출하여 관리형 방화벽 전반에서 악성 IP 주소를 차단합니다.
제어된 트래픽 승인: AlgoSec FireFlow에서 표준화된 허용 규칙을 만들어 확인된 대상 IP 주소로의 합법적인 비즈니스 트래픽을 허용합니다.
템플릿 검색 및 거버넌스: 사용 가능한 FireFlow 변경 요청 템플릿을 검색하여 자동화된 대응 작업을 조직의 변경 관리 정책에 맞게 조정합니다.
비동기 변경 수명 주기 추적: 제출된 트래픽 변경 요청이 해결 또는 구현과 같은 목표 운영 상태에 도달할 때까지 모니터링합니다.
시작하기 전에
Google SecOps에서 AlgoSec 통합을 구성하기 전에 환경이 다음 요구사항을 충족하는지 확인하세요.
네트워크 연결: Google SecOps(또는 온프레미스 환경에 배포된 원격 에이전트)가 TCP 포트
443에서 HTTPS를 통해 AlgoSec 서버에 연결할 수 있는지 확인합니다.FireFlow 템플릿: 변경 요청을 제출하는 작업을 실행하기 전에 AlgoSec FireFlow에서 하나 이상의 트래픽 변경 요청 템플릿(예:
Standard)을 사용 설정합니다.최소 권한 사용자 권한: 다음 표에 설명된 대로 플레이북에 사용되는 작업에 필요한 최소 권한으로 전용 AlgoSec FireFlow 서비스 계정을 구성합니다.
| 작업 | 필수 AlgoSec FireFlow 권한 |
|---|---|
Allow IP |
FireFlow로 인증하고, 허용 규칙에 대한 트래픽 변경 요청을 만들고, 트래픽 변경 요청 세부정보를 읽습니다. |
Block IP |
FireFlow로 인증하고, 삭제 규칙에 대한 트래픽 변경 요청을 만들고, 트래픽 변경 요청 세부정보를 읽습니다. |
List Templates |
FireFlow로 인증하고 사용 가능한 변경 요청 템플릿을 확인합니다. |
Ping |
FireFlow로 인증하고 사용 가능한 변경 요청 템플릿을 확인하여 연결을 검증합니다. |
Wait for Change Request Status Update |
FireFlow로 인증하고 트래픽 변경 요청 세부정보 및 수명 주기 상태를 읽습니다. |
FireFlow 역할, 사용자 계정, 변경 요청 템플릿 구성에 대한 자세한 내용은 공식 AlgoSec FireFlow 문서를 참조하세요.
통합 매개변수
AlgoSec 통합에는 다음 매개변수가 필요합니다.
| 매개변수 | 설명 |
|---|---|
API Root |
필수 항목입니다.
|
Username |
필수 항목입니다. 인증에 사용되는 AlgoSec FireFlow 계정의 사용자 이름입니다. |
Password |
필수 항목입니다. 인증에 사용되는 AlgoSec FireFlow 계정의 비밀번호입니다. |
Verify SSL |
필수 항목입니다. 선택하면 통합에서 AlgoSec 서버에 연결할 때 SSL 인증서를 검증합니다. 기본적으로 사용 설정됩니다. |
Google SecOps에서 통합을 구성하는 방법에 대한 안내는 통합 구성을 참조하세요.
필요한 경우 이후 단계에서 변경할 수 있습니다. 통합 인스턴스를 구성한 후 플레이북에서 사용할 수 있습니다. 여러 인스턴스를 구성하고 지원하는 방법에 관한 자세한 내용은 다중 인스턴스 지원을 참고하세요.
작업
작업에 대한 자세한 내용은 Workdesk의 대기 중인 작업에 응답 및 케이스에서 수동 작업 실행을 참고하세요.
IP 허용
IP 허용 작업을 사용하여 AlgoSec FireFlow에서 케이스의 IP Address 항목(대상 주소로 사용됨)으로의 트래픽을 허용하는 트래픽 변경 요청을 제출합니다.
이 작업은 IP Address Google SecOps 항목에서 실행됩니다.
작업 입력
IP 허용 작업에는 다음 매개변수가 필요합니다.
| 매개변수 | 설명 |
|---|---|
Template |
필수 항목입니다. 트래픽 변경 요청에 사용할 AlgoSec FireFlow 템플릿의 이름입니다. 기본값은 |
Source |
필수 항목입니다. 허용 규칙의 소스 IP 주소 또는 네트워크 객체의 쉼표로 구분된 목록 또는 모든 소스를 포함하는 키워드 기본값은 |
Service |
필수 항목입니다. 허용할 네트워크 서비스의 쉼표로 구분된 목록으로, 기본값은 |
Subject |
(선택사항) AlgoSec FireFlow의 트래픽 변경 요청 제목입니다. 기본값은 |
Owner |
(선택사항) 변경 요청을 소유한 사용자의 사용자 이름 또는 식별자입니다. 값을 제공하지 않으면 AlgoSec은 티켓을 만든 인증된 사용자를 소유자로 할당합니다. |
Due Date |
(선택사항) 변경 요청의 목표 완료 날짜 및 시간입니다(ISO 8601 형식, 예: |
Expiration Date |
(선택사항) 허용된 트래픽 규칙의 만료 날짜 및 시간입니다(ISO 8601 형식, 예: |
Custom Fields |
(선택사항) 키-값 쌍으로 제공되는 추가 FireFlow 변경 요청 필드(예: 이 매개변수를 제공하면 |
작업 출력
IP 허용 작업은 다음 출력을 제공합니다.
| 작업 출력 유형 | 가용성 |
|---|---|
| 케이스 월 연결 | 사용 불가 |
| 케이스 월 링크 | 사용 가능 |
| 케이스 월 테이블 | 사용 불가 |
| 항목 보강 테이블 | 사용 불가 |
| JSON 결과 | 사용 가능 |
| 출력 메시지 | 사용 가능 |
| 스크립트 결과 | 사용 가능 |
케이스 월 링크
IP 허용 작업은 케이스 월에 다음 링크를 제공합니다.
링크 제목:
Change Request Link링크 타겟: AlgoSec FireFlow 웹 인터페이스에서 생성된 트래픽 변경 요청을 엽니다.
JSON 결과
다음 예시는 IP 허용 작업을 사용할 때 수신되는 JSON 결과 출력을 보여줍니다.
{
"status": "Success",
"messages": [],
"data": {
"id": 10,
"fields": [
{
"name": "Owner",
"values": [
"admin@example.com"
]
},
{
"name": "Creator",
"values": [
"admin@example.com"
]
},
{
"name": "Due",
"values": [
"2021-08-31 00:00:00"
]
},
{
"name": "LastUpdated",
"values": [
"2021-08-13 12:31:23"
]
},
{
"name": "Requestor",
"values": [
"admin@example.com"
]
}
],
"originalTraffic": [
{
"source": {
"items": [
{
"value": "all"
}
]
},
"destination": {
"items": [
{
"value": "192.0.2.3"
}
]
},
"service": {
"items": [
{
"value": "ALL"
}
]
},
"application": {
"items": [
{
"value": "any"
}
]
},
"user": {
"items": [
{
"value": "any"
}
]
},
"action": "Allow"
}
],
"plannedTraffic": [
{
"source": {
"items": [
{
"value": "0.0.0.0-255.255.255.255"
}
]
},
"destination": {
"items": [
{
"value": "192.0.2.3"
}
]
},
"service": {
"items": [
{
"value": "tcp/*"
},
{
"value": "udp/*"
},
{
"value": "ospf"
},
{
"value": "icmp/*"
},
{
"value": "gre"
},
{
"value": "ipsec_50"
},
{
"value": "ipsec_51"
}
]
},
"application": {
"items": [
{
"value": "any"
}
]
},
"user": {
"items": [
{
"value": "any"
}
]
},
"action": "Allow"
}
]
}
}
출력 메시지
IP 허용 작업은 다음 출력 메시지를 제공합니다.
| 출력 메시지 | 메시지 설명 |
|---|---|
Successfully created a traffic change request to allow traffic
to the provided entities in AlgoSec |
작업이 완료되었습니다. |
Error executing action AlgoSec - Allow IP. Reason:
ERROR_REASON |
작업이 실패했습니다. AlgoSec 서버 URL과 사용자 인증 정보가 유효한지 확인하고, 지정된 템플릿 이름이 FireFlow에 있는지 확인하고, 날짜 매개변수를 ISO 8601 형식으로 지정하고, 커스텀 필드를 유효한 키-값 쌍으로 지정합니다. |
스크립트 결과
다음 표에는 IP 허용 작업을 사용할 때 스크립트 결과 출력 값이 나와 있습니다.
| 스크립트 결과 이름 | 값 |
|---|---|
is_success |
true 또는 false |
IP 차단
IP 차단 작업을 사용하여 AlgoSec FireFlow에서 케이스의 IP Address 항목(대상 주소로 사용됨)에 대한 트래픽을 차단하는 트래픽 변경 요청을 제출합니다.
이 작업은 IP Address Google SecOps 항목에서 실행됩니다.
작업 입력
IP 차단 작업에는 다음 매개변수가 필요합니다.
| 매개변수 | 설명 |
|---|---|
Template |
필수 항목입니다. 트래픽 변경 요청에 사용할 AlgoSec FireFlow 템플릿의 이름입니다. 기본값은 |
Source |
필수 항목입니다. 차단 규칙의 소스 IP 주소 또는 네트워크 객체의 쉼표로 구분된 목록 또는 모든 소스를 포함하는 키워드 기본값은 |
Service |
필수 항목입니다. 차단할 네트워크 서비스의 쉼표로 구분된 목록으로, 기본값은 |
Subject |
(선택사항) AlgoSec FireFlow의 트래픽 변경 요청 제목입니다. 기본값은 |
Owner |
(선택사항) 변경 요청을 소유한 사용자의 사용자 이름 또는 식별자입니다. 이 매개변수를 생략하면 AlgoSec은 티켓을 만든 인증된 사용자를 소유자로 할당합니다. |
Due Date |
(선택사항) 변경 요청의 목표 완료 날짜 및 시간입니다(ISO 8601 형식, 예: |
Expiration Date |
(선택사항) 차단된 트래픽 규칙의 만료 날짜 및 시간입니다(ISO 8601 형식, 예: |
Custom Fields |
(선택사항) 키-값 쌍으로 제공되는 추가 FireFlow 변경 요청 필드(예: 이 매개변수를 제공하면 |
작업 출력
IP 차단 작업은 다음 출력을 제공합니다.
| 작업 출력 유형 | 가용성 |
|---|---|
| 케이스 월 연결 | 사용 불가 |
| 케이스 월 링크 | 사용 가능 |
| 케이스 월 테이블 | 사용 불가 |
| 항목 보강 테이블 | 사용 불가 |
| JSON 결과 | 사용 가능 |
| 출력 메시지 | 사용 가능 |
| 스크립트 결과 | 사용 가능 |
케이스 월 링크
IP 차단 작업은 케이스 월에 다음 링크를 제공합니다.
링크 제목:
Change Request Link링크 타겟: AlgoSec FireFlow 웹 인터페이스에서 생성된 트래픽 변경 요청을 엽니다.
JSON 결과
다음 예시는 IP 차단 작업을 사용할 때 수신되는 JSON 결과 출력을 보여줍니다.
{
"status": "Success",
"messages": [],
"data": {
"id": 11,
"fields": [
{
"name": "Owner",
"values": [
"admin@example.com"
]
},
{
"name": "Creator",
"values": [
"admin@example.com"
]
},
{
"name": "Due",
"values": [
"2021-08-31 00:00:00"
]
},
{
"name": "LastUpdated",
"values": [
"2021-08-13 12:35:10"
]
},
{
"name": "Requestor",
"values": [
"admin@example.com"
]
}
],
"originalTraffic": [
{
"source": {
"items": [
{
"value": "all"
}
]
},
"destination": {
"items": [
{
"value": "192.0.2.3"
}
]
},
"service": {
"items": [
{
"value": "ALL"
}
]
},
"application": {
"items": [
{
"value": "any"
}
]
},
"user": {
"items": [
{
"value": "any"
}
]
},
"action": "Drop"
}
],
"plannedTraffic": [
{
"source": {
"items": [
{
"value": "0.0.0.0-255.255.255.255"
}
]
},
"destination": {
"items": [
{
"value": "192.0.2.3"
}
]
},
"service": {
"items": [
{
"value": "tcp/*"
},
{
"value": "udp/*"
},
{
"value": "ospf"
},
{
"value": "icmp/*"
},
{
"value": "gre"
},
{
"value": "ipsec_50"
},
{
"value": "ipsec_51"
}
]
},
"application": {
"items": [
{
"value": "any"
}
]
},
"user": {
"items": [
{
"value": "any"
}
]
},
"action": "Drop"
}
]
}
}
출력 메시지
IP 차단 작업은 다음 출력 메시지를 제공합니다.
| 출력 메시지 | 메시지 설명 |
|---|---|
Successfully created a traffic change request to block traffic
to the provided entities in AlgoSec |
작업이 완료되었습니다. |
Error executing action AlgoSec - Block IP. Reason:
ERROR_REASON |
작업이 실패했습니다. AlgoSec 서버 URL과 사용자 인증 정보가 유효한지 확인하고, 지정된 템플릿 이름이 FireFlow에 있는지 확인하고, 날짜 매개변수를 ISO 8601 형식으로 지정하고, 커스텀 필드를 유효한 키-값 쌍으로 지정합니다. |
스크립트 결과
다음 표에는 IP 차단 작업을 사용할 때 스크립트 결과 출력 값이 나와 있습니다.
| 스크립트 결과 이름 | 값 |
|---|---|
is_success |
true 또는 false |
템플릿 나열
템플릿 나열 작업을 사용하여 AlgoSec FireFlow에 구성된 사용 가능한 변경 요청 템플릿을 가져옵니다. 이름으로 템플릿을 필터링하여 트래픽 변경 요청을 자동화할 때 필요한 정확한 템플릿 이름을 식별할 수 있습니다.
이 작업은 Google SecOps 항목에서 실행되지 않습니다.
작업 입력
템플릿 나열 작업에는 다음 매개변수가 필요합니다.
| 매개변수 | 설명 |
|---|---|
Filter Logic |
(선택사항)
가능한 값은 다음과 같습니다.
기본값은 |
Filter Value |
(선택사항) 선택한 필터 값을 지정하지 않으면 작업은 구성된 한도까지 모든 템플릿을 반환합니다. |
Max Templates To Return |
(선택사항) 반환할 최대 템플릿 수입니다. 기본값은 |
작업 출력
템플릿 나열 작업은 다음 출력을 제공합니다.
| 작업 출력 유형 | 가용성 |
|---|---|
| 케이스 월 연결 | 사용 불가 |
| 케이스 월 링크 | 사용 불가 |
| 케이스 월 테이블 | 사용 가능 |
| 항목 보강 테이블 | 사용 불가 |
| JSON 결과 | 사용 가능 |
| 출력 메시지 | 사용 가능 |
| 스크립트 결과 | 사용 가능 |
케이스 월 테이블
템플릿 나열 작업은 케이스 월에 다음 표를 제공합니다.
테이블 이름:
Available Templates열:
NameDescriptionType
JSON 결과
다음 예시는 템플릿 나열 작업을 사용할 때 수신되는 JSON 결과 출력을 보여줍니다.
[
{
"id": 142,
"name": "110: Multi-Approval Request",
"description": "Create a traffic change request which requires multiple approvals",
"type": "Traffic Change",
"enabled": true
},
{
"id": 597,
"name": "190: Verbatim Rule Addition",
"description": "Create a traffic change request for bulk rules addition as specified",
"type": "Traffic Change",
"enabled": true
},
{
"id": 550,
"name": "Basic Change Traffic Request",
"description": "Create a basic change traffic request",
"type": "Traffic Change",
"enabled": true
}
]
출력 메시지
템플릿 나열 작업은 다음 출력 메시지를 제공합니다.
| 출력 메시지 | 메시지 설명 |
|---|---|
Successfully found templates for the provided criteria in
AlgoSec. |
작업이 완료되었습니다. |
No templates were found for the provided criteria in
AlgoSec. |
작업이 실패했습니다. AlgoSec FireFlow에 템플릿이 있는지 확인하고 |
Error executing action AlgoSec - List Templates. Reason:
ERROR_REASON |
작업이 실패했습니다. AlgoSec 서버 연결 매개변수가 유효하고 |
스크립트 결과
다음 표에는 템플릿 나열 작업을 사용할 때의 스크립트 결과 출력 값이 나와 있습니다.
| 스크립트 결과 이름 | 값 |
|---|---|
is_success |
true 또는 false |
핑
Ping 작업을 사용하여 구성된 통합 매개변수를 통해 AlgoSec 서버에 대한 연결 및 인증을 테스트합니다.
이 작업은 Google SecOps 항목에서 실행되지 않습니다.
작업 입력
없음
작업 출력
핑 작업은 다음 출력을 제공합니다.
| 작업 출력 유형 | 가용성 |
|---|---|
| 케이스 월 연결 | 사용 불가 |
| 케이스 월 링크 | 사용 불가 |
| 케이스 월 테이블 | 사용 불가 |
| 항목 보강 테이블 | 사용 불가 |
| JSON 결과 | 사용 불가 |
| 출력 메시지 | 사용 가능 |
| 스크립트 결과 | 사용 가능 |
출력 메시지
Ping 작업은 다음 출력 메시지를 제공합니다.
| 출력 메시지 | 메시지 설명 |
|---|---|
Successfully connected to the AlgoSec server with the provided
connection parameters! |
작업이 완료되었습니다. |
Failed to connect to the AlgoSec server! Error is
ERROR_REASON |
작업이 실패했습니다. Google SecOps에서 |
스크립트 결과
다음 표에는 핑 작업을 사용할 때 스크립트 결과 출력 값이 나와 있습니다.
| 스크립트 결과 이름 | 값 |
|---|---|
is_success |
true 또는 false |
변경 요청 상태 업데이트 대기
변경 요청 상태 업데이트 대기 작업을 사용하여 AlgoSec FireFlow의 트래픽 변경 요청이 대상 상태에 도달할 때까지 모니터링합니다.
이 작업은 Google SecOps 항목에서 실행되지 않습니다.
작업 입력
변경 요청 상태 업데이트 대기 작업에는 다음 매개변수가 필요합니다.
| 매개변수 | 설명 |
|---|---|
Request ID |
필수 항목입니다. 모니터링할 AlgoSec 트래픽 변경 요청의 숫자 식별자입니다. |
Status |
필수 항목입니다. 일치할 때 작업을 완료하는 대상 수명 주기 상태의 쉼표로 구분된 목록입니다. 유효한 상태를 하나 이상 제공하면 작업에서 잘못된 상태 이름을 무시합니다. 가능한 값은 다음과 같습니다.
기본값은 |
작업 출력
변경 요청 상태 업데이트 대기 작업은 다음 출력을 제공합니다.
| 작업 출력 유형 | 가용성 |
|---|---|
| 케이스 월 연결 | 사용 불가 |
| 케이스 월 링크 | 사용 불가 |
| 케이스 월 테이블 | 사용 불가 |
| 항목 보강 테이블 | 사용 불가 |
| JSON 결과 | 사용 가능 |
| 출력 메시지 | 사용 가능 |
| 스크립트 결과 | 사용 가능 |
JSON 결과
다음 예시에서는 변경 요청 상태 업데이트 대기 작업을 사용할 때 수신되는 JSON 결과 출력을 보여줍니다.
{
"status": "Success",
"messages": [],
"data": {
"id": 6,
"subChangeRequests": [
12
],
"fields": [
{
"name": "Risk Level",
"values": [
"No Risk"
]
},
{
"name": "Owner",
"values": [
"admin@example.com"
]
},
{
"name": "Creator",
"values": [
"admin@example.com"
]
},
{
"name": "LastUpdated",
"values": [
"2021-08-13 13:50:58"
]
},
{
"name": "Requestor",
"values": [
"admin@example.com"
]
},
{
"name": "Form Type",
"values": [
"Traffic Change"
]
},
{
"name": "Risks Number",
"values": [
"0"
]
},
{
"name": "Initial Plan status",
"values": [
"Result OK"
]
},
{
"name": "Workflow",
"values": [
"Basic"
]
},
{
"name": "Subject",
"values": [
"1"
]
},
{
"name": "status",
"values": [
"resolved"
]
}
],
"originalTraffic": [
{
"source": {
"items": [
{
"value": "all"
}
]
},
"destination": {
"items": [
{
"value": "192.0.2.2"
}
]
},
"service": {
"items": [
{
"value": "tcp/80"
}
]
},
"application": {
"items": [
{
"value": "any"
}
]
},
"user": {
"items": [
{
"value": "any"
}
]
},
"action": "Allow"
}
],
"plannedTraffic": [
{
"source": {
"items": [
{
"value": "0.0.0.0-255.255.255.255"
}
]
},
"destination": {
"items": [
{
"value": "192.0.2.2"
}
]
},
"service": {
"items": [
{
"value": "tcp/80"
}
]
},
"application": {
"items": [
{
"value": "any"
}
]
},
"user": {
"items": [
{
"value": "any"
}
]
},
"action": "Allow"
}
]
}
}
출력 메시지
변경 요청 상태 업데이트 대기 작업은 다음 출력 메시지를 제공합니다.
| 출력 메시지 | 메시지 설명 |
|---|---|
Status of the change request with ID
REQUEST_ID was updated to status:
STATUS. |
작업이 완료되었습니다. |
Waiting for a change request to be updated... |
변경 요청이 대상 상태 중 하나에 도달할 때까지 작업이 계속 실행되고 AlgoSec FireFlow를 폴링합니다. |
Error executing action AlgoSec - Wait for Change Request Status
Update. Reason: action ran into a timeout during execution. Current status
of the change request: STATUS.
Please increase the timeout for the action in the IDE. |
작업이 실패했습니다. Google SecOps IDE에서 작업 실행 제한 시간을 늘리거나 AlgoSec FireFlow에서 변경 요청이 승인 워크플로를 통해 진행 중인지 확인합니다. |
Error executing action AlgoSec - Wait for Change Request Status
Update. Reason:
ERROR_REASON |
작업이 실패했습니다.
|
스크립트 결과
다음 표에는 변경 요청 상태 업데이트 대기 작업을 사용할 때 스크립트 결과 출력 값이 나와 있습니다.
| 스크립트 결과 이름 | 값 |
|---|---|
is_success |
true 또는 false |
도움이 더 필요하신가요? 커뮤니티 회원 및 Google SecOps 전문가에게 문의하여 답변을 받으세요.