Google은 AI 기술을 사용하여 콘텐츠를 사용자의 기본 언어로 번역합니다. AI 번역에는 오류가 있을 수 있습니다.

Active Directory를 Google SecOps와 통합

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

사용 사례

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

사용자 활성화 및 비활성화: 보안 침해 가능성이 있는 사용자 계정을 비활성화하고 추가 무단 액세스를 방지합니다.
비밀번호 재설정: Active Directory에서 사용자 비밀번호를 자동으로 재설정하고 사용자에게 변경사항을 알립니다.
그룹 관리: 역할에 따라 적절한 보안 그룹에 신규 사용자를 추가하고 사용자에게 올바른 액세스 권한이 있는지 확인합니다.
사용자 정보 검색: 특정 사용자 계정에 대한 그룹 멤버십, 마지막 로그인 시간, 연락처 정보와 같은 사용자 세부정보를 검색합니다.
오프보딩 자동화: 직원이 오프보딩할 때 계정을 사용 중지하고, 그룹에서 삭제하고, 파일 소유권을 이전합니다.

시작하기 전에

Google SecOps에서 Active Directory 통합을 구성하기 전에 네트워크 환경, Active Directory 도메인 서비스 (AD DS), 서비스 계정 사용자 인증 정보가 모든 운영 기본 요건을 충족하는지 확인하세요.

통합을 위해 환경을 준비하려면 다음 기본 요건을 완료하세요.

Google SecOps 인스턴스 (또는 원격 에이전트)와 Active Directory 도메인 컨트롤러 간의 네트워크 연결 및 DNS 변환을 확인합니다.
선택사항: 내부 인증 기관을 사용하여 LDAPS (비밀번호 재설정에 필요한 포트 636)를 통해 연결하는 경우 루트 또는 중간 인증서를 base64 문자열로 인코딩하여 CA 인증서를 구성합니다.
최소 권한의 원칙을 준수하는 전용 Active Directory 서비스 계정을 만듭니다.
필수 작업 권한을 검토하여 실행하려는 특정 작업에 필요한 속성과 액세스 권한을 확인합니다.
사용하려는 작업의 대상 조직 단위에 대한 권한을 위임합니다 (Active Directory 사용자 및 컴퓨터 또는 PowerShell 및 dsacls 사용). 서비스 계정에 userAccountControl 속성에 대한 명시적인 읽기 및 쓰기 액세스 권한이 있는지 확인합니다.

네트워크 및 DNS 요구사항

Google SecOps는 TCP를 통해 경량 디렉터리 액세스 프로토콜 (LDAP 또는 LDAPS)을 사용하여 Active Directory 도메인 컨트롤러와 직접 통신합니다.

네트워크 환경이 다음 연결 규칙을 충족하는지 확인하세요.

포트 연결: 네트워크 방화벽 및 라우팅에서 Google SecOps (또는 원격 에이전트)에서 Active Directory 도메인 컨트롤러로의 아웃바운드 통신을 다음 포트에서 허용하는지 확인합니다.
- LDAP (표준): 암호화되지 않은 LDAP 통신을 위해 포트 389/TCP를 엽니다.
- LDAPS (권장 - 비밀번호에 필수): 포트 636/TCP (또는 커스텀 SSL/TLS 포트)를 엽니다. LDAPS는 암호화된 디렉터리 트래픽에 필요하며 비밀번호 수정 작업에 필수입니다.
DNS 및 호스트 이름 확인: Active Directory에는 SSL/TLS 인증서 및 디렉터리 서비스 결합과 일치하는 정확한 호스트 이름 확인이 필요합니다. 내부 DNS 설정을 통해 정규화된 DNS 이름으로 도메인이 확인되는 경우 추가 호스트 구성이 필요하지 않습니다. 원격 에이전트 컨테이너 이미지에서 DNS 변환을 사용할 수 없는 경우 /etc/hosts 파일을 구성합니다.

`/etc/hosts` 파일 구성

이 구성은 선택사항입니다. 내부 DNS 설정을 통해 도메인 컨트롤러가 이미 확인된 경우 이 섹션을 건너뜁니다. 원격 에이전트가 DNS를 사용하여 Active Directory 도메인 컨트롤러를 확인할 수 없는 경우 /etc/hosts 파일에서 호스트를 수동으로 매핑하여 SSL/TLS 인증서 및 디렉터리 서비스 바인딩을 일치시킵니다.

/etc/hosts 파일을 구성하려면 다음 단계를 완료하세요.

관리자 권한으로 텍스트 편집기에서 /etc/hosts를 엽니다.
```
sudo vi /etc/hosts
```
도메인 컨트롤러의 IP 주소를 정규화된 도메인 이름 (FQDN)에 매핑하는 항목을 추가합니다.
```
192.0.2.195 dc01.example.local
```
저장하고 파일을 닫습니다.

통합에 CA 인증서가 필요하지 않으면 인증 및 서비스 계정 요구사항 구성으로 진행합니다. 그렇지 않으면 CA 인증서를 구성합니다.

CA 인증서 구성

이 단계는 선택사항입니다. 표준 LDAP (포트 389)를 사용하여 연결하거나 공개적으로 신뢰할 수 있는 인증서를 사용하는 경우 이 섹션을 건너뛰고 인증 및 서비스 계정 요구사항으로 진행합니다. 비공개 또는 내부 CA에서 발급한 인증서를 사용하여 LDAPS (비밀번호 재설정에 필요한 포트 636)를 통해 연결하는 경우 설정 중에 base64로 인코딩된 인증서 문자열을 제공하여 신뢰할 수 있는 TLS 연결을 설정합니다.

CA 인증서를 구성하고 업로드하려면 다음 단계를 완료합니다.

PEM 형식의 인증서 파일을 인코딩합니다.
- Linux: bash base64 -w 0 mycert.crt
- macOS: bash base64 -i mycert.crt
전체 출력 문자열 (인코딩된 헤더 포함)을 복사하여 Google SecOps 통합 구성의 CA 인증서 파일 - Base64 문자열로 파싱됨 필드에 붙여넣습니다.
호스트 이름이 인증서의 일반 이름 (CN) 또는 주체 대체 이름 (SAN)과 일치하도록 서버 매개변수를 도메인 컨트롤러의 FQDN (IP 주소가 아님)으로 설정합니다.
테스트를 클릭하여 TLS 핸드셰이크를 검증합니다.

인증 및 서비스 계정 요구사항

Active Directory 통합은 표준 AD DS 사용자 인증 정보를 사용하여 인증합니다.

인증 설정이 다음 보안 관행을 준수하는지 확인합니다.

전용 서비스 계정: Google SecOps 자동 플레이북 전용 서비스 계정 (예: svc_secops_ad)을 만듭니다. 대화형 사용자 계정이나 기본 제공 도메인 관리자 계정을 사용하지 마세요.
사용자 이름 형식: 사용자 이름은 사용자 주 구성원 이름(UPN) (예: svc_secops@example.local) 또는 하위 수준 로그온 이름(EXAMPLE\svc_secops)으로 제공될 수 있습니다.
PoLP: 도메인 관리자, 엔터프라이즈 관리자, 계정 운영자와 같은 권한이 있는 기본 제공 그룹에 서비스 계정을 추가하지 마세요. 대신 사용자, 컴퓨터 또는 그룹 객체가 있는 특정 OU에 세분화된 권한을 부여합니다.

작업 권한 구성 (최소 권한)

인증 서비스 계정에 실행하려는 특정 작업에 필요한 Active Directory 권한 및 LDAP 속성 액세스 권한만 부여합니다.

다음 표에서 Active Directory 작업에 대한 최소 권한을 참조하세요.

액션명	필수 AD DS 권한/확장 권한	대상 객체 클래스	설명/속성 범위
Ping	`Read Property`	사용자, 도메인 루트	구성된 서비스 계정 객체 (`sAMAccountName`, `userPrincipalName`, `mail`)를 쿼리하여 디렉터리 연결 및 사용자 인증 정보를 검증합니다.
항목 보강	`List Contents` `Read Property`(대상 속성: `userAccountControl`, `sAMAccountName`, `mail`, `memberOf`, `lockoutTime`, `pwdLastSet`)	사용자, 컴퓨터, 그룹	사용자 및 컴퓨터 속성을 쿼리하고 중첩된 그룹 멤버십을 확인합니다. null 첨자 오류를 방지하려면 `userAccountControl`에 `Read Property`가 필요합니다.
계정 사용 중지	`Read Property`: `userAccountControl` `Write Property`: `userAccountControl`	사용자	대상 사용자 객체에서 `ACCOUNTDISABLE` 플래그 (`0x0002`)를 읽고 설정합니다.
계정 사용 설정	`Read Property`: `userAccountControl` `Write Property`: `userAccountControl`	사용자	대상 사용자 객체에서 `ACCOUNTDISABLE` 플래그 (`0x0002`)를 읽고 지웁니다.
컴퓨터 사용 중지	`Read Property`: `userAccountControl` `Write Property`: `userAccountControl`	컴퓨터	대상 컴퓨터 객체에서 `ACCOUNTDISABLE` 플래그를 읽고 설정합니다.
컴퓨터 사용 설정	`Read Property`: `userAccountControl` `Write Property`: `userAccountControl`	컴퓨터	대상 컴퓨터 객체에서 `ACCOUNTDISABLE` 플래그를 읽고 삭제합니다.
잠긴 계정 해제	`Read Property`: `lockoutTime` `Write Property`: `lockoutTime`	사용자	`lockoutTime` 속성을 읽고 `0`로 설정하여 잠긴 사용자 계정을 잠금 해제합니다.
비밀번호 업데이트 강제 적용	`Read Property`: `pwdLastSet` `Write Property`: `pwdLastSet`	사용자	`pwdLastSet` 속성을 읽고 `0`로 설정하여 사용자가 다음 로그인 시 비밀번호를 변경하도록 합니다.
사용자 비밀번호 설정	확장된 권리: `Reset Password`(`User-Force-Change-Password`) (선택사항) `Write Property`: `unicodePwd`	사용자	대상 사용자의 비밀번호를 재설정합니다. LDAPS (포트 636) 또는 StartTLS가 필요합니다.
그룹에 사용자 추가	`Read Property`: `member` `Write Property`: `member`	그룹	대상 사용자의 고유 이름 (`distinguishedName`)을 그룹의 `member` 속성에 추가합니다.
그룹에서 사용자 삭제	`Read Property`: `member` `Write Property`: `member`	그룹	그룹의 `member` 속성에서 대상 사용자의 고유 이름(`distinguishedName`)을 삭제합니다.
사용자 OU 변경	원본 OU의 `Delete Child Object` (사용자) 도착 OU의 `Create Child Object` (사용자) `Write Property`: `name`, `distinguishedName`	조직 단위, 사용자	LDAP `modify_dn`를 사용하여 OU 간에 사용자 객체를 이동합니다.
호스트 OU 변경	`Delete Child Object` (컴퓨터) - 소스 OU 대상 OU의 `Create Child Object` (컴퓨터) `Write Property`: `name`, `distinguishedName`	조직 단위, 컴퓨터	LDAP `modify_dn`를 사용하여 OU 간에 컴퓨터 객체를 이동합니다.
AD 사용자의 속성 업데이트	타겟 속성 (예: `mail`, `title`, `department`, `telephoneNumber`, `description`, `manager`)에 대한 `Write Property`	사용자	대상 사용자 객체의 지정된 속성 값을 수정합니다.
AD 호스트 속성 업데이트	대상 속성 (예: `description` 또는 `location`)에 대한 `Write Property`	컴퓨터	대상 컴퓨터 객체의 지정된 속성 값을 수정합니다.
그룹 구성원 가져오기	`List Contents` `Read Property`: `member`, `sAMAccountName`, `distinguishedName`	그룹, 사용자, 컴퓨터	그룹 멤버십 및 멤버 계정 속성을 쿼리합니다.
관리자 연락처 정보 가져오기	`Read Property`: `manager` `Read Property`: `cn`, `telephoneNumber`, `mail`, `displayName`, `title`	사용자	대상 사용자 객체에서 `manager` 속성을 읽고 관리자의 연락처 세부정보를 가져옵니다.
Is User In Group	`Read Property`: `memberOf`, `sAMAccountName`	사용자, 그룹	사용자 계정이 지정된 보안 또는 배포 그룹에 속하는지 여부를 평가합니다.
사용자 그룹 나열	`Read Property`: `memberOf`, `sAMAccountName`	사용자, 그룹	지정된 사용자 계정에 할당된 모든 그룹 목록을 반환합니다.
Active Directory 검색	`List Contents` 쿼리된 속성에 대한 `Read Property`	사용자, 컴퓨터, 그룹, 조직 단위	디렉터리 하위 트리에서 커스텀 LDAP 필터 쿼리를 실행합니다.

