Google 번역을 Google SecOps와 통합

이 문서에서는 Google 번역을 Google Security Operations (Google SecOps)와 통합하고 구성하는 방법을 설명합니다.

통합 버전: 4.0

시작하기 전에

통합을 사용하려면 API 키를 만들고 구성해야 합니다.

API 키 만들기

API 키를 만들려면 다음 단계를 완료하세요.

  1. Google Cloud 콘솔에서 API 및 서비스 > 사용자 인증 정보로 이동합니다.

    사용자 인증 정보로 이동

  2. 추가 사용자 인증 정보 만들기를 클릭합니다.

  3. API 키를 선택하여 새 API 키를 생성합니다. 생성된 API 키가 포함된 대화상자가 표시됩니다.

  4. API 키를 복사하려면 복사를 클릭합니다.

API 키 제한사항 구성

API 키의 API 제한을 구성하려면 다음 단계를 완료하세요.

  1. 키 제한을 클릭합니다.

  2. API 제한사항에서 키 제한을 선택합니다.

  3. API 목록에서 Cloud Translation API를 선택합니다.

  4. 해당 제한사항을 구성합니다.

  5. 저장을 클릭하여 API 키 구성을 저장합니다.

통합 매개변수

Google 번역 통합에는 다음 매개변수가 필요합니다.

매개변수 설명
API Root

필수 항목입니다.

Google 번역 인스턴스의 API 루트입니다.

기본값은 https://translation.googleapis.com입니다.

Cloud Translation API에 관한 자세한 내용은 Cloud Translation API를 참고하세요.
API Key

필수 항목입니다.

Google 번역 계정의 API 키입니다.
Verify SSL

필수 항목입니다.

선택하면 통합에서 Google 번역 서버에 연결할 때 SSL 인증서를 검증합니다.

기본적으로 선택되어 있습니다.

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

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

작업

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

언어 목록

언어 목록 작업을 사용하여 Google 번역에서 사용 가능한 언어를 나열합니다.

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

작업 입력

언어 목록 작업에는 다음 매개변수가 필요합니다.

매개변수 설명
Filter Key

(선택사항)

언어를 필터링하는 키입니다.

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

  • Select One
  • Name

기본값은 Select One입니다.
Filter Logic

(선택사항)

적용할 필터 논리입니다.

필터링 로직은 Filter Key 매개변수에 설정한 값을 사용합니다.

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

  • Not Specified
  • Equal
  • Contains

기본값은 Not Specified입니다.
Filter Value

(선택사항)

필터에 사용할 값입니다.

필터링 로직은 Filter Key 매개변수에 설정한 값을 사용합니다.

Equal을 선택하면 작업에서 결과 중 정확한 일치를 검색합니다. Contains이 선택되면 작업에서 지정된 하위 문자열을 포함하는 결과를 검색합니다.

값을 선택하지 않으면 작업에서 필터를 무시합니다.

필터링 로직은 Filter Key 매개변수에 제공된 값을 기반으로 작동합니다.
Max Records To Return

(선택사항)

반환할 최대 레코드 수입니다.

최댓값은 50입니다.

값을 설정하지 않으면 작업에서 기본적으로 50개의 레코드를 반환합니다.

작업 출력

언어 목록 작업은 다음 출력을 제공합니다.

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

언어 목록 작업을 통해 다음 표를 생성할 수 있습니다.

표 이름: 사용 가능한 언어

표 열: 언어 키

JSON 결과

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

{
    "data": {
        "languages": [
            {
                "language": "af"
            },
            {
                "language": "am"
            },
            {
                "language": "ar"
            }

        ]
    }
}
출력 메시지

언어 목록 작업은 다음 출력 메시지를 반환할 수 있습니다.

출력 메시지 메시지 설명

Successfully found language for the provided criteria in Google Translate.

No languages were found for the provided criteria in Google Translate.

The filter was not applied, because parameter "Filter Value" has an empty value.

 작업이 완료되었습니다.
Error executing action "List Languages". Reason: ERROR_REASON

작업이 실패했습니다.

서버, 입력 매개변수 또는 사용자 인증 정보에 대한 연결을 확인합니다.
스크립트 결과

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

스크립트 결과 이름 값
is_success True 또는 False

핑

Ping 작업을 사용하여 Google 번역과의 연결을 테스트합니다.

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

작업 입력

없음

작업 출력

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

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

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

출력 메시지 메시지 설명

Successfully connected to the Google Translate server with the provided connection parameters!

 작업이 완료되었습니다.
Failed to connect to the Google Translate server! Error is ERROR_REASON

작업이 실패했습니다.

서버, 입력 매개변수 또는 사용자 인증 정보에 대한 연결을 확인합니다.
스크립트 결과

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

스크립트 결과 이름 값
is_success True 또는 False

텍스트 번역

텍스트 번역 작업을 사용하여 Google 번역으로 텍스트를 번역합니다.

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

작업 입력

텍스트 번역 작업에는 다음 매개변수가 필요합니다.

매개변수 설명
Source Language

(선택사항)

텍스트의 소스 언어입니다.

이 매개변수를 구성하지 않으면 작업에서 언어를 자동으로 감지합니다.
Target Language

필수 항목입니다.

대상 언어입니다.

기본값은 en입니다.
Text

필수 항목입니다.

번역할 텍스트입니다.

작업 출력

텍스트 번역 작업은 다음과 같은 출력을 제공합니다.

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

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

{
    "data": {
        "translations": [
            {
                "translatedText": "TRANSLATED_TEXT"
            }
        ]
    }
}
출력 메시지

텍스트 번역 작업은 다음 출력 메시지를 반환할 수 있습니다.

출력 메시지 메시지 설명

Successfully translated the provided text in Google Translate.

 작업이 완료되었습니다.
Error executing action "Translate Text". Reason: ERROR_REASON

작업이 실패했습니다.

서버, 입력 매개변수 또는 사용자 인증 정보에 대한 연결을 확인합니다.
스크립트 결과

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

스크립트 결과 이름 값
is_success True 또는 False

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