REST Resource: customers.connectorConfigs

Recurso: ConnectorConfig

Uma representação de uma configuração de conector.

Representação JSON 
{
  "name": string,
  "displayName": string,
  "type": enum (ConnectorType),
  "details": {
    object (ConnectorConfigDetails)
  },
  "status": {
    object (ConnectorConfigStatus)
  }
}
Campos
name

string

Identificador. Formato: customers/{customer}/connectorConfigs/{connectorConfig}
displayName

string

Obrigatório. O nome de exibição da configuração.
type

enum (ConnectorType)

Obrigatório. O tipo do conector.
details

object (ConnectorConfigDetails)

Obrigatório. Os detalhes da configuração do conector.
status

object (ConnectorConfigStatus)

Apenas saída. O status da configuração do conector.

ConnectorType

Opções para o tipo de configuração do conector.

Tipos enumerados
CONNECTOR_TYPE_UNSPECIFIED Valor padrão. Esse valor não é usado.
REPORTING Conector de relatórios.
DEVICE_TRUST Conector de confiança do dispositivo.
XDR Conector XDR.
IDENTITY_BASED_ENROLLMENT Conector de autenticação.
CERTIFICATE_AUTHORITY Conector da autoridade certificadora. Ainda não há suporte na API.
ROOT_STORE Conector de certificado raiz.

ConnectorConfigDetails

Os detalhes da configuração do conector.

Representação 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.
}
Campos
Campo de união details. Detalhes específicos do conector. details pode ser apenas de um dos tipos a seguir:
splunkConfig

object (SplunkConfig)

Configuração do conector do Splunk.
googleSecOpsConfig

object (GoogleSecOpsConfig)

Configuração do conector do Google SecOps.
pubSubConfig

object (PubSubConfig)

Configuração do conector do Pub/Sub.
crowdStrikeConfig

object (CrowdStrikeConfig)

Configuração do conector da CrowdStrike.
crowdStrikeFalconNextGenConfig

object (CrowdStrikeFalconNextGenConfig)

Configuração do conector Next Gen do CrowdStrike Falcon.
paloAltoNetworksConfig

object (PaloAltoNetworksConfig)

Configuração do conector da Palo Alto Networks.
deviceTrustConfig

object (DeviceTrustConfig)

Configuração do conector de confiança do dispositivo.
crowdStrikeXdrConfig

object (CrowdStrikeXdrConfig)

Configuração do conector XDR da CrowdStrike.
pubSubXdrConfig

object (PubSubXdrConfig)

Configuração do conector XDR do Pub/Sub.

SplunkConfig

Configuração do conector do Splunk.

Representação JSON 
{
  "unsecureScheme": boolean,
  "host": string,
  "portNumber": integer,
  "hecToken": string,
  "source": string,
  "reportingSettings": {
    object (ReportingSettings)
  }
}
Campos
unsecureScheme

boolean

Opcional. Se deve usar um esquema HTTP não seguro. O padrão é "false" (HTTPS).
host

string

Obrigatório. Host para identificar o servidor específico do cliente que vai receber os eventos.
portNumber

integer

Opcional. O número da porta a ser usada. Se não for definido, a porta padrão do Splunk será usada.
hecToken

string

Obrigatório. Somente entrada. O token do coletor de eventos HTTP da entrada de dados a ser usado como um cabeçalho de autorização.
source

string

Opcional. Nome de origem opcional para substituir o padrão definido no Admin Console do Splunk.
reportingSettings

object (ReportingSettings)

Obrigatório. As configurações de relatórios para a configuração do Splunk.

ReportingSettings

Configurações de relatórios para configurações de conector.

Representação JSON 
{
  "enabledDefaultEvents": [
    enum (DefaultEvent)
  ],
  "enabledOptInEvents": [
    enum (OptInEvent)
  ],
  "enabledDeviceEvents": [
    enum (DeviceEvent)
  ]
}
Campos
enabledDefaultEvents[]

enum (DefaultEvent)

Opcional. A lista de eventos de usuário e navegador ativados para esse conector. Uma lista vazia desativa todos os eventos padrão, e usar ALL_DEFAULT_EVENTS ativa todos os eventos padrão.
enabledOptInEvents[]

enum (OptInEvent)

Opcional. A lista de eventos de inclusão ativados para essa configuração. Uma lista vazia desativa todos os eventos de ativação, e usar ALL_OPT_IN_EVENTS ativa todos eles.
enabledDeviceEvents[]

enum (DeviceEvent)

Opcional. A lista de eventos do dispositivo ativados para essa configuração. Uma lista vazia desativa todos os eventos do dispositivo, e usar ALL_DEVICE_EVENTS ativa todos os eventos do dispositivo.

DefaultEvent

Eventos de relatórios padrão. Outros eventos podem ser adicionados.

