Akamai를 Google SecOps와 통합

이 문서에서는 Akamai를 Google Security Operations와 통합하는 방법을 설명합니다.

사용 사례

Akamai 통합은 Google SecOps 기능을 사용하여 다음 사용 사례를 지원합니다.

  • 에지에서 위협 차단 자동화: 조사 중에 식별된 악성 IP 주소, CIDR 블록, 자율 시스템 번호, 지리적 위치, TLS 디지털 지문 또는 파일 해시를 Akamai 클라이언트 목록 또는 네트워크 목록에 추가하여 네트워크 에지에서 위협을 차단합니다.

  • 동적 액세스 제어 및 허용 목록 관리: 거짓양성이 해결되거나 임시 제한이 만료되면 Akamai 클라이언트 목록 및 네트워크 목록에서 무해한 지표 또는 만료된 항목을 삭제합니다.

  • 여러 환경에 정책 업데이트 배포: 자동화된 플레이북에서 직접 Akamai 스테이징 또는 프로덕션 환경에서 업데이트된 클라이언트 목록과 네트워크 목록을 활성화하고 이해관계자에게 활성화 이벤트를 알립니다.

  • 에지 보안 목록 감사: Akamai 클라이언트 목록 및 네트워크 목록의 메타데이터, 항목 콘텐츠, 환경 활성화 상태를 검색하여 보안 조사를 보강하고 현재 시행 상태를 확인합니다.

시작하기 전에

Google SecOps에서 Akamai 통합을 구성하기 전에 다음 기본 요건 단계를 완료하세요.

  1. Google SecOps 인스턴스의 Akamai EdgeGrid API 사용자 인증 정보를 만듭니다.

  2. 실행하려는 작업에 대해 Akamai에서 필수 API 권한을 구성합니다.

Akamai EdgeGrid API 사용자 인증 정보 만들기

Akamai 통합은 EdgeGrid 사용자 인증 정보를 사용하여 Akamai API로 인증합니다. Akamai Control Center에서 전용 API 클라이언트를 프로비저닝하고 통합 매개변수에 필요한 다음 사용자 인증 정보 값을 수집합니다.

  • Host(Akamai API 클라이언트의 기본 호스트 이름 URL)
  • Client Token
  • Client Secret
  • Access 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

필수 항목입니다.

https:// 스키마를 포함한 Akamai API 인스턴스의 기준 URL입니다(예: https://akab-example.luna.akamaiapis.net).

기본값은 https://{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 Name 또는 Client List ID를 제공해야 합니다. 둘 다 제공하면 작업에서 Client List ID를 사용합니다.

Client List ID

(선택사항)

활성화할 고객 목록의 고유 식별자입니다.

Client List Name 또는 Client List ID를 제공해야 합니다. 둘 다 제공하면 작업에서 Client List ID를 사용합니다.

Environment

(선택사항)

클라이언트 목록 활성화를 위한 대상 Akamai 환경입니다.

가능한 값은 다음과 같습니다.

  • Production
  • Staging

기본값은 Production입니다.

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.

작업이 실패했습니다.

Client List Name 또는 Client List ID 매개변수에 유효한 식별자를 제공합니다.

Error executing action "Activate Client List". Reason: "CLIENT_LIST_IDENTIFIER" client list wasn't found in Akamai.

작업이 실패했습니다.

지정된 클라이언트 목록 이름 또는 ID가 Akamai에 있는지, Client List Name로 검색하는 경우 이름이 정확한 대소문자와 일치하는지 확인합니다.

Error executing action "Activate Client List". Reason: ERROR_REASON

작업이 실패했습니다.

Akamai 서버에 대한 연결을 확인하고, 타겟 클라이언트 목록에 활성화할 준비가 된 항목이 있는지 확인하거나, API 사용자 인증 정보를 검토하세요.

스크립트 결과

다음 표에는 고객 목록 활성화 작업을 사용할 때 스크립트 결과 출력 값이 나와 있습니다.

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

네트워크 목록 활성화

네트워크 목록 활성화 작업을 사용하여 Akamai 스테이징 또는 프로덕션 환경에서 특정 네트워크 목록을 활성화합니다.

이 작업은 Google SecOps 항목에서 실행되지 않습니다.

