REST Resource: customers.connectorConfigs

Ressource : ConnectorConfig

Représentation d'une configuration de connecteur.

Représentation JSON 
{
  "name": string,
  "displayName": string,
  "type": enum (ConnectorType),
  "details": {
    object (ConnectorConfigDetails)
  },
  "status": {
    object (ConnectorConfigStatus)
  }
}
Champs
name

string

Identifiant. Format : customers/{customer}/connectorConfigs/{connectorConfig}
displayName

string

Obligatoire. Nom à afficher de la configuration.
type

enum (ConnectorType)

Obligatoire. Type de connecteur.
details

object (ConnectorConfigDetails)

Obligatoire. Détails de la configuration du connecteur.
status

object (ConnectorConfigStatus)

Uniquement en sortie. État de la configuration du connecteur.

ConnectorType

Options pour le type de configuration du connecteur.

Enums
CONNECTOR_TYPE_UNSPECIFIED Valeur par défaut. Cette valeur n'est pas utilisée.
REPORTING Connecteur de reporting.
DEVICE_TRUST Connecteur de confiance de l'appareil.
XDR Connecteur XDR.
IDENTITY_BASED_ENROLLMENT Connecteur d'authentification.
CERTIFICATE_AUTHORITY Connecteur d'autorité de certification. Pas encore compatible avec l'API.
ROOT_STORE Connecteur de certificat racine.

ConnectorConfigDetails

Détails de la configuration du connecteur.

Représentation 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.
}
Champs
Champ d'union details. Détails spécifiques au connecteur. details ne peut être qu'un des éléments suivants :
splunkConfig

object (SplunkConfig)

Configuration du connecteur Splunk.
googleSecOpsConfig

object (GoogleSecOpsConfig)

Configuration du connecteur Google SecOps
pubSubConfig

object (PubSubConfig)

Configuration du connecteur Pub/Sub
crowdStrikeConfig

object (CrowdStrikeConfig)

Configuration du connecteur CrowdStrike.
crowdStrikeFalconNextGenConfig

object (CrowdStrikeFalconNextGenConfig)

Configuration du connecteur CrowdStrike Falcon Next-Gen
paloAltoNetworksConfig

object (PaloAltoNetworksConfig)

Configuration du connecteur Palo Alto Networks
deviceTrustConfig

object (DeviceTrustConfig)

Configuration du connecteur de confiance de l'appareil
crowdStrikeXdrConfig

object (CrowdStrikeXdrConfig)

Configuration du connecteur XDR CrowdStrike
pubSubXdrConfig

object (PubSubXdrConfig)

Configuration du connecteur XDR Pub/Sub

SplunkConfig

Configuration du connecteur Splunk.

Représentation JSON 
{
  "unsecureScheme": boolean,
  "host": string,
  "portNumber": integer,
  "hecToken": string,
  "source": string,
  "reportingSettings": {
    object (ReportingSettings)
  }
}
Champs
unsecureScheme

boolean

Facultatif. Indique s'il faut utiliser un schéma HTTP non sécurisé. La valeur par défaut est "false" (HTTPS).
host

string

Obligatoire. Hôte permettant d'identifier le serveur spécifique au client pour recevoir les événements.
portNumber

integer

Facultatif. Numéro de port à utiliser. Si ce paramètre n'est pas défini, le port Splunk par défaut est utilisé.
hecToken

string

Obligatoire. Uniquement en entrée. Jeton de collecteur d'événements HTTP de l'entrée de données à utiliser comme en-tête d'autorisation.
source

string

Facultatif. Nom de source facultatif permettant de remplacer celui défini par défaut dans la console d'administration Splunk.
reportingSettings

object (ReportingSettings)

Obligatoire. Paramètres de création de rapports pour la configuration Splunk.

ReportingSettings

Paramètres de reporting pour les configurations de connecteurs.

Représentation JSON 
{
  "enabledDefaultEvents": [
    enum (DefaultEvent)
  ],
  "enabledOptInEvents": [
    enum (OptInEvent)
  ],
  "enabledDeviceEvents": [
    enum (DeviceEvent)
  ]
}
Champs
enabledDefaultEvents[]