Active Directory에서 권한 위임

광범위한 관리 권한을 부여하지 않고 PoLP를 적용하려면 그래픽 ADUC 콘솔 또는 PowerShell 및 dsacls 명령줄 도구를 사용하여 대상 OU에 대한 권한을 위임합니다. 이러한 방법 중 하나만 사용하면 되며 실행하려는 특정 작업에 필요한 권한만 위임하면 됩니다.

ADUC를 사용하여 제어 위임

그래픽 인터페이스를 사용하려면 ADUC의 제어 위임 마법사를 사용하여 객체 및 속성별 권한을 위임합니다.

대상 OU에서 마법사를 실행하여 사용하려는 작업 (예: 계정 제어 플래그 읽기 및 쓰기, 비밀번호 재설정, 계정 잠금 해제)에 필요한 객체 및 속성 권한을 부여합니다.

마법사 실행에 대한 단계별 안내는 AD DS의 제어 위임에 대한 Microsoft 문서를 참조하세요.

PowerShell 및 dsacls를 사용하여 제어 위임

명령줄 접근 방식을 선호하거나 권한 할당을 자동화하려면 ADUC 대신 기본 제공되는 dsacls.exe 유틸리티와 함께 PowerShell을 사용하세요.

관리 워크스테이션 또는 도메인 컨트롤러에서 사용하려는 작업에 적용되는 명령어 예시만 실행하고 대상 OU 및 서비스 계정 이름을 대체합니다.

사용자 객체에 대해 userAccountControl에 읽기 및 쓰기 권한을 부여합니다 (사용자 계정을 사용 설정 또는 중지하고 보강 오류를 방지하기 위함). powershell dsacls.exe "OU=Users,DC=example,DC=local" /I:S /G "EXAMPLE\svc_secops_ad:RPWP;userAccountControl;user"
컴퓨터 객체에 대해 userAccountControl에 대한 읽기 및 쓰기 권한을 부여합니다(컴퓨터 사용 설정 또는 중지). powershell dsacls.exe "OU=Computers,DC=example,DC=local" /I:S /G "EXAMPLE\svc_secops_ad:RPWP;userAccountControl;computer"
계정 잠금 해제 권한 (lockoutTime)을 부여합니다. powershell dsacls.exe "OU=Users,DC=example,DC=local" /I:S /G "EXAMPLE\svc_secops_ad:RPWP;lockoutTime;user"
비밀번호 강제 변경 권한 부여 (pwdLastSet): powershell dsacls.exe "OU=Users,DC=example,DC=local" /I:S /G "EXAMPLE\svc_secops_ad:RPWP;pwdLastSet;user"
비밀번호 재설정 권한 (Reset Password 확장 권한)을 부여합니다. powershell dsacls.exe "OU=Users,DC=example,DC=local" /I:S /G "EXAMPLE\svc_secops_ad:CA;Reset Password;user"
보안 그룹에 멤버십 수정 권한을 부여합니다. powershell dsacls.exe "CN=SecOps-Quarantine,OU=Groups,DC=example,DC=local" /G "EXAMPLE\svc_secops_ad:RPWP;member;group"

문법 및 매개변수 스위치에 대한 자세한 내용은 dsacls에 대한 Microsoft 문서를 참조하세요.

통합 매개변수

Active Directory 통합에는 다음 매개변수가 필요합니다.

매개변수	설명
`Server`	필수 입력란입니다. Active Directory 서버의 호스트 이름, DNS 이름 또는 IP 주소입니다. 통합은 LDAP 프로토콜을 사용하여 통신합니다. 커스텀 포트를 사용하려면 주소에 추가합니다 (예: `mydomain.com:636`). 기본적으로 통합은 SSL/TLS가 사용 설정된 경우 포트 636을 사용하고 사용 중지된 경우 포트 389를 사용합니다.
`Username`	필수 입력란입니다. Active Directory에 연결할 사용자의 사용자 이름 또는 이메일 주소(예: `DOMAIN\username` 또는 `user@example.com`)입니다. 이 매개변수는 `userPrincipalName` 속성도 허용합니다.
`Password`	필수 입력란입니다. 사용자 계정의 비밀번호입니다.
`Domain`	필수 입력란입니다. 네트워크 네임스페이스 내 도메인의 전체 DNS 경로입니다. 도메인의 정규화된 도메인 이름(FQDN)을 `SUBDOMAIN.ROOT_DOMAIN` 형식으로 제공합니다. 예를 들어 내부 Active Directory 도메인이 `example.local`인 경우 입력할 FQDN은 `example.local`입니다. 내부 Active Directory 도메인이 `corp.example.com`인 경우 입력할 FQDN은 `corp.example.com`입니다.
`Custom Query Fields`	(선택사항) 쿼리에 포함할 커스텀 Active Directory 필드의 쉼표로 구분된 목록입니다(예: `customField1, customField2`).
`CA Certificate File - parsed into Base64 String`	(선택사항) CA 인증서를 구성할 때 가져온 base64 형식으로 인코딩된 CA 인증서 파일 문자열입니다. 전체 값을 입력합니다.
`Use SSL`	(선택사항) 선택하면 통합에서 Active Directory 디렉터리 서버에 연결할 때 SSL 인증서를 검증하고 보안 LDAPS (포트 636)를 사용합니다. 선택하지 않으면 표준 LDAP (포트 389)가 사용됩니다.
`Debug Logging`	(선택사항) 선택하면 통합에서 Active Directory 작업에 대한 자세한 디버그 정보를 로깅합니다.

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

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

작업

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

그룹에 사용자 추가

그룹에 사용자 추가 작업을 사용하여 케이스의 사용자를 하나 이상의 Active Directory 그룹에 추가합니다(예: 조사 중에 제한된 액세스 그룹에 계정 추가). 이 작업은 케이스에서 대상 사용자를 자동으로 식별하고 지정된 그룹에 추가합니다.

이 작업은 Google SecOps User 항목에서 실행됩니다.

작업 입력

그룹에 사용자 추가 작업에는 다음 매개변수가 필요합니다.

매개변수 설명

매개변수	설명
`Group Name`	필수 입력란입니다. 사용자를 추가할 그룹을 쉼표로 구분된 목록으로 나열합니다.

Group Name

필수 입력란입니다.

사용자를 추가할 그룹을 쉼표로 구분된 목록으로 나열합니다.

작업 출력

그룹에 사용자 추가 작업은 다음 출력을 제공합니다.

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

출력 메시지

그룹에 사용자 추가 작업은 다음 출력 메시지를 반환할 수 있습니다.

출력 메시지	메시지 설명
`Successfully added the following users to the group "GROUP_NAME" in Active Directory: ENTITY_ID` `The following users were already a part of the group "GROUP_NAME" in Active Directory: ENTITY_ID`	작업이 완료되었습니다.
`Action wasn't able to add the following users to the group "GROUP_NAME" in Active Directory: ENTITY_ID`	지정된 사용자에 대한 작업이 실패했습니다. 서비스 계정에 대상 그룹의 `member` 속성을 수정할 권한이 있는지 확인합니다.
`The following users were not found in Active Directory: ENTITY_ID`	지정된 사용자에 대한 작업이 실패했습니다. 사용자 계정이 Active Directory에 있고 항목 식별자가 유효한 사용자 이름 또는 이메일 주소와 일치하는지 확인합니다.
`The following groups were not found in Active Directory: GROUP_NAME`	지정된 그룹에 대한 작업이 실패했습니다. `Group Name` 매개변수에서 그룹 이름의 철자를 확인하고 구성된 도메인에 그룹이 있는지 확인합니다.
`No users were added to the group "GROUP_NAME" in Active Directory.`	지정된 그룹에 대한 작업이 실패했습니다. 대상 사용자가 Active Directory에 존재하고 서비스 계정에 지정된 그룹에 대한 쓰기 액세스 권한이 있는지 확인합니다.
`No users were added to the provided groups in Active Directory.`	작업이 실패했습니다. 케이스에 유효한 `User` 항목이 포함되어 있고 지정된 그룹이 Active Directory에 있는지 확인합니다.
`Error executing action "Add User To Group". Reason: ERROR_REASON`	작업이 실패했습니다. Active Directory 서버, 입력 매개변수 또는 서비스 계정 사용자 인증 정보에 대한 연결을 확인하세요.

스크립트 결과

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

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

호스트 OU 변경

호스트 OU 변경 작업을 사용하여 케이스의 컴퓨터를 Active Directory의 다른 조직 단위로 이동합니다. 예를 들어 손상된 머신을 제한된 정책이 있는 격리 OU로 이동합니다. 이 작업은 케이스에서 대상 컴퓨터를 자동으로 식별하고 지정된 대상 OU로 이동합니다.

