REST Resource: customers.connectorConfigs

Tài nguyên: ConnectorConfig

Hình minh hoạ cấu hình trình kết nối.

Biểu diễn dưới dạng JSON 
{
  "name": string,
  "displayName": string,
  "type": enum (ConnectorType),
  "details": {
    object (ConnectorConfigDetails)
  },
  "status": {
    object (ConnectorConfigStatus)
  }
}
Trường
name

string

Giá trị nhận dạng. Định dạng: customers/{customer}/connectorConfigs/{connectorConfig}
displayName

string

Bắt buộc. Tên hiển thị của cấu hình.
type

enum (ConnectorType)

Bắt buộc. Loại giắc cắm.
details

object (ConnectorConfigDetails)

Bắt buộc. Thông tin chi tiết về cấu hình trình kết nối.
status

object (ConnectorConfigStatus)

Chỉ có đầu ra. Trạng thái của cấu hình trình kết nối.

ConnectorType

Các lựa chọn cho loại cấu hình trình kết nối.

Enum
CONNECTOR_TYPE_UNSPECIFIED Giá trị mặc định. Giá trị này không được dùng.
REPORTING Trình kết nối báo cáo.
DEVICE_TRUST Trình kết nối theo cơ chế tin tưởng thiết bị.
XDR Trình kết nối XDR.
IDENTITY_BASED_ENROLLMENT Trình kết nối xác thực.
CERTIFICATE_AUTHORITY Trình kết nối Tổ chức phát hành chứng chỉ. Chưa được hỗ trợ trong API.
ROOT_STORE Trình kết nối chứng chỉ gốc.

ConnectorConfigDetails

Thông tin chi tiết về cấu hình trình kết nối.

Biểu diễn dưới dạng 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.
}
Trường
Trường nhóm details. Thông tin chi tiết cụ thể về trình kết nối. details chỉ có thể là một trong những trạng thái sau:
splunkConfig

object (SplunkConfig)

Cấu hình trình kết nối Splunk.
googleSecOpsConfig

object (GoogleSecOpsConfig)

Cấu hình trình kết nối Google SecOps.
pubSubConfig

object (PubSubConfig)

Cấu hình trình kết nối Pub/Sub.
crowdStrikeConfig

object (CrowdStrikeConfig)

Cấu hình trình kết nối CrowdStrike.
crowdStrikeFalconNextGenConfig

object (CrowdStrikeFalconNextGenConfig)

Cấu hình trình kết nối CrowdStrike Falcon Next Gen.
paloAltoNetworksConfig

object (PaloAltoNetworksConfig)

Cấu hình trình kết nối Palo Alto Networks.
deviceTrustConfig

object (DeviceTrustConfig)

Cấu hình trình kết nối theo cơ chế tin tưởng thiết bị.
crowdStrikeXdrConfig

object (CrowdStrikeXdrConfig)

Cấu hình trình kết nối CrowdStrike XDR.
pubSubXdrConfig

object (PubSubXdrConfig)

Cấu hình trình kết nối Pub/Sub XDR.

SplunkConfig

Cấu hình trình kết nối Splunk.

Biểu diễn dưới dạng JSON 
{
  "unsecureScheme": boolean,
  "host": string,
  "portNumber": integer,
  "hecToken": string,
  "source": string,
  "reportingSettings": {
    object (ReportingSettings)
  }
}
Trường
unsecureScheme

boolean

Không bắt buộc. Có nên sử dụng một lược đồ HTTP không bảo mật hay không. Mặc định là false (HTTPS).
host

string

Bắt buộc. Máy chủ lưu trữ để xác định máy chủ cụ thể của khách hàng nhằm nhận các sự kiện.
portNumber

integer

Không bắt buộc. Số cổng cần sử dụng. Nếu bạn không đặt, hệ thống sẽ sử dụng cổng Splunk mặc định.
hecToken

string

Bắt buộc. Chỉ có đầu vào. Mã thông báo HTTP Event Collector của dữ liệu đầu vào để dùng làm tiêu đề Uỷ quyền.
source

string

Không bắt buộc. Tên nguồn không bắt buộc để ghi đè tên mặc định được đặt trong bảng điều khiển quản trị Splunk.
reportingSettings

object (ReportingSettings)

Bắt buộc. Chế độ cài đặt báo cáo cho cấu hình Splunk.

ReportingSettings

Chế độ cài đặt báo cáo cho cấu hình trình kết nối.

Biểu diễn dưới dạng JSON 
{
  "enabledDefaultEvents": [
    enum (DefaultEvent)
  ],
  "enabledOptInEvents": [
    enum (OptInEvent)
  ],
  "enabledDeviceEvents": [
    enum (DeviceEvent)
  ]
}
Trường
enabledDefaultEvents[]

