REST Resource: customers.connectorConfigs

Risorsa: ConnectorConfig

Una rappresentazione di una configurazione del connettore.

Rappresentazione JSON 
{
  "name": string,
  "displayName": string,
  "type": enum (ConnectorType),
  "details": {
    object (ConnectorConfigDetails)
  },
  "status": {
    object (ConnectorConfigStatus)
  }
}
Campi
name

string

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

string

Obbligatorio. Il nome visualizzato della configurazione.
type

enum (ConnectorType)

Obbligatorio. Il tipo di connettore.
details

object (ConnectorConfigDetails)

Obbligatorio. I dettagli della configurazione del connettore.
status

object (ConnectorConfigStatus)

Solo output. Lo stato della configurazione del connettore.

ConnectorType

Opzioni per il tipo di configurazione del connettore.

Enum
CONNECTOR_TYPE_UNSPECIFIED Valore predefinito. Questo valore non viene utilizzato.
REPORTING Connettore di reporting.
DEVICE_TRUST Connettore attendibilità dispositivo.
XDR Connettore XDR.
IDENTITY_BASED_ENROLLMENT Connettore di autenticazione.
CERTIFICATE_AUTHORITY Connettore dell'autorità di certificazione. Non ancora supportato nell'API.
ROOT_STORE Connettore certificato radice.

ConnectorConfigDetails

I dettagli della configurazione del connettore.

Rappresentazione 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.
}
Campi
Campo unione details. Dettagli specifici del connettore. details può essere solo uno dei seguenti tipi:
splunkConfig

object (SplunkConfig)

Configurazione del connettore Splunk.
googleSecOpsConfig

object (GoogleSecOpsConfig)

Configurazione del connettore Google SecOps.
pubSubConfig

object (PubSubConfig)

Configurazione del connettore Pub/Sub
crowdStrikeConfig

object (CrowdStrikeConfig)

Configurazione del connettore CrowdStrike.
crowdStrikeFalconNextGenConfig

object (CrowdStrikeFalconNextGenConfig)

Configurazione del connettore CrowdStrike Falcon Next Gen.
paloAltoNetworksConfig

object (PaloAltoNetworksConfig)

Configurazione del connettore Palo Alto Networks.
deviceTrustConfig

object (DeviceTrustConfig)

Configurazione del connettore attendibilità dispositivo.
crowdStrikeXdrConfig

object (CrowdStrikeXdrConfig)

Configurazione del connettore XDR di CrowdStrike.
pubSubXdrConfig

object (PubSubXdrConfig)

Configurazione del connettore XDR Pub/Sub.

SplunkConfig

Configurazione del connettore Splunk.

Rappresentazione JSON 
{
  "unsecureScheme": boolean,
  "host": string,
  "portNumber": integer,
  "hecToken": string,
  "source": string,
  "reportingSettings": {
    object (ReportingSettings)
  }
}
Campi
unsecureScheme

boolean

Facoltativo. Se utilizzare uno schema HTTP non sicuro. Il valore predefinito è false (HTTPS).
host

string

Obbligatorio. Host per identificare il server specifico del cliente per ricevere gli eventi.
portNumber

integer

Facoltativo. Il numero di porta da utilizzare. Se non impostata, viene utilizzata la porta Splunk predefinita.
hecToken

string

Obbligatorio. Solo input. Il token del raccoglitore eventi HTTP dell'input di dati da utilizzare come intestazione di autorizzazione.
source

string

Facoltativo. Nome dell'origine facoltativo per ignorare quello predefinito impostato nella Console di amministrazione Splunk.
reportingSettings

object (ReportingSettings)

Obbligatorio. Le impostazioni dei report per la configurazione di Splunk.

ReportingSettings

Impostazioni di reporting per le configurazioni dei connettori.

Rappresentazione JSON 
{
  "enabledDefaultEvents": [
    enum (DefaultEvent)
  ],
  "enabledOptInEvents": [
    enum (OptInEvent)
  ],
  "enabledDeviceEvents": [
    enum (DeviceEvent)
  ]
}
Campi
enabledDefaultEvents[]

