Vertex AI와 Google SecOps 통합

이 문서에서는 Vertex AI를 Google Security Operations (Google SecOps)와 통합하는 방법을 설명합니다.

통합 버전: 1.0

시작하기 전에

통합을 사용하려면 Google Cloud 프로젝트, Google Cloud 서비스 계정, Identity and Access Management (IAM) 역할이 필요합니다.

가격 책정에 대한 자세한 내용은 Vertex AI 가격 책정을 참고하세요.

Google Cloud 프로젝트 설정

Vertex AI 통합을 위한 Google Cloud 프로젝트를 만들고 구성하려면 Google Cloud 프로젝트를 설정하세요.

서비스 계정 만들기 및 구성

Vertex AI를 Google SecOps와 통합하려면 기존 서비스 계정을 사용하거나 새 서비스 계정을 만들면 됩니다. 서비스 계정을 만드는 방법에 대한 안내는 서비스 계정 만들기를 참고하세요.

워크로드 아이덴티티 이메일을 사용하여 통합을 구성하지 않는 경우 서비스 계정을 만든 후 JSON으로 서비스 계정 키를 만드세요. 통합 매개변수를 구성할 때 다운로드한 JSON 키 파일의 전체 콘텐츠를 제공해야 합니다.

보안상의 이유로 서비스 계정 JSON 키 대신 워크로드 아이덴티티 이메일 주소를 사용하는 것이 좋습니다. 워크로드 아이덴티티에 대한 자세한 내용은 워크로드의 아이덴티티를 참고하세요.

IAM 역할 구성

Vertex AI와 통합하려면 통합을 구성하는 데 사용하는 서비스 계정에 Vertex AI 사용자(roles/aiplatform.user) IAM 역할을 부여합니다.

Vertex AI IAM 역할에 대한 자세한 내용은 IAM으로 Vertex AI 액세스 제어를 참고하세요.

통합 매개변수

Vertex AI 통합에는 다음 매개변수가 필요합니다.

매개변수	설명
API Root	필수 Vertex AI 통합의 API 루트입니다. 기본값은 https://LOCATION-aiplatform.googleapis.com입니다.
Workload Identity Email	선택사항 워크로드 아이덴티티 제휴의 클라이언트 이메일 주소입니다. 이 매개변수 또는 Service Account Json File Content 매개변수를 구성할 수 있습니다. 이 통합에서는 서비스 계정 키 JSON 파일로 인증하는 것이 워크로드 아이덴티티 제휴보다 우선합니다. 워크로드 아이덴티티 제휴를 사용하여 서비스 계정을 가장하려면 서비스 계정에 Service Account Token Creator 역할을 부여합니다. 워크로드 아이덴티티 및 워크로드 아이덴티티 사용 방법에 관한 자세한 내용은 워크로드용 아이덴티티를 참고하세요.
Service Account Json File Content	선택사항 서비스 계정 키 JSON 파일의 콘텐츠입니다. 이 매개변수 또는 Workload Identity Email 매개변수를 구성할 수 있습니다. 이 매개변수를 구성하려면 서비스 계정을 만들 때 다운로드한 서비스 계정 키 JSON 파일의 전체 콘텐츠를 제공하세요. 서비스 계정을 인증 방법으로 사용하는 방법에 대한 자세한 내용은 서비스 계정 개요를 참고하세요.
Project ID	선택사항 통합에서 사용할 프로젝트 ID입니다. 이 매개변수의 값을 설정하지 않으면 통합에서 Google Cloud 서비스 계정에서 프로젝트 ID를 가져옵니다.
Default Model	선택사항 통합에서 사용할 기본 모델의 이름입니다. 기본값은 gemini-1.5-flash-002입니다.
Location	선택사항 Vertex AI API의 위치 ID입니다. 값을 설정하지 않으면 통합에서 API 루트에서 위치 ID를 추출합니다. 위치, 엔드포인트, 리소스에 대한 자세한 내용은 Vertex AI API를 참고하세요.
Verify SSL	필수 선택하면 통합에서 Vertex AI에 연결하는 SSL 인증서가 유효한지 확인합니다. 기본적으로 선택되어 있습니다.

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

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

작업

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

EML 분석

미리보기: 이 작업은 미리보기 상태입니다.