enum (DefaultEvent)

Không bắt buộc. Danh sách các sự kiện của người dùng và trình duyệt được bật cho trình kết nối này. Một danh sách trống sẽ tắt tất cả sự kiện mặc định và việc sử dụng ALL_DEFAULT_EVENTS sẽ bật tất cả sự kiện mặc định.
enabledOptInEvents[]

enum (OptInEvent)

Không bắt buộc. Danh sách các sự kiện chọn tham gia được bật cho cấu hình này. Một danh sách trống sẽ tắt tất cả các sự kiện chọn nhận và việc sử dụng ALL_OPT_IN_EVENTS sẽ bật tất cả các sự kiện chọn nhận.
enabledDeviceEvents[]

enum (DeviceEvent)

Không bắt buộc. Danh sách các sự kiện trên thiết bị được bật cho cấu hình này. Một danh sách trống sẽ vô hiệu hoá tất cả các sự kiện trên thiết bị và việc sử dụng ALL_DEVICE_EVENTS sẽ bật tất cả các sự kiện trên thiết bị.

DefaultEvent

Sự kiện báo cáo mặc định. Có thể sẽ có thêm nhiều sự kiện khác.

Enum
DEFAULT_EVENT_UNSPECIFIED Giá trị mặc định. Giá trị này không được dùng.
ALL_DEFAULT_EVENTS Tất cả sự kiện mặc định.
BROWSER_CRASH_EVENT Sự kiện trình duyệt gặp sự cố.
BROWSER_EXTENSION_INSTALL_EVENT Sự kiện cài đặt tiện ích trên trình duyệt.
CONTENT_TRANSFER_EVENT Sự kiện chuyển nội dung.
CONTENT_UNSCANNED_EVENT Sự kiện về nội dung chưa được quét.
DATA_ACCESS_CONTROL_EVENT Sự kiện kiểm soát quyền truy cập dữ liệu.
MALWARE_TRANSFER_EVENT Sự kiện chuyển phần mềm độc hại.
PASSWORD_CHANGED_EVENT Sự kiện mật khẩu đã thay đổi.
PASSWORD_REUSE_EVENT Sự kiện dùng lại mật khẩu.
SENSITIVE_DATA_TRANSFER_EVENT Sự kiện chuyển dữ liệu nhạy cảm.
SUSPICIOUS_URL_EVENT Sự kiện URL đáng ngờ.
UNSAFE_SITE_VISIT_EVENT Sự kiện truy cập vào trang web không an toàn.
URL_FILTERING_INTERSTITIAL_EVENT Sự kiện xen kẽ lọc URL.

OptInEvent

Chọn báo cáo sự kiện. Có thể sẽ có thêm nhiều sự kiện khác.

Enum
OPT_IN_EVENT_UNSPECIFIED Giá trị mặc định. Giá trị này không được dùng.
ALL_OPT_IN_EVENTS Tất cả sự kiện chọn nhận.
LOGIN_EVENT Sự kiện đăng nhập.
PASSWORD_BREACH_EVENT Sự kiện xâm phạm mật khẩu.
URL_NAVIGATION_EVENT Sự kiện điều hướng URL.
EXTENSION_TELEMETRY_EVENT Sự kiện đo từ xa của tiện ích.

DeviceEvent

Sự kiện về thiết bị. Có thể sẽ có thêm nhiều sự kiện khác.

Enum
DEVICE_EVENT_UNSPECIFIED Giá trị mặc định. Giá trị này không được dùng.
ALL_DEVICE_EVENTS Tất cả các sự kiện trên thiết bị.
ADD_REMOVE_USER_EVENT Thêm/xoá sự kiện người dùng.
LOGIN_LOGOUT_EVENT Sự kiện đăng nhập/đăng xuất.
CRD_EVENT Sự kiện CRD.
PERIPHERAL_EVENT Sự kiện về thiết bị ngoại vi.

GoogleSecOpsConfig

Cấu hình trình kết nối Google SecOps.

Biểu diễn dưới dạng JSON 
{
  "apiKey": string,
  "host": string,
  "reportingSettings": {
    object (ReportingSettings)
  }
}
Trường
apiKey

string

Bắt buộc. Chỉ có đầu vào. Khoá API để sử dụng trên API tiếp nhận.
host

string

Bắt buộc. Máy chủ lưu trữ điểm cuối của API nhập. Cho phép khách hàng tải sự kiện lên máy chủ ở các khu vực địa lý cụ thể. Các cấu hình hiện có không có chế độ cài đặt này sẽ mặc định là Hoa Kỳ.
reportingSettings

object (ReportingSettings)

Bắt buộc. Chế độ cài đặt báo cáo cho cấu hình Google SecOps.

PubSubConfig

Cấu hình trình kết nối Pub/Sub.

