REST Resource: customers.connectorConfigs

리소스: ConnectorConfig

커넥터 구성의 표현입니다.

JSON 표현 
{
  "name": string,
  "displayName": string,
  "type": enum (ConnectorType),
  "details": {
    object (ConnectorConfigDetails)
  },
  "status": {
    object (ConnectorConfigStatus)
  }
}
필드
name

string

식별자. 형식: customers/{customer}/connectorConfigs/{connectorConfig}
displayName

string

필수 항목입니다. 구성의 표시 이름입니다.
type

enum (ConnectorType)

필수 항목입니다. 커넥터 유형입니다.
details

object (ConnectorConfigDetails)

필수 항목입니다. 커넥터 구성의 세부정보입니다.
status

object (ConnectorConfigStatus)

출력 전용입니다. 커넥터 구성의 상태입니다.

ConnectorType

커넥터 구성 유형의 옵션입니다.

열거형
CONNECTOR_TYPE_UNSPECIFIED 기본값 이 값은 사용되지 않습니다.
REPORTING 보고 커넥터입니다.
DEVICE_TRUST 기기 트러스트 커넥터
XDR XDR 커넥터입니다.
IDENTITY_BASED_ENROLLMENT 인증 커넥터입니다.
CERTIFICATE_AUTHORITY 인증 기관 커넥터입니다. API에서 아직 지원되지 않습니다.
ROOT_STORE 루트 인증서 커넥터입니다.

ConnectorConfigDetails

커넥터 구성의 세부정보입니다.

JSON 표현 
{

  // Union field details can be only one of the following:
  "splunkConfig": {
    object (SplunkConfig)
  },
  "googleSecOpsConfig": {
    object (GoogleSecOpsConfig)
  },
  "pubSubConfig": {
    object (PubSubConfig)
  },
  "crowdStrikeConfig": {
    object (CrowdStrikeConfig)
  },
  "crowdStrikeFalconNextGenConfig": {
    object (CrowdStrikeFalconNextGenConfig)
  },
  "paloAltoNetworksConfig": {
    object (PaloAltoNetworksConfig)
  },
  "deviceTrustConfig": {
    object (DeviceTrustConfig)
  },
  "crowdStrikeXdrConfig": {
    object (CrowdStrikeXdrConfig)
  },
  "pubSubXdrConfig": {
    object (PubSubXdrConfig)
  }
  // End of list of possible types for union field details.
}
필드
통합 필드 details. 커넥터 관련 세부정보입니다. details은 다음 중 하나여야 합니다.
splunkConfig

object (SplunkConfig)

Splunk 커넥터 구성입니다.
googleSecOpsConfig

object (GoogleSecOpsConfig)

Google SecOps 커넥터 구성입니다.
pubSubConfig

object (PubSubConfig)

Pub/Sub 커넥터 구성입니다.
crowdStrikeConfig

object (CrowdStrikeConfig)

CrowdStrike 커넥터 구성입니다.
crowdStrikeFalconNextGenConfig

object (CrowdStrikeFalconNextGenConfig)

CrowdStrike Falcon Next Gen 커넥터 구성입니다.
paloAltoNetworksConfig

object (PaloAltoNetworksConfig)

Palo Alto Networks 커넥터 구성입니다.
deviceTrustConfig

object (DeviceTrustConfig)

기기 트러스트 커넥터 구성입니다.
crowdStrikeXdrConfig

object (CrowdStrikeXdrConfig)

CrowdStrike XDR 커넥터 구성입니다.
pubSubXdrConfig

object (PubSubXdrConfig)

Pub/Sub XDR 커넥터 구성입니다.

SplunkConfig

Splunk 커넥터 구성입니다.

JSON 표현 
{
  "unsecureScheme": boolean,
  "host": string,
  "portNumber": integer,
  "hecToken": string,
  "source": string,
  "reportingSettings": {
    object (ReportingSettings)
  }
}
필드
unsecureScheme

boolean

선택사항입니다. 보안되지 않은 HTTP 스키마를 사용할지 여부입니다. 기본값은 false (HTTPS)입니다.
host

string

필수 항목입니다. 이벤트를 수신할 고객별 서버를 식별하는 호스트입니다.
portNumber

integer

선택사항입니다. 사용할 포트 번호입니다. 설정하지 않으면 기본 Splunk 포트가 사용됩니다.
hecToken

string

필수 항목입니다. 입력 전용입니다. 승인 헤더로 사용할 데이터 입력의 HTTP 이벤트 수집기 토큰입니다.
source