이 작업은 Google SecOps Hostname 항목에서 실행됩니다.

작업 입력

호스트 조직 단위 변경 작업에는 다음 매개변수가 필요합니다.

매개변수 설명

매개변수	설명
`OU Name`	필수 입력란입니다. 새 호스트 OU의 이름입니다.

OU Name

필수 입력란입니다.

새 호스트 OU의 이름입니다.

작업 출력

호스트 OU 변경 작업은 다음 출력을 제공합니다.

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

출력 메시지

호스트 OU 변경 작업은 다음 출력 메시지를 반환할 수 있습니다.

출력 메시지	메시지 설명
`Changed OU for the following hosts: ENTITY_ID`	작업이 완료되었습니다.
`Failed to change OU for the following hosts : ENTITY_ID`	지정된 호스트에 대한 작업이 실패했습니다. 대상 OU가 있고 서비스 계정에 소스 OU와 대상 OU 간에 컴퓨터 객체를 이동할 수 있는 권한이 있는지 확인합니다.
`The following hosts were not found in Active Directory: ENTITY_ID`	지정된 호스트에 대한 작업이 실패했습니다. 컴퓨터 계정이 Active Directory에 존재하고 케이스의 `Hostname` 항목과 일치하는지 확인합니다.
`The action didn't change OU on any hosts.`	작업이 실패했습니다. 대상 컴퓨터와 대상 OU가 Active Directory에 있고 서비스 계정에 컴퓨터 계정을 이동할 권한이 있는지 확인합니다.
`Error executing action "Change Host OU". Reason: ERROR_REASON`	작업이 실패했습니다. Active Directory 서버, `OU Name` 매개변수 또는 서비스 계정 사용자 인증 정보에 대한 연결을 확인하세요.

스크립트 결과

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

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

사용자 OU 변경

사용자 OU 변경 작업을 사용하여 케이스의 사용자를 Active Directory의 다른 조직 단위로 이동합니다. 예를 들어 사고 또는 오프보딩 워크플로 중에 계정을 제한된 OU로 이동할 수 있습니다. 이 작업은 케이스에서 대상 사용자를 자동으로 식별하고 지정된 대상 OU로 이동합니다.

이 작업은 Google SecOps User 항목에서 실행됩니다.

작업 입력

사용자 OU 변경 작업에는 다음 매개변수가 필요합니다.

매개변수 설명

매개변수	설명
`OU Name`	필수 입력란입니다. 신규 사용자 OU의 이름입니다.

OU Name

필수 입력란입니다.

신규 사용자 OU의 이름입니다.

작업 출력

사용자 OU 변경 작업은 다음 출력을 제공합니다.

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

출력 메시지

사용자 OU 변경 작업은 다음 출력 메시지를 반환할 수 있습니다.

출력 메시지	메시지 설명
`Changed OU for the following users: ENTITY_ID`	작업이 완료되었습니다.
`Failed to change OU for the following users : ENTITY_ID`	지정된 사용자에 대한 작업이 실패했습니다. 대상 OU가 존재하고 서비스 계정에 소스 OU와 대상 OU 간에 사용자 객체를 이동할 수 있는 권한이 있는지 확인합니다.
`The following users were not found in Active Directory: ENTITY_ID`	지정된 사용자에 대한 작업이 실패했습니다. 사용자 계정이 Active Directory에 있고 케이스의 `User` 항목과 일치하는지 확인합니다.
`The action didn't change OU on any users.`	작업이 실패했습니다. 대상 사용자와 대상 OU가 Active Directory에 있고 서비스 계정에 사용자 계정을 이동할 권한이 있는지 확인합니다.
`Error executing action "Change User OU". Reason: ERROR_REASON`	작업이 실패했습니다. Active Directory 서버, `OU Name` 매개변수 또는 서비스 계정 사용자 인증 정보에 대한 연결을 확인하세요.

스크립트 결과

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

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

계정 사용 중지

계정 사용 중지 작업을 사용하여 Active Directory에서 사용자 계정을 비활성화합니다. 이 작업은 케이스에 연결된 사용자를 자동으로 타겟팅합니다.

이 작업은 Google SecOps User 항목에서 실행됩니다.

작업 입력

없음

작업 출력

계정 사용 중지 작업은 다음 출력을 제공합니다.

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

출력 메시지

계정 사용 중지 작업은 다음 출력 메시지를 반환할 수 있습니다.

출력 메시지	메시지 설명
`Disabled account for the following users: ENTITY_ID`	작업이 완료되었습니다.
`Failed to disable account for the following users: ENTITY_ID`	지정된 사용자에 대한 작업이 실패했습니다. 서비스 계정에 대상 사용자 계정의 `userAccountControl` 속성에 대한 읽기 및 쓰기 권한이 있고 사용자가 보호된 관리 계정이 아닌지 확인합니다.
`The following users were not found in Active Directory: ENTITY_ID`	지정된 사용자에 대한 작업이 실패했습니다. 사용자 계정이 Active Directory에 있고 케이스의 `User` 항목과 일치하는지 확인합니다.
`No users were disabled in Active Directory.`	작업이 실패했습니다. 케이스에 유효한 `User` 항목이 포함되어 있고 서비스 계정에 대상 계정을 사용 중지할 권한이 있는지 확인합니다.
`Error executing action "Disable Account". Reason: ERROR_REASON`	작업이 실패했습니다. Active Directory 서버 또는 서비스 계정 사용자 인증 정보에 대한 연결을 확인하세요.

스크립트 결과

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

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

컴퓨터 사용 중지

컴퓨터 사용 중지 작업을 사용하여 Active Directory에서 컴퓨터 계정을 비활성화하여 손상되거나 승인되지 않은 머신이 도메인에 인증되지 않도록 합니다. 이 작업은 케이스에 연결된 호스트 이름을 자동으로 타겟팅합니다.

이 작업은 Google SecOps Hostname 항목에서 실행됩니다.

작업 입력

없음

작업 출력

컴퓨터 사용 중지 작업은 다음 출력을 제공합니다.

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

출력 메시지

컴퓨터 사용 중지 작업은 다음 출력 메시지를 반환할 수 있습니다.

출력 메시지	메시지 설명
`Successfully disabled the following computers in Active Directory: ENTITY_ID` `The following computers were already disabled in Active Directory: ENTITY_ID`	작업이 완료되었습니다.
`Action wasn't able to disable the following computers in Active Directory: ENTITY_ID`	지정된 컴퓨터에서 작업이 실패했습니다. 서비스 계정에 대상 컴퓨터 객체의 `userAccountControl` 속성에 대한 읽기 및 쓰기 권한이 있는지 확인합니다.
`The following computers were not found in Active Directory: ENTITY_ID`	지정된 컴퓨터에서 작업이 실패했습니다. 컴퓨터 계정이 Active Directory에 존재하고 케이스의 `Hostname` 항목과 일치하는지 확인합니다.
`No computers were disabled in Active Directory.`	작업이 실패했습니다. 케이스에 유효한 `Hostname` 항목이 포함되어 있고 서비스 계정에 대상 컴퓨터 계정을 사용 중지할 권한이 있는지 확인합니다.
`Error executing action "Disable Computer". Reason: ERROR_REASON`	작업이 실패했습니다. Active Directory 서버 또는 서비스 계정 사용자 인증 정보에 대한 연결을 확인하세요.

스크립트 결과

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

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

계정 사용 설정

계정 사용 설정 작업을 사용하여 Active Directory에서 사용 중지된 사용자 계정을 다시 사용 설정합니다. 이 작업은 케이스에 연결된 사용자를 자동으로 타겟팅합니다.

이 작업은 Google SecOps User 항목에서 실행됩니다.

작업 입력

없음

작업 출력

계정 사용 설정 작업은 다음 출력을 제공합니다.

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

출력 메시지

계정 사용 설정 작업은 다음 출력 메시지를 반환할 수 있습니다.

출력 메시지	메시지 설명
`Successfully enabled the following users in Active Directory: ENTITY_ID` `The following users were already enabled in Active Directory: ENTITY_ID`	작업이 완료되었습니다.
`Action wasn't able to enable the following users in Active Directory: ENTITY_ID`	지정된 사용자에 대한 작업이 실패했습니다. 서비스 계정에 대상 사용자 계정의 `userAccountControl` 속성에 대한 읽기 및 쓰기 권한이 있는지 확인합니다.
`The following users were not found in Active Directory: ENTITY_ID`	지정된 사용자에 대한 작업이 실패했습니다. 사용자 계정이 Active Directory에 있고 케이스의 `User` 항목과 일치하는지 확인합니다.
`No users were enabled in Active Directory.`	작업이 실패했습니다. 케이스에 유효한 `User` 항목이 포함되어 있고 서비스 계정에 대상 계정을 사용 설정할 권한이 있는지 확인합니다.
`Error executing action "Enable Account". Reason: ERROR_REASON`	작업이 실패했습니다. Active Directory 서버 또는 서비스 계정 사용자 인증 정보에 대한 연결을 확인하세요.

스크립트 결과

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

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

컴퓨터 사용 설정

컴퓨터 사용 설정 작업을 사용하여 Active Directory에서 사용 중지된 컴퓨터 계정을 다시 사용 설정하면 머신이 도메인에 다시 인증할 수 있습니다. 이 작업은 케이스에 연결된 호스트 이름을 자동으로 타겟팅합니다.

이 작업은 Google SecOps Hostname 항목에서 실행됩니다.

작업 입력

없음

작업 출력

컴퓨터 사용 설정 작업은 다음 출력을 제공합니다.

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

출력 메시지

컴퓨터 사용 설정 작업은 다음 출력 메시지를 반환할 수 있습니다.

출력 메시지	메시지 설명
`Successfully enabled the following computers in Active Directory: ENTITY_ID` `The following computers were already enabled in Active Directory: ENTITY_ID`	작업이 완료되었습니다.
`Action wasn't able to enable the following computers in Active Directory: ENTITY_ID`	지정된 컴퓨터에서 작업이 실패했습니다. 서비스 계정에 대상 컴퓨터 객체의 `userAccountControl` 속성에 대한 읽기 및 쓰기 권한이 있는지 확인합니다.
`The following computers were not found in Active Directory: ENTITY_ID`	지정된 컴퓨터에서 작업이 실패했습니다. 컴퓨터 계정이 Active Directory에 존재하고 케이스의 `Hostname` 항목과 일치하는지 확인합니다.
`No computers were enabled in Active Directory.`	작업이 실패했습니다. 케이스에 유효한 `Hostname` 항목이 포함되어 있고 서비스 계정에 대상 컴퓨터 계정을 사용 설정할 수 있는 권한이 있는지 확인합니다.
`Error executing action "Enable Computer". Reason: ERROR_REASON`	작업이 실패했습니다. Active Directory 서버 또는 서비스 계정 사용자 인증 정보에 대한 연결을 확인하세요.

