REST Resource: customers.connectorConfigs

Resource: ConnectorConfig

Representasi konfigurasi konektor.

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

string

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

string

Wajib. Nama tampilan konfigurasi.
type

enum (ConnectorType)

Wajib. Jenis konektor.
details

object (ConnectorConfigDetails)

Wajib. Detail konfigurasi konektor.
status

object (ConnectorConfigStatus)

Hanya output. Status konfigurasi konektor.

ConnectorType

Opsi untuk jenis konfigurasi konektor.

Enum
CONNECTOR_TYPE_UNSPECIFIED Nilai default. Nilai ini tidak digunakan.
REPORTING Konektor pelaporan.
DEVICE_TRUST Konektor kepercayaan perangkat.
XDR Konektor XDR.
IDENTITY_BASED_ENROLLMENT Konektor autentikasi.
CERTIFICATE_AUTHORITY Konektor certificate authority. Belum didukung di API.
ROOT_STORE Konektor root certificate.

ConnectorConfigDetails

Detail konfigurasi konektor.

Representasi 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.
}
Kolom
Kolom union details. Detail khusus konektor. details hanya dapat berupa salah satu dari berikut:
splunkConfig

object (SplunkConfig)

Konfigurasi konektor Splunk.
googleSecOpsConfig

object (GoogleSecOpsConfig)

Konfigurasi konektor Google SecOps.
pubSubConfig

object (PubSubConfig)

Konfigurasi konektor Pub/Sub.
crowdStrikeConfig

object (CrowdStrikeConfig)

Konfigurasi konektor CrowdStrike.
crowdStrikeFalconNextGenConfig

object (CrowdStrikeFalconNextGenConfig)

Konfigurasi konektor CrowdStrike Falcon Next Gen.
paloAltoNetworksConfig

object (PaloAltoNetworksConfig)

Konfigurasi konektor Palo Alto Networks.
deviceTrustConfig

object (DeviceTrustConfig)

Konfigurasi konektor kepercayaan perangkat.
crowdStrikeXdrConfig

object (CrowdStrikeXdrConfig)

Konfigurasi konektor CrowdStrike XDR.
pubSubXdrConfig

object (PubSubXdrConfig)

Konfigurasi konektor XDR Pub/Sub.

SplunkConfig

Konfigurasi konektor Splunk.

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

boolean

Opsional. Apakah akan menggunakan skema HTTP yang tidak aman. Nilai defaultnya adalah false (HTTPS).
host

string

Wajib. Host untuk mengidentifikasi server khusus pelanggan guna menerima peristiwa.
portNumber

integer

Opsional. Nomor port yang akan digunakan. Jika tidak disetel, port Splunk default akan digunakan.
hecToken

string

Wajib. Hanya input. Token HTTP Event Collector input data yang akan digunakan sebagai header Otorisasi.
source

string

Opsional. Nama sumber opsional untuk menggantikan nama default yang ditetapkan di konsol admin Splunk.
reportingSettings

object (ReportingSettings)

Wajib. Setelan pelaporan untuk konfigurasi Splunk.

ReportingSettings

Setelan pelaporan untuk konfigurasi konektor.

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

enum (DefaultEvent)

Opsional. Daftar peristiwa pengguna dan browser yang diaktifkan untuk konektor ini. Daftar kosong akan menonaktifkan semua peristiwa default, dan menggunakan ALL_DEFAULT_EVENTS akan mengaktifkan semua peristiwa default.
enabledOptInEvents[]

enum (OptInEvent)

Opsional. Daftar peristiwa keikutsertaan yang diaktifkan untuk konfigurasi ini. Daftar kosong akan menonaktifkan semua peristiwa keikutsertaan, dan menggunakan ALL_OPT_IN_EVENTS akan mengaktifkan semua peristiwa keikutsertaan.
enabledDeviceEvents[]

enum (DeviceEvent)

Opsional. Daftar peristiwa perangkat yang diaktifkan untuk konfigurasi ini. Daftar kosong akan menonaktifkan semua peristiwa perangkat, dan menggunakan ALL_DEVICE_EVENTS akan mengaktifkan semua peristiwa perangkat.

DefaultEvent

Peristiwa pelaporan default. Acara lainnya dapat ditambahkan.

Enum
DEFAULT_EVENT_UNSPECIFIED Nilai default. Nilai ini tidak digunakan.
ALL_DEFAULT_EVENTS Semua peristiwa default.
BROWSER_CRASH_EVENT Peristiwa error browser.
BROWSER_EXTENSION_INSTALL_EVENT Peristiwa penginstalan ekstensi browser.
CONTENT_TRANSFER_EVENT Peristiwa transfer konten.
CONTENT_UNSCANNED_EVENT Peristiwa konten tidak dipindai.
DATA_ACCESS_CONTROL_EVENT Peristiwa kontrol akses data.
MALWARE_TRANSFER_EVENT Peristiwa transfer malware.
PASSWORD_CHANGED_EVENT Peristiwa perubahan sandi.
PASSWORD_REUSE_EVENT Peristiwa penggunaan ulang sandi.
SENSITIVE_DATA_TRANSFER_EVENT Peristiwa transfer data sensitif.
SUSPICIOUS_URL_EVENT Peristiwa URL mencurigakan.
UNSAFE_SITE_VISIT_EVENT Peristiwa kunjungan situs tidak aman.
URL_FILTERING_INTERSTITIAL_EVENT Peristiwa interstisial pemfilteran URL.