enum (DefaultEvent)

Facoltativo. L'elenco degli eventi di utenti e browser abilitati per questo connettore. Un elenco vuoto disabilita tutti gli eventi predefiniti, mentre l'utilizzo di ALL_DEFAULT_EVENTS abilita tutti gli eventi predefiniti.
enabledOptInEvents[]

enum (OptInEvent)

Facoltativo. L'elenco degli eventi di attivazione abilitati per questa configurazione. Un elenco vuoto disattiva tutti gli eventi di attivazione e l'utilizzo di ALL_OPT_IN_EVENTS attiverà tutti gli eventi di attivazione.
enabledDeviceEvents[]

enum (DeviceEvent)

Facoltativo. L'elenco degli eventi del dispositivo abilitati per questa configurazione. Un elenco vuoto disattiva tutti gli eventi del dispositivo, mentre l'utilizzo di ALL_DEVICE_EVENTS attiva tutti gli eventi del dispositivo.

DefaultEvent

Eventi di reporting predefiniti. Potrebbero essere aggiunti altri eventi.

Enum
DEFAULT_EVENT_UNSPECIFIED Valore predefinito. Questo valore non viene utilizzato.
ALL_DEFAULT_EVENTS Tutti gli eventi predefiniti.
BROWSER_CRASH_EVENT Evento di arresto anomalo del browser.
BROWSER_EXTENSION_INSTALL_EVENT Evento di installazione dell'estensione del browser.
CONTENT_TRANSFER_EVENT Evento di trasferimento dei contenuti.
CONTENT_UNSCANNED_EVENT Evento contenuti non analizzati.
DATA_ACCESS_CONTROL_EVENT Evento di controllo dell'accesso ai dati.
MALWARE_TRANSFER_EVENT Evento di trasferimento di malware.
PASSWORD_CHANGED_EVENT Evento Password modificata.
PASSWORD_REUSE_EVENT Evento di riutilizzo della password.
SENSITIVE_DATA_TRANSFER_EVENT Evento di trasferimento di dati sensibili.
SUSPICIOUS_URL_EVENT Evento URL sospetto.
UNSAFE_SITE_VISIT_EVENT Evento visita a siti non sicuri.
URL_FILTERING_INTERSTITIAL_EVENT Evento interstitial di filtro URL.

OptInEvent

Eventi di reporting con consenso esplicito. Potrebbero essere aggiunti altri eventi.

Enum
OPT_IN_EVENT_UNSPECIFIED Valore predefinito. Questo valore non viene utilizzato.
ALL_OPT_IN_EVENTS Tutti gli eventi di attivazione.
LOGIN_EVENT Evento di accesso.
PASSWORD_BREACH_EVENT Evento di violazione della password.
URL_NAVIGATION_EVENT Evento di navigazione URL.
EXTENSION_TELEMETRY_EVENT Evento di telemetria dell'estensione.

DeviceEvent

Eventi dispositivo. Potrebbero essere aggiunti altri eventi.

Enum
DEVICE_EVENT_UNSPECIFIED Valore predefinito. Questo valore non viene utilizzato.
ALL_DEVICE_EVENTS Tutti gli eventi del dispositivo.
ADD_REMOVE_USER_EVENT Aggiungi/rimuovi evento utente.
LOGIN_LOGOUT_EVENT Evento di accesso/uscita.
CRD_EVENT Evento CRD.
PERIPHERAL_EVENT Evento periferica.

GoogleSecOpsConfig

Configurazione del connettore Google SecOps.

Rappresentazione JSON 
{
  "apiKey": string,
  "host": string,
  "reportingSettings": {
    object (ReportingSettings)
  }
}
Campi
apiKey

string

Obbligatorio. Solo input. Chiave API da utilizzare nell'API di importazione.
host

string

Obbligatorio. Host dell'endpoint API di importazione. Consente al cliente di caricare eventi sui server in regioni geografiche specifiche. Le configurazioni esistenti che non hanno questa impostazione utilizzano per impostazione predefinita gli Stati Uniti.
reportingSettings