enum (DefaultEvent)

Facultatif. Liste des événements utilisateur et de navigateur activés pour ce connecteur. Une liste vide désactive tous les événements par défaut, tandis que l'utilisation de ALL_DEFAULT_EVENTS active tous les événements par défaut.
enabledOptInEvents[]

enum (OptInEvent)

Facultatif. Liste des événements activés pour cette configuration. Une liste vide désactive tous les événements d'activation, tandis que l'utilisation de ALL_OPT_IN_EVENTS active tous les événements d'activation.
enabledDeviceEvents[]

enum (DeviceEvent)

Facultatif. Liste des événements d'appareil activés pour cette configuration. Une liste vide désactive tous les événements de l'appareil, tandis que l'utilisation de ALL_DEVICE_EVENTS les active tous.

DefaultEvent

Événements de reporting par défaut. D'autres événements pourront être ajoutés.

Enums
DEFAULT_EVENT_UNSPECIFIED Valeur par défaut. Cette valeur n'est pas utilisée.
ALL_DEFAULT_EVENTS Tous les événements par défaut.
BROWSER_CRASH_EVENT Événement de plantage du navigateur.
BROWSER_EXTENSION_INSTALL_EVENT Événement d'installation de l'extension de navigateur.
CONTENT_TRANSFER_EVENT Événement de transfert de contenu.
CONTENT_UNSCANNED_EVENT Événement "Contenu non analysé".
DATA_ACCESS_CONTROL_EVENT Événement de contrôle des accès aux données.
MALWARE_TRANSFER_EVENT Événement de transfert de logiciel malveillant.
PASSWORD_CHANGED_EVENT Événement de modification du mot de passe.
PASSWORD_REUSE_EVENT Événement de réutilisation de mot de passe.
SENSITIVE_DATA_TRANSFER_EVENT Événement de transfert de données sensibles.
SUSPICIOUS_URL_EVENT Événement d'URL suspecte.
UNSAFE_SITE_VISIT_EVENT Événement de visite d'un site non sécurisé.
URL_FILTERING_INTERSTITIAL_EVENT Événement d'interstitiel de filtrage d'URL.

OptInEvent

Événements de reporting activés D'autres événements pourront être ajoutés.

Enums
OPT_IN_EVENT_UNSPECIFIED Valeur par défaut. Cette valeur n'est pas utilisée.
ALL_OPT_IN_EVENTS Tous les événements d'activation.
LOGIN_EVENT Événement de connexion.
PASSWORD_BREACH_EVENT Événement de mot de passe piraté.
URL_NAVIGATION_EVENT Événement de navigation vers une URL.
EXTENSION_TELEMETRY_EVENT Événement de télémétrie d'extension.

DeviceEvent

Événements de l'appareil. D'autres événements pourront être ajoutés.

Enums
DEVICE_EVENT_UNSPECIFIED Valeur par défaut. Cette valeur n'est pas utilisée.
ALL_DEVICE_EVENTS Tous les événements de l'appareil.
ADD_REMOVE_USER_EVENT Ajouter/Supprimer un événement utilisateur.
LOGIN_LOGOUT_EVENT Événement de connexion/déconnexion.
CRD_EVENT Événement Bureau à distance Chrome.
PERIPHERAL_EVENT Événement du périphérique.

GoogleSecOpsConfig

Configuration du connecteur Google SecOps

Représentation JSON 
{
  "apiKey": string,
  "host": string,
  "reportingSettings": {
    object (ReportingSettings)
  }
}
Champs
apiKey

string

Obligatoire. Uniquement en entrée. Clé API à utiliser sur l'API d'ingestion.
host

string

Obligatoire. Hôte du point de terminaison de l'API d'ingestion. Permet au client d'importer des événements sur des serveurs situés dans des régions géographiques spécifiques. Les configurations existantes qui ne disposent pas de ce paramètre sont définies par défaut sur les États-Unis.
reportingSettings

object (ReportingSettings)

Obligatoire. Paramètres de création de rapports pour la configuration Google SecOps.

PubSubConfig

Configuration du connecteur Pub/Sub

