REST Resource: customers.connectorConfigs

ทรัพยากร: ConnectorConfig

การแสดงการกำหนดค่าเครื่องมือเชื่อมต่อ

การแสดง JSON 
{
  "name": string,
  "displayName": string,
  "type": enum (ConnectorType),
  "details": {
    object (ConnectorConfigDetails)
  },
  "status": {
    object (ConnectorConfigStatus)
  }
}
ช่อง
name

string

ตัวระบุ รูปแบบ: customers/{customer}/connectorConfigs/{connectorConfig}
displayName

string

ต้องระบุ ชื่อที่แสดงของการกำหนดค่า
type

enum (ConnectorType)

ต้องระบุ ประเภทของตัวเชื่อมต่อ
details

object (ConnectorConfigDetails)

ต้องระบุ รายละเอียดการกำหนดค่าตัวเชื่อมต่อ
status

object (ConnectorConfigStatus)

เอาต์พุตเท่านั้น สถานะของการกำหนดค่าตัวเชื่อมต่อ

ConnectorType

ตัวเลือกสำหรับประเภทการกำหนดค่าเครื่องมือเชื่อมต่อ

Enum
CONNECTOR_TYPE_UNSPECIFIED ค่าเริ่มต้น ค่านี้ไม่ได้ใช้
REPORTING เครื่องมือเชื่อมต่อการรายงาน
DEVICE_TRUST เครื่องมือเชื่อมต่อความน่าเชื่อถือของอุปกรณ์
XDR เครื่องมือเชื่อมต่อ XDR
IDENTITY_BASED_ENROLLMENT เครื่องมือเชื่อมต่อการตรวจสอบสิทธิ์
CERTIFICATE_AUTHORITY เครื่องมือเชื่อมต่อผู้ออกใบรับรอง ยังไม่รองรับใน API
ROOT_STORE เครื่องมือเชื่อมต่อใบรับรองรูท

ConnectorConfigDetails

รายละเอียดการกำหนดค่าตัวเชื่อมต่อ

การแสดง 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.
}
ช่อง
ฟิลด์ Union details รายละเอียดเฉพาะของเครื่องมือเชื่อมต่อ details ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้เท่านั้น
splunkConfig

object (SplunkConfig)

การกำหนดค่าเครื่องมือเชื่อมต่อ Splunk
googleSecOpsConfig

object (GoogleSecOpsConfig)

การกำหนดค่าเครื่องมือเชื่อมต่อ Google SecOps
pubSubConfig

object (PubSubConfig)

กำหนดค่าเครื่องมือเชื่อมต่อ Pub/Sub
crowdStrikeConfig

object (CrowdStrikeConfig)

การกำหนดค่าเครื่องมือเชื่อมต่อ CrowdStrike
crowdStrikeFalconNextGenConfig

object (CrowdStrikeFalconNextGenConfig)

การกำหนดค่าเครื่องมือเชื่อมต่อ CrowdStrike Falcon Next Gen
paloAltoNetworksConfig

object (PaloAltoNetworksConfig)

การกำหนดค่าเครื่องมือเชื่อมต่อ Palo Alto Networks
deviceTrustConfig

object (DeviceTrustConfig)

การกำหนดค่าเครื่องมือเชื่อมต่อความน่าเชื่อถือของอุปกรณ์
crowdStrikeXdrConfig

object (CrowdStrikeXdrConfig)

การกำหนดค่าเครื่องมือเชื่อมต่อ CrowdStrike XDR
pubSubXdrConfig

object (PubSubXdrConfig)

การกำหนดค่าเครื่องมือเชื่อมต่อ Pub/Sub XDR

SplunkConfig

การกำหนดค่าเครื่องมือเชื่อมต่อ Splunk

การแสดง JSON 
{
  "unsecureScheme": boolean,
  "host": string,
  "portNumber": integer,
  "hecToken": string,
  "source": string,
  "reportingSettings": {
    object (ReportingSettings)
  }
}
ฟิลด์
unsecureScheme

boolean

ไม่บังคับ จะใช้รูปแบบ HTTP ที่ไม่ปลอดภัยหรือไม่ ค่าเริ่มต้นคือ False (HTTPS)
host

string

ต้องระบุ โฮสต์เพื่อระบุเซิร์ฟเวอร์เฉพาะของลูกค้าเพื่อรับเหตุการณ์
portNumber

integer

ไม่บังคับ หมายเลขพอร์ตที่จะใช้ หากไม่ได้ตั้งค่า ระบบจะใช้พอร์ต Splunk เริ่มต้น
hecToken

string