Biểu diễn dưới dạng JSON 
{
  "topicFullPath": string,
  "reportingSettings": {
    object (ReportingSettings)
  }
}
Trường
topicFullPath

string

Bắt buộc. Đường dẫn đầy đủ đến chủ đề để gửi sự kiện đến.
reportingSettings

object (ReportingSettings)

Bắt buộc. Chế độ cài đặt báo cáo cho cấu hình Pub/Sub.

CrowdStrikeConfig

Cấu hình trình kết nối CrowdStrike.

Biểu diễn dưới dạng JSON 
{
  "apiKey": string,
  "host": string,
  "reportingSettings": {
    object (ReportingSettings)
  }
}
Trường
apiKey

string

Bắt buộc. Chỉ có đầu vào. Khoá API để sử dụng trên API tiếp nhận.
host

string

Bắt buộc. Máy chủ lưu trữ để xác định máy chủ cụ thể của khách hàng nhằm nhận các sự kiện.
reportingSettings

object (ReportingSettings)

Bắt buộc. Chế độ cài đặt báo cáo cho cấu hình CrowdStrike.

CrowdStrikeFalconNextGenConfig

Cấu hình trình kết nối CrowdStrike Falcon Next Gen.

Biểu diễn dưới dạng JSON 
{
  "apiKey": string,
  "host": string,
  "reportingSettings": {
    object (ReportingSettings)
  }
}
Trường
apiKey

string

Bắt buộc. Chỉ có đầu vào. Khoá API để sử dụng trên API tiếp nhận.
host

string

Bắt buộc. Máy chủ lưu trữ để xác định máy chủ cụ thể của khách hàng nhằm nhận các sự kiện.
reportingSettings

object (ReportingSettings)

Bắt buộc. Chế độ cài đặt báo cáo cho cấu hình CrowdStrike Falcon Next Gen.

PaloAltoNetworksConfig

Cấu hình trình kết nối Palo Alto Networks.

Biểu diễn dưới dạng JSON 
{
  "apiKey": string,
  "host": string,
  "reportingSettings": {
    object (ReportingSettings)
  }
}
Trường
apiKey

string

Bắt buộc. Chỉ có đầu vào. Khoá API để sử dụng trên API tiếp nhận.
host

string

Bắt buộc. Máy chủ lưu trữ để xác định máy chủ cụ thể của khách hàng nhằm nhận các sự kiện.
reportingSettings

object (ReportingSettings)

Bắt buộc. Chế độ cài đặt báo cáo cho cấu hình Palo Alto Networks.

DeviceTrustConfig

Cấu hình cho cơ chế tin tưởng thiết bị đối với trình kết nối của cơ chế tin tưởng thiết bị.

Biểu diễn dưới dạng JSON 
{
  "serviceProvider": enum (ServiceProvider),
  "urlMatchers": [
    string
  ],
  "serviceAccounts": [
    string
  ],
  "scope": enum (BrowserEnforcementScope)
}
Trường
serviceProvider

enum (ServiceProvider)

Không bắt buộc. Nhà cung cấp dịch vụ cho trình kết nối theo cơ chế tin tưởng thiết bị.
urlMatchers[]

string

Bắt buộc. Danh sách các URL được phép đưa vào quy trình chứng thực để nhận được loạt tín hiệu từ máy. Các URL phải có lược đồ HTTPS, ví dụ: "https://example.com". Cho phép sử dụng ký tự đại diện (*). Để biết thông tin chi tiết về các mẫu URL hợp lệ, vui lòng truy cập https://cloud.google.com/docs/chrome-enterprise/policies/url-patterns.
serviceAccounts[]

string

Bắt buộc. Danh sách địa chỉ email của những tài khoản dịch vụ được phép gọi API Quyền truy cập được xác minh với toàn quyền truy cập.
scope

enum (BrowserEnforcementScope)

Bắt buộc. Phạm vi áp dụng cấu hình này. Xin lưu ý rằng điều này chỉ áp dụng cho trình duyệt Chrome, vì trong ChromeOS, chế độ này luôn được áp dụng.

ServiceProvider

Nhà cung cấp dịch vụ cho trình kết nối theo cơ chế tin tưởng thiết bị.

Enum
SERVICE_PROVIDER_UNSPECIFIED Giá trị mặc định.
UNIVERSAL_DEVICE_TRUST Trình kết nối theo cơ chế tin tưởng thiết bị chung.
OKTA Nhà cung cấp dịch vụ Okta.
PING_IDENTITY Nhà cung cấp dịch vụ định danh Ping Identity.
ONELOGIN Nhà cung cấp dịch vụ OneLogin.
DUO Nhà cung cấp dịch vụ Duo.
ZSCALER Nhà cung cấp dịch vụ Zscaler.
OMNISSA Nhà cung cấp dịch vụ Omnissa.
JUMPCLOUD Nhà cung cấp dịch vụ JumpCloud.