EML 분석 작업을 사용하여 Vertex AI로 EML 파일을 분석합니다. 이 작업은 모든 파일을 개별적으로 제출합니다.

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

작업 입력

EML 분석 작업에는 다음 매개변수가 필요합니다.

매개변수	설명
Model ID	선택사항 사용할 모델의 ID입니다(예: gemini-1.5-flash-002).
Temperature	선택사항 토큰 선택의 무작위성 수준을 제어하는 값입니다. 이 매개변수는 float 데이터 유형 값을 허용합니다. 온도 값에 대한 자세한 내용은 파라미터 값 실험을 참고하세요.
Files To Analyze	필수 분석을 위해 제출할 EML 파일의 쉼표로 구분된 목록입니다.
Max Output Tokens	선택사항 모든 대답에서 생성할 수 있는 최대 출력 토큰 수입니다. 토큰 1개는 약 4자(영문 기준)입니다. 토큰 100개는 단어 약 60~80개에 해당합니다. 이 한도는 모든 개별 항목에 적용됩니다. 자세한 내용은 파라미터 값 실험을 참고하세요. 기본값은 100입니다.

작업 출력

EML 분석 작업은 다음 출력을 제공합니다.

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

JSON 결과

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

[{
   "Entity": "file",
   "EntityResult": {
       "raw": "{\"threat_level\": \"High\", \"threats_found\": [{\"threat\": \"Phishing Links\", \"explanation\": \"Multiple links point",
       "extracted_info": {
           "threat_level": "High",
           "threats_found": [
               {
                   "threat": "Phishing Links",
                   "explanation": "Multiple links point to example.com, a suspicious domain likely used for phishing campaigns.",
                   "example": "URL"
               },
               {
                   "threat": "Social Engineering",
                   "explanation": "The email uses urgency and scarcity tactics, pressuring the recipient to click links quickly.",
                   "example": "Register Now and Save $1,000 on all 2-Day Project Management (Fundamentals)"
               },
               {
                   "threat": "Suspicious Domain",
                   "explanation": "The email uses the domain example.com', which is not commonly associated with legitimate businesses or organizations and may be a newly registered domain for malicious purposes. This should be checked for validity and legitimacy. The email also uses the domain pdu-xl.com which may also be suspicious.",
                   "example": "example.com"
               }
           ],
           "verification_steps": [
               "Check the domain reputation of example.com using online tools like VirusTotal or URLVoid.",
               "Analyze email headers to identify the true sender's IP address and location using email analysis tools.",
               "Verify the legitimacy of mentioned products or services by independently contacting the companies mentioned."
           ],
           "protection_measures": [
               "Avoid clicking links in suspicious emails. Hover over links to check the actual URL in a separate tool.",
               "Enable email filtering and anti-phishing features in your email client.",
               "Regularly update your antivirus and anti-malware software.",
               "Educate users about social engineering tactics and phishing schemes."
           ]
       },
       "usageMetadata": {
           "promptTokenCount": 12,
           "candidatesTokenCount": 778,
           "totalTokenCount": 790
       }
   }
}]

출력 메시지

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

출력 메시지	메시지 설명
Successfully analysed the following EML files using Vertex AI: FILE_PATHS	작업이 완료되었습니다.
Error executing action "Analyze EML". Reason: ERROR_REASON	작업이 실패했습니다. 서버, 입력 매개변수 또는 사용자 인증 정보에 대한 연결을 확인합니다.

스크립트 결과

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

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

항목 설명

미리보기: 이 작업은 미리보기 상태입니다.

Describe Entity 작업을 사용하여 Vertex AI를 통해 엔티티에 관한 정보를 요약합니다.

이 작업은 모든 Google SecOps 항목에서 실행되며 모든 항목을 개별적으로 제출합니다.

작업 입력

Describe Entity 작업에는 다음 매개변수가 필요합니다.