ต้องระบุ อินพุตเท่านั้น โทเค็น HTTP Event Collector ของอินพุตข้อมูลที่จะใช้เป็นส่วนหัวการให้สิทธิ์
source

string

ไม่บังคับ ชื่อแหล่งข้อมูลที่ไม่บังคับเพื่อลบล้างค่าเริ่มต้นที่ตั้งไว้ในคอนโซลผู้ดูแลระบบ Splunk
reportingSettings

object (ReportingSettings)

ต้องระบุ การตั้งค่าการรายงานสำหรับการกำหนดค่า Splunk

ReportingSettings

การตั้งค่าการรายงานสําหรับการกำหนดค่าเครื่องมือเชื่อมต่อ

การแสดง JSON 
{
  "enabledDefaultEvents": [
    enum (DefaultEvent)
  ],
  "enabledOptInEvents": [
    enum (OptInEvent)
  ],
  "enabledDeviceEvents": [
    enum (DeviceEvent)
  ]
}
ฟิลด์
enabledDefaultEvents[]

enum (DefaultEvent)

ไม่บังคับ รายการเหตุการณ์ของผู้ใช้และเบราว์เซอร์ที่เปิดใช้สำหรับตัวเชื่อมต่อนี้ รายการที่ว่างเปล่าจะปิดใช้เหตุการณ์เริ่มต้นทั้งหมด และการใช้ ALL_DEFAULT_EVENTS จะเปิดใช้เหตุการณ์เริ่มต้นทั้งหมด
enabledOptInEvents[]

enum (OptInEvent)

ไม่บังคับ รายการเหตุการณ์ที่เลือกใช้ซึ่งเปิดใช้สําหรับการกําหนดค่านี้ รายการที่ว่างเปล่าจะปิดใช้เหตุการณ์ที่เลือกเข้าร่วมทั้งหมด และการใช้ ALL_OPT_IN_EVENTS จะเปิดใช้เหตุการณ์ที่เลือกเข้าร่วมทั้งหมด
enabledDeviceEvents[]

enum (DeviceEvent)

ไม่บังคับ รายการเหตุการณ์ของอุปกรณ์ที่เปิดใช้สำหรับการกำหนดค่านี้ รายการที่ว่างเปล่าจะปิดใช้เหตุการณ์ของอุปกรณ์ทั้งหมด และการใช้ ALL_DEVICE_EVENTS จะเปิดใช้เหตุการณ์ของอุปกรณ์ทั้งหมด

DefaultEvent

เหตุการณ์การรายงานเริ่มต้น อาจมีการเพิ่มกิจกรรมอื่นๆ

Enum
DEFAULT_EVENT_UNSPECIFIED ค่าเริ่มต้น ค่านี้ไม่ได้ใช้
ALL_DEFAULT_EVENTS เหตุการณ์เริ่มต้นทั้งหมด
BROWSER_CRASH_EVENT เหตุการณ์ข้อขัดข้องของเบราว์เซอร์
BROWSER_EXTENSION_INSTALL_EVENT เหตุการณ์การติดตั้งส่วนขยายเบราว์เซอร์
CONTENT_TRANSFER_EVENT กิจกรรมการโอนเนื้อหา
CONTENT_UNSCANNED_EVENT เหตุการณ์ที่ไม่ได้สแกนเนื้อหา
DATA_ACCESS_CONTROL_EVENT เหตุการณ์การควบคุมการเข้าถึงข้อมูล
MALWARE_TRANSFER_EVENT เหตุการณ์การโอนมัลแวร์
PASSWORD_CHANGED_EVENT เหตุการณ์การเปลี่ยนรหัสผ่าน
PASSWORD_REUSE_EVENT เหตุการณ์การใช้รหัสผ่านซ้ำ
SENSITIVE_DATA_TRANSFER_EVENT เหตุการณ์การโอนข้อมูลที่ละเอียดอ่อน
SUSPICIOUS_URL_EVENT เหตุการณ์ URL ที่น่าสงสัย
UNSAFE_SITE_VISIT_EVENT เหตุการณ์การเข้าชมเว็บไซต์ที่ไม่ปลอดภัย
URL_FILTERING_INTERSTITIAL_EVENT เหตุการณ์โฆษณาคั่นระหว่างหน้าที่กรอง URL

OptInEvent

เหตุการณ์การรายงานที่เลือกใช้ อาจมีการเพิ่มกิจกรรมอื่นๆ