작업 입력

네트워크 목록 활성화 작업에는 다음 매개변수가 필요합니다.

매개변수 설명
Network List Name

(선택사항)

활성화할 네트워크 목록의 이름입니다. 일치 여부에서는 대소문자를 구분합니다.

Network List Name 또는 Network List ID를 제공해야 합니다. 둘 다 제공하면 작업에서 Network List ID를 사용합니다.

Network List ID

(선택사항)

활성화할 네트워크 목록의 고유 식별자입니다.

Network List Name 또는 Network List ID를 제공해야 합니다. 둘 다 제공하면 작업에서 Network List ID를 사용합니다.

Environment

(선택사항)

네트워크 목록 활성화를 위한 타겟 Akamai 환경입니다.

가능한 값은 다음과 같습니다.

  • Production
  • Staging

기본값은 Production입니다.

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.

작업이 실패했습니다.

Network List Name 또는 Network List ID 매개변수에 유효한 식별자를 제공합니다.

Error executing action "Activate Network List". Reason: "NETWORK_LIST_IDENTIFIER" network list wasn't found in Akamai.

작업이 실패했습니다.

지정된 네트워크 목록 이름 또는 ID가 Akamai에 있는지, Network List Name로 검색하는 경우 이름이 정확한 대소문자와 일치하는지 확인합니다.

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 Name 또는 Client List ID를 제공해야 합니다. 둘 다 제공하면 작업에서 Client List ID를 사용합니다.

Client List ID

(선택사항)

업데이트할 고객 목록의 고유 식별자입니다. 일치는 대소문자를 구분하지 않습니다.

Client List Name 또는 Client List ID를 제공해야 합니다. 둘 다 제공하면 작업에서 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.

작업이 완료되었습니다.

지정된 모든 항목이 고객 목록에 추가되었거나("status": "added") 목록에 이미 존재합니다("status": "duplicated").

One or more items were not added. See JSON results for details.

작업에서 지정된 항목("status": "failed")을 하나 이상 추가하지 못했습니다.

배치에 있는 항목 중 하나 이상이 목록에 추가되었거나 이미 목록에 있는 경우 is_success는 true로 유지됩니다. 모든 항목이 실패하면 is_success은 false입니다. JSON 결과 출력을 검토하여 실패한 각 항목의 error 세부정보를 검사하고 Item Value 매개변수의 각 값이 타겟 고객 목록의 데이터 유형과 일치하는지 확인합니다.

Error executing action "Add Items To Client List". Reason: provide a value in "Client List Name" or "Client List ID" parameter.

작업이 실패했습니다.

Client List Name 또는 Client List ID 매개변수에 유효한 식별자를 제공합니다.

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 서버에 대한 연결을 확인하고, Item Expiration Date 매개변수가 유효한 ISO 8601 형식을 사용하는지 확인하거나, API 사용자 인증 정보를 검토하세요.

스크립트 결과

다음 표에는 고객 목록에 항목 추가 작업을 사용할 때 스크립트 결과 출력 값이 나와 있습니다.

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

네트워크 목록에 항목 추가

네트워크 목록에 항목 추가 작업을 사용하여 하나 이상의 항목(예: IP 주소, CIDR 블록, 지리적 위치)을 Akamai의 기존 네트워크 목록에 추가합니다.

항목을 추가하면 Akamai의 네트워크 목록이 업데이트되지만 대상 환경에 대해 네트워크 목록 활성화 작업을 실행할 때까지 Akamai 에지에서 변경사항이 적용되지 않습니다.

이 작업은 Google SecOps 항목에서 실행되지 않습니다.

작업 입력

네트워크 목록에 항목 추가 작업에는 다음 매개변수가 필요합니다.

매개변수 설명
Network List Name

(선택사항)

업데이트할 네트워크 목록의 이름입니다. 일치 여부에서는 대소문자를 구분합니다.

Network List Name 또는 Network List ID를 제공해야 합니다. 둘 다 제공하면 작업에서 Network List ID를 사용합니다.

Network List ID

(선택사항)

업데이트할 네트워크 목록의 고유 식별자입니다.

Network List Name 또는 Network List ID를 제공해야 합니다. 둘 다 제공하면 작업에서 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.

