Akamai를 Google SecOps와 통합
이 문서에서는 Akamai를 Google Security Operations와 통합하는 방법을 설명합니다.
사용 사례
Akamai 통합은 Google SecOps 기능을 사용하여 다음 사용 사례를 지원합니다.
에지에서 위협 차단 자동화: 조사 중에 식별된 악성 IP 주소, CIDR 블록, 자율 시스템 번호, 지리적 위치, TLS 디지털 지문 또는 파일 해시를 Akamai 클라이언트 목록 또는 네트워크 목록에 추가하여 네트워크 에지에서 위협을 차단합니다.
동적 액세스 제어 및 허용 목록 관리: 거짓양성이 해결되거나 임시 제한이 만료되면 Akamai 클라이언트 목록 및 네트워크 목록에서 무해한 지표 또는 만료된 항목을 삭제합니다.
여러 환경에 정책 업데이트 배포: 자동화된 플레이북에서 직접 Akamai 스테이징 또는 프로덕션 환경에서 업데이트된 클라이언트 목록과 네트워크 목록을 활성화하고 이해관계자에게 활성화 이벤트를 알립니다.
에지 보안 목록 감사: Akamai 클라이언트 목록 및 네트워크 목록의 메타데이터, 항목 콘텐츠, 환경 활성화 상태를 검색하여 보안 조사를 보강하고 현재 시행 상태를 확인합니다.
시작하기 전에
Google SecOps에서 Akamai 통합을 구성하기 전에 다음 기본 요건 단계를 완료하세요.
Google SecOps 인스턴스의 Akamai EdgeGrid API 사용자 인증 정보를 만듭니다.
실행하려는 작업에 대해 Akamai에서 필수 API 권한을 구성합니다.
Akamai EdgeGrid API 사용자 인증 정보 만들기
Akamai 통합은 EdgeGrid 사용자 인증 정보를 사용하여 Akamai API로 인증합니다. Akamai Control Center에서 전용 API 클라이언트를 프로비저닝하고 통합 매개변수에 필요한 다음 사용자 인증 정보 값을 수집합니다.
Host(Akamai API 클라이언트의 기본 호스트 이름 URL)Client TokenClient SecretAccess Token
API 권한 구성(최소 권한)
실행하려는 특정 작업에 필요한 API 서비스 권한만 Akamai API 클라이언트에 부여하고 API 클라이언트의 액세스 제어 그룹 범위에 대상 클라이언트 목록과 네트워크 목록이 포함되어 있는지 확인합니다.
다음 표에서 Akamai 작업에 필요한 최소 API 권한을 참고하세요.
| 액션명 | Akamai API 서비스 | 필수 액세스 수준 | 엔드포인트 범위 |
|---|---|---|---|
| 고객 목록 활성화 | Client Lists API v1 및 v2 | Read-Write |
GET /client-list/v1/lists를 사용하여 고객 목록 식별자를 확인하고 POST /client-list/v2/lists/{listId}/activations를 사용하여 타겟 목록을 활성화합니다. |
| 네트워크 목록 활성화 | Network Lists API v2 | Read-Write |
GET /network-list/v2/network-lists를 사용하여 네트워크 목록 식별자를 확인하고 POST
/network-list/v2/network-lists/{networkListId}/environments/{environment}/activate를 사용하여 대상 목록을 활성화합니다. |
| 고객 목록에 항목 추가 | Client Lists API v1 | Read-Write |
GET /client-list/v1/lists를 사용하여 유효성 검사를 위한 클라이언트 목록을 가져오고 POST /client-list/v1/lists/{listId}/items를 사용하여 항목을 추가합니다. |
| 네트워크 목록에 항목 추가 | Network Lists API v2 | Read-Write |
GET /network-list/v2/network-lists를 사용하여 네트워크 목록 식별자를 확인하고 POST
/network-list/v2/network-lists/{networkListId}/append를 사용하여 항목을 추가합니다. |
| 고객 목록 가져오기 | Client Lists API v1 | Read-Only |
GET /client-list/v1/lists를 사용하여 클라이언트 목록과 해당 항목을 가져옵니다. |
| 네트워크 목록 가져오기 | Network Lists API v2 | Read-Only |
GET /network-list/v2/network-lists, GET /network-list/v2/network-lists/{networkListId}, GET
/network-list/v2/network-lists/{networkListId}/environments/{environment}/status를 사용하여 네트워크 목록, 목록 항목, 환경 활성화 상태를 검색합니다. |
| Ping | Network Lists API v2 | Read-Only |
GET /network-list/v2/network-lists?limit=1를 사용하여 API 연결 및 사용자 인증 정보를 검증합니다. |
| 고객 목록에서 항목 삭제 | Client Lists API v1 | Read-Write |
GET /client-list/v1/lists를 사용하여 검증을 위해 클라이언트 목록을 검색하고 POST /client-list/v1/lists/{listId}/items를 사용하여 항목을 삭제합니다. |
| 네트워크 목록에서 항목 삭제 | Network Lists API v2 | Read-Write |
GET /network-list/v2/network-lists를 사용하여 네트워크 목록 식별자를 확인하고 DELETE
/network-list/v2/network-lists/{networkListId}/elements를 사용하여 개별 요소를 삭제합니다. |
통합 매개변수
Akamai 통합에는 다음 매개변수가 필요합니다.
| 매개변수 | 설명 |
|---|---|
Host |
필수 항목입니다.
기본값은 |
Client Token |
필수 항목입니다. Akamai EdgeGrid API 클라이언트의 클라이언트 토큰입니다. |
Client Secret |
필수 항목입니다. Akamai EdgeGrid API 클라이언트의 클라이언트 보안 비밀번호입니다. |
Access Token |
필수 항목입니다. Akamai EdgeGrid API 클라이언트의 액세스 토큰입니다. |
Verify SSL |
필수 항목입니다. 선택하면 통합에서 Akamai 서버에 연결할 때 SSL 인증서를 검증합니다. 기본적으로 사용 설정됩니다. |
Google SecOps에서 통합을 구성하는 방법에 대한 안내는 통합 구성을 참조하세요.
필요한 경우 이후 단계에서 변경할 수 있습니다. 통합 인스턴스를 구성한 후 플레이북에서 사용할 수 있습니다. 여러 인스턴스를 구성하고 지원하는 방법에 관한 자세한 내용은 다중 인스턴스 지원을 참고하세요.
작업
작업에 대한 자세한 내용은 Workdesk의 대기 중인 작업에 응답 및 케이스에서 수동 작업 실행을 참고하세요.
고객 목록 활성화
클라이언트 목록 활성화 작업을 사용하여 Akamai 스테이징 또는 프로덕션 환경에서 특정 클라이언트 목록을 활성화합니다.
이 작업은 Google SecOps 항목에서 실행되지 않습니다.
작업 입력
고객 목록 활성화 작업에는 다음 매개변수가 필요합니다.
| 매개변수 | 설명 |
|---|---|
Client List Name |
(선택사항) 활성화할 클라이언트 목록의 이름입니다. 일치 여부에서는 대소문자를 구분합니다.
|
Client List ID |
(선택사항) 활성화할 고객 목록의 고유 식별자입니다.
|
Environment |
(선택사항) 클라이언트 목록 활성화를 위한 대상 Akamai 환경입니다. 가능한 값은 다음과 같습니다.
기본값은 |
Comment |
(선택사항) 클라이언트 목록 활성화의 목적을 설명하는 댓글입니다. |
Notification Recipients |
(선택사항) 고객 목록 활성화가 완료되면 알림을 받을 이메일 주소의 쉼표로 구분된 목록입니다. |
작업 출력
고객 목록 활성화 작업은 다음 출력을 제공합니다.
| 작업 출력 유형 | 가용성 |
|---|---|
| 케이스 월 연결 | 사용 불가 |
| 케이스 월 링크 | 사용 불가 |
| 케이스 월 테이블 | 사용 불가 |
| 보강 테이블 | 사용 불가 |
| JSON 결과 | 사용 가능 |
| 출력 메시지 | 사용 가능 |
| 스크립트 결과 | 사용 가능 |
JSON 결과
다음 예시에서는 고객 목록 활성화 작업을 사용할 때 수신되는 JSON 결과 출력을 보여줍니다.
{
"action": "ACTIVATE",
"activations": {
"STAGING": {
"activationId": 3797405,
"activationStatus": "PENDING_ACTIVATION"
}
},
"comments": "Activating 235466",
"createDate": "2026-02-12T15:12:07.952+00:00",
"createdBy": "4wksaj3wyt23jt2i",
"listId": "235466_GOOGLESECOPSCLIENTLIST1",
"notificationRecipients": [
"12345@email.com"
],
"version": 14
}
출력 메시지
고객 목록 활성화 작업은 다음 출력 메시지를 제공합니다.
| 출력 메시지 | 메시지 설명 |
|---|---|
Successfully activated the client list in Akamai. |
작업이 완료되었습니다. |
Error executing action "Activate Client List". Reason: Provide a
value in "Client List Name" or "Client List ID" parameter. |
작업이 실패했습니다.
|
Error executing action "Activate Client List". Reason:
"CLIENT_LIST_IDENTIFIER" client
list wasn't found in Akamai. |
작업이 실패했습니다. 지정된 클라이언트 목록 이름 또는 ID가 Akamai에 있는지, |
Error executing action "Activate Client List". Reason:
ERROR_REASON |
작업이 실패했습니다. Akamai 서버에 대한 연결을 확인하고, 타겟 클라이언트 목록에 활성화할 준비가 된 항목이 있는지 확인하거나, API 사용자 인증 정보를 검토하세요. |
스크립트 결과
다음 표에는 고객 목록 활성화 작업을 사용할 때 스크립트 결과 출력 값이 나와 있습니다.
| 스크립트 결과 이름 | 값 |
|---|---|
is_success |
true 또는 false |
네트워크 목록 활성화
네트워크 목록 활성화 작업을 사용하여 Akamai 스테이징 또는 프로덕션 환경에서 특정 네트워크 목록을 활성화합니다.
이 작업은 Google SecOps 항목에서 실행되지 않습니다.
작업 입력
네트워크 목록 활성화 작업에는 다음 매개변수가 필요합니다.
| 매개변수 | 설명 |
|---|---|
Network List Name |
(선택사항) 활성화할 네트워크 목록의 이름입니다. 일치 여부에서는 대소문자를 구분합니다.
|
Network List ID |
(선택사항) 활성화할 네트워크 목록의 고유 식별자입니다.
|
Environment |
(선택사항) 네트워크 목록 활성화를 위한 타겟 Akamai 환경입니다. 가능한 값은 다음과 같습니다.
기본값은 |
Comment |
(선택사항) 네트워크 목록 활성화의 목적을 설명하는 주석입니다. |
Notification Recipients |
(선택사항) 네트워크 목록 활성화가 완료되면 알림을 받을 이메일 주소의 쉼표로 구분된 목록입니다. |
작업 출력
네트워크 목록 활성화 작업은 다음 출력을 제공합니다.
| 작업 출력 유형 | 가용성 |
|---|---|
| 케이스 월 연결 | 사용 불가 |
| 케이스 월 링크 | 사용 불가 |
| 케이스 월 테이블 | 사용 불가 |
| 보강 테이블 | 사용 불가 |
| JSON 결과 | 사용 가능 |
| 출력 메시지 | 사용 가능 |
| 스크립트 결과 | 사용 가능 |
JSON 결과
다음 예시에서는 네트워크 목록 활성화 작업을 사용할 때 수신되는 JSON 결과 출력을 보여줍니다.
{
"activationId": 12345,
"activationComments": "Allow IPs of new employees who joined this week",
"activationStatus": "PENDING_ACTIVATION",
"syncPoint": 5,
"uniqueId": "25614_GENERALLIST",
"fast": false,
"dispatchCount": 1,
"links": {
"appendItems": {
"href": "/networklist-api/rest/v2/network-lists/25614_GENERALLIST/append",
"method": "POST"
},
"retrieve": {
"href": "/networklist-api/rest/v2/network-lists/25614_GENERALLIST"
},
"statusInProduction": {
"href": "/networklist-api/rest/v2/network-lists/25614_GENERALLIST/environments/PRODUCTION/status"
},
"statusInStaging": {
"href": "/networklist-api/rest/v2/network-lists/25614_GENERALLIST/environments/STAGING/status"
},
"syncPointHistory": {
"href": "/networklist-api/rest/v2/network-lists/25614_GENERALLIST/sync-points/5/history"
},
"update": {
"href": "/networklist-api/rest/v2/network-lists/25614_GENERALLIST",
"method": "PUT"
},
"activationDetails": {
"href": "/network-list/v2/network-lists/activations/12345/"
}
}
}
출력 메시지
네트워크 목록 활성화 작업은 다음 출력 메시지를 제공합니다.
| 출력 메시지 | 메시지 설명 |
|---|---|
Successfully activated the network list in Akamai. |
작업이 완료되었습니다. |
Error executing action "Activate Network List". Reason: Provide
a value in "Network List Name" or "Network List ID"
parameter. |
작업이 실패했습니다.
|
Error executing action "Activate Network List". Reason:
"NETWORK_LIST_IDENTIFIER" network
list wasn't found in Akamai. |
작업이 실패했습니다. 지정된 네트워크 목록 이름 또는 ID가 Akamai에 있는지, |
Error executing action "Activate Network List". Reason:
ERROR_REASON |
작업이 실패했습니다. Akamai 서버에 대한 연결을 확인하고, API 사용자 인증 정보에 Network Lists API에 대한 쓰기 액세스 권한이 있는지 확인하거나, 입력 매개변수를 검토하세요. |
스크립트 결과
다음 표에는 네트워크 목록 활성화 작업을 사용할 때의 스크립트 결과 출력 값이 나와 있습니다.
| 스크립트 결과 이름 | 값 |
|---|---|
is_success |
true 또는 false |
고객 목록에 항목 추가
클라이언트 목록에 항목 추가 작업을 사용하여 하나 이상의 항목(예: IP 주소, 지리적 위치, 자율 시스템 번호, TLS 디지털 지문, 파일 해시)을 Akamai의 기존 클라이언트 목록에 추가합니다.
이 작업은 각 항목을 개별적으로 처리하고 JSON 결과에서 added, duplicated(항목이 이미 목록에 있는 경우) 또는 failed의 status를 보고합니다. 항목을 추가하면 Akamai의 클라이언트 목록이 업데이트되지만 대상 환경에 대해 클라이언트 목록 활성화 작업을 실행할 때까지 Akamai 에지에서 변경사항이 적용되지 않습니다.
이 작업은 Google SecOps 항목에서 실행되지 않습니다.
작업 입력
고객 목록에 항목 추가 작업에는 다음 매개변수가 필요합니다.
| 매개변수 | 설명 |
|---|---|
Client List Name |
(선택사항) 업데이트할 고객 목록의 이름입니다. 일치는 대소문자를 구분하지 않습니다.
|
Client List ID |
(선택사항) 업데이트할 고객 목록의 고유 식별자입니다. 일치는 대소문자를 구분하지 않습니다.
|
Item Value |
필수 항목입니다. 고객 목록에 추가할 항목 값의 쉼표로 구분된 목록입니다. |
Item Description |
(선택사항) 추가된 항목과 연결할 설명입니다. |
Item Expiration Date |
(선택사항) 추가된 항목의 만료일입니다(ISO 8601 형식). |
Item Tags |
(선택사항) 추가된 항목과 연결할 태그의 쉼표로 구분된 목록입니다. |
작업 출력
클라이언트 목록에 항목 추가 작업은 다음 출력을 제공합니다.
| 작업 출력 유형 | 가용성 |
|---|---|
| 케이스 월 연결 | 사용 불가 |
| 케이스 월 링크 | 사용 불가 |
| 케이스 월 테이블 | 사용 불가 |
| 보강 테이블 | 사용 불가 |
| JSON 결과 | 사용 가능 |
| 출력 메시지 | 사용 가능 |
| 스크립트 결과 | 사용 가능 |
JSON 결과
다음 예시에서는 고객 목록에 항목 추가 작업을 사용할 때 수신되는 JSON 결과 출력을 보여줍니다.
[
{
"createDate": "2026-03-20T09:54:11.410+00:00",
"createdBy": "4wksaj3wyt23jt2i",
"description": "Blocked IP indicator",
"expirationDate": "2026-04-05T19:29:02.320+00:00",
"tags": [],
"type": "IP",
"updateDate": "2026-03-20T09:54:11.410+00:00",
"updatedBy": "4wksaj3wyt23jt2i",
"value": "192.0.2.1",
"status": "added"
},
{
"value": "192.0.2.3",
"status": "duplicated"
},
{
"value": "192.0.2.TT",
"status": "failed",
"error": "Validation failed: append[0].value: Item of type IP has an invalid value 192.0.2.TT"
}
]
출력 메시지
클라이언트 목록에 항목 추가 작업은 다음 출력 메시지를 제공합니다.
| 출력 메시지 | 메시지 설명 |
|---|---|
Successfully updated client list in Akamai. |
작업이 완료되었습니다. 지정된 모든 항목이 고객 목록에 추가되었거나( |
One or more items were not added. See JSON results for
details. |
작업에서 지정된 항목( 배치에 있는 항목 중 하나 이상이 목록에 추가되었거나 이미 목록에 있는 경우 |
Error executing action "Add Items To Client List". Reason:
provide a value in "Client List Name" or "Client List ID"
parameter. |
작업이 실패했습니다.
|
Error executing action "Add Items To Client List". Reason:
"CLIENT_LIST_IDENTIFIER" client
list wasn't found in Akamai. |
작업이 실패했습니다. 지정된 클라이언트 목록 이름 또는 ID가 Akamai에 있고 API 사용자 인증 정보에 클라이언트 목록에 액세스할 수 있는 권한이 있는지 확인하세요. |
Error executing action "Add Items To Client List". Reason:
ERROR_REASON |
작업이 실패했습니다. Akamai 서버에 대한 연결을 확인하고, |
스크립트 결과
다음 표에는 고객 목록에 항목 추가 작업을 사용할 때 스크립트 결과 출력 값이 나와 있습니다.
| 스크립트 결과 이름 | 값 |
|---|---|
is_success |
true 또는 false |
네트워크 목록에 항목 추가
네트워크 목록에 항목 추가 작업을 사용하여 하나 이상의 항목(예: IP 주소, CIDR 블록, 지리적 위치)을 Akamai의 기존 네트워크 목록에 추가합니다.
항목을 추가하면 Akamai의 네트워크 목록이 업데이트되지만 대상 환경에 대해 네트워크 목록 활성화 작업을 실행할 때까지 Akamai 에지에서 변경사항이 적용되지 않습니다.
이 작업은 Google SecOps 항목에서 실행되지 않습니다.
작업 입력
네트워크 목록에 항목 추가 작업에는 다음 매개변수가 필요합니다.
| 매개변수 | 설명 |
|---|---|
Network List Name |
(선택사항) 업데이트할 네트워크 목록의 이름입니다. 일치 여부에서는 대소문자를 구분합니다.
|
Network List ID |
(선택사항) 업데이트할 네트워크 목록의 고유 식별자입니다.
|
Items |
필수 항목입니다. 네트워크 목록에 추가할 항목의 쉼표로 구분된 목록입니다. |
작업 출력
네트워크 목록에 항목 추가 작업은 다음 출력을 제공합니다.
| 작업 출력 유형 | 가용성 |
|---|---|
| 케이스 월 연결 | 사용 불가 |
| 케이스 월 링크 | 사용 불가 |
| 케이스 월 테이블 | 사용 불가 |
| 보강 테이블 | 사용 불가 |
| JSON 결과 | 사용 가능 |
| 출력 메시지 | 사용 가능 |
| 스크립트 결과 | 사용 가능 |
JSON 결과
다음 예시에서는 네트워크 목록에 항목 추가 작업을 사용할 때 수신되는 JSON 결과 출력을 보여줍니다.
{
"networkListType": "networkListResponse",
"accessControlGroup": "KSD\nwith ION 3-13H1234",
"name": "General List",
"elementCount": 3011,
"readOnly": false,
"shared": false,
"syncPoint": 22,
"type": "IP",
"uniqueId": "25614_GENERALLIST",
"links": {
"activateInProduction": {
"href": "/network-list/v2/network-lists/25614_GENERALLIST/environments/PRODUCTION/activate",
"method": "POST"
},
"activateInStaging": {
"href": "/network-list/v2/network-lists/25614_GENERALLIST/environments/STAGING/activate",
"method": "POST"
},
"appendItems": {
"href": "/network-list/v2/network-lists/25614_GENERALLIST",
"method": "POST"
},
"retrieve": {
"href": "/network-list/v2/network-lists/25614_GENERALLIST"
},
"statusInProduction": {
"href": "/network-list/v2/network-lists/25614_GENERALLIST/environments/PRODUCTION/status"
},
"statusInStaging": {
"href": "/network-list/v2/network-lists/25614_GENERALLIST/environments/STAGING/status"
},
"update": {
"href": "/network-list/v2/network-lists/25614_GENERALLIST",
"method": "PUT"
}
}
}
출력 메시지
네트워크 목록에 항목 추가 작업은 다음 출력 메시지를 제공합니다.
| 출력 메시지 | 메시지 설명 |
|---|---|
Successfully updated network list
'NETWORK_LIST_IDENTIFIER' in
Akamai. |
작업이 완료되었습니다. |
Failed to update network list
'NETWORK_LIST_IDENTIFIER' in
Akamai. |
작업이 실패했습니다.
|
Error executing action "Add Items To Network List". Reason:
Provide a value in "Network List Name" or "Network List ID"
parameter. |
작업이 실패했습니다.
|
Error executing action "Add Items To Network List". Reason:
"NETWORK_LIST_IDENTIFIER" network
list wasn't found in Akamai. |
작업이 실패했습니다. 지정된 네트워크 목록 이름 또는 ID가 Akamai에 있는지, |
Error executing action "Add Items To Network List". Reason:
ERROR_REASON |
작업이 실패했습니다. Akamai 서버에 대한 연결을 확인하거나, |
스크립트 결과
다음 표에는 네트워크 목록에 항목 추가 작업을 사용할 때 스크립트 결과 출력 값이 나와 있습니다.
| 스크립트 결과 이름 | 값 |
|---|---|
is_success |
true 또는 false |
고객 목록 가져오기
클라이언트 목록 가져오기 작업을 사용하여 Akamai에 구성된 클라이언트 목록의 메타데이터 및 항목 콘텐츠를 검색합니다.
이 작업은 Google SecOps 항목에서 실행되지 않습니다.
작업 입력
고객 목록 가져오기 작업에는 다음 매개변수가 필요합니다.
| 매개변수 | 설명 |
|---|---|
Client List Name |
(선택사항) 검색할 고객 목록 이름의 쉼표로 구분된 목록입니다. 일치 여부에서는 대소문자를 구분합니다.
|
Client List ID |
(선택사항) 검색할 고객 목록 ID의 쉼표로 구분된 목록입니다. 일치는 대소문자를 구분하지 않습니다.
|
Include Items |
(선택사항) 선택하면 작업에서 일치하는 각 클라이언트 목록 내의 항목에 대한 정보를 반환합니다. 이 작업은 |
Type |
(선택사항) 검색할 고객 목록의 유형입니다. 가능한 값은 다음과 같습니다.
기본값은 |
Max Client Lists To Return |
필수 항목입니다. 반환할 최대 고객 목록 수입니다. 최댓값은 기본값은 |
Max Client List Items To Return |
필수 항목입니다. 각 고객 목록에 대해 반환할 최대 항목 수입니다. 최댓값은 기본값은 |
작업 출력
고객 목록 가져오기 작업은 다음 출력을 제공합니다.
| 작업 출력 유형 | 가용성 |
|---|---|
| 케이스 월 연결 | 사용 불가 |
| 케이스 월 링크 | 사용 불가 |
| 케이스 월 테이블 | 사용 불가 |
| 보강 테이블 | 사용 불가 |
| JSON 결과 | 사용 가능 |
| 출력 메시지 | 사용 가능 |
| 스크립트 결과 | 사용 가능 |
JSON 결과
다음 예시는 고객 목록 가져오기 작업을 사용할 때 수신되는 JSON 결과 출력을 보여줍니다.
[
{
"contractId": "K-0N7RAK71",
"createDate": "2023-04-05T18:20:42.090+00:00",
"createdBy": "jsmith",
"deprecated": false,
"groupId": 32145,
"groupName": "Acme IT Group",
"items": [
{
"createDate": "2023-04-05T18:20:42.892+00:00",
"createdBy": "jkowalski",
"description": "Canada - North America",
"expirationDate": "2023-12-31T23:59:19.700+00:00",
"productionStatus": "INACTIVE",
"stagingStatus": "INACTIVE",
"tags": [
"allowlist1"
],
"type": "GEO",
"updateDate": "2023-04-05T18:20:42.892+00:00",
"updatedBy": "mrossi",
"value": "CA"
}
],
"itemsCount": 3,
"listId": "1234_NORTHAMERICAGEOALLOWLIST",
"listType": "CL",
"name": "NorthAmericaGeoAllowlist",
"notes": "GEO code allowlist",
"productionActivationStatus": "INACTIVE",
"readOnly": false,
"shared": false,
"stagingActivationStatus": "INACTIVE",
"tags": [
"allowlist2"
],
"type": "GEO",
"updateDate": "2023-04-05T18:20:42.090+00:00",
"updatedBy": "jdupont",
"version": 1
}
]
출력 메시지
고객 목록 가져오기 작업은 다음 출력 메시지를 제공합니다.
| 출력 메시지 | 메시지 설명 |
|---|---|
Successfully returned client lists from Akamai. |
작업이 완료되었습니다. |
No clients lists were found for the provided criteria in
Akamai. |
작업이 실패했습니다. 지정된 클라이언트 목록 이름 또는 ID가 Akamai에 존재하고, 선택한 |
Error executing action "Get Client Lists". Reason:
ERROR_REASON |
작업이 실패했습니다. Akamai 서버에 대한 연결을 확인하고, 최대 반환 매개변수가 |
스크립트 결과
다음 표에는 고객 목록 가져오기 작업을 사용할 때의 스크립트 결과 출력 값이 나와 있습니다.
| 스크립트 결과 이름 | 값 |
|---|---|
is_success |
true 또는 false |
네트워크 목록 가져오기
네트워크 목록 가져오기 작업을 사용하여 Akamai에 구성된 네트워크 목록의 메타데이터, 항목 콘텐츠, 활성화 상태를 검색합니다.
이 작업은 Google SecOps 항목에서 실행되지 않습니다.
작업 입력
네트워크 목록 가져오기 작업에는 다음 매개변수가 필요합니다.
| 매개변수 | 설명 |
|---|---|
Network List Name |
(선택사항) 검색할 네트워크 목록 이름의 쉼표로 구분된 목록입니다. 일치 여부에서는 대소문자를 구분합니다.
|
Network List ID |
(선택사항) 가져올 네트워크 목록 ID의 쉼표로 구분된 목록입니다. 일치는 대소문자를 구분하지 않습니다.
|
Include Items |
(선택사항) 선택하면 작업이 각 네트워크 목록에 포함된 항목을 반환합니다. |
Include Activation Status |
(선택사항) 선택하면 작업이 일치하는 각 네트워크 목록의 활성화 상태를 반환합니다. 이 작업은 |
Activation Environment |
(선택사항)
가능한 값은 다음과 같습니다.
기본값은 |
Max Network Lists To Return |
필수 항목입니다. 반환할 최대 네트워크 목록 수입니다. 최댓값은 기본값은 |
Max Network List Items To Return |
필수 항목입니다. 각 네트워크 목록에 대해 반환할 최대 항목 수입니다. 최댓값은 기본값은 |
작업 출력
네트워크 목록 가져오기 작업은 다음 출력을 제공합니다.
| 작업 출력 유형 | 가용성 |
|---|---|
| 케이스 월 연결 | 사용 불가 |
| 케이스 월 링크 | 사용 불가 |
| 케이스 월 테이블 | 사용 불가 |
| 보강 테이블 | 사용 불가 |
| JSON 결과 | 사용 가능 |
| 출력 메시지 | 사용 가능 |
| 스크립트 결과 | 사용 가능 |
JSON 결과
다음 예시에서는 네트워크 목록 가져오기 작업을 사용할 때 수신되는 JSON 결과 출력을 보여줍니다.
[
{
"networkListType": "networkListResponse",
"accessControlGroup": "KSD\nwith ION 3-13H1234",
"name": "General List",
"elementCount": 3011,
"readOnly": false,
"shared": false,
"syncPoint": 22,
"type": "IP",
"uniqueId": "25614_GENERALLIST",
"links": {
"activateInProduction": {
"href": "/network-list/v2/network-lists/25614_GENERALLIST/environments/PRODUCTION/activate",
"method": "POST"
},
"activateInStaging": {
"href": "/network-list/v2/network-lists/25614_GENERALLIST/environments/STAGING/activate",
"method": "POST"
},
"appendItems": {
"href": "/network-list/v2/network-lists/25614_GENERALLIST",
"method": "POST"
},
"retrieve": {
"href": "/network-list/v2/network-lists/25614_GENERALLIST"
},
"statusInProduction": {
"href": "/network-list/v2/network-lists/25614_GENERALLIST/environments/PRODUCTION/status"
},
"statusInStaging": {
"href": "/network-list/v2/network-lists/25614_GENERALLIST/environments/STAGING/status"
},
"update": {
"href": "/network-list/v2/network-lists/25614_GENERALLIST",
"method": "PUT"
}
},
"Activation_STAGING": {
"activationId": 12345,
"activationComments": "Allow IPs of new employees who joined this week",
"activationStatus": "PENDING_ACTIVATION",
"syncPoint": 5,
"uniqueId": "25614_GENERALLIST",
"fast": false,
"dispatchCount": 1,
"links": {
"appendItems": {
"href": "/networklist-api/rest/v2/network-lists/25614_GENERALLIST/append",
"method": "POST"
},
"retrieve": {
"href": "/networklist-api/rest/v2/network-lists/25614_GENERALLIST"
},
"statusInProduction": {
"href": "/networklist-api/rest/v2/network-lists/25614_GENERALLIST/environments/PRODUCTION/status"
},
"statusInStaging": {
"href": "/networklist-api/rest/v2/network-lists/25614_GENERALLIST/environments/STAGING/status"
},
"syncPointHistory": {
"href": "/networklist-api/rest/v2/network-lists/25614_GENERALLIST/sync-points/5/history"
},
"update": {
"href": "/networklist-api/rest/v2/network-lists/25614_GENERALLIST",
"method": "PUT"
},
"activationDetails": {
"href": "/network-list/v2/network-lists/activations/12345/"
}
}
},
"Activation_PRODUCTION": {
"activationId": 12345,
"activationComments": "Allow IPs of new employees who joined this week",
"activationStatus": "PENDING_ACTIVATION",
"syncPoint": 5,
"uniqueId": "25614_GENERALLIST",
"fast": false,
"dispatchCount": 1,
"links": {
"appendItems": {
"href": "/networklist-api/rest/v2/network-lists/25614_GENERALLIST/append",
"method": "POST"
},
"retrieve": {
"href": "/networklist-api/rest/v2/network-lists/25614_GENERALLIST"
},
"statusInProduction": {
"href": "/networklist-api/rest/v2/network-lists/25614_GENERALLIST/environments/PRODUCTION/status"
},
"statusInStaging": {
"href": "/networklist-api/rest/v2/network-lists/25614_GENERALLIST/environments/STAGING/status"
},
"syncPointHistory": {
"href": "/networklist-api/rest/v2/network-lists/25614_GENERALLIST/sync-points/5/history"
},
"update": {
"href": "/networklist-api/rest/v2/network-lists/25614_GENERALLIST",
"method": "PUT"
},
"activationDetails": {
"href": "/network-list/v2/network-lists/activations/12345/"
}
}
}
}
]
출력 메시지
네트워크 목록 가져오기 작업은 다음 출력 메시지를 제공합니다.
| 출력 메시지 | 메시지 설명 |
|---|---|
Successfully returned network lists from Akamai. |
작업이 완료되었습니다. |
No network lists were found for the provided criteria in
Akamai. |
작업이 실패했습니다. 지정된 네트워크 목록 이름 또는 ID가 Akamai에 있는지, |
Error executing action "Get Network Lists". Reason:
ERROR_REASON |
작업이 실패했습니다. Akamai 서버에 대한 연결을 확인하고, 최대 반환 매개변수가 |
스크립트 결과
다음 표에는 네트워크 목록 가져오기 작업을 사용할 때 스크립트 결과 출력 값이 나와 있습니다.
| 스크립트 결과 이름 | 값 |
|---|---|
is_success |
true 또는 false |
핑
Ping 작업을 사용하여 연결을 테스트하고 Akamai 서버에서 사용자 인증 정보를 검증합니다.
이 작업은 Google SecOps 항목에서 실행되지 않습니다.
작업 입력
없음
작업 출력
핑 작업은 다음 출력을 제공합니다.
| 작업 출력 유형 | 가용성 |
|---|---|
| 케이스 월 연결 | 사용 불가 |
| 케이스 월 링크 | 사용 불가 |
| 케이스 월 테이블 | 사용 불가 |
| 보강 테이블 | 사용 불가 |
| JSON 결과 | 사용 불가 |
| 출력 메시지 | 사용 가능 |
| 스크립트 결과 | 사용 가능 |
출력 메시지
Ping 작업은 다음 출력 메시지를 제공합니다.
| 출력 메시지 | 메시지 설명 |
|---|---|
Successfully connected to the Akamai server with the provided
connection parameters! |
작업이 완료되었습니다. |
Failed to connect to the Akamai server! Error is
ERROR_REASON |
작업이 실패했습니다.
|
스크립트 결과
다음 표에는 핑 작업을 사용할 때 스크립트 결과 출력 값이 나와 있습니다.
| 스크립트 결과 이름 | 값 |
|---|---|
is_success |
true 또는 false |
고객 목록에서 항목 삭제
클라이언트 목록에서 항목 삭제 작업을 사용하여 Akamai의 기존 클라이언트 목록에서 하나 이상의 항목을 삭제합니다.
이 작업은 각 항목을 개별적으로 처리하고 JSON 결과에서 removed, doesn't exist(항목이 목록에 없는 경우) 또는 failed의 status를 보고합니다. 항목을 삭제하면 Akamai의 클라이언트 목록이 업데이트되지만 대상 환경에 대해 클라이언트 목록 활성화 작업을 실행할 때까지 Akamai 에지에서 변경사항이 적용되지 않습니다.
이 작업은 Google SecOps 항목에서 실행되지 않습니다.
작업 입력
고객 목록에서 항목 삭제 작업에는 다음 매개변수가 필요합니다.
| 매개변수 | 설명 |
|---|---|
Client List Name |
(선택사항) 업데이트할 고객 목록의 이름입니다. 일치는 대소문자를 구분하지 않습니다.
|
Client List ID |
(선택사항) 업데이트할 고객 목록의 고유 식별자입니다. 일치는 대소문자를 구분하지 않습니다.
|
Item Value |
필수 항목입니다. 클라이언트 목록에서 삭제할 항목 값의 쉼표로 구분된 목록입니다. |
작업 출력
클라이언트 목록에서 항목 삭제 작업은 다음 출력을 제공합니다.
| 작업 출력 유형 | 가용성 |
|---|---|
| 케이스 월 연결 | 사용 불가 |
| 케이스 월 링크 | 사용 불가 |
| 케이스 월 테이블 | 사용 불가 |
| 보강 테이블 | 사용 불가 |
| JSON 결과 | 사용 가능 |
| 출력 메시지 | 사용 가능 |
| 스크립트 결과 | 사용 가능 |
JSON 결과
다음 예시에서는 고객 목록에서 항목 삭제 작업을 사용할 때 수신되는 JSON 결과 출력을 보여줍니다.
[
{
"value": "192.0.2.1",
"status": "doesn't exist"
},
{
"value": "192.0.2.4",
"status": "removed"
},
{
"value": "192.0.2.4E",
"status": "failed",
"error": "Validation failed: delete[0].value: Item of type IP has an invalid value 192.0.2.4E"
}
]
출력 메시지
고객 목록에서 항목 삭제 작업은 다음 출력 메시지를 제공합니다.
| 출력 메시지 | 메시지 설명 |
|---|---|
Successfully updated client list in Akamai. |
작업이 완료되었습니다. 지정된 모든 항목이 클라이언트 목록에서 삭제되었거나( |
One or more items were not removed. See JSON results for
details. |
지정된 항목( 배치에 있는 항목 중 하나 이상의 상태가 |
Error executing action "Remove Items From Client List". Reason:
provide a value in "Client List Name" or "Client List ID"
parameter. |
작업이 실패했습니다.
|
Error executing action "Remove Items From Client List". Reason:
"CLIENT_LIST_IDENTIFIER" client
list wasn't found in Akamai. |
작업이 실패했습니다. 지정된 클라이언트 목록 이름 또는 ID가 Akamai에 있고 API 사용자 인증 정보에 클라이언트 목록에 액세스할 수 있는 권한이 있는지 확인하세요. |
Error executing action "Remove Items From Client List". Reason:
ERROR_REASON |
작업이 실패했습니다. Akamai 서버에 대한 연결을 확인하거나, |
스크립트 결과
다음 표에는 고객 목록에서 항목 삭제 작업을 사용할 때의 스크립트 결과 출력 값이 나와 있습니다.
| 스크립트 결과 이름 | 값 |
|---|---|
is_success |
true 또는 false |
네트워크 목록에서 항목 삭제
네트워크 목록에서 항목 삭제 작업을 사용하여 Akamai의 기존 네트워크 목록에서 하나 이상의 항목을 삭제합니다.
항목을 삭제하면 Akamai의 네트워크 목록이 업데이트되지만 대상 환경에 대해 네트워크 목록 활성화 작업을 실행할 때까지 Akamai 에지에서 변경사항이 적용되지 않습니다.
이 작업은 Google SecOps 항목에서 실행되지 않습니다.
작업 입력
네트워크 목록에서 항목 삭제 작업에는 다음 매개변수가 필요합니다.
| 매개변수 | 설명 |
|---|---|
Network List Name |
(선택사항) 업데이트할 네트워크 목록의 이름입니다. 일치 여부에서는 대소문자를 구분합니다.
|
Network List ID |
(선택사항) 업데이트할 네트워크 목록의 고유 식별자입니다.
|
Items |
필수 항목입니다. 네트워크 목록에서 삭제할 항목의 쉼표로 구분된 목록입니다. |
작업 출력
네트워크 목록에서 항목 삭제 작업은 다음 출력을 제공합니다.
| 작업 출력 유형 | 가용성 |
|---|---|
| 케이스 월 연결 | 사용 불가 |
| 케이스 월 링크 | 사용 불가 |
| 케이스 월 테이블 | 사용 불가 |
| 보강 테이블 | 사용 불가 |
| JSON 결과 | 사용 가능 |
| 출력 메시지 | 사용 가능 |
| 스크립트 결과 | 사용 가능 |
JSON 결과
다음 예시는 네트워크 목록에서 항목 삭제 작업을 사용할 때 수신되는 JSON 결과 출력을 보여줍니다.
[
{
"networkListType": "networkListResponse",
"accessControlGroup": "KSD\nwith ION 3-13H1234",
"name": "General List",
"elementCount": 3010,
"readOnly": false,
"shared": false,
"syncPoint": 23,
"type": "IP",
"uniqueId": "25614_GENERALLIST",
"links": {
"activateInProduction": {
"href": "/network-list/v2/network-lists/25614_GENERALLIST/environments/PRODUCTION/activate",
"method": "POST"
},
"activateInStaging": {
"href": "/network-list/v2/network-lists/25614_GENERALLIST/environments/STAGING/activate",
"method": "POST"
},
"appendItems": {
"href": "/network-list/v2/network-lists/25614_GENERALLIST",
"method": "POST"
},
"retrieve": {
"href": "/network-list/v2/network-lists/25614_GENERALLIST"
},
"statusInProduction": {
"href": "/network-list/v2/network-lists/25614_GENERALLIST/environments/PRODUCTION/status"
},
"statusInStaging": {
"href": "/network-list/v2/network-lists/25614_GENERALLIST/environments/STAGING/status"
},
"update": {
"href": "/network-list/v2/network-lists/25614_GENERALLIST",
"method": "PUT"
}
}
}
]
출력 메시지
네트워크 목록에서 항목 삭제 작업은 다음 출력 메시지를 제공합니다.
| 출력 메시지 | 메시지 설명 |
|---|---|
Successfully updated network list in Akamai. |
작업이 완료되었습니다.
|
None of the provided items were found in the network list in
Akamai. |
지정된 항목을 삭제하지 못했습니다.
|
No valid items provided for removal. Please provide a
comma-separated list of items. |
작업이 실패했습니다.
|
Error executing action "Remove Items From Network List". Reason:
provide a value in "Network List Name" or "Network List ID"
parameter. |
작업이 실패했습니다.
|
Error executing action "Remove Items From Network List". Reason:
"NETWORK_LIST_IDENTIFIER" network
list wasn't found in Akamai. |
작업이 실패했습니다. 지정된 네트워크 목록 이름 또는 ID가 Akamai에 있는지, |
Error executing action "Remove Items From Network List". Reason:
ERROR_REASON |
작업이 실패했습니다. Akamai 서버에 대한 연결을 확인하거나, |
스크립트 결과
다음 표에는 네트워크 목록에서 항목 삭제 작업을 사용할 때 스크립트 결과 출력 값이 나와 있습니다.
| 스크립트 결과 이름 | 값 |
|---|---|
is_success |
true 또는 false |
도움이 더 필요하신가요? 커뮤니티 회원 및 Google SecOps 전문가에게 문의하여 답변을 받으세요.