Google SecOps와 Azure API 통합

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

사용 사례

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

• 범용 Microsoft 365 조사: 커스텀 HTTP 요청 기능을 사용하여 Microsoft Graph 엔드포인트를 쿼리하면 분석가가 단일 인터페이스에서 Teams, SharePoint, Exchange 전반의 데이터를 수집할 수 있습니다.

• 커스텀 사고 해결: 전용 '원클릭' 작업을 사용할 수 없는 경우 타겟팅된 POST 또는 PATCH 요청을 실행하여 Azure 서비스의 위협을 해결함으로써 새로운 취약점에 신속하게 대응할 수 있습니다.

• 자동 데이터 수집: 다양한 Azure 저장소에서 보안 이벤트 및 감사 로그를 예약 수집하여 클라우드 환경에 대한 포괄적인 가시성을 유지합니다.

• 안전한 멀웨어 처리: 악성 콘텐츠의 우발적인 실행을 방지하는 내장된 비밀번호 보호 ZIP 파일 보관처리 기능을 사용하여 의심스러운 파일을 안전하게 다운로드하고 분석합니다.

• 영구 인증 관리: 갱신 토큰 갱신 작업을 사용하여 OAuth 2.0 토큰을 자동으로 순환함으로써 자동화된 플레이북과 헌팅 작업이 Microsoft 365 서비스에 중단 없이 안전하게 액세스할 수 있도록 합니다.

시작하기 전에

Google SecOps에서 통합을 구성하기 전에 다음이 있는지 확인합니다.

• Microsoft Entra ID 애플리케이션: API 통신을 용이하게 하기 위해 Microsoft Entra ID 포털에 등록된 애플리케이션입니다.

• 클라이언트 ID 및 클라이언트 보안 비밀번호: 애플리케이션 등록에서 생성된 유효한 사용자 인증 정보입니다.

• 테넌트 ID: Azure Active Directory 인스턴스의 고유 식별자입니다.

• 리디렉션 URL: 통합 매개변수에 제공된 URI와 일치하는 구성된 리디렉션 URI입니다.

• API 권한 (범위): 쿼리하려는 Azure 서비스를 기반으로 애플리케이션에 할당된 특정 권한입니다.

• 갱신 토큰: 영구 위임 액세스에 필요한 90일 동안 유효한 토큰입니다.

• 갱신 토큰 갱신 작업: 토큰 만료로 인한 통합 실패를 방지하는 데 사용되는 중요한 보안 자동화입니다.

Azure API 인증 설정

Azure API 통합은 두 가지 유형의 인증을 지원합니다. 필요한 권한 집합은 쿼리하는 특정 API 요청 및 Azure 서비스에 따라 다릅니다.

• 애플리케이션 권한: API 요청은 Microsoft Entra ID에 구성된 애플리케이션의 관점에서 실행됩니다. 이 설정에는 클라이언트 ID와 클라이언트 보안 비밀번호만 필요합니다.

• 위임된 권한: 가장이 구성된 특정 사용자를 대신하여 API 요청이 실행됩니다.

위임된 인증 설정

위임된 권한을 사용하려면 다음 단계를 사용하여 초기 갱신 토큰을 수동으로 생성해야 합니다.

1. 통합 구성에 Client ID, Client Secret, Scope, Redirect URL, Tenant ID를 제공합니다.

2. 승인 받기 작업을 실행합니다.

3. 브라우저에서 작업으로 생성된 링크를 열고 결과로 리디렉션된 링크를 복사합니다.

4. 리디렉션된 링크를 토큰 생성 작업의 입력으로 제공합니다.

5. 작업에서 반환된 토큰을 복사하고 통합 구성 중에 Refresh Token에 입력합니다.

갱신 토큰 갱신 구성

초기 갱신 토큰은 90일 동안 유효합니다. 서비스가 중단되지 않도록 하려면 통합 인스턴스의 갱신 토큰을 자동으로 업데이트하도록 갱신 토큰 갱신 작업을 구성합니다.

통합 매개변수

Azure API 통합에는 다음 매개변수가 필요합니다.

