REST Resource: customers.connectorConfigs

Zasób: ConnectorConfig

Reprezentacja konfiguracji złącza.

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

string

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

string

Wymagane. Wyświetlana nazwa konfiguracji.
type

enum (ConnectorType)

Wymagane. Typ złącza.
details

object (ConnectorConfigDetails)

Wymagane. Szczegóły konfiguracji oprogramowania sprzęgającego.
status

object (ConnectorConfigStatus)

Tylko dane wyjściowe. Stan konfiguracji oprogramowania sprzęgającego.

ConnectorType

Opcje typu konfiguracji wtyczki.

Wartości w polu enum
CONNECTOR_TYPE_UNSPECIFIED Wartość domyślna. Ta wartość nie jest używana.
REPORTING Oprogramowanie sprzęgające do raportowania.
DEVICE_TRUST Oprogramowanie sprzęgające zaufania do urządzenia.
XDR Oprogramowanie sprzęgające XDR.
IDENTITY_BASED_ENROLLMENT Oprogramowanie sprzęgające do uwierzytelniania.
CERTIFICATE_AUTHORITY Oprogramowanie sprzęgające urzędu certyfikacji. Nie jest jeszcze obsługiwane w interfejsie API.
ROOT_STORE Oprogramowanie sprzęgające certyfikatu głównego.

ConnectorConfigDetails

Szczegóły konfiguracji oprogramowania sprzęgającego.

Zapis 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.
}
Pola
Pole zbiorcze details. Szczegóły dotyczące oprogramowania sprzęgającego. details może mieć tylko jedną z tych wartości:
splunkConfig

object (SplunkConfig)

Konfiguracja oprogramowania sprzęgającego Splunk.
googleSecOpsConfig

object (GoogleSecOpsConfig)

Konfiguracja oprogramowania sprzęgającego Google SecOps.
pubSubConfig

object (PubSubConfig)

Konfiguracja oprogramowania sprzęgającego Pub/Sub.
crowdStrikeConfig

object (CrowdStrikeConfig)

Konfiguracja oprogramowania sprzęgającego CrowdStrike.
crowdStrikeFalconNextGenConfig

object (CrowdStrikeFalconNextGenConfig)

Konfiguracja oprogramowania sprzęgającego CrowdStrike Falcon Next Gen.
paloAltoNetworksConfig

object (PaloAltoNetworksConfig)

Konfiguracja oprogramowania sprzęgającego Palo Alto Networks.
deviceTrustConfig

object (DeviceTrustConfig)

Konfiguracja oprogramowania sprzęgającego zaufania do urządzenia.
crowdStrikeXdrConfig

object (CrowdStrikeXdrConfig)

Konfiguracja oprogramowania sprzęgającego CrowdStrike XDR.
pubSubXdrConfig

object (PubSubXdrConfig)

Konfiguracja oprogramowania sprzęgającego XDR Pub/Sub.

SplunkConfig

Konfiguracja oprogramowania sprzęgającego Splunk.

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

boolean

Opcjonalnie. Określa, czy używać niezabezpieczonego schematu HTTP. Domyślna wartość to false (HTTPS).
host

string

Wymagane. Host, który identyfikuje serwer klienta, na który mają być przesyłane zdarzenia.
portNumber

integer

Opcjonalnie. Numer portu do użycia. Jeśli nie zostanie ustawiony, używany będzie domyślny port Splunk.
hecToken

string

Wymagane. Tylko dane wejściowe. Token kolektora zdarzeń HTTP wejścia danych, który ma być używany jako nagłówek autoryzacji.
source

string

Opcjonalnie. Opcjonalna nazwa źródła, która zastępuje domyślną nazwę ustawioną w konsoli administracyjnej Splunk.
reportingSettings

object (ReportingSettings)

Wymagane. Ustawienia raportowania dla konfiguracji Splunk.

ReportingSettings

Ustawienia raportowania dla konfiguracji oprogramowania sprzęgającego.

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

enum (DefaultEvent)

Opcjonalnie. Lista zdarzeń użytkownika i przeglądarki, które są włączone w przypadku tego oprogramowania sprzęgającego. Pusta lista wyłącza wszystkie domyślne zdarzenia, a użycie ALL_DEFAULT_EVENTS włącza wszystkie domyślne zdarzenia.
enabledOptInEvents[]

enum (OptInEvent)