BrowserEnforcementScope

Cấp thực thi của trình kết nối theo cơ chế tin tưởng thiết bị.

Enum
BROWSER_ENFORCEMENT_SCOPE_UNSPECIFIED Giá trị mặc định. Giá trị này không được dùng.
BROWSERS_ONLY Chỉ các trình duyệt mới được thực thi.
PROFILES_ONLY Chỉ các hồ sơ mới được thực thi.
BROWSERS_AND_PROFILES Cả trình duyệt và hồ sơ đều được thực thi.

CrowdStrikeXdrConfig

Cấu hình trình kết nối CrowdStrike XDR.

Biểu diễn dưới dạng JSON 
{
  "apiKey": string,
  "host": string,
  "xdrSettings": {
    object (XdrSettings)
  }
}
Trường
apiKey

string

Bắt buộc. Chỉ có đầu vào. Khoá API để sử dụng trên API tiếp nhận.
host

string

Bắt buộc. Máy chủ lưu trữ để xác định máy chủ cụ thể của khách hàng nhằm nhận các sự kiện.
xdrSettings

object (XdrSettings)

Bắt buộc. Chế độ cài đặt XDR cho cấu hình CrowdStrike XDR.

XdrSettings

Chế độ cài đặt XDR cho cấu hình trình kết nối.

Biểu diễn dưới dạng JSON 
{
  "enableAllXdrEvents": boolean
}
Trường
enableAllXdrEvents

boolean

Bắt buộc. Có bật tất cả sự kiện XDR hay không.

PubSubXdrConfig

Cấu hình trình kết nối Pub/Sub XDR.

Biểu diễn dưới dạng JSON 
{
  "topicFullPath": string,
  "xdrSettings": {
    object (XdrSettings)
  }
}
Trường
topicFullPath

string

Bắt buộc. Đường dẫn đầy đủ đến chủ đề để gửi sự kiện đến.
xdrSettings

object (XdrSettings)

Bắt buộc. Chế độ cài đặt XDR cho cấu hình Pub/Sub XDR.

ConnectorConfigStatus

Trạng thái của cấu hình trình kết nối.

Biểu diễn dưới dạng JSON 
{
  "state": enum (ConfigState),
  "failureStartTime": string,
  "updateTime": string
}
Trường
state

enum (ConfigState)

Chỉ có đầu ra. Trạng thái của cấu hình trình kết nối. Trạng thái của trình kết nối sẽ bị tắt nếu trình kết nối không gửi được sự kiện nào trong 24 giờ qua.
failureStartTime

string (Timestamp format)

Chỉ có đầu ra. Thời gian ghi nhận lỗi sớm nhất kể từ sự kiện thành công gần đây nhất. Trường này chỉ được đặt khi trạng thái là DISABLED_BY_FAILURES.

Hãy dùng RFC 3339, trong đó dữ liệu đầu ra được tạo sẽ luôn được chuẩn hoá theo múi giờ và sử dụng 0, 3, 6 hoặc 9 chữ số thập phân. Các khoảng lệch khác ngoài "Z" cũng được chấp nhận. Ví dụ: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" hoặc "2014-10-02T15:01:23+05:30".
updateTime

string (Timestamp format)

Chỉ có đầu ra. Thời gian ghi nhận gần đây nhất về trạng thái. Đối với ENABLED, đây là thời điểm trạng thái được thay đổi thành ENABLED. Đối với DISABLED_BY_FAILURES, đây là thời gian của lần thất bại gần đây nhất khi gửi một sự kiện đến cấu hình này.

Hãy dùng RFC 3339, trong đó dữ liệu đầu ra được tạo sẽ luôn được chuẩn hoá theo múi giờ và sử dụng 0, 3, 6 hoặc 9 chữ số thập phân. Các khoảng lệch khác ngoài "Z" cũng được chấp nhận. Ví dụ: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" hoặc "2014-10-02T15:01:23+05:30".

ConfigState

Trạng thái của cấu hình trình kết nối. Chúng tôi có thể sẽ bổ sung các tiểu bang khác.

Enum
CONFIG_STATE_UNKNOWN Giá trị mặc định.
ENABLED Đã bật cấu hình trình kết nối.
DISABLED_BY_FAILURES Cấu hình trình kết nối tạm thời bị tắt do lỗi.

Phương thức

create

 Tạo một cấu hình trình kết nối.

delete

 Xoá một cấu hình trình kết nối.

get

 Nhận cấu hình trình kết nối bằng mã khách hàng và mã cấu hình.

list

 Liệt kê các cấu hình trình kết nối của một khách hàng.

patch

 Cập nhật cấu hình trình kết nối.