string

선택사항입니다. Splunk 관리 콘솔에 설정된 기본값을 재정의하는 선택적 소스 이름입니다.
reportingSettings

object (ReportingSettings)

필수 항목입니다. Splunk 구성의 보고 설정입니다.

ReportingSettings

커넥터 구성의 보고 설정입니다.

JSON 표현 
{
  "enabledDefaultEvents": [
    enum (DefaultEvent)
  ],
  "enabledOptInEvents": [
    enum (OptInEvent)
  ],
  "enabledDeviceEvents": [
    enum (DeviceEvent)
  ]
}
필드
enabledDefaultEvents[]

enum (DefaultEvent)

선택사항입니다. 이 커넥터에 사용 설정된 사용자 및 브라우저 이벤트 목록입니다. 빈 목록은 모든 기본 이벤트를 사용 중지하고 ALL_DEFAULT_EVENTS를 사용하면 모든 기본 이벤트가 사용 설정됩니다.
enabledOptInEvents[]

enum (OptInEvent)

선택사항입니다. 이 구성에 사용 설정된 선택 이벤트 목록입니다. 목록이 비어 있으면 모든 선택 이벤트가 사용 중지되고 ALL_OPT_IN_EVENTS를 사용하면 모든 선택 이벤트가 사용 설정됩니다.
enabledDeviceEvents[]

enum (DeviceEvent)

선택사항입니다. 이 구성에 사용 설정된 기기 이벤트 목록입니다. 목록이 비어 있으면 모든 기기 이벤트가 사용 중지되고 ALL_DEVICE_EVENTS를 사용하면 모든 기기 이벤트가 사용 설정됩니다.

DefaultEvent

기본 보고 이벤트입니다. 이벤트가 더 추가될 수 있습니다.

열거형
DEFAULT_EVENT_UNSPECIFIED 기본값 이 값은 사용되지 않습니다.
ALL_DEFAULT_EVENTS 모든 기본 이벤트
BROWSER_CRASH_EVENT 브라우저 비정상 종료 이벤트입니다.
BROWSER_EXTENSION_INSTALL_EVENT 브라우저 확장 프로그램 설치 이벤트입니다.
CONTENT_TRANSFER_EVENT 콘텐츠 전송 이벤트입니다.
CONTENT_UNSCANNED_EVENT 콘텐츠가 검사되지 않음 이벤트입니다.
DATA_ACCESS_CONTROL_EVENT 데이터 액세스 제어 이벤트입니다.
MALWARE_TRANSFER_EVENT 멀웨어 전송 이벤트입니다.
PASSWORD_CHANGED_EVENT 비밀번호 변경 이벤트입니다.
PASSWORD_REUSE_EVENT 비밀번호 재사용 이벤트입니다.
SENSITIVE_DATA_TRANSFER_EVENT 민감한 정보 전송 이벤트입니다.
SUSPICIOUS_URL_EVENT 의심스러운 URL 이벤트입니다.
UNSAFE_SITE_VISIT_EVENT 안전하지 않은 사이트 방문 이벤트입니다.
URL_FILTERING_INTERSTITIAL_EVENT URL 필터링 전면 광고 이벤트입니다.

OptInEvent

보고 선택 이벤트입니다. 이벤트가 더 추가될 수 있습니다.

열거형
OPT_IN_EVENT_UNSPECIFIED 기본값 이 값은 사용되지 않습니다.
ALL_OPT_IN_EVENTS 모든 선택 이벤트입니다.
LOGIN_EVENT 로그인 이벤트입니다.
PASSWORD_BREACH_EVENT 비밀번호 유출 이벤트입니다.
URL_NAVIGATION_EVENT URL 탐색 이벤트입니다.
EXTENSION_TELEMETRY_EVENT 확장 프로그램 원격 분석 이벤트입니다.

DeviceEvent

기기 이벤트입니다. 이벤트가 더 추가될 수 있습니다.

열거형
DEVICE_EVENT_UNSPECIFIED 기본값 이 값은 사용되지 않습니다.
ALL_DEVICE_EVENTS 모든 기기 이벤트입니다.
ADD_REMOVE_USER_EVENT 사용자 이벤트 추가/삭제
LOGIN_LOGOUT_EVENT 로그인/로그아웃 이벤트입니다.
CRD_EVENT CRD 이벤트입니다.
PERIPHERAL_EVENT 주변기기 이벤트입니다.

GoogleSecOpsConfig

Google SecOps 커넥터 구성입니다.