Opcjonalnie. Lista wydarzeń wymagających zgody użytkownika, które są włączone w tej konfiguracji. Pusta lista wyłącza wszystkie zdarzenia, na które użytkownik wyraził zgodę, a użycie ALL_OPT_IN_EVENTS włącza wszystkie takie zdarzenia.
enabledDeviceEvents[]

enum (DeviceEvent)

Opcjonalnie. Lista zdarzeń na urządzeniu, które są włączone w tej konfiguracji. Pusta lista wyłącza wszystkie zdarzenia urządzenia, a użycie ALL_DEVICE_EVENTS włącza wszystkie zdarzenia urządzenia.

DefaultEvent

Domyślne zdarzenia raportowania. Możemy dodać więcej wydarzeń.

Wartości w polu enum
DEFAULT_EVENT_UNSPECIFIED Wartość domyślna. Ta wartość nie jest używana.
ALL_DEFAULT_EVENTS Wszystkie zdarzenia domyślne.
BROWSER_CRASH_EVENT Zdarzenie awarii przeglądarki.
BROWSER_EXTENSION_INSTALL_EVENT Zdarzenie dotyczące instalacji rozszerzenia do przeglądarki.
CONTENT_TRANSFER_EVENT Zdarzenie przeniesienia treści.
CONTENT_UNSCANNED_EVENT Zdarzenie związane z nieprzeskanowaną treścią.
DATA_ACCESS_CONTROL_EVENT Zdarzenie kontroli dostępu do danych.
MALWARE_TRANSFER_EVENT Zdarzenie związane z przeniesieniem złośliwego oprogramowania.
PASSWORD_CHANGED_EVENT Wydarzenie zmiany hasła.
PASSWORD_REUSE_EVENT Zdarzenie ponownego użycia hasła.
SENSITIVE_DATA_TRANSFER_EVENT Zdarzenie związane z przeniesieniem danych wrażliwych.
SUSPICIOUS_URL_EVENT Zdarzenie związane z podejrzanym adresem URL.
UNSAFE_SITE_VISIT_EVENT Zdarzenie wizyty na niebezpiecznej stronie.
URL_FILTERING_INTERSTITIAL_EVENT Zdarzenie filtrowania adresów URL reklam pełnoekranowych.

OptInEvent

Zdarzenia raportowania, na które użytkownik wyraził zgodę. Możemy dodać więcej wydarzeń.

Wartości w polu enum
OPT_IN_EVENT_UNSPECIFIED Wartość domyślna. Ta wartość nie jest używana.
ALL_OPT_IN_EVENTS Wszystkie zdarzenia wymagające zgody użytkownika.
LOGIN_EVENT Zdarzenie logowania.
PASSWORD_BREACH_EVENT Zdarzenie ujawnienia hasła.
URL_NAVIGATION_EVENT Zdarzenie otworzenia adresu URL.
EXTENSION_TELEMETRY_EVENT Zdarzenie telemetryczne rozszerzenia.

DeviceEvent

Zdarzenia dotyczące urządzenia. Możemy dodać więcej wydarzeń.

Wartości w polu enum
DEVICE_EVENT_UNSPECIFIED Wartość domyślna. Ta wartość nie jest używana.
ALL_DEVICE_EVENTS wszystkie zdarzenia dotyczące urządzenia;
ADD_REMOVE_USER_EVENT Dodawanie i usuwanie zdarzeń użytkownika.
LOGIN_LOGOUT_EVENT Zdarzenie zalogowania/wylogowania.
CRD_EVENT Zdarzenie CRD.
PERIPHERAL_EVENT Zdarzenie dotyczące urządzenia peryferyjnego.

GoogleSecOpsConfig

Konfiguracja oprogramowania sprzęgającego Google SecOps.

Zapis JSON 
{
  "apiKey": string,
  "host": string,
  "reportingSettings": {
    object (ReportingSettings)
  }
}
Pola
apiKey

string

Wymagane. Tylko dane wejściowe. Klucz interfejsu API do użycia w interfejsie API do przesyłania danych.
host

string

Wymagane. Host punktu końcowego interfejsu API do pozyskiwania danych. Umożliwia klientowi przesyłanie zdarzeń na serwery w określonych regionach geograficznych. W przypadku istniejących konfiguracji, które nie mają tego ustawienia, domyślnym krajem są Stany Zjednoczone.
reportingSettings

object (ReportingSettings)

Wymagane. Ustawienia raportowania konfiguracji Google SecOps.

PubSubConfig

Konfiguracja oprogramowania sprzęgającego Pub/Sub.