object (ReportingSettings)

Obbligatorio. Le impostazioni dei report per la configurazione di Google SecOps.

PubSubConfig

Configurazione del connettore Pub/Sub

Rappresentazione JSON 
{
  "topicFullPath": string,
  "reportingSettings": {
    object (ReportingSettings)
  }
}
Campi
topicFullPath

string

Obbligatorio. Il percorso completo all'argomento a cui inviare l'evento.
reportingSettings

object (ReportingSettings)

Obbligatorio. Le impostazioni di generazione dei report per la configurazione di Pub/Sub.

CrowdStrikeConfig

Configurazione del connettore CrowdStrike.

Rappresentazione JSON 
{
  "apiKey": string,
  "host": string,
  "reportingSettings": {
    object (ReportingSettings)
  }
}
Campi
apiKey

string

Obbligatorio. Solo input. Chiave API da utilizzare nell'API di importazione.
host

string

Obbligatorio. Host per identificare il server specifico del cliente per ricevere gli eventi.
reportingSettings

object (ReportingSettings)

Obbligatorio. Le impostazioni di reporting per la configurazione di CrowdStrike.

CrowdStrikeFalconNextGenConfig

Configurazione del connettore CrowdStrike Falcon Next Gen.

Rappresentazione JSON 
{
  "apiKey": string,
  "host": string,
  "reportingSettings": {
    object (ReportingSettings)
  }
}
Campi
apiKey

string

Obbligatorio. Solo input. Chiave API da utilizzare nell'API di importazione.
host

string

Obbligatorio. Host per identificare il server specifico del cliente per ricevere gli eventi.
reportingSettings

object (ReportingSettings)

Obbligatorio. Le impostazioni di reporting per la configurazione di CrowdStrike Falcon Next Gen.

PaloAltoNetworksConfig

Configurazione del connettore Palo Alto Networks.

Rappresentazione JSON 
{
  "apiKey": string,
  "host": string,
  "reportingSettings": {
    object (ReportingSettings)
  }
}
Campi
apiKey

string

Obbligatorio. Solo input. Chiave API da utilizzare nell'API di importazione.
host

string

Obbligatorio. Host per identificare il server specifico del cliente per ricevere gli eventi.
reportingSettings

object (ReportingSettings)

Obbligatorio. Le impostazioni di reporting per la configurazione di Palo Alto Networks.

DeviceTrustConfig

Configurazione dell'attendibilità dispositivo per i connettori di attendibilità dispositivo.

Rappresentazione JSON 
{
  "serviceProvider": enum (ServiceProvider),
  "urlMatchers": [
    string
  ],
  "serviceAccounts": [
    string
  ],
  "scope": enum (BrowserEnforcementScope)
}
Campi
serviceProvider

enum (ServiceProvider)

Facoltativo. Il fornitore di servizi per il connettore attendibilità dispositivo.
urlMatchers[]

string

Obbligatorio. Elenco degli URL autorizzati a far parte del flusso di attestazione per ricevere l'insieme di segnali dalla macchina. Gli URL devono avere uno schema HTTPS, ad esempio "https://example.com". I caratteri jolly * sono consentiti. Per informazioni dettagliate sui pattern URL validi, visita la pagina https://cloud.google.com/docs/chrome-enterprise/policies/url-patterns.
serviceAccounts[]

string

Obbligatorio. Un elenco di indirizzi email dei service account che possono chiamare l'API Accesso verificato con accesso completo.
scope

enum (BrowserEnforcementScope)

Obbligatorio. L'ambito in cui verrà applicata questa configurazione. Tieni presente che questa impostazione si applica solo al browser Chrome, in quanto in ChromeOS è sempre applicata.

ServiceProvider

Il fornitore di servizi per il connettore attendibilità dispositivo.

Enum
SERVICE_PROVIDER_UNSPECIFIED Valore predefinito.
UNIVERSAL_DEVICE_TRUST Connettore attendibilità dispositivo universale.
OKTA Provider di servizi Okta.
PING_IDENTITY Provider di servizi Ping Identity.
ONELOGIN Provider di servizi OneLogin.
DUO Fornitore di servizi Duo.
ZSCALER Fornitore di servizi Zscaler.
OMNISSA fornitore di servizi Omnissa.
JUMPCLOUD Fornitore di servizi JumpCloud.