매개변수	설명
Model ID	선택사항 사용할 모델의 ID입니다(예: gemini-1.5-flash-002).
Temperature	선택사항 토큰 선택의 무작위성 수준을 제어하는 값입니다. 이 매개변수는 float 데이터 유형 값을 허용합니다. 온도 값에 대한 자세한 내용은 파라미터 값 실험을 참고하세요.
Exclude Fields	선택사항 엔티티 요약 생성 중에 제외할 Google SecOps 엔티티 메타데이터 필드의 쉼표로 구분된 목록입니다.
Force Refresh	선택사항 선택하면 작업에서 Refresh After (Days) 매개변수와 해시 유효성 검사를 무시하고 모든 작업 실행에 대해 엔티티 요약을 재생성합니다. 기본적으로 선택되지 않습니다.
Refresh After (Days)	필수 작업이 엔티티 요약을 새로고침하기 전에 대기하는 일수입니다. 이 작업은 Fields To Ignore 매개변수의 값을 제외하고 Vertex AI로 전송되는 모든 입력을 기반으로 하는 해시 값을 생성합니다. 해시 값이 변경된 경우 작업은 설정된 일수가 지난 후 요약을 새로고침합니다. 해시 값이 변경되지 않으면 Refresh After (Days) parameter value is earlier than the latest summary generation time.이 변경되더라도 작업에서 요약을 새로고침하지 않습니다. The action validates the hash value of the latest actual generated summary and ignores the cached hash value. The default value is 30.
Max Output Tokens	선택사항 모든 대답에서 생성할 수 있는 최대 출력 토큰 수입니다. 토큰 1개는 약 4자(영문 기준)입니다. 토큰 100개는 단어 약 60~80개에 해당합니다. 이 한도는 모든 개별 항목에 적용됩니다. 자세한 내용은 파라미터 값 실험을 참고하세요.

작업 출력

엔티티 설명 작업은 다음 출력을 제공합니다.

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

JSON 결과

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

[
    {
        "Entity": "1B16D64CE18772B8F77C74C3D4DC24AA066BB117",
        "EntityResult": {
            "summary": "This is a suspicious, enriched, internal file hash (SHA1: 1B16D64CE18772B8F77C74C3D4DC24AA066BB117) identified as a Microsoft Excel 2007+ file (\"FC090000\") located on a user's desktop.  VirusTotal analysis shows 3 malicious flags out of 65 total engines.  The file contains macros, is potentially obfuscated, and exhibits behaviors like writing to files, running DLLs, and downloading content.  It was last modified on 2024-11-13 and created on 2021-07-07.  The file is linked to a single case (\"potential_apt_doc_files\") which was closed.  The file is flagged as an artifact but not vulnerable or a pivot point.\n",
            "usageMetadata": {
                "promptTokenCount": 12,
                "candidatesTokenCount": 778,
                "totalTokenCount": 790
            }
        }
    }
]

출력 메시지

엔티티 설명 작업은 다음 출력 메시지를 반환할 수 있습니다.

출력 메시지	메시지 설명
Successfully summarized the entity based on the available information using Vertex AI.	작업이 완료되었습니다.
Error executing action "Describe Entity". Reason: ERROR_REASON	작업이 실패했습니다. 서버, 입력 매개변수 또는 사용자 인증 정보에 대한 연결을 확인합니다.

스크립트 결과

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

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

프롬프트 실행

미리보기: 이 작업은 미리보기 상태입니다.

프롬프트 실행 작업을 사용하여 Vertex AI를 통해 개별 텍스트 프롬프트를 실행합니다.

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

작업 입력

프롬프트 실행 작업에는 다음 매개변수가 필요합니다.

매개변수	설명
Model ID	선택사항 사용할 모델의 ID입니다(예: gemini-1.5-flash-002).
Text Prompt	필수 프롬프트에 포함할 텍스트 요청 사항입니다.
Temperature	선택사항 토큰 선택의 무작위성 수준을 제어하는 값입니다. 이 매개변수는 float 데이터 유형 값을 허용합니다. 온도 값에 대한 자세한 내용은 파라미터 값 실험을 참고하세요.
Candidate Count	선택사항 모든 작업 실행에서 반환할 응답 변형의 개수입니다. 모든 요청에 대해 입력 토큰에는 한 번, 생성된 모든 후보의 출력 토큰에는 각각 청구가 적용됩니다.
Response MIME Type	선택사항 생성된 후보 텍스트의 출력 응답의 미디어 (MIME) 유형입니다. 다음 모델에 응답 미디어 (MIME) 유형을 사용할 수 있습니다. gemini-1.5-pro, gemini-1.5-flash 가능한 값은 다음과 같습니다. application/json text/plain text/x.enum 기본값은 text/plain입니다.
Response Schema	선택사항 생성된 후보 텍스트가 따라야 하는 스키마입니다. 이 매개변수를 사용하려면 Response MIME Type 매개변수를 구성하세요. 다음 모델에 응답 스키마를 사용할 수 있습니다. gemini-1.5-pro, gemini-1.5-flash
Max Input Tokens	선택사항 제출할 최대 입력 토큰 수입니다. 하나의 토큰은 최대 4자로 구성됩니다. 100개의 토큰은 60~80개의 단어에 해당할 수 있습니다. 값을 설정하지 않으면 작업에서 프롬프트를 실행합니다. 토큰 수가 구성된 최대 수를 초과하면 작업이 실패합니다.
Max Output Tokens	선택사항 모든 대답에서 생성할 수 있는 최대 출력 토큰 수입니다. 토큰 1개는 약 4자(영문 기준)입니다. 토큰 100개는 단어 약 60~80개에 해당합니다. 이 한도는 모든 개별 항목에 적용됩니다. 자세한 내용은 파라미터 값 실험을 참고하세요.