스크립트 결과

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

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

항목 보강

항목 보강 작업을 사용하여 케이스의 사용자 및 컴퓨터에 대한 Active Directory 프로필 세부정보, 계정 상태, 그룹 멤버십을 검색합니다. 사용 가능한 모든 디렉터리 정보로 항목을 보강하거나 결과 및 케이스 월 테이블을 특정 속성으로 제한할 수 있습니다.

이 작업은 비동기식입니다. 필요한 경우 Google SecOps IDE에서 작업의 스크립트 제한 시간 값을 조정합니다.

항목 보강 작업은 다음 Google SecOps 항목에서 실행됩니다.

User
Hostname

작업 입력

항목 보강 작업에는 다음 매개변수가 필요합니다.

매개변수	설명
`Mark Entities as Internal`	(선택사항) 선택하면 작업이 보강된 항목을 내부 항목으로 자동 표시합니다. 기본적으로 사용 설정됩니다.
`Create Case Wall Table`	(선택사항) 선택하면 작업에서 각 보강된 항목에 대해 검색된 Active Directory 속성이 포함된 케이스 월 테이블을 생성합니다. 기본적으로 사용 설정됩니다.
`Specific Attribute Names To Enrich With`	(선택사항) 항목을 보강할 속성 이름의 쉼표로 구분된 목록입니다. 값을 제공하지 않으면 작업은 사용 가능한 모든 속성으로 항목을 보강합니다. 속성에 여러 값이 포함된 경우 작업은 사용 가능한 모든 값으로 속성을 보강합니다. 이 매개변수는 대소문자를 구분합니다.
`Should Case Wall Table be filtered by the specified Attributes?`	(선택사항) 선택하면 작업이 `Specific Attribute Names To Enrich With`에 지정된 속성으로만 케이스 월 테이블을 채웁니다.
`Should JSON result be filtered by the specified Attributes?`	(선택사항) 선택하면 JSON 결과는 `Specific Attribute Names To Enrich With`에 지정된 속성만 반환합니다.

작업 출력

항목 보강 작업은 다음 출력을 제공합니다.

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

케이스 월 테이블

항목 보강 작업은 Create Case Wall Table를 선택하면 케이스 월에 다음 표를 제공합니다.

테이블 이름: Report for: <var class="readonly">ENTITY_ID</var>
열: 항목에 대해 검색된 Active Directory 속성 이름 및 값 (또는 Should Case Wall Table be filtered by the specified Attributes?가 선택된 경우 Specific Attribute Names To Enrich With 매개변수로 필터링됨)

항목 보강

항목 보강 작업은 다음 항목 보강을 지원합니다.

보강 필드 이름	로직
`AD_primaryGroupID`	이 작업은 JSON 결과에 값이 있는 경우 값을 반환합니다.
`AD_logonCount`	이 작업은 JSON 결과에 값이 있는 경우 값을 반환합니다.
`AD_cn`	이 작업은 JSON 결과에 값이 있는 경우 값을 반환합니다.
`AD_countryCode`	이 작업은 JSON 결과에 값이 있는 경우 값을 반환합니다.
`AD_objectClass`	이 작업은 JSON 결과에 값이 있는 경우 값을 반환합니다.
`AD_userPrincipalName`	이 작업은 JSON 결과에 값이 있는 경우 값을 반환합니다.
`AD_adminCount`	이 작업은 JSON 결과에 값이 있는 경우 값을 반환합니다.
`AD_lastLogonTimestamp`	이 작업은 JSON 결과에 값이 있는 경우 값을 반환합니다.
`AD_manager`	이 작업은 JSON 결과에 값이 있는 경우 값을 반환합니다.
`AD_instanceType`	이 작업은 JSON 결과에 값이 있는 경우 값을 반환합니다.
`AD_distinguishedName`	이 작업은 JSON 결과에 값이 있는 경우 값을 반환합니다.
`AD_dSCorePropagationData`	이 작업은 JSON 결과에 값이 있는 경우 값을 반환합니다.
`AD_msDS-SupportedEncryptionTypes`	이 작업은 JSON 결과에 값이 있는 경우 값을 반환합니다.
`AD_objectSid`	이 작업은 JSON 결과에 값이 있는 경우 값을 반환합니다.
`AD_whenCreated`	이 작업은 JSON 결과에 값이 있는 경우 값을 반환합니다.
`AD_uSNCreated`	이 작업은 JSON 결과에 값이 있는 경우 값을 반환합니다.
`AD_lockoutTime`	이 작업은 JSON 결과에 값이 있는 경우 값을 반환합니다.
`AD_badPasswordTime`	이 작업은 JSON 결과에 값이 있는 경우 값을 반환합니다.
`AD_pwdLastSet`	이 작업은 JSON 결과에 값이 있는 경우 값을 반환합니다.
`AD_sAMAccountName`	이 작업은 JSON 결과에 값이 있는 경우 값을 반환합니다.
`AD_objectCategory`	이 작업은 JSON 결과에 값이 있는 경우 값을 반환합니다.
`AD_lastLogon`	이 작업은 JSON 결과에 값이 있는 경우 값을 반환합니다.
`AD_objectGUID`	이 작업은 JSON 결과에 값이 있는 경우 값을 반환합니다.
`AD_whenChanged`	이 작업은 JSON 결과에 값이 있는 경우 값을 반환합니다.
`AD_badPwdCount`	이 작업은 JSON 결과에 값이 있는 경우 값을 반환합니다.
`AD_accountExpires`	이 작업은 JSON 결과에 값이 있는 경우 값을 반환합니다.
`AD_displayName`	이 작업은 JSON 결과에 값이 있는 경우 값을 반환합니다.
`AD_name`	이 작업은 JSON 결과에 값이 있는 경우 값을 반환합니다.
`AD_memberOf`	이 작업은 JSON 결과에 값이 있는 경우 값을 반환합니다.
`AD_codePage`	이 작업은 JSON 결과에 값이 있는 경우 값을 반환합니다.
`AD_userAccountControl`	이 작업은 JSON 결과에 값이 있는 경우 값을 반환합니다.
`AD_sAMAccountType`	이 작업은 JSON 결과에 값이 있는 경우 값을 반환합니다.
`AD_uSNChanged`	이 작업은 JSON 결과에 값이 있는 경우 값을 반환합니다.
`AD_sn`	이 작업은 JSON 결과에 값이 있는 경우 값을 반환합니다.
`AD_givenName`	이 작업은 JSON 결과에 값이 있는 경우 값을 반환합니다.
`AD_lastLogoff`	이 작업은 JSON 결과에 값이 있는 경우 값을 반환합니다.

JSON 결과

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

[
    {
        "EntityResult": {
            "primaryGroupID": [513],
            "logonCount": [6505],
            "cn": ["user name"],
            "countryCode": [0],
            "objectClass": ["top", "person", "organizationalPerson"],
            "userPrincipalName": ["user@example.com"],
            "adminCount": [1],
            "lastLogonTimestamp": ["2019-01-09 08:42:03.540783+00:00"],
            "manager": ["CN=user name,OU=R&D,OU=TLV,OU=host name,DC=domain,DC=LOCAL"],
            "instanceType": [4],
            "distinguishedName": ["CN=user name,OU=R&D,OU=TLV,OU=host,DC=domain,DC=LOCAL"],
            "dSCorePropagationData": ["2019-01-14 14:39:16+00:00"],
            "msDS-SupportedEncryptionTypes": [0],
            "objectSid": ["ID"],
            "whenCreated": ["2011-11-07 08:00:44+00:00"],
            "uSNCreated": [7288202],
            "lockoutTime": ["1601-01-01 00:00:00+00:00"],
            "badPasswordTime": ["date"],
            "pwdLastSet": ["date"],
            "sAMAccountName": ["example"],
            "objectCategory": ["CN=Person,CN=Schema,CN=Configuration,DC=host,DC=LOCAL"],
            "lastLogon": ["2019-01-14 17:13:54.463070+00:00"],
            "objectGUID": ["GUID"],
            "whenChanged": ["2019-01-14 16:49:01+00:00"],
            "badPwdCount": [1],
            "accountExpires": ["9999-12-31 23:59:59.999999"],
            "displayName": ["example user"],
            "name": ["user"],
            "memberOf": ["CN=\\\\u05e7\\\\u05d1\\\\u05d5\\\\u05e6\\\\u05d4 \\\\u05d1\\\\u05e2\\\\u05d1\\\\u05e8\\\\u05d9\\\\u05ea,OU=TEST,OU=QA,OU=IT,OU=TLV,OU=host,DC=domain,DC=LOCAL", "CN=Organization Management,OU=Microsoft Exchange Security Groups,DC=domain,DC=LOCAL", "CN=Local Admin,OU=Groups,OU=IT,OU=TLV,OU=host,DC=domain,DC=LOCAL"],
            "codePage": [0],
            "userAccountControl": [111],
            "sAMAccountType": [805306368],
            "uSNChanged": [15301168],
            "sn": ["example"],
            "givenName": ["user"],
            "lastLogoff": ["1601-01-01 00:00:00+00:00"]
        },
        "Entity": "user@example.com"
    }
]

출력 메시지

항목 보강 작업은 다음 출력 메시지를 반환할 수 있습니다.

출력 메시지	메시지 설명
`Active Directory Permalink: SERVER` `Enriched the following Users ENTITY_ID` `Enriched the following Hosts ENTITY_ID` `All entities were enriched.`	작업이 완료되었습니다.
`The following entities were not found in Active Directory: ENTITY_ID`	지정된 항목에 대한 작업이 실패했습니다. 사용자 또는 호스트 계정이 Active Directory에 존재하고 케이스의 엔티티 식별자와 일치하는지 확인합니다.
`Failed to enrich the following Users ENTITY_ID`	지정된 사용자에 대한 작업이 실패했습니다. 서비스 계정에 대상 사용자 계정의 속성(`userAccountControl` 포함)을 읽을 수 있는 권한이 있는지 확인하고 Active Directory에 맞춤 속성이 있는지 확인합니다.
`Failed to enrich the following Hosts ENTITY_ID`	지정된 호스트에 대한 작업이 실패했습니다. 서비스 계정에 대상 컴퓨터 계정의 속성(`userAccountControl` 포함)을 읽을 수 있는 권한이 있는지 확인하고 Active Directory에 맞춤 속성이 있는지 확인합니다.
`No entities were enriched.`	작업이 실패했습니다. 케이스에 Active Directory에 있는 유효한 `User` 또는 `Hostname` 항목이 포함되어 있는지 확인합니다.
`Error executing action "Enrich Entities". Reason: ERROR_REASON`	작업이 실패했습니다. Active Directory 서버, 맞춤 쿼리 필드 또는 서비스 계정 사용자 인증 정보에 대한 연결을 확인하세요.