매개변수	설명
Microsoft Login API Root	필수 입력란입니다. Azure API 인증에 사용되는 Microsoft Identity Platform 로그인 서비스의 API 루트입니다. 기본값은 https://login.microsoftonline.com입니다.
Microsoft Graph API Root	필수 입력란입니다. Azure API 작업에 사용되는 Microsoft Graph 서비스의 API 루트입니다. 기본값은 https://graph.microsoft.com입니다.
Client ID	필수 입력란입니다. Azure API 계정의 클라이언트 ID입니다.
Client Secret	필수 입력란입니다. Azure API 계정의 클라이언트 보안 비밀번호입니다.
Tenant ID	필수 입력란입니다. Azure API 계정의 테넌트 ID입니다.
Refresh Token	(선택사항) Azure API 계정에 대한 위임된 액세스에 사용되는 갱신 토큰입니다. 이 토큰은 90일 동안 유효하며 초기 설정에서 가져옵니다.
Verify SSL	(선택사항) 선택하면 통합에서 Azure API 서버에 연결할 때 SSL 인증서를 검증합니다. 기본적으로 사용 설정됩니다.
Redirect URL	(선택사항) Microsoft Entra ID 애플리케이션과 연결된 리디렉션 URI입니다. 기본값은 http://localhost입니다.
Test URL	필수 입력란입니다. GET 요청을 사용하여 Azure API에 대한 인증을 검증하는 데 사용되는 URL입니다.
Scopes	필수 입력란입니다. Azure API 인증 범위의 쉼표로 구분된 목록입니다.

Google SecOps에서 통합을 구성하는 방법에 대한 안내는 통합 구성을 참조하세요.

필요한 경우 이후 단계에서 변경할 수 있습니다. 통합 인스턴스를 구성한 후 플레이북에서 사용할 수 있습니다. 여러 인스턴스를 구성하고 지원하는 방법에 관한 자세한 내용은 다중 인스턴스 지원을 참고하세요.

작업

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

HTTP 요청 실행

HTTP 요청 실행 작업을 사용하여 대상 URL에 대해 맞춤설정된 HTTP API 요청을 구성하고 실행합니다.

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

작업 동작

이 작업은 비동기 폴링, 동적 페이로드 구성, 파일 관리를 포함한 복잡한 동작을 지원합니다.

비동기 폴링

Expected Response Values가 제공되면 작업이 비동기 모드로 작동합니다. 이 모드에서 작업은 대상 엔드포인트를 반복적으로 폴링하여 응답 상태를 추적합니다 (예: 장기 실행 작업이 완료될 때까지 대기).

이 작업은 매개변수에 제공된 JSON 조건에 따라 응답 본문을 평가하고 조건이 충족되거나 작업이 제한 시간에 도달할 때까지 실행을 계속합니다.

조건 로직

이 작업은 응답 상태를 추적하기 위해 다음 로직을 지원합니다.

• 단일 필드 일치: 작업은 특정 필드가 단일 값에 도달할 때까지 기다립니다.

  {
    "state": "finished"
  }
  

• 여러 값 (OR 로직): 필드가 제공된 목록의 값과 일치하면 작업이 실행을 중지합니다. 이는 불필요한 폴링을 방지하기 위해 '성공' 및 '오류' 상태 모두에서 중지하는 데 유용합니다.

  {
    "state": ["finished", "error"]
  }
  

• 여러 필드 (AND 로직): 지정된 모든 필드가 동시에 각 값과 일치할 때까지 작업이 대기합니다.

  {
    "state": "finished",
    "percentage": "100"
  }
  

• 결합된 로직: JSON 객체 내에서 여러 조건을 결합할 수 있습니다.

  {
    "state": ["finished", "error"],
    "percentage": "10"
  }
  

JSON 파싱 동작

조건을 평가할 때 작업은 다음 규칙을 따릅니다.

• 전역 검색: 이 작업은 전체 JSON 응답 객체에서 지정된 키를 검색합니다. 상위 객체 이름을 앞에 추가하거나 프리픽스를 사용하지 않고 JSON에 표시된 대로 키 이름을 정확하게 입력합니다 (예: "data_state" 또는 "data-state"가 아닌 "state" 사용).

• 여러 개의 동일한 키: 응답에 JSON 계층 구조의 여러 수준에서 동일한 이름을 가진 여러 키가 포함된 경우 모든 일치하는 키 이름이 동일한 예상 값을 충족하는 경우에만 예상 출력에 도달합니다.

  예를 들어 JSON 응답에서 finished 상태를 검색하고 다른 상태를 무시하려면 Expected Response Values의 모든 state 키를 finished로 설정합니다.

  {
  "data": {
    "state": "finished"
    },
    "state": "finished"
  }
  

본문 페이로드 구성

