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.
}
שדות
שדה איחוד 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 שמורשות להיות חלק מתהליך האימות (attestation) כדי לקבל את קבוצת האותות מהמכשיר. בכתובות 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 ההגדרה של המחבר מושבתת באופן זמני בגלל כשלים.

Methods

create

 יוצר הגדרת מחבר.

delete

 מוחק הגדרות של מחבר.

get

 מקבלים הגדרת מחבר עם מספר לקוח ומזהה הגדרה.

list

 הפונקציה מחזירה את הגדרות המחבר של לקוח.

patch

 עדכון של הגדרות מחבר.