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)를 통해 연결하는 경우(비밀번호 재설정에 필요) 디렉터리 인증서가 구성되어 있는지 확인합니다. 내부 인증 기관 (CA)을 사용하는 경우 루트 또는 중간 CA 인증서를 base64 인코딩할 준비를 합니다.
최소 권한 원칙 (PoLP)을 준수하는 전용 Active Directory 서비스 계정을 만듭니다.
필요한 작업 권한을 검토하여 실행하려는 특정 플레이북에 필요한 속성 및 액세스 권한을 확인합니다.
Active Directory 사용자 및 컴퓨터 (ADUC) 또는 PowerShell (dsacls)을 사용하여 타겟 조직 단위 (OU)에 대한 권한을 위임하고 서비스 계정에 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` 파일 구성

Active Directory에는 SSL/TLS 인증서 및 디렉터리 서비스 바인딩과 일치하는 정확한 호스트 이름 확인이 필요합니다. 원격 에이전트가 DNS를 사용하여 Active Directory 도메인 컨트롤러를 확인할 수 없는 경우 호스트를 수동으로 매핑합니다.

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

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

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

(선택사항) CA 인증서 구성

비공개 또는 내부 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)과 일치하도록 Server 매개변수를 도메인 컨트롤러의 FQDN (IP 주소 아님)으로 설정합니다.
테스트를 클릭하여 TLS 핸드셰이크를 검증합니다.

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

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

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

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

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

인증 서비스 계정에 플레이북에서 실행하는 작업에 필요한 특정 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` 플래그를 읽고 지웁니다.
잠긴 계정 해제	`Write Property`: `lockoutTime`	사용자	잠긴 사용자 계정을 잠금 해제하기 위해 `lockoutTime` 속성을 `0`로 설정합니다.
비밀번호 업데이트 강제 적용	`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`	조직 단위 (OU), 사용자	LDAP `modify_dn`를 사용하여 OU 간에 사용자 객체를 이동합니다.
호스트 OU 변경	`Delete Child Object` (컴퓨터) - 소스 OU 대상 OU의 `Create Child Object` (컴퓨터) `Write Property`: `name`, `distinguishedName`	조직 단위 (OU), 컴퓨터	LDAP `modify_dn`를 사용하여 OU 간에 컴퓨터 객체를 이동합니다.
AD 사용자 속성 업데이트	타겟 속성 (예: `mail`, `title`, `department`, `telephoneNumber`, `description`, `manager`)에 대한 `Write Property`	사용자	타겟 사용자 객체에서 지정된 속성 값을 수정합니다.
AD 호스트의 속성 업데이트	`Write Property` 목표 속성 (예: `description` 또는 `location`)	컴퓨터	타겟 컴퓨터 객체의 지정된 속성 값을 수정합니다.
그룹 구성원 가져오기	`List Contents` `Read Property`: `member`, `sAMAccountName`, `distinguishedName`	그룹, 사용자, 컴퓨터	그룹 멤버십 및 회원 계정 속성을 쿼리합니다.
관리자 연락처 세부정보 가져오기	`Read Property`: `manager` `Read Property`: `mail`, `displayName`, `telephoneNumber`, `title`	사용자	타겟 사용자 객체에서 `manager` 속성을 읽고 관리자의 연락처 세부정보를 가져옵니다.
Is User In Group	`Read Property`: `memberOf`, `sAMAccountName`	사용자, 그룹	사용자 계정이 지정된 보안 또는 메일 그룹에 속하는지 평가합니다.
사용자 그룹 나열	`Read Property`: `memberOf`, `sAMAccountName`	사용자, 그룹	지정된 사용자 계정에 할당된 모든 그룹의 목록을 반환합니다.
Active Directory 검색	`List Contents` `Read Property`에 대한 쿼리된 속성	사용자, 컴퓨터, 그룹, OU	디렉터리 하위 트리에 대해 맞춤 LDAP 필터 쿼리를 실행합니다.

Active Directory에서 권한 위임

광범위한 관리 권한을 부여하지 않고 PoLP를 적용하려면 ADUC 또는 PowerShell 및 dsacls를 사용하여 표준 Active Directory 관리 도구를 사용하여 타겟 OU에 대한 권한을 위임합니다.

ADUC를 사용하여 제어 위임

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

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

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

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