스크립트 결과

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

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

비밀번호 강제 업데이트

비밀번호 업데이트 강제 적용 작업을 사용하여 사용자가 다음에 로그인할 때 비밀번호를 변경하도록 요구합니다. 이 작업은 케이스에 연결된 사용자를 자동으로 타겟팅합니다.

이 작업은 Google SecOps User 항목에서 실행됩니다.

작업 입력

없음

작업 출력

비밀번호 업데이트 강제 적용 작업은 다음 출력을 제공합니다.

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

출력 메시지

비밀번호 업데이트 강제 적용 작업은 다음 출력 메시지를 반환할 수 있습니다.

출력 메시지	메시지 설명
`Forced password update on next logon for the following users: ENTITY_ID`	작업이 완료되었습니다.
`Failed to force password update on next logon for the following users: ENTITY_ID`	지정된 사용자에 대한 작업이 실패했습니다. 서비스 계정에 대상 사용자 계정의 `pwdLastSet` 속성에 대한 읽기 및 쓰기 권한이 있는지 확인합니다.
`The following users were not found in Active Directory: ENTITY_ID`	지정된 사용자에 대한 작업이 실패했습니다. 사용자 계정이 Active Directory에 있고 케이스의 `User` 항목과 일치하는지 확인합니다.
`Password update wasn't forced on any users.`	작업이 실패했습니다. 케이스에 유효한 `User` 항목이 포함되어 있고 서비스 계정에 비밀번호 만료 설정을 업데이트할 권한이 있는지 확인합니다.
`Error executing action "Force Password Update". Reason: ERROR_REASON`	작업이 실패했습니다. Active Directory 서버 또는 서비스 계정 사용자 인증 정보에 대한 연결을 확인하세요.

스크립트 결과

다음 표에는 비밀번호 업데이트 강제 적용 작업을 사용할 때의 스크립트 결과 출력 값이 나와 있습니다.

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

그룹 구성원 가져오기

그룹 구성원 가져오기 작업을 사용하여 특정 Active Directory 그룹에 속한 사용자, 컴퓨터 또는 둘 다를 나열합니다. 원하는 경우 검색 범위를 특정 조직 단위 또는 상위 그룹으로 좁히고 중첩된 하위 그룹의 구성원을 포함할 수 있습니다.

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

작업 입력

그룹 구성원 가져오기 작업에는 다음 매개변수가 필요합니다.

매개변수	설명
`Group Name`	필수 입력란입니다. 나열된 구성원이 포함된 그룹의 이름입니다.
`Members Type`	필수 입력란입니다. 그룹에서 검색할 구성원 유형입니다. 가능한 값은 다음과 같습니다. `Only Users` `Only Hosts` `Both` 기본값은 `Only Users`입니다.
`Where To Search`	필수 입력란입니다. 검색 범위를 지정할 특정 `Organizational Unit` 또는 `Group` 가능한 값은 다음과 같습니다. `Select Option` `Organizational Unit` `Group` 기본값은 `Select Option`입니다.
`Filter Object Value`	(선택사항) 작업이 대상 그룹을 검색하는 `Organizational Unit` 또는 `Group`의 이름입니다. `Where To Search`가 `Organizational Unit` 또는 `Group`로 설정된 경우 이 매개변수가 필요합니다.
`Perform Nested Search`	(선택사항) 선택하면 이 작업은 대상 그룹에 속한 중첩된 하위 그룹에서 구성원을 검색합니다.
`Limit`	(선택사항) Active Directory에서 검색할 최대 등록정보 수입니다. 기본값은 `100`입니다.

작업 출력

그룹 구성원 가져오기 작업은 다음 출력을 제공합니다.

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

케이스 월 테이블

그룹 구성원 가져오기 작업은 케이스 월에 다음 표를 제공합니다.

테이블 이름: Members of Active Directory group: <var class="readonly">GROUP_NAME</var>
열:
- Distinguished Name
- SAM Account Name
- User Principal Name
- Type

JSON 결과

다음 예시는 그룹 구성원 가져오기 작업을 사용할 때 수신되는 JSON 결과 출력을 보여줍니다.

[
  {
    "dn": "CN=Example User1,OU=User Accounts,DC=example,DC=local",
    "sAMAccountName": "ExampleUser1",
    "userPrincipalName": "user1@example.local",
    "type": "CN=Person,CN=Schema,CN=Configuration,DC=example,DC=local"
  },
  {
    "dn": "CN=Example User2,CN=Users,DC=example,DC=local",
    "sAMAccountName": "ExampleUser2",
    "userPrincipalName": "user2@example.local",
    "type": "CN=Person,CN=Schema,CN=Configuration,DC=example,DC=local"
  }
]

출력 메시지

그룹 구성원 가져오기 작업은 다음 출력 메시지를 반환할 수 있습니다.

출력 메시지	메시지 설명
`Successfully retrieved members of the group "GROUP_NAME" from Active Directory.` `Group "GROUP_NAME" doesn't contain any members matching search criteria in Active Directory.`	작업이 완료되었습니다.
`Error executing action "Get Group Members". Reason: Filter Object Value should be provided`	작업이 실패했습니다. `Where To Search`가 `Organizational Unit` 또는 `Group`로 설정된 경우 `Filter Object Value` 매개변수에 유효한 OU 또는 그룹 이름을 입력하세요.
`Error executing action "Get Group Members". Reason: Given value for Limit should be a positive number.`	작업이 실패했습니다. `Limit` 매개변수에 `0`보다 큰 정수를 입력하세요.
`Error executing action "Get Group Members". Reason: Given group doesn't exist in Active Directory.`	작업이 실패했습니다. `Group Name` 매개변수에서 그룹 이름을 확인하고 구성된 검색 범위 내에 그룹이 있는지 확인합니다.
`Error executing action "Get Group Members". Reason: Specified Organizational Unit doesn't exist in Active Directory.`	작업이 실패했습니다. `Filter Object Value`에 지정된 조직 단위가 Active Directory에 있는지 확인합니다.
`Error executing action "Get Group Members". Reason: Specified Group in "Filter Object Value" doesn't exist in Active Directory.`	작업이 실패했습니다. `Filter Object Value`에 지정된 상위 그룹이 Active Directory에 있는지 확인합니다.
`Error executing action "Get Group Members". Reason: ERROR_REASON`	작업이 실패했습니다. Active Directory 서버, 입력 매개변수 또는 서비스 계정 사용자 인증 정보에 대한 연결을 확인하세요.

스크립트 결과

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

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

관리자 연락처 정보 가져오기

관리자 연락처 세부정보 가져오기 작업을 사용하여 Active Directory에서 사용자의 관리자를 조회하고 관리자의 연락처 정보를 검색합니다. 이 작업은 케이스에 연결된 사용자를 자동으로 타겟팅합니다.

이 작업은 Google SecOps User 항목에서 실행됩니다.

작업 입력

없음

작업 출력

관리자 연락처 세부정보 가져오기 작업은 다음 출력을 제공합니다.

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

케이스 월 테이블

관리자 연락처 세부정보 가져오기 작업은 케이스 벽에 다음 표를 제공합니다.

테이블 이름: Manager Contact: <var class="readonly">ENTITY_ID</var>
열:
- Manager Name
- Manager Phone

항목 보강

관리자 연락처 세부정보 가져오기 작업은 다음 항목 보강을 지원합니다.

보강 필드 이름	로직
`AD_Manager_Name`	이 작업은 JSON 결과에 값이 있는 경우 값을 반환합니다.
`AD_Manager_phone`	이 작업은 JSON 결과에 값이 있는 경우 값을 반환합니다.
`AD_primaryGroupID`	이 작업은 JSON 결과에 값이 있는 경우 값을 반환합니다.
`AD_logonCount`	이 작업은 JSON 결과에 값이 있는 경우 값을 반환합니다.
`AD_cn`	이 작업은 JSON 결과에 값이 있는 경우 값을 반환합니다.
`AD_countryCode`	이 작업은 JSON 결과에 값이 있는 경우 값을 반환합니다.
`AD_objectClass`	이 작업은 JSON 결과에 값이 있는 경우 값을 반환합니다.
`AD_userPrincipalName`	이 작업은 JSON 결과에 값이 있는 경우 값을 반환합니다.
`AD_adminCount`	이 작업은 JSON 결과에 값이 있는 경우 값을 반환합니다.
`AD_lastLogonTimestamp`	이 작업은 JSON 결과에 값이 있는 경우 값을 반환합니다.
`AD_manager`	이 작업은 JSON 결과에 값이 있는 경우 값을 반환합니다.
`AD_instanceType`	이 작업은 JSON 결과에 값이 있는 경우 값을 반환합니다.
`AD_distinguishedName`	이 작업은 JSON 결과에 값이 있는 경우 값을 반환합니다.
`AD_dSCorePropagationData`	이 작업은 JSON 결과에 값이 있는 경우 값을 반환합니다.
`AD_msDS-SupportedEncryptionTypes`	이 작업은 JSON 결과에 값이 있는 경우 값을 반환합니다.
`AD_objectSid`	이 작업은 JSON 결과에 값이 있는 경우 값을 반환합니다.
`AD_whenCreated`	이 작업은 JSON 결과에 값이 있는 경우 값을 반환합니다.
`AD_uSNCreated`	이 작업은 JSON 결과에 값이 있는 경우 값을 반환합니다.
`AD_lockoutTime`	이 작업은 JSON 결과에 값이 있는 경우 값을 반환합니다.
`AD_badPasswordTime`	이 작업은 JSON 결과에 값이 있는 경우 값을 반환합니다.
`AD_pwdLastSet`	이 작업은 JSON 결과에 값이 있는 경우 값을 반환합니다.
`AD_sAMAccountName`	이 작업은 JSON 결과에 값이 있는 경우 값을 반환합니다.
`AD_objectCategory`	이 작업은 JSON 결과에 값이 있는 경우 값을 반환합니다.
`AD_lastLogon`	이 작업은 JSON 결과에 값이 있는 경우 값을 반환합니다.
`AD_objectGUID`	이 작업은 JSON 결과에 값이 있는 경우 값을 반환합니다.
`AD_whenChanged`	이 작업은 JSON 결과에 값이 있는 경우 값을 반환합니다.
`AD_badPwdCount`	이 작업은 JSON 결과에 값이 있는 경우 값을 반환합니다.
`AD_accountExpires`	이 작업은 JSON 결과에 값이 있는 경우 값을 반환합니다.
`AD_displayName`	이 작업은 JSON 결과에 값이 있는 경우 값을 반환합니다.
`AD_name`	이 작업은 JSON 결과에 값이 있는 경우 값을 반환합니다.
`AD_memberOf`	이 작업은 JSON 결과에 값이 있는 경우 값을 반환합니다.
`AD_codePage`	이 작업은 JSON 결과에 값이 있는 경우 값을 반환합니다.
`AD_userAccountControl`	이 작업은 JSON 결과에 값이 있는 경우 값을 반환합니다.
`AD_sAMAccountType`	이 작업은 JSON 결과에 값이 있는 경우 값을 반환합니다.
`AD_uSNChanged`	이 작업은 JSON 결과에 값이 있는 경우 값을 반환합니다.
`AD_sn`	이 작업은 JSON 결과에 값이 있는 경우 값을 반환합니다.
`AD_givenName`	이 작업은 JSON 결과에 값이 있는 경우 값을 반환합니다.
`AD_lastLogoff`	이 작업은 JSON 결과에 값이 있는 경우 값을 반환합니다.