JSON 표현 
{
  "apiKey": string,
  "host": string,
  "reportingSettings": {
    object (ReportingSettings)
  }
}
필드
apiKey

string

필수 항목입니다. 입력 전용입니다. 수집 API에서 사용할 API 키입니다.
host

string

필수 항목입니다. 수집 API 엔드포인트의 호스트입니다. 고객이 특정 지리적 리전의 서버에 이벤트를 업로드할 수 있습니다. 이 설정이 없는 기존 구성은 기본적으로 미국으로 설정됩니다.
reportingSettings

object (ReportingSettings)

필수 항목입니다. Google SecOps 구성의 보고 설정입니다.

PubSubConfig

Pub/Sub 커넥터 구성입니다.

JSON 표현 
{
  "topicFullPath": string,
  "reportingSettings": {
    object (ReportingSettings)
  }
}
필드
topicFullPath

string

필수 항목입니다. 이벤트를 전송할 주제의 전체 경로입니다.
reportingSettings

object (ReportingSettings)

필수 항목입니다. Pub/Sub 구성의 보고 설정입니다.

CrowdStrikeConfig

CrowdStrike 커넥터 구성입니다.

JSON 표현 
{
  "apiKey": string,
  "host": string,
  "reportingSettings": {
    object (ReportingSettings)
  }
}
필드
apiKey

string

필수 항목입니다. 입력 전용입니다. 수집 API에서 사용할 API 키입니다.
host

string

필수 항목입니다. 이벤트를 수신할 고객별 서버를 식별하는 호스트입니다.
reportingSettings

object (ReportingSettings)

필수 항목입니다. CrowdStrike 구성의 보고 설정입니다.

CrowdStrikeFalconNextGenConfig

CrowdStrike Falcon Next Gen 커넥터 구성입니다.

JSON 표현 
{
  "apiKey": string,
  "host": string,
  "reportingSettings": {
    object (ReportingSettings)
  }
}
필드
apiKey

string

필수 항목입니다. 입력 전용입니다. 수집 API에서 사용할 API 키입니다.
host

string

필수 항목입니다. 이벤트를 수신할 고객별 서버를 식별하는 호스트입니다.
reportingSettings

object (ReportingSettings)

필수 항목입니다. CrowdStrike Falcon Next Gen 구성의 보고 설정입니다.

PaloAltoNetworksConfig

Palo Alto Networks 커넥터 구성입니다.

JSON 표현 
{
  "apiKey": string,
  "host": string,
  "reportingSettings": {
    object (ReportingSettings)
  }
}
필드
apiKey

string

필수 항목입니다. 입력 전용입니다. 수집 API에서 사용할 API 키입니다.
host

string

필수 항목입니다. 이벤트를 수신할 고객별 서버를 식별하는 호스트입니다.
reportingSettings

object (ReportingSettings)

필수 항목입니다. Palo Alto Networks 구성의 보고 설정입니다.

DeviceTrustConfig

기기 트러스트 커넥터의 기기 트러스트 구성입니다.

JSON 표현 
{
  "serviceProvider": enum (ServiceProvider),
  "urlMatchers": [
    string
  ],
  "serviceAccounts": [
    string
  ],
  "scope": enum (BrowserEnforcementScope)
}
필드
serviceProvider

enum (ServiceProvider)

선택사항입니다. 기기 트러스트 커넥터의 서비스 제공업체입니다.
urlMatchers[]

string

필수 항목입니다. 시스템에서 여러 신호를 가져오기 위한 증명 흐름의 일부로서 허용되는 URL 목록입니다. URL에는 HTTPS 스킴(예: 'https://example.com')이 있어야 합니다. 와일드 카드(*)를 사용할 수 있습니다. 유효한 URL 패턴을 자세히 알아보려면 https://cloud.google.com/docs/chrome-enterprise/policies/url-patterns를 참고하세요.
serviceAccounts[]

string

필수 항목입니다. 전체 액세스 권한으로 인증 액세스 API를 호출할 수 있는 서비스 계정의 이메일 주소 목록입니다.
scope

enum (BrowserEnforcementScope)

필수 항목입니다. 이 구성이 적용될 범위입니다. ChromeOS에서는 항상 적용되므로 Chrome 브라우저에만 적용됩니다.

ServiceProvider

기기 트러스트 커넥터의 서비스 제공업체입니다.