Représentation JSON 
{
  "topicFullPath": string,
  "reportingSettings": {
    object (ReportingSettings)
  }
}
Champs
topicFullPath

string

Obligatoire. Chemin d'accès complet au sujet auquel envoyer l'événement.
reportingSettings

object (ReportingSettings)

Obligatoire. Paramètres de création de rapports pour la configuration Pub/Sub.

CrowdStrikeConfig

Configuration du connecteur CrowdStrike.

Représentation JSON 
{
  "apiKey": string,
  "host": string,
  "reportingSettings": {
    object (ReportingSettings)
  }
}
Champs
apiKey

string

Obligatoire. Uniquement en entrée. Clé API à utiliser sur l'API d'ingestion.
host

string

Obligatoire. Hôte permettant d'identifier le serveur spécifique au client pour recevoir les événements.
reportingSettings

object (ReportingSettings)

Obligatoire. Paramètres de reporting pour la configuration CrowdStrike.

CrowdStrikeFalconNextGenConfig

Configuration du connecteur CrowdStrike Falcon Next-Gen

Représentation JSON 
{
  "apiKey": string,
  "host": string,
  "reportingSettings": {
    object (ReportingSettings)
  }
}
Champs
apiKey

string

Obligatoire. Uniquement en entrée. Clé API à utiliser sur l'API d'ingestion.
host

string

Obligatoire. Hôte permettant d'identifier le serveur spécifique au client pour recevoir les événements.
reportingSettings

object (ReportingSettings)

Obligatoire. Paramètres de reporting pour la configuration CrowdStrike Falcon Next-Gen.

PaloAltoNetworksConfig

Configuration du connecteur Palo Alto Networks

Représentation JSON 
{
  "apiKey": string,
  "host": string,
  "reportingSettings": {
    object (ReportingSettings)
  }
}
Champs
apiKey

string

Obligatoire. Uniquement en entrée. Clé API à utiliser sur l'API d'ingestion.
host

string

Obligatoire. Hôte permettant d'identifier le serveur spécifique au client pour recevoir les événements.
reportingSettings

object (ReportingSettings)

Obligatoire. Paramètres de création de rapports pour la configuration Palo Alto Networks.

DeviceTrustConfig

Configuration de la confiance de l'appareil pour les connecteurs de confiance de l'appareil.

Représentation JSON 
{
  "serviceProvider": enum (ServiceProvider),
  "urlMatchers": [
    string
  ],
  "serviceAccounts": [
    string
  ],
  "scope": enum (BrowserEnforcementScope)
}
Champs
serviceProvider

enum (ServiceProvider)

Facultatif. Fournisseur de services pour le connecteur de confiance de l'appareil.
urlMatchers[]

string

Obligatoire. Liste des URL autorisées à faire partie du parcours d'attestation visant à obtenir l'ensemble de signaux auprès de la machine. Les URL doivent être au format HTTPS, comme "https://example.com". Les caractères génériques (*) sont autorisés. Pour en savoir plus sur les formats d'URL valides, veuillez consulter https://cloud.google.com/docs/chrome-enterprise/policies/url-patterns.
serviceAccounts[]

string

Obligatoire. Liste des adresses e-mail des comptes de service autorisés à appeler l'API Verified Access avec un accès complet.
scope

enum (BrowserEnforcementScope)

Obligatoire. Champ d'application de cette configuration. Notez que cela ne s'applique qu'au navigateur Chrome, car il est toujours appliqué dans ChromeOS.

ServiceProvider

Fournisseur de services pour le connecteur de confiance de l'appareil.

Enums
SERVICE_PROVIDER_UNSPECIFIED Valeur par défaut.
UNIVERSAL_DEVICE_TRUST Connecteur Device Trust universel.
OKTA Fournisseur de services Okta.
PING_IDENTITY Fournisseur de services Ping Identity.
ONELOGIN Fournisseur de services OneLogin.
DUO Fournisseur de services Duo.
ZSCALER Fournisseur de services Zscaler.
OMNISSA Fournisseur de services Omnissa.
JUMPCLOUD Fournisseur de services JumpCloud.

BrowserEnforcementScope