Enum
OPT_IN_EVENT_UNSPECIFIED ค่าเริ่มต้น ค่านี้ไม่ได้ใช้
ALL_OPT_IN_EVENTS กิจกรรมที่เลือกเข้าร่วมทั้งหมด
LOGIN_EVENT เหตุการณ์การเข้าสู่ระบบ
PASSWORD_BREACH_EVENT เหตุการณ์การละเมิดรหัสผ่าน
URL_NAVIGATION_EVENT เหตุการณ์การไปยังส่วนต่างๆ ของ URL
EXTENSION_TELEMETRY_EVENT เหตุการณ์การตรวจวัดระยะไกลของส่วนขยาย

DeviceEvent

เหตุการณ์ในอุปกรณ์ อาจมีการเพิ่มกิจกรรมอื่นๆ

Enum
DEVICE_EVENT_UNSPECIFIED ค่าเริ่มต้น ค่านี้ไม่ได้ใช้
ALL_DEVICE_EVENTS เหตุการณ์ทั้งหมดในอุปกรณ์
ADD_REMOVE_USER_EVENT เพิ่ม/นำเหตุการณ์ของผู้ใช้ออก
LOGIN_LOGOUT_EVENT เหตุการณ์การเข้าสู่ระบบ/ออกจากระบบ
CRD_EVENT เหตุการณ์ CRD
PERIPHERAL_EVENT เหตุการณ์เกี่ยวกับอุปกรณ์ต่อพ่วง

GoogleSecOpsConfig

การกำหนดค่าเครื่องมือเชื่อมต่อ Google SecOps

การแสดง JSON 
{
  "apiKey": string,
  "host": string,
  "reportingSettings": {
    object (ReportingSettings)
  }
}
ช่อง
apiKey

string

ต้องระบุ อินพุตเท่านั้น คีย์ API ที่จะใช้ใน API การส่งผ่านข้อมูล
host

string

ต้องระบุ โฮสต์ของปลายทาง API การส่งผ่านข้อมูล ช่วยให้ลูกค้าอัปโหลดเหตุการณ์ไปยังเซิร์ฟเวอร์ในภูมิภาคทางภูมิศาสตร์ที่เฉพาะเจาะจงได้ การกำหนดค่าที่มีอยู่ซึ่งไม่มีการตั้งค่านี้จะใช้ค่าเริ่มต้นเป็นสหรัฐอเมริกา
reportingSettings

object (ReportingSettings)

ต้องระบุ การตั้งค่าการรายงานสำหรับการกำหนดค่า Google SecOps

PubSubConfig

กำหนดค่าเครื่องมือเชื่อมต่อ Pub/Sub

การแสดง JSON 
{
  "topicFullPath": string,
  "reportingSettings": {
    object (ReportingSettings)
  }
}
ช่อง
topicFullPath

string

ต้องระบุ เส้นทางแบบเต็มไปยังหัวข้อที่จะส่งเหตุการณ์
reportingSettings

object (ReportingSettings)

ต้องระบุ การตั้งค่าการรายงานสำหรับการกำหนดค่า Pub/Sub

CrowdStrikeConfig

การกำหนดค่าเครื่องมือเชื่อมต่อ CrowdStrike

การแสดง JSON 
{
  "apiKey": string,
  "host": string,
  "reportingSettings": {
    object (ReportingSettings)
  }
}
ช่อง
apiKey

string

ต้องระบุ อินพุตเท่านั้น คีย์ API ที่จะใช้ใน API การส่งผ่านข้อมูล
host

string

ต้องระบุ โฮสต์เพื่อระบุเซิร์ฟเวอร์เฉพาะของลูกค้าเพื่อรับเหตุการณ์
reportingSettings

object (ReportingSettings)

ต้องระบุ การตั้งค่าการรายงานสำหรับการกำหนดค่า CrowdStrike

CrowdStrikeFalconNextGenConfig

การกำหนดค่าเครื่องมือเชื่อมต่อ CrowdStrike Falcon Next Gen

การแสดง JSON 
{
  "apiKey": string,
  "host": string,
  "reportingSettings": {
    object (ReportingSettings)
  }
}
ช่อง
apiKey

string

ต้องระบุ อินพุตเท่านั้น คีย์ API ที่จะใช้ใน API การส่งผ่านข้อมูล
host

string

ต้องระบุ โฮสต์เพื่อระบุเซิร์ฟเวอร์เฉพาะของลูกค้าเพื่อรับเหตุการณ์
reportingSettings

object (ReportingSettings)

ต้องระบุ การตั้งค่าการรายงานสำหรับการกำหนดค่า CrowdStrike Falcon Next Gen

PaloAltoNetworksConfig

การกำหนดค่าเครื่องมือเชื่อมต่อ Palo Alto Networks

