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 )

Только вывод. Состояние конфигурации коннектора.

Тип соединителя

Варианты конфигурации типа коннектора.

Перечисления
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 Event Collector, используемый в заголовке Authorization.

source

string

Необязательно. Необязательное имя источника для переопределения имени по умолчанию, заданного в консоли администратора Splunk.

reportingSettings

object ( ReportingSettings )

Обязательно. Настройки отчетности для конфигурации Splunk.

Настройки отчетов

Настройки отчетов для конфигураций коннекторов.

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 Verified Access.

scope

enum ( BrowserEnforcementScope )

Обязательно. Область применения данной конфигурации. Обратите внимание, что это относится только к браузеру Chrome, поскольку в ChromeOS она применяется всегда.

Поставщик услуг

Поставщик услуг для коннектора доверия устройства.

Перечисления
SERVICE_PROVIDER_UNSPECIFIED Значение по умолчанию.
UNIVERSAL_DEVICE_TRUST Универсальный коннектор доверия устройств.
OKTA Поставщик услуг Okta.
PING_IDENTITY Поставщик услуг идентификации Ping.
ONELOGIN Поставщик услуг OneLogin.
DUO Поставщик услуг Duo.
ZSCALER Zscaler — поставщик услуг.
OMNISSA Поставщик услуг Omnissa.
JUMPCLOUD Поставщик услуг JumpCloud.

BrowserEnforcementScope

Уровень обеспечения доверия к устройству-коннектору.

Перечисления
BROWSER_ENFORCEMENT_SCOPE_UNSPECIFIED Значение по умолчанию. Это значение не используется.
BROWSERS_ONLY Принудительное соблюдение распространяется только на браузеры.
PROFILES_ONLY Обязательны только профили.
BROWSERS_AND_PROFILES Применяются правила как к браузерам, так и к профилям.

CrowStrikeXdrConfig

Конфигурация коннектора CrowdStrike XDR.

JSON-представление 
{
  "apiKey": string,
  "host": string,
  "xdrSettings": {
    object (XdrSettings)
  }
}
Поля
apiKey

string

Обязательный параметр. Только для ввода. Ключ API для использования в API приема данных.

host

string

Обязательно. Хост для идентификации сервера конкретного клиента, который будет получать события.

xdrSettings

object ( XdrSettings )

Обязательно. Настройки XDR для конфигурации CrowdStrike XDR.

XdrSettings

Настройки XDR для конфигурации коннектора.

JSON-представление 
{
  "enableAllXdrEvents": boolean
}
Поля
enableAllXdrEvents

boolean

Обязательно. Включить ли все события XDR.

PubSubXdrConfig

Конфигурация коннектора Pub/Sub XDR.

JSON-представление 
{
  "topicFullPath": string,
  "xdrSettings": {
    object (XdrSettings)
  }
}
Поля
topicFullPath

string

Обязательно. Полный путь к теме, в которую нужно отправить событие.

xdrSettings

object ( XdrSettings )

Обязательно. Настройки XDR для конфигурации Pub/Sub XDR.

ConnectorConfigStatus

Состояние конфигурации коннектора.

JSON-представление 
{
  "state": enum (ConfigState),
  "failureStartTime": string,
  "updateTime": string
}
Поля
state

enum ( ConfigState )

Только вывод. Состояние конфигурации коннектора. Состояние коннектора отключено, если коннектор не отправлял успешное событие в течение последних 24 часов.

failureStartTime

string ( Timestamp format)

Только для вывода. Поле, регистрирующее время самого раннего сбоя с момента последнего успешного события. Это поле устанавливается только тогда, когда состояние — DISABLED_BY_FAILURES .

Используется RFC 3339, согласно которому генерируемый вывод всегда будет Z-нормализован и будет содержать 0, 3, 6 или 9 дробных знаков. Допускаются также смещения, отличные от "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 это время последней неудачной попытки отправить событие в эту конфигурацию.

Используется RFC 3339, согласно которому генерируемый вывод всегда будет Z-нормализован и будет содержать 0, 3, 6 или 9 дробных знаков. Допускаются также смещения, отличные от "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

 Получает конфигурацию коннектора с идентификатором клиента и идентификатором конфигурации.

list

 Отображает список конфигураций коннекторов клиента.

patch

 Обновляет конфигурацию коннектора.