OptInEvent

Peristiwa pelaporan keikutsertaan. Acara lainnya dapat ditambahkan.

Enum
OPT_IN_EVENT_UNSPECIFIED Nilai default. Nilai ini tidak digunakan.
ALL_OPT_IN_EVENTS Semua peristiwa keikutsertaan.
LOGIN_EVENT Peristiwa login.
PASSWORD_BREACH_EVENT Peristiwa kebocoran sandi.
URL_NAVIGATION_EVENT Peristiwa navigasi URL.
EXTENSION_TELEMETRY_EVENT Peristiwa telemetri ekstensi.

DeviceEvent

Peristiwa perangkat. Acara lainnya dapat ditambahkan.

Enum
DEVICE_EVENT_UNSPECIFIED Nilai default. Nilai ini tidak digunakan.
ALL_DEVICE_EVENTS Semua peristiwa perangkat.
ADD_REMOVE_USER_EVENT Peristiwa penambahan/penghapusan pengguna.
LOGIN_LOGOUT_EVENT Peristiwa login/logout.
CRD_EVENT Peristiwa CRD.
PERIPHERAL_EVENT Peristiwa periferal.

GoogleSecOpsConfig

Konfigurasi konektor Google SecOps.

Representasi JSON 
{
  "apiKey": string,
  "host": string,
  "reportingSettings": {
    object (ReportingSettings)
  }
}
Kolom
apiKey

string

Wajib. Hanya input. Kunci API yang akan digunakan di API penyerapan.
host

string

Wajib. Host endpoint API penyerapan. Memungkinkan pelanggan mengupload peristiwa ke server di wilayah geografis tertentu. Konfigurasi yang ada yang tidak memiliki setelan ini akan ditetapkan secara default ke AS.
reportingSettings

object (ReportingSettings)

Wajib. Setelan pelaporan untuk konfigurasi Google SecOps.

PubSubConfig

Konfigurasi konektor Pub/Sub.

Representasi JSON 
{
  "topicFullPath": string,
  "reportingSettings": {
    object (ReportingSettings)
  }
}
Kolom
topicFullPath

string

Wajib. Jalur lengkap ke topik untuk mengirim peristiwa.
reportingSettings

object (ReportingSettings)

Wajib. Setelan pelaporan untuk konfigurasi Pub/Sub.

CrowdStrikeConfig

Konfigurasi konektor CrowdStrike.

Representasi JSON 
{
  "apiKey": string,
  "host": string,
  "reportingSettings": {
    object (ReportingSettings)
  }
}
Kolom
apiKey

string

Wajib. Hanya input. Kunci API yang akan digunakan di API penyerapan.
host

string

Wajib. Host untuk mengidentifikasi server khusus pelanggan guna menerima peristiwa.
reportingSettings

object (ReportingSettings)

Wajib. Setelan pelaporan untuk konfigurasi CrowdStrike.

CrowdStrikeFalconNextGenConfig

Konfigurasi konektor CrowdStrike Falcon Next Gen.

Representasi JSON 
{
  "apiKey": string,
  "host": string,
  "reportingSettings": {
    object (ReportingSettings)
  }
}
Kolom
apiKey

string

Wajib. Hanya input. Kunci API yang akan digunakan di API penyerapan.
host

string

Wajib. Host untuk mengidentifikasi server khusus pelanggan guna menerima peristiwa.
reportingSettings

object (ReportingSettings)

Wajib. Setelan pelaporan untuk konfigurasi CrowdStrike Falcon Next Gen.

PaloAltoNetworksConfig

Konfigurasi konektor Palo Alto Networks.

Representasi JSON 
{
  "apiKey": string,
  "host": string,
  "reportingSettings": {
    object (ReportingSettings)
  }
}
Kolom
apiKey

string

Wajib. Hanya input. Kunci API yang akan digunakan di API penyerapan.
host

string

Wajib. Host untuk mengidentifikasi server khusus pelanggan guna menerima peristiwa.
reportingSettings

object (ReportingSettings)

Wajib. Setelan pelaporan untuk konfigurasi Palo Alto Networks.

DeviceTrustConfig

Konfigurasi kepercayaan perangkat untuk konektor kepercayaan perangkat.

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

enum (ServiceProvider)

Opsional. Penyedia layanan untuk konektor kepercayaan perangkat.
urlMatchers[]

string

Wajib. Daftar URL yang diizinkan menjadi bagian dari alur pengesahan untuk mendapatkan serangkaian sinyal dari perangkat. URL harus berisi skema HTTPS, misalnya "https://example.com". Karakter pengganti, *, diizinkan. Untuk mengetahui informasi selengkapnya tentang pola URL yang valid, lihat https://cloud.google.com/docs/chrome-enterprise/policies/url-patterns.
serviceAccounts[]