Zapis JSON 
{
  "topicFullPath": string,
  "reportingSettings": {
    object (ReportingSettings)
  }
}
Pola
topicFullPath

string

Wymagane. Pełna ścieżka do tematu, do którego ma zostać wysłane zdarzenie.
reportingSettings

object (ReportingSettings)

Wymagane. Ustawienia raportowania konfiguracji Pub/Sub.

CrowdStrikeConfig

Konfiguracja oprogramowania sprzęgającego CrowdStrike.

Zapis JSON 
{
  "apiKey": string,
  "host": string,
  "reportingSettings": {
    object (ReportingSettings)
  }
}
Pola
apiKey

string

Wymagane. Tylko dane wejściowe. Klucz interfejsu API do użycia w interfejsie API do przesyłania danych.
host

string

Wymagane. Host, który identyfikuje serwer klienta, na który mają być przesyłane zdarzenia.
reportingSettings

object (ReportingSettings)

Wymagane. Ustawienia raportowania konfiguracji CrowdStrike.

CrowdStrikeFalconNextGenConfig

Konfiguracja oprogramowania sprzęgającego CrowdStrike Falcon Next Gen.

Zapis JSON 
{
  "apiKey": string,
  "host": string,
  "reportingSettings": {
    object (ReportingSettings)
  }
}
Pola
apiKey

string

Wymagane. Tylko dane wejściowe. Klucz interfejsu API do użycia w interfejsie API do przesyłania danych.
host

string

Wymagane. Host, który identyfikuje serwer klienta, na który mają być przesyłane zdarzenia.
reportingSettings

object (ReportingSettings)

Wymagane. Ustawienia raportowania konfiguracji CrowdStrike Falcon nowej generacji.

PaloAltoNetworksConfig

Konfiguracja oprogramowania sprzęgającego Palo Alto Networks.

Zapis JSON 
{
  "apiKey": string,
  "host": string,
  "reportingSettings": {
    object (ReportingSettings)
  }
}
Pola
apiKey

string

Wymagane. Tylko dane wejściowe. Klucz interfejsu API do użycia w interfejsie API do przesyłania danych.
host

string

Wymagane. Host, który identyfikuje serwer klienta, na który mają być przesyłane zdarzenia.
reportingSettings

object (ReportingSettings)

Wymagane. Ustawienia raportowania konfiguracji Palo Alto Networks.

DeviceTrustConfig

Konfiguracja zaufania do urządzenia w przypadku oprogramowania sprzęgającego zaufania do urządzenia.

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

enum (ServiceProvider)

Opcjonalnie. Dostawca oprogramowania sprzęgającego zaufania do urządzenia.
urlMatchers[]

string

Wymagane. Lista adresów URL, które mogą być częścią procedury poświadczania, aby otrzymywać zestaw sygnałów z urządzenia. Adresy URL muszą mieć schemat HTTPS, np. „https://example.com”. Możesz też używać symboli wieloznacznych (*). Szczegółowe informacje o prawidłowych wzorcach adresów URL znajdziesz na https://cloud.google.com/docs/chrome-enterprise/policies/url-patterns.
serviceAccounts[]

string

Wymagane. Lista adresów e-mail należących do kont usługi, które mogą wywoływać interfejs Verified Access API z pełnym dostępem.
scope

enum (BrowserEnforcementScope)

Wymagane. Zakres, w którym będzie stosowana ta konfiguracja. Pamiętaj, że dotyczy to tylko przeglądarki Chrome, ponieważ w ChromeOS jest zawsze stosowane.

ServiceProvider

Dostawca oprogramowania sprzęgającego zaufania do urządzenia.

Wartości w polu enum
SERVICE_PROVIDER_UNSPECIFIED Wartość domyślna.
UNIVERSAL_DEVICE_TRUST Oprogramowanie sprzęgające uniwersalnej konfiguracji Device Trust.
OKTA dostawcą usług Okta.
PING_IDENTITY Dostawca usług Ping Identity.
ONELOGIN Dostawca usług OneLogin.
DUO dostawcą usług Duo.
ZSCALER dostawcą usług Zscaler.
OMNISSA dostawcą usług Omnissa.
JUMPCLOUD dostawcą usług JumpCloud.

BrowserEnforcementScope

Poziom wymuszania stosowania oprogramowania sprzęgającego zaufania do urządzenia.