JSON 결과

다음 예시는 관리자 연락처 세부정보 가져오기 작업을 사용할 때 수신되는 JSON 결과 출력을 보여줍니다.

[
   {
        "EntityResult":
        {
            "primaryGroupID": [513],
            "logonCount": [6505],
            "cn": ["user name"],
            "countryCode": [0],
            "objectClass": ["top", "person", "organizationalPerson"],
            "userPrincipalName": ["user@example.com"],
            "adminCount": [1],
            "lastLogonTimestamp": ["2019-01-09 08:42:03.540783+00:00"],
            "manager": ["CN=user name,OU=R&D,OU=TLV,OU=host name,DC=domain,DC=LOCAL"],
            "instanceType": [4],
            "distinguishedName": ["CN=user name,OU=R&D,OU=TLV,OU=host,DC=domain,DC=LOCAL"],
            "dSCorePropagationData": ["2019-01-14 14:39:16+00:00"],
            "msDS-SupportedEncryptionTypes": [0],
            "objectSid": ["ID"],
            "whenCreated": ["2011-11-07 08:00:44+00:00"],
            "uSNCreated": [7288202],
            "lockoutTime": ["1601-01-01 00:00:00+00:00"],
            "badPasswordTime": ["date"],
            "pwdLastSet": ["date"],
            "sAMAccountName": ["example"],
            "objectCategory": ["CN=Person,CN=Schema,CN=Configuration,DC=host,DC=LOCAL"],
            "lastLogon": ["2019-01-14 17:13:54.463070+00:00"],
            "objectGUID": ["GUID"],
            "whenChanged": ["2019-01-14 16:49:01+00:00"],
            "badPwdCount": [1],
            "accountExpires": ["9999-12-31 23:59:59.999999"],
            "displayName": ["example"],
            "name": ["user"],
            "memberOf": ["CN=\\\\u05e7\\\\u05d1\\\\u05d5\\\\u05e6\\\\u05d4 \\\\u05d1\\\\u05e2\\\\u05d1\\\\u05e8\\\\u05d9\\\\u05ea,OU=TEST,OU=QA,OU=IT,OU=TLV,OU=host,DC=domain,DC=LOCAL", "CN=Organization Management,OU=Microsoft Exchange Security Groups,DC=domain,DC=LOCAL", "CN=Local Admin,OU=Groups,OU=IT,OU=TLV,OU=host,DC=domain,DC=LOCAL"],
            "codePage": [0],
            "userAccountControl": [111],
            "sAMAccountType": [805306368],
            "uSNChanged": [15301168],
            "sn": ["example"],
            "givenName": ["user"],
            "lastLogoff": ["1601-01-01 00:00:00+00:00"]
        },
        "Entity": "user@example.com"
    }
]

출력 메시지

관리자 연락처 세부정보 가져오기 작업은 다음 출력 메시지를 반환할 수 있습니다.

출력 메시지	메시지 설명
`Retrieved manager details for the following users: ENTITY_ID`	작업이 완료되었습니다.
`The following users don't have managers specified in Active Directory: ENTITY_ID`	지정된 사용자에 대한 작업이 실패했습니다. Active Directory의 대상 사용자 계정에 `manager` 속성이 채워져 있는지 확인합니다.
`Failed to retrieve manager details for the following users: ENTITY_ID`	지정된 사용자에 대한 작업이 실패했습니다. 서비스 계정에 Active Directory에서 `manager` 속성과 관리자의 사용자 프로필을 읽을 수 있는 권한이 있는지 확인합니다.
`The following users were not found in Active Directory: ENTITY_ID`	지정된 사용자에 대한 작업이 실패했습니다. 사용자 계정이 Active Directory에 있고 케이스의 `User` 항목과 일치하는지 확인합니다.
`No manager details were retrieved for the provided users.`	작업이 실패했습니다. 케이스에 Active Directory에서 관리자가 할당된 유효한 `User` 항목이 포함되어 있는지 확인합니다.
`Error executing action "Get Manager Contact Details". Reason: ERROR_REASON`	작업이 실패했습니다. Active Directory 서버 또는 서비스 계정 사용자 인증 정보에 대한 연결을 확인하세요.

스크립트 결과

다음 표에는 관리자 연락처 세부정보 가져오기 작업을 사용할 때 스크립트 결과 출력 값이 나와 있습니다.

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

사용자가 그룹에 있는지 확인

Is User In Group 작업을 사용하여 특정 사용자가 지정된 Active Directory 그룹에 속하는지 확인합니다. 기본적으로 이 작업은 케이스의 User 항목을 확인합니다. 또는 User Name 매개변수에 쉼표로 구분된 사용자 이름 목록을 입력하여 특정 계정을 직접 확인할 수 있습니다.

이 작업은 Google SecOps User 항목에서 실행됩니다.

작업 입력

사용자가 그룹에 속함 작업에는 다음 매개변수가 필요합니다.

매개변수	설명
`Group Name`	필수 입력란입니다. 확인할 그룹 이름입니다(예: `administrators`).
`User Name`	(선택사항) 확인할 사용자 이름을 쉼표로 구분한 목록입니다. 값을 제공하지 않으면 작업은 케이스의 `User` 항목을 확인합니다.
`Where To Search`	필수 입력란입니다. 검색 범위를 지정할 특정 `Organizational Unit` 또는 `Group`입니다. 가능한 값은 다음과 같습니다. `Select Option` `Organizational Unit` `Group` 기본값은 `Select Option`입니다.
`Filter Object Value`	(선택사항) 작업이 대상 그룹을 검색하는 `Organizational Unit` 또는 `Group`의 이름입니다. `Where To Search`가 `Organizational Unit` 또는 `Group`로 설정된 경우 이 매개변수는 필수입니다.
`Search In Subgroups`	(선택사항) 선택하면 작업이 중첩된 하위 그룹 내에서 재귀적으로 검색합니다.

작업 출력

Is User In Group 작업은 다음 출력을 제공합니다.

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

JSON 결과

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

[
    {
        "EntityResult": true,
        "Entity": "USER1@EXAMPLE.COM"
    }, {
        "EntityResult": false,
        "Entity": "USER2@EXAMPLE.COM"
    }, {
        "EntityResult": true,
        "Entity": "USER3@EXAMPLE.COM"
    }
]

출력 메시지

Is User In Group 작업은 다음 출력 메시지를 반환할 수 있습니다.

출력 메시지	메시지 설명
`USER_NAME IN GROUP_NAME;` `USER_NAME NOT in GROUP_NAME;`	작업이 완료되었습니다.
`The following users were not found in Active Directory: USER_NAME`	지정된 사용자에 대한 작업이 실패했습니다. 사용자 이름 또는 `User` 항목이 Active Directory에 있는지 확인합니다.
`None of the provided users were found in Active Directory.`	작업이 실패했습니다. 케이스에 유효한 `User` 항목이 포함되어 있는지 또는 `User Name` 매개변수에 지정된 사용자 이름이 Active Directory에 있는지 확인합니다.
`Error executing action "Is User In Group". Reason: Filter Object Value should be provided`	작업이 실패했습니다. `Where To Search`가 `Organizational Unit` 또는 `Group`로 설정된 경우 `Filter Object Value` 매개변수에 유효한 OU 또는 그룹 이름을 입력하세요.
`Error executing action "Is User In Group". Reason: Given group doesn't exist in Active Directory.`	작업이 실패했습니다. `Group Name` 매개변수에서 그룹 이름을 확인하고 구성된 검색 범위 내에 그룹이 있는지 확인합니다.
`Error executing action "Is User In Group". Reason: Specified Organizational Unit doesn't exist in Active Directory.`	작업이 실패했습니다. `Filter Object Value`에 지정된 조직 단위가 Active Directory에 있는지 확인합니다.
`Error executing action "Is User In Group". Reason: Specified Group in "Filter Object Value" doesn't exist in Active Directory.`	작업이 실패했습니다. `Filter Object Value`에 지정된 상위 그룹이 Active Directory에 있는지 확인합니다.
`Error executing action "Is User In Group". Reason: ERROR_REASON`	작업이 실패했습니다. Active Directory 서버, 입력 매개변수 또는 서비스 계정 사용자 인증 정보에 대한 연결을 확인하세요.

스크립트 결과

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

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

사용자 그룹 나열

사용자 그룹 나열 작업을 사용하여 사용자가 속한 모든 Active Directory 그룹 목록을 검색합니다. 이 작업은 케이스에 연결된 사용자를 자동으로 타겟팅합니다.

이 작업은 Google SecOps User 항목에서 실행됩니다.

작업 입력

없음

작업 출력

사용자 그룹 나열 작업은 다음 출력을 제공합니다.

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

JSON 결과

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

[
    {
        "EntityResult": ["Domain Users"],
        "Entity": "user@example.com"
    }
]

출력 메시지

사용자 그룹 나열 작업은 다음 출력 메시지를 반환할 수 있습니다.

출력 메시지	메시지 설명
`Groups were listed for the following users: ENTITY_ID`	작업이 완료되었습니다.
`No groups were found for the following users: ENTITY_ID`	지정된 사용자에 대한 작업이 실패했습니다. 사용자 계정이 Active Directory의 `memberOf` 속성에 있는 하나 이상의 명시적 그룹에 할당되어 있는지 확인합니다.
`Failed to list groups for the following users: ENTITY_ID`	지정된 사용자에 대한 작업이 실패했습니다. 서비스 계정에 대상 사용자 계정의 `memberOf` 속성을 읽을 수 있는 권한이 있는지 확인합니다.
`The following users were not found in Active Directory: ENTITY_ID`	지정된 사용자에 대한 작업이 실패했습니다. 사용자 계정이 Active Directory에 있고 케이스의 `User` 항목과 일치하는지 확인합니다.
`No groups were listed.`	작업이 실패했습니다. 케이스에 Active Directory의 그룹에 속하는 유효한 `User` 항목이 포함되어 있는지 확인합니다.
`Error executing action "List User Groups". Reason: ERROR_REASON`	작업이 실패했습니다. Active Directory 서버 또는 서비스 계정 사용자 인증 정보에 대한 연결을 확인하세요.