string

Wajib. Daftar alamat email akun layanan yang diizinkan untuk memanggil Verified Access API dengan akses penuh.
scope

enum (BrowserEnforcementScope)

Wajib. Cakupan tempat konfigurasi ini akan diterapkan. Perhatikan bahwa setelan ini hanya berlaku untuk browser Chrome, karena di ChromeOS, setelan ini selalu diterapkan.

ServiceProvider

Penyedia layanan untuk konektor kepercayaan perangkat.

Enum
SERVICE_PROVIDER_UNSPECIFIED Nilai default.
UNIVERSAL_DEVICE_TRUST Konektor kepercayaan perangkat universal.
OKTA Penyedia layanan Okta.
PING_IDENTITY Penyedia layanan Ping Identity.
ONELOGIN Penyedia layanan OneLogin.
DUO Penyedia layanan Duo.
ZSCALER Penyedia layanan Zscaler.
OMNISSA Penyedia layanan Omnissa.
JUMPCLOUD Penyedia layanan JumpCloud.

BrowserEnforcementScope

Tingkat penerapan konektor kepercayaan perangkat.

Enum
BROWSER_ENFORCEMENT_SCOPE_UNSPECIFIED Nilai default. Nilai ini tidak digunakan.
BROWSERS_ONLY Hanya browser yang diterapkan.
PROFILES_ONLY Hanya profil yang diterapkan.
BROWSERS_AND_PROFILES Browser dan profil diterapkan.

CrowdStrikeXdrConfig

Konfigurasi konektor CrowdStrike XDR.

Representasi JSON 
{
  "apiKey": string,
  "host": string,
  "xdrSettings": {
    object (XdrSettings)
  }
}
Kolom
apiKey

string

Wajib. Hanya input. Kunci API yang akan digunakan di API penyerapan.
host

string

Wajib. Host untuk mengidentifikasi server khusus pelanggan guna menerima peristiwa.
xdrSettings

object (XdrSettings)

Wajib. Setelan XDR untuk konfigurasi CrowdStrike XDR.

XdrSettings

Setelan XDR untuk konfigurasi konektor.

Representasi JSON 
{
  "enableAllXdrEvents": boolean
}
Kolom
enableAllXdrEvents

boolean

Wajib. Apakah akan mengaktifkan semua peristiwa XDR.

PubSubXdrConfig

Konfigurasi konektor XDR Pub/Sub.

Representasi JSON 
{
  "topicFullPath": string,
  "xdrSettings": {
    object (XdrSettings)
  }
}
Kolom
topicFullPath

string

Wajib. Jalur lengkap ke topik untuk mengirim peristiwa.
xdrSettings

object (XdrSettings)

Wajib. Setelan XDR untuk konfigurasi XDR Pub/Sub.

ConnectorConfigStatus

Status konfigurasi konektor.

Representasi JSON 
{
  "state": enum (ConfigState),
  "failureStartTime": string,
  "updateTime": string
}
Kolom
state

enum (ConfigState)

Hanya output. Status konfigurasi konektor. Status konektor dinonaktifkan jika konektor belum berhasil mengirim peristiwa dalam 24 jam terakhir.
failureStartTime

string (Timestamp format)

Hanya output. Waktu perekaman lapangan kegagalan paling awal sejak peristiwa keberhasilan terakhir. Kolom ini hanya disetel jika statusnya DISABLED_BY_FAILURES.

Menggunakan RFC 3339 yang outputnya akan selalu dinormalisasi Z dan menggunakan 0, 3, 6, atau 9 digit pecahan. Offset selain "Z" juga diterima. Contoh: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z", atau "2014-10-02T15:01:23+05:30".
updateTime

string (Timestamp format)

Hanya output. Waktu perekaman di lapangan saat perubahan status terakhir. Untuk ENABLED, ini adalah waktu saat status diubah menjadi ENABLED. Untuk DISABLED_BY_FAILURES, ini adalah waktu upaya pengiriman peristiwa yang gagal terakhir ke konfigurasi ini.

Menggunakan RFC 3339 yang outputnya akan selalu dinormalisasi Z dan menggunakan 0, 3, 6, atau 9 digit pecahan. Offset selain "Z" juga diterima. Contoh: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z", atau "2014-10-02T15:01:23+05:30".

ConfigState

Status konfigurasi konektor. Negara bagian lainnya dapat ditambahkan.

Enum
CONFIG_STATE_UNKNOWN Nilai default.
ENABLED Konfigurasi konektor diaktifkan.
DISABLED_BY_FAILURES Konfigurasi konektor dinonaktifkan sementara karena kegagalan.

Metode

create

 Membuat konfigurasi konektor.

delete

 Menghapus konfigurasi konektor.

get

 Mendapatkan konfigurasi konektor dengan ID pelanggan dan ID konfigurasi.

list

 Mencantumkan konfigurasi konektor pelanggan.

patch

 Memperbarui konfigurasi konektor.