Niveau d'application forcée du connecteur de confiance de l'appareil.

Enums
BROWSER_ENFORCEMENT_SCOPE_UNSPECIFIED Valeur par défaut. Cette valeur n'est pas utilisée.
BROWSERS_ONLY Seuls les navigateurs sont concernés.
PROFILES_ONLY Seuls les profils sont appliqués.
BROWSERS_AND_PROFILES Les navigateurs et les profils sont tous deux appliqués.

CrowdStrikeXdrConfig

Configuration du connecteur XDR CrowdStrike

Représentation JSON 
{
  "apiKey": string,
  "host": string,
  "xdrSettings": {
    object (XdrSettings)
  }
}
Champs
apiKey

string

Obligatoire. Uniquement en entrée. Clé API à utiliser sur l'API d'ingestion.
host

string

Obligatoire. Hôte permettant d'identifier le serveur spécifique au client pour recevoir les événements.
xdrSettings

object (XdrSettings)

Obligatoire. Paramètres XDR pour la configuration XDR CrowdStrike.

XdrSettings

Paramètres XDR pour les configurations de connecteurs.

Représentation JSON 
{
  "enableAllXdrEvents": boolean
}
Champs
enableAllXdrEvents

boolean

Obligatoire. Indique si tous les événements XDR doivent être activés.

PubSubXdrConfig

Configuration du connecteur XDR Pub/Sub

Représentation JSON 
{
  "topicFullPath": string,
  "xdrSettings": {
    object (XdrSettings)
  }
}
Champs
topicFullPath

string

Obligatoire. Chemin d'accès complet au sujet auquel envoyer l'événement.
xdrSettings

object (XdrSettings)

Obligatoire. Paramètres XDR pour la configuration Pub/Sub XDR.

ConnectorConfigStatus

État de la configuration du connecteur.

Représentation JSON 
{
  "state": enum (ConfigState),
  "failureStartTime": string,
  "updateTime": string
}
Champs
state

enum (ConfigState)

Uniquement en sortie. État de la configuration du connecteur. L'état du connecteur est "Désactivé" si le connecteur n'a pas réussi à envoyer d'événement au cours des dernières 24 heures.
failureStartTime

string (Timestamp format)

Uniquement en sortie. Heure d'enregistrement du premier échec depuis le dernier événement réussi. Ce champ n'est défini que lorsque l'état est DISABLED_BY_FAILURES.

Utilise la norme RFC 3339, où la sortie générée utilise toujours le format UTC (indiqué par "Z" pour le temps universel coordonné) avec des secondes fractionnaires de 0, 3, 6 ou 9 chiffres décimaux. Des décalages horaires autres que "Z" (UTC) sont également acceptés. Exemples : "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" ou "2014-10-02T15:01:23+05:30".
updateTime

string (Timestamp format)

Uniquement en sortie. Heure de l'enregistrement sur le terrain de la dernière modification de l'état. Pour ENABLED, il s'agit de l'heure à laquelle l'état est passé à ENABLED. Pour DISABLED_BY_FAILURES, il s'agit de l'heure de la dernière tentative infructueuse d'envoi d'un événement à cette configuration.

Utilise la norme RFC 3339, où la sortie générée utilise toujours le format UTC (indiqué par "Z" pour le temps universel coordonné) avec des secondes fractionnaires de 0, 3, 6 ou 9 chiffres décimaux. Des décalages horaires autres que "Z" (UTC) sont également acceptés. Exemples : "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" ou "2014-10-02T15:01:23+05:30".

ConfigState

État de la configuration du connecteur. D'autres États pourront être ajoutés.

Enums
CONFIG_STATE_UNKNOWN Valeur par défaut.
ENABLED La configuration du connecteur est activée.
DISABLED_BY_FAILURES La configuration du connecteur est temporairement désactivée en raison d'échecs.

Méthodes

create

 Crée une configuration de connecteur.

delete

 Supprime une configuration de connecteur.

get

 Obtient une configuration de connecteur avec l'ID client et l'ID de configuration.

list

 Liste les configurations de connecteur d'un client.

patch

 Met à jour une configuration de connecteur.