BrowserEnforcementScope

Il livello di applicazione forzata del connettore attendibilità dispositivo.

Enum
BROWSER_ENFORCEMENT_SCOPE_UNSPECIFIED Valore predefinito. Questo valore non viene utilizzato.
BROWSERS_ONLY Vengono applicati solo i browser.
PROFILES_ONLY Vengono applicati solo i profili.
BROWSERS_AND_PROFILES Vengono applicati sia ai browser che ai profili.

CrowdStrikeXdrConfig

Configurazione del connettore XDR di CrowdStrike.

Rappresentazione JSON 
{
  "apiKey": string,
  "host": string,
  "xdrSettings": {
    object (XdrSettings)
  }
}
Campi
apiKey

string

Obbligatorio. Solo input. Chiave API da utilizzare nell'API di importazione.
host

string

Obbligatorio. Host per identificare il server specifico del cliente per ricevere gli eventi.
xdrSettings

object (XdrSettings)

Obbligatorio. Le impostazioni XDR per la configurazione XDR di CrowdStrike.

XdrSettings

Impostazioni XDR per le configurazioni dei connettori.

Rappresentazione JSON 
{
  "enableAllXdrEvents": boolean
}
Campi
enableAllXdrEvents

boolean

Obbligatorio. Se attivare tutti gli eventi XDR.

PubSubXdrConfig

Configurazione del connettore XDR Pub/Sub.

Rappresentazione JSON 
{
  "topicFullPath": string,
  "xdrSettings": {
    object (XdrSettings)
  }
}
Campi
topicFullPath

string

Obbligatorio. Il percorso completo all'argomento a cui inviare l'evento.
xdrSettings

object (XdrSettings)

Obbligatorio. Le impostazioni XDR per la configurazione XDR di Pub/Sub.

ConnectorConfigStatus

Lo stato della configurazione del connettore.

Rappresentazione JSON 
{
  "state": enum (ConfigState),
  "failureStartTime": string,
  "updateTime": string
}
Campi
state

enum (ConfigState)

Solo output. Lo stato della configurazione del connettore. Lo stato del connettore è disattivato se il connettore non ha inviato correttamente un evento nelle ultime 24 ore.
failureStartTime

string (Timestamp format)

Solo output. Ora di registrazione sul campo del primo errore dall'ultimo evento riuscito. Questo campo viene impostato solo quando lo stato è DISABLED_BY_FAILURES.

Utilizza RFC 3339, in cui l'output generato è sempre con normalizzazione Z e utilizza 0, 3, 6 o 9 cifre frazionarie. Sono accettati anche offset diversi da "Z". Esempi: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".
updateTime

string (Timestamp format)

Solo output. Ora di registrazione sul campo dell'ultima modifica dello stato. Per ENABLED, questo è il momento in cui lo stato è stato modificato in ENABLED. Per DISABLED_BY_FAILURES, questo è l'orario dell'ultimo tentativo non riuscito di invio di un evento a questa configurazione.

Utilizza RFC 3339, in cui l'output generato è sempre con normalizzazione Z e utilizza 0, 3, 6 o 9 cifre frazionarie. Sono accettati anche offset diversi da "Z". Esempi: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".

ConfigState

Lo stato della configurazione del connettore. Potrebbero essere aggiunti altri stati.

Enum
CONFIG_STATE_UNKNOWN Valore predefinito.
ENABLED La configurazione del connettore è abilitata.
DISABLED_BY_FAILURES La configurazione del connettore è disabilitata temporaneamente a causa di errori.

Metodi

create

 Crea una configurazione del connettore.

delete

 Elimina una configurazione del connettore.

get

 Recupera una configurazione del connettore con ID cliente e ID configurazione.

list

 Elenca le configurazioni del connettore di un cliente.

patch

 Aggiorna una configurazione del connettore.