이 작업은 Headers에 제공된 Content-Type 헤더를 기반으로 요청 본문을 구성합니다.

다음 구성 예시에 사용되는 Body Payload 입력입니다.

{
  "Id": "123123",
  "sorting": "asc"
}

• application/x-www-form-urlencoded: 작업이 페이로드를 Id=123123&sorting=asc로 생성합니다.

• application/json: 이 작업은 다음 JSON 페이로드를 생성합니다.

  {
    "Id": "123123",
    "sorting": "asc"
  }
  

• XML: 서드 파티 제품에 XML이 필요한 경우 Body Payload에 XML 형식의 입력을 직접 제공합니다.

  <?xml version="1.0" encoding="utf-8"?>
  <soap:Envelope xmlns:soap="[http://schemas.xmlsoap.org/soap/envelope/](http://schemas.xmlsoap.org/soap/envelope/)">
  <soap:Body>
    <NumberToWords xmlns="[http://www.dataaccess.com/webservicesserver/](http://www.dataaccess.com/webservicesserver/)">
      <ubiNum>500</ubiNum>
    </NumberToWords>
  </soap:Body>
  </soap:Envelope>
  

파일 처리

이 작업은 파일 관리를 위해 다음 워크플로를 지원합니다.

• 파일 다운로드:

  • 파일 데이터를 base64 형식의 JSON 결과의 일부로 반환하려면 Base64 Output를 선택합니다.

  • 파일을 ZIP 파일로 케이스 월에 직접 저장하려면 Save To Case Wall를 선택합니다.

• 파일 업로드: 파일을 업로드하려면 base64 인코딩 문자열로 변환하고 Body Payload 값의 일부로 포함합니다.

  다음 예시에서는 base64로 인코딩된 문자열로 변환된 이미지 파일을 보여줍니다.

  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
  

• 보안: 민감한 파일 (예: 멀웨어)의 경우 Password Protect Zip를 선택합니다. 이렇게 하면 Save To Case Wall를 사용하여 생성된 저장된 ZIP 파일이 비밀번호 infected로 자동 암호화됩니다.

플레이북 블록 구성

다음 구성은 플레이북 블록 내에서 HTTP 요청 실행 작업을 사용하는 방법을 보여줍니다. 이 예시를 사용하여 자리표시자와 입력 프리픽스를 적용하는 방법을 알아봅니다.

블록 입력을 자리표시자로 사용할 때는 Input. 프리픽스(예: [Input.comment])를 포함해야 합니다.

• 메서드: PUT

• URL 경로:

  https://{API_URL}/[Input.table_name]/[Input.sys_id]
  

• 헤더:

  {
    "Content-type": "application/json; charset=utf-8",
    "Accept": "application/json",
    "User-Agent": "GoogleSecops"
  }
  

• 본문 페이로드:

  {
    "work_notes": "[Input.comment]"
  }
  

작업 입력

HTTP 요청 실행 작업에는 다음 매개변수가 필요합니다.