명령줄 방식을 선호하거나 권한 할당을 자동화하고 스크립팅해야 하는 경우 내장된 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:WP;lockoutTime;user"
강제 비밀번호 변경 권한 부여 (pwdLastSet): powershell dsacls.exe "OU=Users,DC=example,DC=local" /I:S /G "EXAMPLE\svc_secops_ad:WP;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에 연결할 사용자의 이메일 주소입니다(예: `user@example.com`). 이 매개변수는 `userPrincipalName` 속성도 허용합니다.
`Domain`	필수 항목입니다. 네트워크 네임스페이스 내 도메인의 전체 DNS 경로입니다. 이 매개변수를 구성하려면 다음 형식인 경우 도메인의 정규화된 도메인 이름 (FQDN)을 입력하세요. `SUBDOMAIN.ROOT_DOMAIN` 예를 들어 내부 Active Directory 도메인이 `example.local`이면 입력할 FQDN은 `example.local`입니다. 내부 Active Directory 도메인이 `corp.example.com`인 경우 입력할 FQDN은 `corp.example.com`입니다.
`Password`	필수 항목입니다. 사용자 계정의 비밀번호입니다.
`Custom Query Fields`	(선택사항) Active Directory 통합의 맞춤 필드입니다(예: `customField1, customField2`).
`CA Certificate File - parsed into Base64 String`	(선택사항) CA 인증서를 구성할 때 획득한 base64 형식으로 인코딩된 CA 인증서 파일 문자열입니다. 이 매개변수를 구성하려면 전체 `BASE64_ENCODED_CERTIFICATE_STRING` 값을 입력합니다.
`Use SSL`	(선택사항) 선택하면 Active Directory 서버에 연결할 때 통합에서 SSL 인증서를 검증합니다. 선택한 경우 통합에서 보안 LDAPS (포트 636)를 사용합니다. 선택하지 않으면 표준 LDAP (포트 389)를 사용합니다. 기본적으로 선택되지 않습니다.

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

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

작업

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

그룹에 사용자 추가

그룹에 사용자 추가 작업을 사용하여 그룹에 사용자를 추가합니다.