작업이 실패했습니다.

Items 매개변수의 값이 대상 네트워크 목록 유형에 유효하고 목록이 읽기 전용이 아닌지 확인합니다.

Error executing action "Add Items To Network List". Reason: Provide a value in "Network List Name" or "Network List ID" parameter.

작업이 실패했습니다.

Network List Name 또는 Network List ID 매개변수에 유효한 식별자를 제공합니다.

Error executing action "Add Items To Network List". Reason: "NETWORK_LIST_IDENTIFIER" network list wasn't found in Akamai.

작업이 실패했습니다.

지정된 네트워크 목록 이름 또는 ID가 Akamai에 있는지, Network List Name로 검색하는 경우 이름이 정확한 대소문자와 일치하는지 확인합니다.

Error executing action "Add Items To Network List". Reason: ERROR_REASON

작업이 실패했습니다.

Akamai 서버에 대한 연결을 확인하거나, Items 매개변수의 형식을 확인하거나, API 사용자 인증 정보를 검토하세요.

스크립트 결과

다음 표에는 네트워크 목록에 항목 추가 작업을 사용할 때 스크립트 결과 출력 값이 나와 있습니다.

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

고객 목록 가져오기

클라이언트 목록 가져오기 작업을 사용하여 Akamai에 구성된 클라이언트 목록의 메타데이터 및 항목 콘텐츠를 검색합니다.

이 작업은 Google SecOps 항목에서 실행되지 않습니다.

작업 입력

고객 목록 가져오기 작업에는 다음 매개변수가 필요합니다.

매개변수 설명
Client List Name

(선택사항)

검색할 고객 목록 이름의 쉼표로 구분된 목록입니다. 일치 여부에서는 대소문자를 구분합니다.

Client List Name 또는 Client List ID를 제공하지 않으면 작업은 지정된 한도까지 사용 가능한 모든 고객 목록을 반환합니다.

Client List ID

(선택사항)

검색할 고객 목록 ID의 쉼표로 구분된 목록입니다. 일치는 대소문자를 구분하지 않습니다.

Client List Name 또는 Client List ID를 제공하지 않으면 작업은 지정된 한도까지 사용 가능한 모든 고객 목록을 반환합니다.

Include Items

(선택사항)

선택하면 작업에서 일치하는 각 클라이언트 목록 내의 항목에 대한 정보를 반환합니다.

이 작업은 Client List Name 또는 Client List ID에 값을 제공하는 경우에만 이 정보를 반환합니다.

Type

(선택사항)

검색할 고객 목록의 유형입니다. Select One로 설정하면 작업이 모든 클라이언트 목록 유형에서 검색됩니다.

가능한 값은 다음과 같습니다.

  • Select One
  • IP
  • GEO
  • ASN
  • TLS Fingerprint
  • File Hash

기본값은 Select One입니다.

Max Client Lists To Return

필수 항목입니다.

반환할 최대 고객 목록 수입니다.

최댓값은 100입니다.

기본값은 100입니다.

Max Client List Items To Return

필수 항목입니다.

각 고객 목록에 대해 반환할 최대 항목 수입니다.

최댓값은 100입니다.

기본값은 100입니다.

작업 출력

고객 목록 가져오기 작업은 다음 출력을 제공합니다.

작업 출력 유형 가용성
케이스 월 연결 사용 불가
케이스 월 링크 사용 불가
케이스 월 테이블 사용 불가
보강 테이블 사용 불가
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에 존재하고, 선택한 Type 필터와 일치하며, Client List Name로 검색할 때 정확한 대소문자를 사용하는지 확인합니다.

Error executing action "Get Client Lists". Reason: ERROR_REASON

작업이 실패했습니다.

Akamai 서버에 대한 연결을 확인하고, 최대 반환 매개변수가 1에서 100 사이인지 확인하거나, API 사용자 인증 정보를 검토하세요.

스크립트 결과

다음 표에는 고객 목록 가져오기 작업을 사용할 때의 스크립트 결과 출력 값이 나와 있습니다.

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

네트워크 목록 가져오기

네트워크 목록 가져오기 작업을 사용하여 Akamai에 구성된 네트워크 목록의 메타데이터, 항목 콘텐츠, 활성화 상태를 검색합니다.