매개변수	설명
Method	(선택사항) 요청에 사용되는 HTTP 메서드 (동사)입니다. 가능한 값은 다음과 같습니다. GET POST PUT PATCH DELETE HEAD OPTIONS 기본값은 GET입니다.
URL Path	필수 입력란입니다. 요청이 실행되는 API 엔드포인트입니다. 이 경로에는 원하는 경우 쿼리 매개변수가 포함될 수 있습니다.
URL Params	(선택사항) URL의 쿼리 매개변수이며 JSON 객체로 제공됩니다. 이 매개변수는 URL Path에 이미 정의된 쿼리 매개변수에 추가되므로 이 매개변수에 권장되는 입력 방법입니다.
Headers	(선택사항) HTTP 요청의 헤더로, JSON 객체로 제공됩니다. 헤더는 인증과 같은 측면을 제어하고 Body Payload 형식을 정의합니다(Content-Type 사용).
Cookie	(선택사항) HTTP Cookie 헤더로 구성된 쿠키로, JSON 객체로 제공됩니다. 이 매개변수는 Headers에 제공된 쿠키 값을 재정의합니다.
Body Payload	(선택사항) HTTP 요청의 콘텐츠 페이로드로, JSON 객체로 제공됩니다. 요청 형식 (JSON 또는 form-urlencoded)은 Headers에 설정된 Content-Type에 의해 결정됩니다.
Expected Response Values	(선택사항) 응답 본문의 필수 상태를 정의하는 필드-값 쌍이 포함된 JSON 객체입니다. 참고: 이 매개변수의 값을 제공하면 비동기 폴링 동작이 트리거됩니다. 조건 및 논리 연산자 형식 지정에 대한 자세한 내용은 작업 동작을 참조하세요.
Save To Case Wall	(선택사항) 선택하면 작업이 응답 데이터를 파일로 저장하고 케이스 벽에 첨부합니다. 파일은 .zip 확장자로 보관처리됩니다. 이 ZIP은 Password Protect Zip가 사용 설정되지 않는 한 비밀번호로 보호되지 않습니다.
Password Protect Zip	(선택사항) 선택하면 이 작업은 다운로드한 ZIP 파일(Save To Case Wall를 사용하여 생성됨)을 비밀번호 (예: infected)로 암호화합니다. 의심스럽거나 잠재적으로 악의적인 파일을 처리할 때 이 옵션을 사용하여 실수로 실행되지 않도록 합니다. 기본적으로 사용 설정됩니다.
Follow Redirects	(선택사항) 선택하면 작업이 최종 도착 URL에 대한 HTTP 리디렉션 응답(예: 301 또는 302 상태 코드)을 자동으로 따릅니다. 기본적으로 사용 설정됩니다.
Fail on 4xx/5xx	(선택사항) 선택하면 HTTP 응답이 클라이언트 오류 (4xx) 또는 서버 오류 (5xx) 상태 코드를 반환할 때 작업이 단계를 명시적으로 실패합니다. 기본적으로 사용 설정됩니다.
Base64 Output	(선택사항) 선택하면 작업이 HTTP 응답 본문을 Base64로 인코딩된 문자열로 변환합니다. 이는 다운로드한 파일을 처리하거나 저장하는 데 유용합니다. 인코딩된 문자열은 15MB를 초과할 수 없습니다.
Fields To Return	필수 입력란입니다. 작업이 출력에서 반환하는 쉼표로 구분된 필드 목록입니다. 가능한 값은 다음과 같습니다. response_data redirects response_code response_cookies response_headers apparent_encoding 기본값은 response_data,redirects,response_code,response_cookies,response_headers,apparent_encoding입니다.
Request Timeout	필수 입력란입니다. 요청이 중단되기 전에 작업이 서버에서 데이터를 전송할 때까지 기다리는 최대 시간(초)입니다. 기본값은 120입니다.

작업 출력

HTTP 요청 실행 작업은 다음 출력을 제공합니다.

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

JSON 결과

다음 예시에서는 HTTP 요청 실행 작업을 사용할 때 수신되는 JSON 결과 출력을 보여줍니다.

{
   "response_data": {
       "data": {
           "relationships": {
               "comment": [
                   {
                       "name": "example_resource_name",
                       "description": "Description of the object to which the comment belongs."
                   },
                   {
                       "name": "example_user_role",
                       "description": "Description of the user role associated with the comment."
                   }
               ]
           }
       }
   },
   "redirects": [],
   "response_code": 200,
   "cookies": {},
   "response_headers": {
       "Content-Type": "application/json",
       "X-Cloud-Trace-Context": "REDACTED_TRACE_ID",
       "Date": "REDACTED_DATE_TIME",
       "Server": "REDACTED_SERVER_NAME",
       "Content-Length": "REDACTED_VALUE"
   },
   "apparent_encoding": "ascii"
}

출력 메시지

HTTP 요청 실행 작업은 다음 출력 메시지를 반환할 수 있습니다.

출력 메시지	메시지 설명
Successfully executed API request. Successfully executed API request, but the status code 4xx_OR_5xx was returned. Please check the request or try again later.	작업이 완료되었습니다.
Failed to execute API request. Error: ERROR_REASON	작업이 실패했습니다. 서버, 입력 매개변수 또는 사용자 인증 정보에 대한 연결을 확인하세요.

스크립트 결과

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

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

승인 가져오기

승인 가져오기 작업을 사용하여 OAuth 흐름을 시작하고 위임된 인증에 필요한 액세스 코드가 포함된 링크를 가져옵니다.

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

작업 입력

승인 가져오기 작업에는 다음 매개변수가 필요합니다.

매개변수	설명
Oauth Scopes	필수 입력란입니다. 액세스 및 갱신 토큰의 액세스 수준을 정의하는 쉼표로 구분된 권한 (범위) 목록입니다. 기본값은 user.read, offline_access입니다.