작업 출력

프롬프트 실행 작업은 다음 출력을 제공합니다.

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

JSON 결과

다음 예는 프롬프트 실행 작업을 사용할 때 수신되는 JSON 결과 출력을 보여줍니다.

{
  "candidates": [
    {
      "content": {
        "role": "model",
        "parts": [
          {
            "text": "Responding to a malicious email requires a layered approach.  Here's a breakdown of remediation steps, prioritizing actions based on urgency:\n\n**Immediate Actions (within minutes):**\n\n1. **Do NOT click any links or open any attachments.** This is paramount.  Malicious links can download malware, and attachments can contain viruses or exploits.\n\n2. **Disconnect from the internet (if possible).** This limits the damage the malware can do if it's already on your system.  Unplug your ethernet cable or turn off Wi-Fi.\n\n3. **Close the email immediately.** Don't even hover over links or attachments; the preview might be enough to trigger some malware.\n\n**Investigative Actions (within hours):**\n\n4. **Check your email account for unauthorized access.**  Look for unfamiliar sent emails, changed settings (like forwarding rules), or new accounts added.\n\n5. **Run a full system scan with your antivirus software.**  Ensure your antivirus definitions are up-to-date before running the scan.  Consider a second opinion scan with a different reputable antivirus program.\n\n6. **Review your computer's processes (Task Manager on Windows, Activity Monitor on macOS).** Look for unfamiliar processes consuming significant resources.  This could indicate malware activity.\n\n7. **Check your network connections.**  See if any unauthorized connections exist.\n\n8. **Change your email password immediately.** Use a strong, unique password.  Consider using a password manager.\n\n9. **If you clicked a link or opened an attachment, consider the potential impact.** Did you enter credentials?  Did you download a file?  The severity of action needed depends on this.\n\n**Remediation Actions (within days):**\n\n10. **Contact your IT department or security professional.**  They can provide expert guidance and assist with more advanced remediation steps.\n\n11. **Consider more advanced malware scanning tools.**  There are specialized tools that can detect malware missed by standard antivirus.\n\n12. **Review your operating system's security settings.**  Ensure firewalls are enabled and that other security features are adequately configured.\n\n13. **Report the malicious email to your email provider.** This helps them remove the email and prevent others from being affected. You can often do this by forwarding the email to an abuse reporting address provided by your provider.  Report it to the appropriate authorities if you suspect the email involves a crime.\n\n14. **Monitor your accounts and financial records for suspicious activity.**  Phishing emails often aim to steal credentials and financial information.\n\n**Preventive Actions (ongoing):**\n\n15. **Implement strong email filtering.** Use spam filters and configure your email provider's security settings to block suspicious emails.\n\n16. **Train yourself and others to identify phishing emails.**  Be wary of emails with unusual addresses, grammatical errors, urgent requests, or suspicious attachments.\n\n17. **Keep your software up to date.** Regularly update your operating system, applications, and antivirus software.\n\n18. **Use strong, unique passwords for all accounts.**  A password manager can assist with this.\n\n19. **Enable two-factor authentication (2FA) wherever possible.** This adds an extra layer of security to your accounts.\n\n\n**If you suspect your personal data or financial information has been compromised:**\n\n* **Contact your bank and credit card companies immediately.**  Report any suspicious transactions and consider placing a fraud alert on your accounts.\n* **Consider credit monitoring services.**  This can help you detect and respond to identity theft.\n\n\nThe severity of the remediation steps depends on the nature of the malicious email and what actions you took in response to it. If you're unsure about any step, err on the side of caution and seek professional help.\n"
          }
        ]
      },
      "finishReason": "STOP",
      "avgLogprobs": -0.4171245741660307
    }
  ],
  "usageMetadata": {
    "promptTokenCount": 12,
    "candidatesTokenCount": 778,
    "totalTokenCount": 790
  },
  "modelVersion": "gemini-1.5-flash-002",
"Text_context": ""
"extracted_info": ""
}