การแสดง JSON 
{
  "apiKey": string,
  "host": string,
  "reportingSettings": {
    object (ReportingSettings)
  }
}
ช่อง
apiKey

string

ต้องระบุ อินพุตเท่านั้น คีย์ API ที่จะใช้ใน API การส่งผ่านข้อมูล
host

string

ต้องระบุ โฮสต์เพื่อระบุเซิร์ฟเวอร์เฉพาะของลูกค้าเพื่อรับเหตุการณ์
reportingSettings

object (ReportingSettings)

ต้องระบุ การตั้งค่าการรายงานสําหรับการกําหนดค่า Palo Alto Networks

DeviceTrustConfig

การกำหนดค่าความน่าเชื่อถือของอุปกรณ์สำหรับเครื่องมือเชื่อมต่อความน่าเชื่อถือของอุปกรณ์

การแสดง JSON 
{
  "serviceProvider": enum (ServiceProvider),
  "urlMatchers": [
    string
  ],
  "serviceAccounts": [
    string
  ],
  "scope": enum (BrowserEnforcementScope)
}
ฟิลด์
serviceProvider

enum (ServiceProvider)

ไม่บังคับ ผู้ให้บริการเครื่องมือเชื่อมต่อความน่าเชื่อถือของอุปกรณ์
urlMatchers[]

string

ต้องระบุ รายการ URL ที่ได้รับอนุญาตให้เป็นส่วนหนึ่งของโฟลว์เอกสารรับรองเพื่อรับชุดสัญญาณจากเครื่อง URL ต้องมีรูปแบบ HTTPS เช่น "https://example.com" และใช้ไวลด์การ์ด * ได้ ดูข้อมูลโดยละเอียดเกี่ยวกับรูปแบบ URL ที่ถูกต้องได้ที่ https://cloud.google.com/docs/chrome-enterprise/policies/url-patterns
serviceAccounts[]

string

ต้องระบุ รายชื่ออีเมลของบัญชีบริการที่ได้รับอนุญาตให้เรียก Verified Access API โดยมีสิทธิ์เข้าถึงเต็มรูปแบบ
scope

enum (BrowserEnforcementScope)

ต้องระบุ ขอบเขตที่จะใช้การกำหนดค่านี้ โปรดทราบว่าการตั้งค่านี้มีผลกับเบราว์เซอร์ Chrome เท่านั้น เนื่องจากใน ChromeOS จะมีการใช้การตั้งค่านี้เสมอ

ServiceProvider

ผู้ให้บริการเครื่องมือเชื่อมต่อความน่าเชื่อถือของอุปกรณ์

Enum
SERVICE_PROVIDER_UNSPECIFIED ค่าเริ่มต้น
UNIVERSAL_DEVICE_TRUST เครื่องมือเชื่อมต่อสำหรับความน่าเชื่อถือของอุปกรณ์แบบสากล
OKTA ผู้ให้บริการ Okta
PING_IDENTITY ผู้ให้บริการ Ping Identity
ONELOGIN ผู้ให้บริการ OneLogin
DUO ผู้ให้บริการ Duo
ZSCALER ผู้ให้บริการ Zscaler
OMNISSA ผู้ให้บริการ Omnissa
JUMPCLOUD ผู้ให้บริการ JumpCloud

BrowserEnforcementScope

ระดับการบังคับใช้เครื่องมือเชื่อมต่อความน่าเชื่อถือของอุปกรณ์

Enum
BROWSER_ENFORCEMENT_SCOPE_UNSPECIFIED ค่าเริ่มต้น ค่านี้ไม่ได้ใช้
BROWSERS_ONLY โดยจะบังคับใช้เฉพาะเบราว์เซอร์
PROFILES_ONLY ระบบจะบังคับใช้เฉพาะโปรไฟล์
BROWSERS_AND_PROFILES ทั้งเบราว์เซอร์และโปรไฟล์จะได้รับการบังคับใช้

CrowdStrikeXdrConfig

การกำหนดค่าเครื่องมือเชื่อมต่อ CrowdStrike XDR

การแสดง JSON 
{
  "apiKey": string,
  "host": string,
  "xdrSettings": {
    object (XdrSettings)
  }
}
ช่อง
apiKey

string

ต้องระบุ อินพุตเท่านั้น คีย์ API ที่จะใช้ใน API การส่งผ่านข้อมูล
host

string

ต้องระบุ โฮสต์เพื่อระบุเซิร์ฟเวอร์เฉพาะของลูกค้าเพื่อรับเหตุการณ์
xdrSettings

object (XdrSettings)