스크립트 결과

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

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

핑

핑 작업을 사용하여 Google SecOps가 구성된 통합 설정을 사용하여 Active Directory 디렉터리 서버에 연결하고 인증할 수 있는지 확인합니다.

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

작업 입력

없음

작업 출력

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

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

출력 메시지

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

출력 메시지 메시지 설명

Connected successfully. 작업이 완료되었습니다.

Error executing action "Ping". Reason:
      ERROR_REASON

작업이 실패했습니다.

통합 구성에서 서버 주소, 포트, SSL 설정 또는 서비스 계정 사용자 인증 정보를 확인하세요.

스크립트 결과

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

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

잠긴 계정 해제

잠긴 계정 해제 작업을 사용하여 로그인 시도가 너무 많이 실패하여 잠긴 Active Directory의 사용자 계정을 잠금 해제합니다. 이 작업은 케이스에 연결된 사용자를 자동으로 타겟팅합니다.

이 작업은 Google SecOps User 항목에서 실행됩니다.

작업 입력

없음

작업 출력

잠긴 계정 해제 작업은 다음 출력을 제공합니다.

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

출력 메시지

잠긴 계정 해제 작업은 다음 출력 메시지를 반환할 수 있습니다.

출력 메시지	메시지 설명
`Unlocked account for the following users: ENTITY_ID`	작업이 완료되었습니다.
`Failed to unlock account for the following users: ENTITY_ID`	지정된 사용자에 대한 작업이 실패했습니다. 서비스 계정에 대상 사용자 계정의 `lockoutTime` 속성에 대한 읽기 및 쓰기 권한이 있는지 확인합니다.
`The following users were not found in Active Directory: ENTITY_ID`	지정된 사용자에 대한 작업이 실패했습니다. 사용자 계정이 Active Directory에 있고 케이스의 `User` 항목과 일치하는지 확인합니다.
`No accounts were unlocked.`	작업이 실패했습니다. 케이스에 유효한 `User` 항목이 포함되어 있고 서비스 계정에 대상 계정을 잠금 해제할 권한이 있는지 확인합니다.
`Error executing action "Release Locked Account". Reason: ERROR_REASON`	작업이 실패했습니다. Active Directory 서버 또는 서비스 계정 사용자 인증 정보에 대한 연결을 확인하세요.

스크립트 결과

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

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

그룹에서 사용자 삭제

그룹에서 사용자 삭제 작업을 사용하여 케이스의 사용자를 하나 이상의 Active Directory 그룹에서 삭제합니다(예: 사고 중에 승격된 그룹 액세스 권한 취소). 이 작업은 케이스에서 대상 사용자를 자동으로 식별하고 지정된 그룹에서 삭제합니다.

이 작업은 Google SecOps User 항목에서 실행됩니다.

작업 입력

그룹에서 사용자 삭제 작업에는 다음 매개변수가 필요합니다.

매개변수 설명

Group Name

필수 입력란입니다.

사용자를 삭제할 그룹을 쉼표로 구분된 목록으로 나열합니다.

작업 출력

그룹에서 사용자 삭제 작업은 다음 출력을 제공합니다.

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

출력 메시지

그룹에서 사용자 삭제 작업은 다음 출력 메시지를 반환할 수 있습니다.

출력 메시지	메시지 설명
`Successfully removed the following users from the group "GROUP_NAME" in Active Directory: ENTITY_ID` `The following users were not a part of the group "GROUP_NAME" in Active Directory: ENTITY_ID`	작업이 완료되었습니다.
`Action wasn't able to remove the following users from the group "GROUP_NAME" in Active Directory: ENTITY_ID`	지정된 사용자에 대한 작업이 실패했습니다. 서비스 계정에 대상 그룹의 `member` 속성을 수정할 권한이 있는지 확인합니다.
`The following users were not found in Active Directory: ENTITY_ID`	지정된 사용자에 대한 작업이 실패했습니다. 사용자 계정이 Active Directory에 있고 케이스의 `User` 항목과 일치하는지 확인합니다.
`The following groups were not found in Active Directory: GROUP_NAME`	지정된 그룹에 대한 작업이 실패했습니다. `Group Name` 매개변수에서 그룹 이름의 철자를 확인하고 구성된 도메인에 그룹이 있는지 확인합니다.
`No users were removed from the group "GROUP_NAME" in Active Directory.`	지정된 그룹에 대한 작업이 실패했습니다. 대상 사용자가 Active Directory에 존재하고 서비스 계정에 지정된 그룹에 대한 쓰기 액세스 권한이 있는지 확인합니다.
`No users were removed from the provided groups in Active Directory.`	작업이 실패했습니다. 케이스에 유효한 `User` 항목이 포함되어 있고 지정된 그룹이 Active Directory에 있는지 확인합니다.
`Error executing action "Remove User From Group". Reason: ERROR_REASON`	작업이 실패했습니다. Active Directory 서버, 입력 매개변수 또는 서비스 계정 사용자 인증 정보에 대한 연결을 확인하세요.

스크립트 결과

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

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

Active Directory 검색

Active Directory 검색 작업을 사용하여 기본 제공 검색 조건 또는 커스텀 쿼리를 사용하여 디렉터리에서 사용자, 컴퓨터, 그룹 또는 조직 단위를 검색합니다. 특정 조직 단위로 검색을 필터링하고 결과에 포함할 디렉터리 필드를 선택할 수도 있습니다.

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

작업 입력

Active Directory 검색 작업에는 다음 매개변수가 필요합니다.

매개변수	설명
`Search Condition`	필수 입력란입니다. 검색에 적용할 조건입니다. 가능한 값은 다음과 같습니다. `Contains` `Exact Match` `Starts With` `Custom LDAP Query` 기본값은 `Contains`입니다.
`Include Domain`	(선택사항) 선택하면 `Contains`, `Exact Match` 또는 `Starts With` 조건으로 검색할 때 작업에 도메인 구성요소가 포함됩니다.
`Search Object`	필수 입력란입니다. `Custom LDAP Query`를 사용하지 않을 때 검색할 객체 유형입니다. 가능한 값은 다음과 같습니다. `Select Option` `User` `Host` `Group` `Organizational Unit` 기본값은 `Select Option`입니다.
`Filter Object Value`	필수 입력란입니다. 필터링할 객체 값 또는 `Search Condition`가 `Custom LDAP Query`로 설정된 경우 전체 LDAP 쿼리 문자열입니다.
`Custom Fields`	(선택사항) 검색 결과에 반환할 LDAP 속성의 쉼표로 구분된 목록입니다.
`Specific OUs to Search`	(선택사항) 검색 범위를 제한하는 조직 단위 이름의 쉼표로 구분된 목록입니다.
`Include Default Search Fields`	(선택사항) 선택하면 작업에 지정된 `Custom Fields` 외에 반환된 결과에 기본 Active Directory 필드가 포함됩니다. 기본적으로 사용 설정됩니다.
`Max Records To Return`	(선택사항) Active Directory에서 가져올 최대 레코드 수입니다. 기본값은 `100`입니다.
`Sort Field`	(선택사항) 반환된 항목을 정렬하는 데 사용되는 LDAP 속성 이름입니다.

작업 출력

Active Directory 검색 작업은 다음 출력을 제공합니다.

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

케이스 월 테이블

Active Directory 검색 작업은 케이스 월에 다음 표를 제공합니다.

테이블 이름: Active Directory Search Results
열: 일치하는 디렉터리 항목에 대해 반환되는 Active Directory 속성입니다(Include Default Search Fields 및 Custom Fields 기준).

JSON 결과

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

[
      {
        "primaryGroupID": [
          513
        ],
        "logonCount": [
          6505
        ],
        "cn": [
          "user name"
        ],
        "countryCode": [
          0
        ],
        "objectClass": [
          "top",
          "person",
          "organizationalPerson"
        ],
        "userPrincipalName": [
          "user@example.com"
        ],
        "adminCount": [
          1
        ],
        "lastLogonTimestamp": [
          "2019-01-09 08:42:03.540783+00:00"
        ],
        "manager": [
          "CN=user name,OU=R&D,OU=TLV,OU=host name,DC=domain,DC=LOCAL"
        ],
        "instanceType": [
          4
        ],
        "distinguishedName": [
          "CN=user name,OU=R&D,OU=TLV,OU=host,DC=domain,DC=LOCAL"
        ],
        "dSCorePropagationData": [
          "2019-01-14 14:39:16+00:00"
        ],
        "msDS-SupportedEncryptionTypes": [
          0
        ],
        "objectSid": [
          "ID"
        ],
        "whenCreated": [
          "2011-11-07 08:00:44+00:00"
        ],
        "uSNCreated": [
          7288202
        ],
        "lockoutTime": [
          "1601-01-01 00:00:00+00:00"
        ],
        "badPasswordTime": [
          "date"
        ],
        "pwdLastSet": [
          "date"
        ],
        "sAMAccountName": [
          "example"
        ],
        "objectCategory": [
          "CN=Person,CN=Schema,CN=Configuration,DC=host,DC=LOCAL"
        ],
        "lastLogon": [
          "2019-01-14 17:13:54.463070+00:00"
        ],
        "objectGUID": [
          "GUID"
        ],
        "whenChanged": [
          "2019-01-14 16:49:01+00:00"
        ],
        "badPwdCount": [
          1
        ],
        "accountExpires": [
          "9999-12-31 23:59:59.999999"
        ],
        "displayName": [
          "example"
        ],
        "name": [
          "user"
        ],
        "memberOf": [
          "CN=\\\\u05e7\\\\u05d1\\\\u05d5\\\\u05e6\\\\u05d4 \\\\u05d1\\\\u05e2\\\\u05d1\\\\u05e8\\\\u05d9\\\\u05ea,OU=TEST,OU=QA,OU=IT,OU=TLV,OU=host,DC=domain,DC=LOCAL",
          "CN=Organization Management,OU=Microsoft Exchange Security Groups,DC=domain,DC=LOCAL",
          "CN=Local Admin,OU=Groups,OU=IT,OU=TLV,OU=host,DC=domain,DC=LOCAL"
        ],
        "codePage": [
          0
        ],
        "userAccountControl": [
          111
        ],
        "sAMAccountType": [
          805306368
        ],
        "uSNChanged": [
          15301168
        ],
        "sn": [
          "example"
        ],
        "givenName": [
          "user"
        ],
        "lastLogoff": [
          "1601-01-01 00:00:00+00:00"
        ]
      }
    ]

출력 메시지

Active Directory 검색 작업은 다음 출력 메시지를 반환할 수 있습니다.