이 작업은 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` `No users were added to the group "GROUP_NAME" in Active Directory.` `No users were added to the provided groups in Active Directory.`	작업이 완료되었습니다.
`Error executing action "Add User to Group". Reason: ERROR_REASON`	작업이 실패했습니다. 서버, 입력 매개변수 또는 사용자 인증 정보에 대한 연결을 확인합니다.

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

No users were added to the group "GROUP_NAME" in Active Directory.

No users were added to the provided groups in Active Directory.

작업이 완료되었습니다.

Error executing action "Add User to Group". Reason:
      ERROR_REASON

작업이 실패했습니다.

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

스크립트 결과

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

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

호스트 OU 변경

호스트 OU 변경 작업을 사용하여 호스트의 OU를 변경합니다.

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

작업 입력

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

매개변수 설명

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

OU Name

필수 항목입니다.

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

작업 출력

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

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

스크립트 결과

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

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

사용자 OU 변경

사용자 OU 변경 작업을 사용하여 사용자의 OU를 변경합니다.

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

작업 입력

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

매개변수 설명

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

OU Name

필수 항목입니다.

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

작업 출력

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

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

스크립트 결과

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

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

계정 사용 중지

계정 사용 중지 작업을 사용하여 사용자 계정을 사용 중지합니다.

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

작업 입력

없음

작업 출력

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

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

스크립트 결과

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

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

컴퓨터 사용 중지

컴퓨터 사용 중지 작업을 사용하여 컴퓨터 계정을 사용 중지합니다.

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

작업 입력

없음

작업 출력

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

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

스크립트 결과

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

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

계정 사용 설정

계정 사용 설정 작업을 사용하여 사용자 계정을 사용 설정합니다.

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

작업 입력

없음

작업 출력

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

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

스크립트 결과

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

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

컴퓨터 사용 설정

컴퓨터 사용 설정 작업을 사용하여 컴퓨터 계정을 사용 설정합니다.

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

작업 입력

없음

작업 출력

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

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

스크립트 결과

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

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

항목 보강

항목 보강 작업을 사용하여 Active Directory 속성으로 Hostname 또는 Username 항목을 보강합니다.

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

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

User
Hostname

작업 입력

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

매개변수	설명
`Mark entities as internal`	필수 항목입니다. 선택하면 작업에서 성공적으로 풍부해진 항목을 내부 항목으로 자동 표시합니다.
`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` 파라미터 값에 지정된 속성만 반환합니다. 기본적으로 선택되지 않습니다.
`Connection Timeout`	(선택사항) 네트워크 연결 제한 시간(초)입니다. 기본값은 `10`입니다.
`Receive Timeout`	(선택사항) 네트워크 수신 제한 시간(초)입니다. 기본값은 `60`입니다.

작업 출력

엔티티 보강 작업은 다음 출력을 제공합니다.

작업 출력 유형	가용성
케이스 월 연결	사용 불가
케이스 월 링크	사용 불가
케이스 월 테이블	사용 불가
항목 보강 표	사용 가능
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 결과

다음 예는 Enrich Entities 작업을 사용할 때 수신되는 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"
    }
]

스크립트 결과

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

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

비밀번호 강제 업데이트

비밀번호 업데이트 강제 작업을 사용하여 다음 로그인 시 사용자에게 비밀번호를 변경하도록 요구합니다.

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

작업 입력

없음

작업 출력

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

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

스크립트 결과

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

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

그룹 구성원 가져오기

그룹 구성원 가져오기 작업을 사용하여 지정된 Active Directory 그룹의 구성원을 가져옵니다.

이 작업은 사용자 및 호스트 이름 구성원을 모두 가져오는 것을 지원하며 중첩된 그룹 내 검색을 지원합니다.

작업 입력

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

매개변수	설명
`Group Name`	필수 항목입니다. 나열된 회원이 포함된 그룹의 이름입니다.
`Members Type`	필수 항목입니다. 그룹의 구성원 유형입니다. 기본값은 `User`입니다.
`Perform Nested Search`	(선택사항) 선택하면 이 작업은 기본 그룹에 속한 그룹에 관한 추가 세부정보를 가져옵니다. 기본적으로 선택되지 않습니다.
`Limit`	필수 항목입니다. Active Directory에서 가져올 최대 등록정보 수입니다. 기본값은 100입니다.

작업 출력

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

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

JSON 결과

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

[
  {
    "cn":"Example User1",
    "displayName":"Example User1",
    "distinguishedName":"CN=Example User1,OU=User Accounts,DC=example,DC=local"
  },
  {
    "cn":"Example User2",
    "displayName":"Example User2",
    "distinguishedName":"CN=Example User2,CN=Users,DC=example,DC=local"
  },
  {
    "cn":"Example User3",
    "displayName":"Example User3",
    "distinguishedName":"CN=Example User3,CN=Users,DC=example,DC=local"
  }
]

스크립트 결과

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

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

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

관리자 연락처 세부정보 가져오기 작업을 사용하여 Active Directory에서 관리자 연락처 세부정보를 가져옵니다.

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

작업 입력

없음

작업 출력

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

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

항목 보강

Get Manager Contact Details 작업은 다음 엔티티 보강을 지원합니다.

보강 필드 이름	로직
`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": ["{id}"],
            "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"
    }
]

출력 메시지

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

출력 메시지 메시지 설명

출력 메시지	메시지 설명
`All entities were processed successfully.` `Some entities were processed successfully and some weren't. Please check the action log for further information.` `No entities were processed.`	작업이 완료되었습니다.
`Error executing action "Get Manager Contact Details". Reason: ERROR_REASON`	작업이 실패했습니다. 서버, 입력 매개변수 또는 사용자 인증 정보에 대한 연결을 확인합니다.

All entities were processed successfully.

Some entities were processed successfully and some weren't. Please check the action log for further information.

No entities were processed.

작업이 완료되었습니다.

Error executing action "Get Manager Contact Details".
      Reason: ERROR_REASON

작업이 실패했습니다.

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

스크립트 결과

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

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

사용자가 그룹에 속하는지 여부

사용자가 그룹에 속해 있는지 확인 작업을 사용하여 사용자가 특정 그룹의 구성원인지 확인합니다.

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

작업 입력

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

매개변수 설명

매개변수	설명
`Group Name`	필수 항목입니다. 확인할 그룹 이름입니다(예: `administrators`).

Group Name

필수 항목입니다.

확인할 그룹 이름입니다(예: administrators).

작업 출력

사용자가 그룹에 속하는지 여부 작업은 다음 출력을 제공합니다.

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

JSON 결과

다음 예시는 사용자가 그룹에 속하는지 확인 작업을 사용할 때 수신되는 JSON 결과 출력을 보여줍니다.

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

스크립트 결과

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

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

사용자 그룹 나열