작업 출력

승인 가져오기 작업은 다음 출력을 제공합니다.

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

출력 메시지

승인 가져오기 작업은 다음 출력 메시지를 반환할 수 있습니다.

출력 메시지	메시지 설명
Authorization URL generated successfully. To obtain a URL with access code,Please navigate to the link below as the user that you want to run the integration with., to get a URL with access code. Provide the URL with the access code should be provided next in the Generate Token action.	작업이 완료되었습니다.
Failed to generate the authorization URL! Error is ERROR_REASON	작업이 실패했습니다. 서버, 입력 매개변수 또는 사용자 인증 정보에 대한 연결을 확인하세요.

스크립트 결과

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

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

토큰 생성

토큰 생성 작업을 사용하여 위임된 인증에 필요한 영구 갱신 토큰을 가져옵니다.

이 토큰은 승인 가져오기 작업에서 수신한 승인 URL을 사용하여 생성됩니다.

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

참고: 초기 갱신 토큰을 생성한 직후에 갱신 토큰 갱신 작업을 구성하고 활성화하는 것이 좋습니다. 이 작업은 주기적으로 토큰을 자동으로 갱신하여 토큰이 유효한 상태로 유지되고 만료로 인한 통합 실패를 방지합니다.

작업 입력

토큰 생성 작업에는 다음 매개변수가 필요합니다.

매개변수	설명
Authorization URL	필수 입력란입니다. 승인 가져오기 작업에서 수신한 승인 코드가 포함된 전체 리디렉션 URL입니다. 이 URL은 갱신 토큰을 요청하고 생성하는 데 사용됩니다.

작업 출력

토큰 생성 작업은 다음 출력을 제공합니다.

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

출력 메시지

토큰 생성 작업은 다음 출력 메시지를 반환할 수 있습니다.

출력 메시지	메시지 설명
Successfully fetched the refresh token: TOKEN_VALUE. Enter this token in the integration configuration to enable the integration to authenticate with delegated permissions on behalf of the user that performed the configuration steps. Note: We strongly recommend you configure the "Refresh Token Renewal Job" after you generate the initial refresh token so the job automatically renews and keeps the token valid.	작업이 완료되었습니다.
Failed to get the refresh token! Error is ERROR_REASON	작업이 실패했습니다. 서버, 입력 매개변수 또는 사용자 인증 정보에 대한 연결을 확인하세요.

스크립트 결과

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

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

핑

핑 작업을 사용하여 Azure API에 대한 연결을 테스트합니다.

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

작업 입력

없음

작업 출력

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

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

JSON 결과

다음 예시는 Ping 작업을 사용할 때 수신되는 JSON 결과 출력을 보여줍니다.

{
    "endpoint": "https://api.example-cloud-provider.com/v1.0/health"
}

출력 메시지

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

출력 메시지	메시지 설명
Successfully tested connectivity.	작업이 완료되었습니다.
Failed to test connectivity. ERROR_REASON	작업이 실패했습니다. 서버, 입력 매개변수 또는 사용자 인증 정보에 대한 연결을 확인하세요.

스크립트 결과

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

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

작업

작업에 대한 자세한 내용은 새 작업 구성 및 고급 예약을 참조하세요.

갱신 토큰 갱신 작업

갱신 토큰 갱신 작업을 사용하여 통합에 구성된 갱신 토큰을 주기적으로 업데이트합니다.

기본적으로 갱신 토큰은 90일마다 만료됩니다. 갱신 토큰을 최신 상태로 유지하려면 이 작업이 7일 또는 14일마다 자동으로 실행되도록 구성하는 것이 좋습니다.

중요: 이 작업은 모든 통합에서 고유한 이름이 없으면 충돌을 일으킬 수 있습니다.

이를 방지하려면 다음 단계를 따르세요.

1. IDE에서 작업의 사본을 만듭니다.
2. 복사된 작업의 이름을 고유한 이름으로 바꿉니다.

   권장되는 이름 지정 규칙은 'Azure API - 갱신 토큰 갱신 작업'입니다.

작업 매개변수

갱신 토큰 갱신 작업에는 다음 매개변수가 필요합니다.

매개변수	설명
Integration Environments	(선택사항) 작업이 갱신 토큰을 업데이트하는 통합 환경 이름의 쉼표로 구분된 목록입니다. 각 환경 이름은 큰따옴표로 묶어야 합니다.

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