Tipos enumerados
DEFAULT_EVENT_UNSPECIFIED Valor padrão. Esse valor não é usado.
ALL_DEFAULT_EVENTS Todos os eventos padrão.
BROWSER_CRASH_EVENT Evento de falha do navegador.
BROWSER_EXTENSION_INSTALL_EVENT Evento de instalação de extensão do navegador.
CONTENT_TRANSFER_EVENT Evento de transferência de conteúdo.
CONTENT_UNSCANNED_EVENT Evento de conteúdo não verificado.
DATA_ACCESS_CONTROL_EVENT Evento de acesso aos dados.
MALWARE_TRANSFER_EVENT Evento de transferência de malware.
PASSWORD_CHANGED_EVENT Evento de mudança de senha.
PASSWORD_REUSE_EVENT Evento de reutilização de senha.
SENSITIVE_DATA_TRANSFER_EVENT Evento de transferência de dados sensíveis.
SUSPICIOUS_URL_EVENT Evento de URL suspeito.
UNSAFE_SITE_VISIT_EVENT Evento de visita a site não seguro.
URL_FILTERING_INTERSTITIAL_EVENT Evento intersticial de filtragem de URL.

OptInEvent

Eventos de relatórios de permissão. Outros eventos podem ser adicionados.

Tipos enumerados
OPT_IN_EVENT_UNSPECIFIED Valor padrão. Esse valor não é usado.
ALL_OPT_IN_EVENTS Todos os eventos de ativação.
LOGIN_EVENT Evento de login.
PASSWORD_BREACH_EVENT Evento de violação de senha.
URL_NAVIGATION_EVENT Evento de navegação de URL.
EXTENSION_TELEMETRY_EVENT Evento de telemetria de extensão.

DeviceEvent

Eventos do dispositivo. Outros eventos podem ser adicionados.

Tipos enumerados
DEVICE_EVENT_UNSPECIFIED Valor padrão. Esse valor não é usado.
ALL_DEVICE_EVENTS Todos os eventos do dispositivo.
ADD_REMOVE_USER_EVENT Adicionar/remover evento do usuário.
LOGIN_LOGOUT_EVENT Evento de login/logout.
CRD_EVENT Evento de CRD.
PERIPHERAL_EVENT Evento de periférico.

GoogleSecOpsConfig

Configuração do conector do Google SecOps.

Representação JSON 
{
  "apiKey": string,
  "host": string,
  "reportingSettings": {
    object (ReportingSettings)
  }
}
Campos
apiKey

string

Obrigatório. Somente entrada. Chave de API a ser usada na API de ingestão.
host

string

Obrigatório. Host do endpoint de API de ingestão. Permite que o cliente faça upload de eventos para servidores em regiões geográficas específicas. As configurações atuais que não têm essa definição usam os EUA como padrão.
reportingSettings

object (ReportingSettings)

Obrigatório. As configurações de relatórios para a configuração do Google SecOps.

PubSubConfig

Configuração do conector do Pub/Sub.

Representação JSON 
{
  "topicFullPath": string,
  "reportingSettings": {
    object (ReportingSettings)
  }
}
Campos
topicFullPath

string

Obrigatório. O caminho completo do tópico para enviar o evento.
reportingSettings

object (ReportingSettings)

Obrigatório. As configurações de relatórios para a configuração do Pub/Sub.

CrowdStrikeConfig

Configuração do conector da CrowdStrike.

Representação JSON 
{
  "apiKey": string,
  "host": string,
  "reportingSettings": {
    object (ReportingSettings)
  }
}
Campos
apiKey

string

Obrigatório. Somente entrada. Chave de API a ser usada na API de ingestão.
host

string

Obrigatório. Host para identificar o servidor específico do cliente que vai receber os eventos.
reportingSettings

object (ReportingSettings)

Obrigatório. As configurações de relatórios da configuração do CrowdStrike.

CrowdStrikeFalconNextGenConfig

Configuração do conector Next Gen do CrowdStrike Falcon.

Representação JSON 
{
  "apiKey": string,
  "host": string,
  "reportingSettings": {
    object (ReportingSettings)
  }
}
Campos
apiKey

string

Obrigatório. Somente entrada. Chave de API a ser usada na API de ingestão.
host

string

Obrigatório. Host para identificar o servidor específico do cliente que vai receber os eventos.
reportingSettings

object (ReportingSettings)

Obrigatório. As configurações de relatórios da configuração do Next-Gen do CrowdStrike Falcon.

PaloAltoNetworksConfig

Configuração do conector da Palo Alto Networks.

Representação JSON 
{
  "apiKey": string,
  "host": string,
  "reportingSettings": {
    object (ReportingSettings)
  }
}
Campos
apiKey

string

Obrigatório. Somente entrada. Chave de API a ser usada na API de ingestão.
host

string

Obrigatório. Host para identificar o servidor específico do cliente que vai receber os eventos.
reportingSettings

object (ReportingSettings)

Obrigatório. As configurações de relatórios da configuração da Palo Alto Networks.

DeviceTrustConfig

Configuração de confiança do dispositivo para conectores de confiança do dispositivo.

Representação JSON 
{
  "serviceProvider": enum (ServiceProvider),
  "urlMatchers": [
    string
  ],
  "serviceAccounts": [
    string
  ],
  "scope": enum (BrowserEnforcementScope)
}
Campos
serviceProvider

enum (ServiceProvider)