사용자 그룹 나열 작업을 사용하여 Active Directory에서 사용할 수 있는 모든 사용자 그룹의 목록을 가져옵니다.

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

작업 입력

없음

작업 출력

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

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

JSON 결과

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

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

스크립트 결과

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

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

핑

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

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

작업 입력

없음

작업 출력

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

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

스크립트 결과

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

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

잠긴 계정 해제

잠긴 계정 잠금 해제 작업을 사용하여 잠긴 계정을 차단 해제합니다.

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

작업 입력

없음

작업 출력

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

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

스크립트 결과

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

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

그룹에서 사용자 삭제

그룹에서 사용자 삭제 작업을 사용하여 그룹에서 사용자를 삭제합니다.

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

작업 입력

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

매개변수 설명

매개변수	설명
`Group Name`	필수 항목입니다. 사용자를 삭제할 그룹을 쉼표로 구분한 목록입니다.

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` `No users were removed from the group "GROUP_NAME" in Active Directory.` `No users were removed from the provided groups in Active Directory.`	작업이 완료되었습니다.
`Error executing action "Remove User From Group". Reason: ERROR_REASON`	작업이 실패했습니다. 서버, 입력 매개변수 또는 사용자 인증 정보에 대한 연결을 확인합니다.

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

No users were removed from the group "GROUP_NAME" in Active Directory.

No users were removed from the provided groups in Active Directory.

작업이 완료되었습니다.

Error executing action "Remove User From Group". Reason:
      ERROR_REASON

작업이 실패했습니다.

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

스크립트 결과

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

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

Active Directory 검색

Active Directory 검색 작업을 사용하여 지정된 쿼리를 통해 Active Directory를 검색합니다.

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

작업 입력

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

매개변수 설명

매개변수	설명
`Query String`	필수 항목입니다. Active Directory에서 실행할 쿼리 문자열입니다.
`Limit`	(선택사항) Active Directory에서 가져올 최대 등록정보 수입니다.

Query String

필수 항목입니다.

Active Directory에서 실행할 쿼리 문자열입니다.

Limit

(선택사항)

Active Directory에서 가져올 최대 등록정보 수입니다.

작업 출력

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

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

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: ERROR_REASON`	작업이 실패했습니다. 서버, 입력 매개변수 또는 사용자 인증 정보에 대한 연결을 확인합니다.

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:
      ERROR_REASON

작업이 실패했습니다.

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

스크립트 결과

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

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

사용자 비밀번호 설정

사용자 비밀번호 설정 작업을 사용하여 사용자 비밀번호를 구성합니다.

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

작업 입력

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

매개변수 설명

New Password

필수 항목입니다.

새 비밀번호 값입니다.

작업 출력

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

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

스크립트 결과

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

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

AD 호스트의 속성 업데이트

AD 호스트의 속성 업데이트 작업을 사용하여 Active Directory의 현재 호스트 속성을 업데이트합니다.

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

작업 입력

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

매개변수 설명

Attribute Name

필수 항목입니다.

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

Attribute Value

필수 항목입니다.

속성의 새 값입니다.

작업 출력

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

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

출력 메시지

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

출력 메시지 메시지 설명

Active Directory - Following entities were updated successfully: ENTITY_ID_LIST.

No suitable entities were found.

작업이 완료되었습니다.

Failed to update the
      ATTRIBUTE_NAME for the following
      entities: ENTITY_ID_LIST.

작업이 실패했습니다.

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

스크립트 결과

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

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

AD 사용자의 속성 업데이트

AD 사용자 속성 업데이트 작업을 사용하여 Active Directory의 현재 사용자의 속성을 업데이트합니다.

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

작업 입력

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

매개변수 설명

Attribute Name

필수 항목입니다.

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

Attribute Value

필수 항목입니다.

속성의 새 값입니다.

작업 출력

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

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

출력 메시지

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

출력 메시지 메시지 설명

Active Directory - Following entities were updated successfully: ENTITY_ID_LIST.

No suitable entities were found.

작업이 완료되었습니다.

Failed to update the
      ATTRIBUTE_NAME for the following
      entities: ENTITY_ID_LIST.

작업이 실패했습니다.

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

스크립트 결과

다음 표에는 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 결과

스크립트 결과

사용자 그룹 나열

작업 입력

작업 출력

JSON 결과

스크립트 결과

핑

작업 입력

작업 출력

스크립트 결과

잠긴 계정 해제

작업 입력

`/etc/hosts` 파일 구성