출력 메시지

프롬프트 실행 작업은 다음 출력 메시지를 반환할 수 있습니다.

출력 메시지	메시지 설명
Successfully executed a prompt.	작업이 완료되었습니다.
Error executing action "Execute Prompt". Reason: ERROR_REASON	작업이 실패했습니다. 서버, 입력 매개변수 또는 사용자 인증 정보에 대한 연결을 확인합니다.

스크립트 결과

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

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

핑

Ping 작업을 사용하여 Vertex AI와의 연결을 테스트합니다.

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

작업 입력

없음

작업 출력

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

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

출력 메시지

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

출력 메시지	메시지 설명
Successfully connected to Vertex AI with the provided connection parameters!	작업이 완료되었습니다.
Failed to connect to Vertex AI. The API root that you provided doesn't match the following expected pattern: "https://((\w|-)+)-aiplatform.googleapis.com". Check the spelling. Failed to connect to Vertex AI! The error is ERROR_REASON	작업이 실패했습니다. 서버, 입력 매개변수 또는 사용자 인증 정보에 대한 연결을 확인합니다.

스크립트 결과

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

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

데이터 변환

미리보기: 이 작업은 미리보기 상태입니다.

데이터 변환 작업을 사용하여 Vertex AI를 통해 데이터 변환을 실행합니다.

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

작업 입력

데이터 변환 작업에는 다음 매개변수가 필요합니다.

매개변수	설명
Model ID	선택사항 사용할 모델의 ID입니다(예: gemini-1.5-flash-002).
Text Prompt	필수 프롬프트에 포함할 텍스트 요청 사항입니다.
Temperature	선택사항 토큰 선택의 무작위성 수준을 제어하는 값입니다. 이 매개변수는 float 데이터 유형 값을 허용합니다. 온도 값에 대한 자세한 내용은 파라미터 값 실험을 참고하세요.
JSON Object	필수 작업 입력으로 사용할 JSON 객체입니다.
Max Output Tokens	필수 모든 대답에서 생성할 수 있는 최대 출력 토큰 수입니다. 토큰 1개는 약 4자(영문 기준)입니다. 토큰 100개는 단어 약 60~80개에 해당합니다. 이 한도는 모든 개별 항목에 적용됩니다. 자세한 내용은 파라미터 값 실험을 참고하세요. 기본값은 100입니다.

작업 출력

데이터 변환 작업은 다음과 같은 출력을 제공합니다.

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

JSON 결과

다음 예는 데이터 변환 작업을 사용할 때 수신되는 JSON 결과 출력을 보여줍니다.

{
  "candidates": [
    {
      "content": {
        "role": "model",
        "parts": [
          {
            "text": "Respondo it. If you're unsure about any step, err on the side of caution and seek professional help.\n"
          }
        ]
      },
      "finishReason": "STOP",
      "avgLogprobs": -0.4171245741660307
    }
  ],
  "usageMetadata": {
    "promptTokenCount": 12,
    "candidatesTokenCount": 778,
    "totalTokenCount": 790
  },
  "modelVersion": "gemini-1.5-flash-002",
"Text_context": ""
"extracted_info": ""
}

출력 메시지

데이터 변환 작업은 다음 출력 메시지를 반환할 수 있습니다.

출력 메시지	메시지 설명
Successfully transformed provided data.	작업이 완료되었습니다.
Error executing action "Transform Data". Reason: ERROR_REASON	작업이 실패했습니다. 서버, 입력 매개변수 또는 사용자 인증 정보에 대한 연결을 확인합니다.

스크립트 결과

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

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

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