이 작업은 Google SecOps 항목에서 실행되지 않습니다.

작업 입력

네트워크 목록 가져오기 작업에는 다음 매개변수가 필요합니다.

매개변수 설명
Network List Name

(선택사항)

검색할 네트워크 목록 이름의 쉼표로 구분된 목록입니다. 일치 여부에서는 대소문자를 구분합니다.

Network List Name 또는 Network List ID를 제공하지 않으면 작업은 지정된 한도까지 사용 가능한 모든 네트워크 목록을 반환합니다.

Network List ID

(선택사항)

가져올 네트워크 목록 ID의 쉼표로 구분된 목록입니다. 일치는 대소문자를 구분하지 않습니다.

Network List Name 또는 Network List ID를 제공하지 않으면 작업은 지정된 한도까지 사용 가능한 모든 네트워크 목록을 반환합니다.

Include Items

(선택사항)

선택하면 작업이 각 네트워크 목록에 포함된 항목을 반환합니다.

Include Activation Status

(선택사항)

선택하면 작업이 일치하는 각 네트워크 목록의 활성화 상태를 반환합니다.

이 작업은 Network List Name 또는 Network List ID에 값을 제공하는 경우에만 이 정보를 반환합니다.

Activation Environment

(선택사항)

Include Activation Status를 선택하고 특정 Network List Name 또는 Network List ID를 제공할 때 네트워크 목록 활성화 상태를 반환할 환경입니다.

가능한 값은 다음과 같습니다.

  • Both
  • Production
  • Staging

기본값은 Both입니다.

Max Network Lists To Return

필수 항목입니다.

반환할 최대 네트워크 목록 수입니다.

최댓값은 100입니다.

기본값은 100입니다.

Max Network List Items To Return

필수 항목입니다.

각 네트워크 목록에 대해 반환할 최대 항목 수입니다.

최댓값은 100입니다.

기본값은 100입니다.

작업 출력

네트워크 목록 가져오기 작업은 다음 출력을 제공합니다.

작업 출력 유형 가용성
케이스 월 연결 사용 불가
케이스 월 링크 사용 불가
케이스 월 테이블 사용 불가
보강 테이블 사용 불가
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에 있는지, Network List Name로 검색할 때 이름이 정확한 대소문자와 일치하는지 확인합니다.

Error executing action "Get Network Lists". Reason: ERROR_REASON

작업이 실패했습니다.

Akamai 서버에 대한 연결을 확인하고, 최대 반환 매개변수가 1에서 100 사이인지 확인하거나, API 사용자 인증 정보를 검토하세요.

스크립트 결과

다음 표에는 네트워크 목록 가져오기 작업을 사용할 때 스크립트 결과 출력 값이 나와 있습니다.

스크립트 결과 이름 값
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

작업이 실패했습니다.

Host URL에 연결할 수 있는지 확인하고, Akamai EdgeGrid 토큰과 보안 비밀이 유효한지 확인하고, API 클라이언트에 네트워크 목록 API에 대한 액세스 권한이 있는지 확인합니다.

스크립트 결과

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

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

고객 목록에서 항목 삭제

클라이언트 목록에서 항목 삭제 작업을 사용하여 Akamai의 기존 클라이언트 목록에서 하나 이상의 항목을 삭제합니다.

이 작업은 각 항목을 개별적으로 처리하고 JSON 결과에서 removed, doesn't exist(항목이 목록에 없는 경우) 또는 failed의 status를 보고합니다. 항목을 삭제하면 Akamai의 클라이언트 목록이 업데이트되지만 대상 환경에 대해 클라이언트 목록 활성화 작업을 실행할 때까지 Akamai 에지에서 변경사항이 적용되지 않습니다.

이 작업은 Google SecOps 항목에서 실행되지 않습니다.

작업 입력

고객 목록에서 항목 삭제 작업에는 다음 매개변수가 필요합니다.

매개변수 설명
Client List Name

(선택사항)

업데이트할 고객 목록의 이름입니다. 일치는 대소문자를 구분하지 않습니다.

Client List Name 또는 Client List ID를 제공해야 합니다. 둘 다 제공하면 작업에서 Client List ID를 사용합니다.

Client List ID

(선택사항)