ต้องระบุ การตั้งค่า XDR สำหรับการกำหนดค่า CrowdStrike XDR

XdrSettings

การตั้งค่า XDR สำหรับการกำหนดค่าเครื่องมือเชื่อมต่อ

การแสดง JSON 
{
  "enableAllXdrEvents": boolean
}
ช่อง
enableAllXdrEvents

boolean

ต้องระบุ เลือกว่าจะเปิดใช้เหตุการณ์ XDR ทั้งหมดหรือไม่

PubSubXdrConfig

การกำหนดค่าเครื่องมือเชื่อมต่อ Pub/Sub XDR

การแสดง JSON 
{
  "topicFullPath": string,
  "xdrSettings": {
    object (XdrSettings)
  }
}
ช่อง
topicFullPath

string

ต้องระบุ เส้นทางแบบเต็มไปยังหัวข้อที่จะส่งเหตุการณ์
xdrSettings

object (XdrSettings)

ต้องระบุ การตั้งค่า XDR สำหรับการกำหนดค่า Pub/Sub XDR

ConnectorConfigStatus

สถานะของการกำหนดค่าตัวเชื่อมต่อ

การแสดง JSON 
{
  "state": enum (ConfigState),
  "failureStartTime": string,
  "updateTime": string
}
ช่อง
state

enum (ConfigState)

เอาต์พุตเท่านั้น สถานะของการกำหนดค่าเครื่องมือเชื่อมต่อ สถานะเครื่องมือเชื่อมต่อจะปิดใช้หากเครื่องมือเชื่อมต่อส่งเหตุการณ์ไม่สำเร็จในช่วง 24 ชั่วโมงที่ผ่านมา
failureStartTime

string (Timestamp format)

เอาต์พุตเท่านั้น เวลาบันทึกฟิลด์ของความล้มเหลวที่เร็วที่สุดนับตั้งแต่เหตุการณ์ที่สำเร็จครั้งล่าสุด ระบบจะตั้งค่าฟิลด์นี้เมื่อสถานะเป็น DISABLED_BY_FAILURES เท่านั้น

ใช้ RFC 3339 โดยเอาต์พุตที่สร้างขึ้นจะได้รับการแปลงเป็นรูปแบบ Z เสมอ และใช้ตัวเลขเศษส่วน 0, 3, 6 หรือ 9 หลัก นอกจากนี้ ระบบยังยอมรับออฟเซ็ตอื่นๆ นอกเหนือจาก "Z" ด้วย เช่น "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" หรือ "2014-10-02T15:01:23+05:30"
updateTime

string (Timestamp format)

เอาต์พุตเท่านั้น เวลาที่บันทึกฟิลด์ของการแก้ไขสถานะครั้งล่าสุด สำหรับ ENABLED นี่คือเวลาที่สถานะเปลี่ยนเป็น ENABLED สำหรับ DISABLED_BY_FAILURES นี่คือเวลาของความพยายามครั้งล่าสุดที่ส่งเหตุการณ์ไปยังการกำหนดค่านี้ไม่สำเร็จ

ใช้ RFC 3339 โดยเอาต์พุตที่สร้างขึ้นจะได้รับการแปลงเป็นรูปแบบ Z เสมอ และใช้ตัวเลขเศษส่วน 0, 3, 6 หรือ 9 หลัก นอกจากนี้ ระบบยังยอมรับออฟเซ็ตอื่นๆ นอกเหนือจาก "Z" ด้วย เช่น "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" หรือ "2014-10-02T15:01:23+05:30"

ConfigState

สถานะของการกำหนดค่าเครื่องมือเชื่อมต่อ อาจมีการเพิ่มรัฐอื่นๆ

Enum
CONFIG_STATE_UNKNOWN ค่าเริ่มต้น
ENABLED เปิดใช้การกำหนดค่าเครื่องมือเชื่อมต่อแล้ว
DISABLED_BY_FAILURES ระบบปิดใช้การกำหนดค่าเครื่องมือเชื่อมต่อชั่วคราวเนื่องจากเกิดข้อผิดพลาด

เมธอด

create

 สร้างการกำหนดค่าเครื่องมือเชื่อมต่อ

delete

 ลบการกำหนดค่าเครื่องมือเชื่อมต่อ

get

 รับการกำหนดค่าเครื่องมือเชื่อมต่อด้วยรหัสลูกค้าและรหัสการกำหนดค่า

list

 แสดงรายการการกำหนดค่าเครื่องมือเชื่อมต่อของลูกค้า

patch

 อัปเดตการกำหนดค่าเครื่องมือเชื่อมต่อ