열거형
SERVICE_PROVIDER_UNSPECIFIED 기본값
UNIVERSAL_DEVICE_TRUST 범용 기기 트러스트 커넥터입니다.
OKTA Okta 서비스 제공업체입니다.
PING_IDENTITY Ping Identity 서비스 제공업체
ONELOGIN OneLogin 서비스 제공업체입니다.
DUO Duo 서비스 제공업체입니다.
ZSCALER Zscaler 서비스 제공업체
OMNISSA Omnissa 서비스 제공업체입니다.
JUMPCLOUD JumpCloud 서비스 제공업체

BrowserEnforcementScope

기기 트러스트 커넥터의 시행 수준입니다.

열거형
BROWSER_ENFORCEMENT_SCOPE_UNSPECIFIED 기본값 이 값은 사용되지 않습니다.
BROWSERS_ONLY 브라우저만 적용됩니다.
PROFILES_ONLY 프로필만 적용됩니다.
BROWSERS_AND_PROFILES 브라우저와 프로필 모두 강제 적용됩니다.

CrowdStrikeXdrConfig

CrowdStrike XDR 커넥터 구성입니다.

JSON 표현 
{
  "apiKey": string,
  "host": string,
  "xdrSettings": {
    object (XdrSettings)
  }
}
필드
apiKey

string

필수 항목입니다. 입력 전용입니다. 수집 API에서 사용할 API 키입니다.
host

string

필수 항목입니다. 이벤트를 수신할 고객별 서버를 식별하는 호스트입니다.
xdrSettings

object (XdrSettings)

필수 항목입니다. CrowdStrike XDR 구성의 XDR 설정입니다.

XdrSettings

커넥터 구성의 XDR 설정입니다.

JSON 표현 
{
  "enableAllXdrEvents": boolean
}
필드
enableAllXdrEvents

boolean

필수 항목입니다. 모든 XDR 이벤트를 사용 설정할지 여부입니다.

PubSubXdrConfig

Pub/Sub XDR 커넥터 구성입니다.

JSON 표현 
{
  "topicFullPath": string,
  "xdrSettings": {
    object (XdrSettings)
  }
}
필드
topicFullPath

string

필수 항목입니다. 이벤트를 전송할 주제의 전체 경로입니다.
xdrSettings

object (XdrSettings)

필수 항목입니다. Pub/Sub XDR 구성의 XDR 설정입니다.

ConnectorConfigStatus

커넥터 구성의 상태입니다.

JSON 표현 
{
  "state": enum (ConfigState),
  "failureStartTime": string,
  "updateTime": string
}
필드
state

enum (ConfigState)

출력 전용입니다. 커넥터 구성의 상태입니다. 커넥터가 지난 24시간 동안 이벤트를 전송하지 못한 경우 커넥터 상태가 사용 중지됩니다.
failureStartTime

string (Timestamp format)

출력 전용입니다. 마지막 성공 이벤트 이후 가장 이른 실패의 필드 녹화 시간입니다. 이 필드는 상태가 DISABLED_BY_FAILURES인 경우에만 설정됩니다.

생성된 출력은 항상 Z-정규화되고 소수점 이하 0, 3, 6 또는 9자리인 RFC 3339를 사용합니다. 'Z' 이외의 오프셋도 허용됩니다. 예를 들면 "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" 또는 "2014-10-02T15:01:23+05:30"입니다.
updateTime

string (Timestamp format)

출력 전용입니다. 상태의 가장 최근 수정의 필드 기록 시간입니다. ENABLED의 경우 상태가 ENABLED로 변경된 시간입니다. DISABLED_BY_FAILURES의 경우 이 구성에 이벤트를 전송하려고 시도한 가장 최근 실패 시간입니다.

생성된 출력은 항상 Z-정규화되고 소수점 이하 0, 3, 6 또는 9자리인 RFC 3339를 사용합니다. 'Z' 이외의 오프셋도 허용됩니다. 예를 들면 "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" 또는 "2014-10-02T15:01:23+05:30"입니다.

ConfigState

커넥터 구성의 상태입니다. 더 많은 주가 추가될 수 있습니다.

열거형
CONFIG_STATE_UNKNOWN 기본값
ENABLED 커넥터 구성이 사용 설정되어 있습니다.
DISABLED_BY_FAILURES 오류로 인해 커넥터 구성이 일시적으로 사용 중지되었습니다.

메서드

create

 커넥터 구성을 만듭니다.

delete

 커넥터 구성을 삭제합니다.

get

 고객 ID와 구성 ID가 있는 커넥터 구성을 가져옵니다.

list

 고객의 커넥터 구성을 나열합니다.

patch

 커넥터 구성을 업데이트합니다.