Wartości w polu enum
BROWSER_ENFORCEMENT_SCOPE_UNSPECIFIED Wartość domyślna. Ta wartość nie jest używana.
BROWSERS_ONLY Wymuszane są tylko przeglądarki.
PROFILES_ONLY Wymagane są tylko profile.
BROWSERS_AND_PROFILES Zarządzane są zarówno przeglądarki, jak i profile.

CrowdStrikeXdrConfig

Konfiguracja oprogramowania sprzęgającego CrowdStrike XDR.

Zapis JSON 
{
  "apiKey": string,
  "host": string,
  "xdrSettings": {
    object (XdrSettings)
  }
}
Pola
apiKey

string

Wymagane. Tylko dane wejściowe. Klucz interfejsu API do użycia w interfejsie API do przesyłania danych.
host

string

Wymagane. Host, który identyfikuje serwer klienta, na który mają być przesyłane zdarzenia.
xdrSettings

object (XdrSettings)

Wymagane. Ustawienia XDR dla konfiguracji CrowdStrike XDR.

XdrSettings

Ustawienia XDR dla konfiguracji oprogramowania sprzęgającego.

Zapis JSON 
{
  "enableAllXdrEvents": boolean
}
Pola
enableAllXdrEvents

boolean

Wymagane. Określa, czy mają być włączone wszystkie zdarzenia XDR.

PubSubXdrConfig

Konfiguracja oprogramowania sprzęgającego XDR Pub/Sub.

Zapis JSON 
{
  "topicFullPath": string,
  "xdrSettings": {
    object (XdrSettings)
  }
}
Pola
topicFullPath

string

Wymagane. Pełna ścieżka do tematu, do którego ma zostać wysłane zdarzenie.
xdrSettings

object (XdrSettings)

Wymagane. Ustawienia XDR dla konfiguracji XDR Pub/Sub.

ConnectorConfigStatus

Stan konfiguracji oprogramowania sprzęgającego.

Zapis JSON 
{
  "state": enum (ConfigState),
  "failureStartTime": string,
  "updateTime": string
}
Pola
state

enum (ConfigState)

Tylko dane wyjściowe. Stan konfiguracji oprogramowania sprzęgającego. Stan oprogramowania sprzęgającego jest wyłączony, jeśli w ciągu ostatnich 24 godzin nie udało mu się wysłać zdarzenia.
failureStartTime

string (Timestamp format)

Tylko dane wyjściowe. Czas nagrania w terenie najwcześniejszego błędu od czasu ostatniego zdarzenia zakończonego sukcesem. To pole jest ustawiane tylko wtedy, gdy stan to DISABLED_BY_FAILURES.

Korzysta ze standardu RFC 3339, w którym wygenerowane dane wyjściowe są zawsze znormalizowane do formatu Z i zawierają 0, 3, 6 lub 9 cyfr po przecinku. Akceptowane są też przesunięcia inne niż „Z”. Przykłady: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" lub "2014-10-02T15:01:23+05:30".
updateTime

string (Timestamp format)

Tylko dane wyjściowe. Czas nagrania w terenie ostatniej modyfikacji stanu. W przypadku ENABLED jest to czas, w którym stan został zmieniony na ENABLED. W przypadku DISABLED_BY_FAILURES jest to czas ostatniej nieudanej próby wysłania zdarzenia do tej konfiguracji.

Korzysta ze standardu RFC 3339, w którym wygenerowane dane wyjściowe są zawsze znormalizowane do formatu Z i zawierają 0, 3, 6 lub 9 cyfr po przecinku. Akceptowane są też przesunięcia inne niż „Z”. Przykłady: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" lub "2014-10-02T15:01:23+05:30".

ConfigState

Stan konfiguracji oprogramowania sprzęgającego. Możemy dodać więcej stanów.

Wartości w polu enum
CONFIG_STATE_UNKNOWN Wartość domyślna.
ENABLED Konfiguracja oprogramowania sprzęgającego jest włączona.
DISABLED_BY_FAILURES Konfiguracja łącznika jest tymczasowo wyłączona z powodu błędów.

Metody

create

 Tworzy konfigurację oprogramowania sprzęgającego.

delete

 Usuwa konfigurację oprogramowania sprzęgającego.

get

 Pobiera konfigurację oprogramowania sprzęgającego z identyfikatorem klienta i identyfikatorem konfiguracji.

list

 Wyświetla listę konfiguracji oprogramowania sprzęgającego klienta.

patch

 Aktualizuje konfigurację oprogramowania sprzęgającego.