업데이트할 고객 목록의 고유 식별자입니다. 일치는 대소문자를 구분하지 않습니다.

Client List Name 또는 Client List ID를 제공해야 합니다. 둘 다 제공하면 작업에서 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.

작업이 완료되었습니다.

지정된 모든 항목이 클라이언트 목록에서 삭제되었거나("status": "removed") 목록에 이미 없습니다("status": "doesn't exist").

One or more items were not removed. See JSON results for details.

지정된 항목("status": "failed") 중 하나 이상을 삭제하지 못했습니다.

배치에 있는 항목 중 하나 이상의 상태가 removed 또는 doesn't exist인 경우 is_success는 true로 유지됩니다. 모든 항목이 실패하면 is_success은 false입니다. JSON 결과 출력을 검토하여 실패한 각 항목의 error 세부정보를 검사하고 Item Value 매개변수의 각 값이 타겟 고객 목록에 유효한지 확인합니다.

Error executing action "Remove Items From Client List". Reason: provide a value in "Client List Name" or "Client List ID" parameter.

작업이 실패했습니다.

Client List Name 또는 Client List ID 매개변수에 유효한 식별자를 제공합니다.

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 서버에 대한 연결을 확인하거나, Item Value 매개변수의 형식을 확인하거나, API 사용자 인증 정보를 검토하세요.

스크립트 결과

다음 표에는 고객 목록에서 항목 삭제 작업을 사용할 때의 스크립트 결과 출력 값이 나와 있습니다.

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

네트워크 목록에서 항목 삭제

네트워크 목록에서 항목 삭제 작업을 사용하여 Akamai의 기존 네트워크 목록에서 하나 이상의 항목을 삭제합니다.

항목을 삭제하면 Akamai의 네트워크 목록이 업데이트되지만 대상 환경에 대해 네트워크 목록 활성화 작업을 실행할 때까지 Akamai 에지에서 변경사항이 적용되지 않습니다.

이 작업은 Google SecOps 항목에서 실행되지 않습니다.

작업 입력

네트워크 목록에서 항목 삭제 작업에는 다음 매개변수가 필요합니다.

매개변수 설명
Network List Name

(선택사항)

업데이트할 네트워크 목록의 이름입니다. 일치 여부에서는 대소문자를 구분합니다.

Network List Name 또는 Network List ID를 제공해야 합니다. 둘 다 제공하면 작업에서 Network List ID를 사용합니다.

Network List ID

(선택사항)

업데이트할 네트워크 목록의 고유 식별자입니다.

Network List Name 또는 Network List ID를 제공해야 합니다. 둘 다 제공하면 작업에서 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.

작업이 완료되었습니다.

Items 매개변수에 여러 항목을 지정하는 경우 네트워크 목록에서 하나 이상의 항목을 삭제하면 작업이 성공합니다.

None of the provided items were found in the network list in Akamai.

지정된 항목을 삭제하지 못했습니다.

Items 매개변수에 지정된 값이 타겟 네트워크 목록에 있는지 확인합니다.

No valid items provided for removal. Please provide a comma-separated list of items.

작업이 실패했습니다.

Items 매개변수에 하나 이상의 유효한 값을 쉼표로 구분하여 입력합니다.

Error executing action "Remove Items From Network List". Reason: provide a value in "Network List Name" or "Network List ID" parameter.

작업이 실패했습니다.

Network List Name 또는 Network List ID 매개변수에 유효한 식별자를 제공합니다.

Error executing action "Remove Items From Network List". Reason: "NETWORK_LIST_IDENTIFIER" network list wasn't found in Akamai.

작업이 실패했습니다.

지정된 네트워크 목록 이름 또는 ID가 Akamai에 있는지, Network List Name로 검색하는 경우 이름이 정확한 대소문자와 일치하는지 확인합니다.

Error executing action "Remove Items From Network List". Reason: ERROR_REASON

작업이 실패했습니다.

Akamai 서버에 대한 연결을 확인하거나, Items 매개변수의 형식을 확인하거나, API 사용자 인증 정보를 검토하세요.

스크립트 결과

다음 표에는 네트워크 목록에서 항목 삭제 작업을 사용할 때 스크립트 결과 출력 값이 나와 있습니다.

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

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