출력 메시지	메시지 설명
`Successfully performed the query "QUERY_STRING" in Active Directory.` `No results to show following the query: "QUERY_STRING".`	작업이 완료되었습니다.
`Error executing action "Search Active Directory". Reason: you need to select "Search Object" or choose "Custom LDAP Query" as a "Search Condition"`	작업이 실패했습니다. `Search Object` 매개변수에서 유효한 객체 유형을 선택하거나 `Search Condition`를 `Custom LDAP Query`로 변경하세요.
`Error executing action "Search Active Directory". Reason: Value for the parameter "Max Records To Return" should be a positive number.`	작업이 실패했습니다. `Max Records To Return` 매개변수에 `0`보다 큰 정수를 입력하세요.
`Error executing action "Search Active Directory". Reason: The following OUs were not found in Active Directory: OU_NAMES`	작업이 실패했습니다. `Specific OUs to Search` 매개변수에서 조직 단위의 철자를 확인하고 Active Directory에 있는지 확인합니다.
`Error executing action "Search Active Directory". Reason: Knowingly invalid query was executed: "QUERY_STRING". Please verify the inputs and try again.`	작업이 실패했습니다. `Filter Object Value` 매개변수에서 커스텀 쿼리 또는 필터 값의 문법을 확인하고 지정된 `Custom Fields` 또는 `Sort Field` 이름이 유효한 LDAP 속성인지 확인합니다.
`Error executing action "Search Active Directory". Reason: ERROR_REASON`	작업이 실패했습니다. Active Directory 서버, 입력 매개변수 또는 서비스 계정 사용자 인증 정보에 대한 연결을 확인하세요.

스크립트 결과

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

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

사용자 비밀번호 설정

사용자 비밀번호 설정 작업을 사용하여 케이스의 사용자 비밀번호를 새 비밀번호로 재설정합니다. 통합이 SSL (LDAPS)을 통해 연결되어 있고 새 비밀번호가 도메인의 비밀번호 복잡성 규칙을 충족하는지 확인합니다.

이 작업은 Google SecOps User 항목에서 실행됩니다.

작업 입력

사용자 비밀번호 설정 작업에는 다음 매개변수가 필요합니다.

매개변수 설명

New Password

필수 입력란입니다.

새 비밀번호 값입니다.

작업 출력

사용자 비밀번호 설정 작업은 다음 출력을 제공합니다.

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

출력 메시지

사용자 비밀번호 설정 작업은 다음 출력 메시지를 반환할 수 있습니다.

출력 메시지	메시지 설명
`Reset password for the following users: ENTITY_ID`	작업이 완료되었습니다.
`Failed to reset password for the following users: ENTITY_ID`	지정된 사용자에 대한 작업이 실패했습니다. 새 비밀번호가 도메인 비밀번호 복잡성 및 기록 요구사항을 충족하고 대상 사용자가 보호된 관리 계정이 아닌지 확인합니다.
`The following users were not found in Active Directory: ENTITY_ID`	지정된 사용자에 대한 작업이 실패했습니다. 사용자 계정이 Active Directory에 있고 케이스의 `User` 항목과 일치하는지 확인합니다.
`No passwords were changed.`	작업이 실패했습니다. 케이스에 유효한 `User` 항목이 포함되어 있고 서비스 계정에 대상 계정의 비밀번호를 재설정할 권한이 있는지 확인합니다.
`Failed to execute "Set User Password" action! Watch Over Extended Rights permission or SSL connection.`	작업이 실패했습니다. 통합 구성 (포트 `636`의 LDAPS)에서 `Use SSL`가 선택되어 있고 서비스 계정에 비밀번호 재설정 확장 권한이 있는지 확인합니다.
`Error executing action "Set User Password". Reason: ERROR_REASON`	작업이 실패했습니다. Active Directory 서버, 입력 매개변수 또는 서비스 계정 사용자 인증 정보에 대한 연결을 확인하세요.

스크립트 결과

다음 표에는 사용자 비밀번호 설정 작업을 사용할 때 스크립트 결과 출력 값이 나와 있습니다.

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

AD 호스트의 속성 업데이트

AD 호스트 속성 업데이트 작업을 사용하여 케이스의 컴퓨터 계정에서 특정 디렉터리 속성을 업데이트합니다(예: 컴퓨터의 Description 필드를 사고 메모로 업데이트). 이 작업은 케이스에서 대상 컴퓨터를 자동으로 식별하고 새 값을 적용합니다.

이 작업은 Google SecOps Hostname 항목에서 실행됩니다.

작업 입력

AD 호스트의 속성 업데이트 작업에는 다음 매개변수가 필요합니다.

매개변수 설명

Attribute Name

필수 입력란입니다.

업데이트할 속성의 이름입니다(예: Description).

Attribute Value

필수 입력란입니다.

속성의 새 값입니다.

작업 출력

AD 호스트 속성 업데이트 작업은 다음 출력을 제공합니다.

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

출력 메시지

AD 호스트 속성 업데이트 작업은 다음 출력 메시지를 반환할 수 있습니다.

출력 메시지	메시지 설명
`Successfully updated attribute "ATTRIBUTE_NAME" on the following hosts in Active Directory: ENTITY_ID_LIST`	작업이 완료되었습니다.
`Action wasn't able to update attribute "ATTRIBUTE_NAME" on the following hosts in Active Directory: ENTITY_ID_LIST`	지정된 호스트에 대한 작업이 실패했습니다. 서비스 계정에 대상 컴퓨터 계정의 지정된 속성에 대한 쓰기 권한이 있고 값 형식이 해당 속성에 유효한지 확인합니다.
`The following hosts were not found in Active Directory: ENTITY_ID_LIST`	지정된 호스트에 대한 작업이 실패했습니다. 컴퓨터 계정이 Active Directory에 존재하고 케이스의 `Hostname` 항목과 일치하는지 확인합니다.
`No hosts were updated in Active Directory.`	작업이 실패했습니다. 케이스에 유효한 `Hostname` 항목이 포함되어 있고 서비스 계정에 지정된 속성을 업데이트할 권한이 있는지 확인합니다.
`Error executing action "Update attributes of an AD Host". Reason: Provided attribute doesn't exist in Active Directory.`	작업이 실패했습니다. `Attribute Name` 매개변수에서 속성의 철자를 확인하고 유효한 Active Directory 컴퓨터 속성인지 확인합니다.
`Error executing action "Update attributes of an AD Host". Reason: ERROR_REASON`	작업이 실패했습니다. Active Directory 서버, 입력 매개변수 또는 서비스 계정 사용자 인증 정보에 대한 연결을 확인하세요.

스크립트 결과

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

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

AD 사용자의 속성 업데이트

AD 사용자 속성 업데이트 작업을 사용하여 케이스의 사용자 계정에서 특정 디렉터리 속성을 업데이트합니다(예: 사용자의 Description, title 또는 department 필드 업데이트). 이 작업은 케이스에서 대상 사용자를 자동으로 식별하고 새 값을 적용합니다.

이 작업은 Google SecOps User 항목에서 실행됩니다.

작업 입력

AD 사용자의 속성 업데이트 작업에는 다음 매개변수가 필요합니다.

매개변수 설명

Attribute Name

필수 입력란입니다.

업데이트할 속성의 이름입니다(예: Description).

Attribute Value

필수 입력란입니다.

속성의 새 값입니다.

작업 출력

AD 사용자 속성 업데이트 작업은 다음 출력을 제공합니다.

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

출력 메시지

AD 사용자 속성 업데이트 작업은 다음 출력 메시지를 반환할 수 있습니다.

출력 메시지	메시지 설명
`Successfully updated attribute "ATTRIBUTE_NAME" for the following users in Active Directory: ENTITY_ID_LIST`	작업이 완료되었습니다.
`Action wasn't able to update attribute "ATTRIBUTE_NAME" for the following users in Active Directory: ENTITY_ID_LIST`	지정된 사용자에 대한 작업이 실패했습니다. 서비스 계정에 대상 사용자 계정의 지정된 속성에 대한 쓰기 권한이 있고 값 형식이 해당 속성에 유효한지 확인합니다.
`The following users were not found in Active Directory: ENTITY_ID_LIST`	지정된 사용자에 대한 작업이 실패했습니다. 사용자 계정이 Active Directory에 있고 케이스의 `User` 항목과 일치하는지 확인합니다.
`No users were updated in Active Directory.`	작업이 실패했습니다. 케이스에 유효한 `User` 항목이 포함되어 있고 서비스 계정에 지정된 속성을 업데이트할 권한이 있는지 확인하세요.
`Error executing action "Update attributes of an AD User". Reason: Provided attribute doesn't exist in Active Directory.`	작업이 실패했습니다. `Attribute Name` 매개변수에서 속성의 철자를 확인하고 유효한 Active Directory 사용자 속성인지 확인합니다.
`Error executing action "Update attributes of an AD User". Reason: ERROR_REASON`	작업이 실패했습니다. Active Directory 서버, 입력 매개변수 또는 서비스 계정 사용자 인증 정보에 대한 연결을 확인하세요.

스크립트 결과

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

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

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

Active Directory를 Google SecOps와 통합

사용 사례

시작하기 전에

네트워크 및 DNS 요구사항

/etc/hosts 파일 구성

CA 인증서 구성

인증 및 서비스 계정 요구사항

작업 권한 구성 (최소 권한)

Active Directory에서 권한 위임

ADUC를 사용하여 제어 위임

PowerShell 및 dsacls를 사용하여 제어 위임

통합 매개변수

작업

그룹에 사용자 추가

작업 입력

작업 출력

출력 메시지

스크립트 결과

호스트 OU 변경

작업 입력

작업 출력

출력 메시지

스크립트 결과

사용자 OU 변경

작업 입력

작업 출력

출력 메시지

스크립트 결과

계정 사용 중지

작업 입력

작업 출력

출력 메시지

스크립트 결과

컴퓨터 사용 중지

작업 입력

작업 출력

출력 메시지

스크립트 결과

계정 사용 설정

작업 입력

작업 출력

출력 메시지

스크립트 결과

컴퓨터 사용 설정

작업 입력

작업 출력

출력 메시지

스크립트 결과

항목 보강

작업 입력

작업 출력

케이스 월 테이블

항목 보강

JSON 결과

출력 메시지

스크립트 결과

비밀번호 강제 업데이트

작업 입력

작업 출력

출력 메시지

스크립트 결과

그룹 구성원 가져오기

작업 입력

작업 출력

케이스 월 테이블

JSON 결과

출력 메시지

스크립트 결과

관리자 연락처 정보 가져오기

작업 입력

작업 출력

케이스 월 테이블

항목 보강

JSON 결과

출력 메시지

스크립트 결과

사용자가 그룹에 있는지 확인

작업 입력

작업 출력

JSON 결과

`/etc/hosts` 파일 구성