Opcional. O provedor de serviços do conector de confiança do dispositivo.
urlMatchers[]

string

Obrigatório. Lista de URLs que podem fazer parte do fluxo de atestado para receber o conjunto de indicadores da máquina. Os URLs precisam ter um esquema HTTPS, como "https://example.com". Caracteres curinga (*) são permitidos. Para informações detalhadas sobre padrões de URL válidos, consulte https://cloud.google.com/docs/chrome-enterprise/policies/url-patterns.
serviceAccounts[]

string

Obrigatório. Uma lista de endereços de e-mail das contas de serviço que têm permissão para chamar a API Acesso verificado com acesso total.
scope

enum (BrowserEnforcementScope)

Obrigatório. O escopo em que essa configuração será aplicada. Isso só se aplica ao navegador Chrome, já que no ChromeOS ele está sempre ativado.

ServiceProvider

O provedor de serviços do conector de confiança do dispositivo.

Tipos enumerados
SERVICE_PROVIDER_UNSPECIFIED Valor padrão.
UNIVERSAL_DEVICE_TRUST Conector de confiança do dispositivo universal.
OKTA Provedor de serviços do Okta.
PING_IDENTITY Provedor de serviços da Ping Identity.
ONELOGIN Provedor de serviços OneLogin.
DUO Provedor de serviços do Duo.
ZSCALER Provedor de serviços da Zscaler.
OMNISSA Provedor de serviços da Omnissa.
JUMPCLOUD Provedor de serviços do JumpCloud.

BrowserEnforcementScope

O nível de aplicação obrigatória do conector de confiança do dispositivo.

Tipos enumerados
BROWSER_ENFORCEMENT_SCOPE_UNSPECIFIED Valor padrão. Esse valor não é usado.
BROWSERS_ONLY Apenas navegadores são aplicados.
PROFILES_ONLY Somente perfis são aplicados.
BROWSERS_AND_PROFILES Os navegadores e perfis são aplicados.

CrowdStrikeXdrConfig

Configuração do conector XDR da CrowdStrike.

Representação JSON 
{
  "apiKey": string,
  "host": string,
  "xdrSettings": {
    object (XdrSettings)
  }
}
Campos
apiKey

string

Obrigatório. Somente entrada. Chave de API a ser usada na API de ingestão.
host

string

Obrigatório. Host para identificar o servidor específico do cliente que vai receber os eventos.
xdrSettings

object (XdrSettings)

Obrigatório. As configurações de XDR para a configuração do XDR da CrowdStrike.

XdrSettings

Configurações de XDR para configurações de conector.

Representação JSON 
{
  "enableAllXdrEvents": boolean
}
Campos
enableAllXdrEvents

boolean

Obrigatório. Se todos os eventos de XDR devem ser ativados.

PubSubXdrConfig

Configuração do conector XDR do Pub/Sub.

Representação JSON 
{
  "topicFullPath": string,
  "xdrSettings": {
    object (XdrSettings)
  }
}
Campos
topicFullPath

string

Obrigatório. O caminho completo do tópico para enviar o evento.
xdrSettings

object (XdrSettings)

Obrigatório. As configurações de XDR para a configuração do Pub/Sub XDR.

ConnectorConfigStatus

O status da configuração do conector.

Representação JSON 
{
  "state": enum (ConfigState),
  "failureStartTime": string,
  "updateTime": string
}
Campos
state

enum (ConfigState)

Apenas saída. O estado da configuração do conector. O estado do conector é desativado se ele não tiver enviado um evento nas últimas 24 horas.
failureStartTime

string (Timestamp format)

Apenas saída. Tempo de gravação de campo da primeira falha desde o último evento de sucesso. Este campo só é definido quando o estado é DISABLED_BY_FAILURES.

Usa o padrão RFC 3339, em que a saída gerada é sempre convertida em Z e tem 0, 3, 6 ou 9 dígitos fracionários. Além de "Z", outros ajustes também são aceitos. Exemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" ou "2014-10-02T15:01:23+05:30".
updateTime

string (Timestamp format)

Apenas saída. Horário do registro do campo da modificação mais recente do status. Para ENABLED, esse é o momento em que o status foi alterado para ENABLED. Para DISABLED_BY_FAILURES, esse é o horário da tentativa mais recente de enviar um evento a essa configuração.

Usa o padrão RFC 3339, em que a saída gerada é sempre convertida em Z e tem 0, 3, 6 ou 9 dígitos fracionários. Além de "Z", outros ajustes também são aceitos. Exemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" ou "2014-10-02T15:01:23+05:30".

ConfigState

O estado da configuração do conector. Outros estados podem ser adicionados.

Tipos enumerados
CONFIG_STATE_UNKNOWN Valor padrão.
ENABLED A configuração do conector está ativada.
DISABLED_BY_FAILURES A configuração do conector está temporariamente desativada devido a falhas.

Métodos

create

 Cria uma configuração de conector.

delete

 Exclui uma configuração de conector.

get

 Recebe uma configuração de conector com ID do cliente e ID da configuração.

list

 Lista as configurações de conector de um cliente.

patch

 Atualiza uma configuração de conector.