REST Resource: customers.connectorConfigs

Kaynak: ConnectorConfig

Bağlayıcı yapılandırmasının temsili.

JSON gösterimi
{
  "name": string,
  "displayName": string,
  "type": enum (ConnectorType),
  "details": {
    object (ConnectorConfigDetails)
  },
  "status": {
    object (ConnectorConfigStatus)
  }
}
Alanlar
name

string

Tanımlayıcı. Biçim: customers/{customer}/connectorConfigs/{connectorConfig}

displayName

string

Zorunlu. Yapılandırmanın görünen adı.

type

enum (ConnectorType)

Zorunlu. Bağlayıcının türü.

details

object (ConnectorConfigDetails)

Zorunlu. Bağlayıcı yapılandırmasının ayrıntıları.

status

object (ConnectorConfigStatus)

Yalnızca çıkış. Bağlayıcı yapılandırmasının durumu.

ConnectorType

Bağlayıcı yapılandırmasının türüyle ilgili seçenekler.

Sıralamalar
CONNECTOR_TYPE_UNSPECIFIED Varsayılan değer. Bu değer kullanılmıyor.
REPORTING Raporlama bağlayıcısı.
DEVICE_TRUST Cihaz güveni bağlayıcısı.
XDR XDR bağlayıcısı.
IDENTITY_BASED_ENROLLMENT Kimlik doğrulama bağlayıcısı.
CERTIFICATE_AUTHORITY Sertifika yetkilisi bağlayıcısı. API'de henüz desteklenmemektedir.
ROOT_STORE Kök sertifika bağlayıcısı.

ConnectorConfigDetails

Bağlayıcı yapılandırmasının ayrıntıları.

JSON gösterimi
{

  // 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.
}
Alanlar
details birleşik alanı. Bağlayıcıya özgü ayrıntılar. details aşağıdakilerden yalnızca biri olabilir:
splunkConfig

object (SplunkConfig)

Splunk bağlayıcı yapılandırması.

googleSecOpsConfig

object (GoogleSecOpsConfig)

Google SecOps bağlayıcı yapılandırması

pubSubConfig

object (PubSubConfig)

Pub/Sub bağlayıcısı yapılandırması

crowdStrikeConfig

object (CrowdStrikeConfig)

CrowdStrike bağlayıcı yapılandırması.

crowdStrikeFalconNextGenConfig

object (CrowdStrikeFalconNextGenConfig)

CrowdStrike Falcon Next Gen bağlayıcısı yapılandırması

paloAltoNetworksConfig

object (PaloAltoNetworksConfig)

Palo Alto Networks bağlayıcı yapılandırması.

deviceTrustConfig

object (DeviceTrustConfig)

Cihaz güveni bağlayıcı yapılandırması.

crowdStrikeXdrConfig

object (CrowdStrikeXdrConfig)

CrowdStrike XDR bağlayıcı yapılandırması.

pubSubXdrConfig

object (PubSubXdrConfig)

Pub/Sub XDR bağlayıcısı yapılandırması.

SplunkConfig

Splunk bağlayıcı yapılandırması.

JSON gösterimi
{
  "unsecureScheme": boolean,
  "host": string,
  "portNumber": integer,
  "hecToken": string,
  "source": string,
  "reportingSettings": {
    object (ReportingSettings)
  }
}
Alanlar
unsecureScheme

boolean

İsteğe bağlı. Güvenli olmayan bir HTTP şemasının kullanılıp kullanılmayacağı. Varsayılan olarak false (HTTPS) değerine ayarlanır.

host

string

Zorunlu. Etkinlikleri alacak müşteriye özel sunucuyu tanımlamak için kullanılan ana makine.

portNumber

integer

İsteğe bağlı. Kullanılacak bağlantı noktası numarası. Ayarlanmazsa varsayılan Splunk bağlantı noktası kullanılır.

hecToken

string

Zorunlu. Yalnızca giriş. Yetkilendirme üstbilgisi olarak kullanılacak veri girişinin HTTP etkinlik toplayıcı jetonu.

source

string

İsteğe bağlı. Splunk Yönetici Konsolu'nda ayarlanan varsayılan kaynak adını geçersiz kılmak için isteğe bağlı kaynak adı.

reportingSettings

object (ReportingSettings)

Zorunlu. Splunk yapılandırmasının raporlama ayarları.

ReportingSettings

Bağlayıcı yapılandırmaları için raporlama ayarları.

JSON gösterimi
{
  "enabledDefaultEvents": [
    enum (DefaultEvent)
  ],
  "enabledOptInEvents": [
    enum (OptInEvent)
  ],
  "enabledDeviceEvents": [
    enum (DeviceEvent)
  ]
}
Alanlar
enabledDefaultEvents[]

enum (DefaultEvent)

İsteğe bağlı. Bu bağlayıcı için etkinleştirilen kullanıcı ve tarayıcı etkinliklerinin listesi. Boş bir liste, tüm varsayılan etkinlikleri devre dışı bırakır. ALL_DEFAULT_EVENTS kullanmak ise tüm varsayılan etkinlikleri etkinleştirir.

enabledOptInEvents[]

enum (OptInEvent)

İsteğe bağlı. Bu yapılandırma için etkinleştirilen izin verilen etkinliklerin listesi. Boş bir liste, tüm dahil etme etkinliklerini devre dışı bırakır. ALL_OPT_IN_EVENTS kullanmak ise tüm dahil etme etkinliklerini etkinleştirir.

enabledDeviceEvents[]

enum (DeviceEvent)

İsteğe bağlı. Bu yapılandırma için etkinleştirilen cihaz etkinliklerinin listesi. Boş bir liste tüm cihaz etkinliklerini devre dışı bırakır. ALL_DEVICE_EVENTS kullanıldığında ise tüm cihaz etkinlikleri etkinleştirilir.

DefaultEvent

Varsayılan raporlama etkinlikleri. Başka etkinlikler de eklenebilir.

Sıralamalar
DEFAULT_EVENT_UNSPECIFIED Varsayılan değer. Bu değer kullanılmıyor.
ALL_DEFAULT_EVENTS Tüm varsayılan etkinlikler.
BROWSER_CRASH_EVENT Tarayıcı kilitlenme etkinliği.
BROWSER_EXTENSION_INSTALL_EVENT Tarayıcı uzantısı yükleme etkinliği.
CONTENT_TRANSFER_EVENT İçerik aktarımı etkinliği.
CONTENT_UNSCANNED_EVENT İçerik taranmadı etkinliği.
DATA_ACCESS_CONTROL_EVENT Veri erişim denetimi etkinliği.
MALWARE_TRANSFER_EVENT Kötü amaçlı yazılım aktarma etkinliği.
PASSWORD_CHANGED_EVENT Şifre değiştirme etkinliği.
PASSWORD_REUSE_EVENT Şifre yeniden kullanım etkinliği.
SENSITIVE_DATA_TRANSFER_EVENT Hassas veri aktarımı etkinliği.
SUSPICIOUS_URL_EVENT Şüpheli URL etkinliği.
UNSAFE_SITE_VISIT_EVENT Güvenli olmayan site ziyareti etkinliği.
URL_FILTERING_INTERSTITIAL_EVENT Ara sayfada URL filtreleme etkinliği.

OptInEvent

Raporlama etkinliklerini etkinleştirin. Başka etkinlikler de eklenebilir.

Sıralamalar
OPT_IN_EVENT_UNSPECIFIED Varsayılan değer. Bu değer kullanılmıyor.
ALL_OPT_IN_EVENTS Tüm izinli etkinlikler.
LOGIN_EVENT Giriş etkinliği.
PASSWORD_BREACH_EVENT Şifre ihlali etkinliği.
URL_NAVIGATION_EVENT URL ile gezinme etkinliği.
EXTENSION_TELEMETRY_EVENT Uzantı telemetri etkinliği.

DeviceEvent

Cihaz etkinlikleri. Başka etkinlikler de eklenebilir.

Sıralamalar
DEVICE_EVENT_UNSPECIFIED Varsayılan değer. Bu değer kullanılmıyor.
ALL_DEVICE_EVENTS Tüm cihaz etkinlikleri.
ADD_REMOVE_USER_EVENT Kullanıcı etkinliği ekleme/kaldırma.
LOGIN_LOGOUT_EVENT Giriş/çıkış etkinliği.
CRD_EVENT CRD etkinliği.
PERIPHERAL_EVENT Çevre birimi etkinliği.

GoogleSecOpsConfig

Google SecOps bağlayıcı yapılandırması

JSON gösterimi
{
  "apiKey": string,
  "host": string,
  "reportingSettings": {
    object (ReportingSettings)
  }
}
Alanlar
apiKey

string

Zorunlu. Yalnızca giriş. Alma API'sinde kullanılacak API anahtarı.

host

string

Zorunlu. Kullanım API uç noktasının ana makinesi. Müşterinin, etkinlikleri belirli coğrafi bölgelerdeki sunuculara yüklemesine olanak tanır. Bu ayarın varsayılan olarak ABD'de olmadığı mevcut yapılandırmalar.

reportingSettings

object (ReportingSettings)

Zorunlu. Google SecOps yapılandırmasının raporlama ayarları.

PubSubConfig

Pub/Sub bağlayıcısı yapılandırması

JSON gösterimi
{
  "topicFullPath": string,
  "reportingSettings": {
    object (ReportingSettings)
  }
}
Alanlar
topicFullPath

string

Zorunlu. Etkinliğin gönderileceği konunun tam yolu.

reportingSettings

object (ReportingSettings)

Zorunlu. Pub/Sub yapılandırması için raporlama ayarları.

CrowdStrikeConfig

CrowdStrike bağlayıcı yapılandırması.

JSON gösterimi
{
  "apiKey": string,
  "host": string,
  "reportingSettings": {
    object (ReportingSettings)
  }
}
Alanlar
apiKey

string

Zorunlu. Yalnızca giriş. Alma API'sinde kullanılacak API anahtarı.

host

string

Zorunlu. Etkinlikleri alacak müşteriye özel sunucuyu tanımlamak için kullanılan ana makine.

reportingSettings

object (ReportingSettings)

Zorunlu. CrowdStrike yapılandırması için raporlama ayarları.

CrowdStrikeFalconNextGenConfig

CrowdStrike Falcon Next Gen bağlayıcısı yapılandırması

JSON gösterimi
{
  "apiKey": string,
  "host": string,
  "reportingSettings": {
    object (ReportingSettings)
  }
}
Alanlar
apiKey

string

Zorunlu. Yalnızca giriş. Alma API'sinde kullanılacak API anahtarı.

host

string

Zorunlu. Etkinlikleri alacak müşteriye özel sunucuyu tanımlamak için kullanılan ana makine.

reportingSettings

object (ReportingSettings)

Zorunlu. CrowdStrike Falcon Next Gen yapılandırmasının raporlama ayarları.

PaloAltoNetworksConfig

Palo Alto Networks bağlayıcı yapılandırması.

JSON gösterimi
{
  "apiKey": string,
  "host": string,
  "reportingSettings": {
    object (ReportingSettings)
  }
}
Alanlar
apiKey

string

Zorunlu. Yalnızca giriş. Alma API'sinde kullanılacak API anahtarı.

host

string

Zorunlu. Etkinlikleri alacak müşteriye özel sunucuyu tanımlamak için kullanılan ana makine.

reportingSettings

object (ReportingSettings)

Zorunlu. Palo Alto Networks yapılandırması için raporlama ayarları.

DeviceTrustConfig

Cihaz güven bağlayıcıları için cihaz güveni yapılandırması.

JSON gösterimi
{
  "serviceProvider": enum (ServiceProvider),
  "urlMatchers": [
    string
  ],
  "serviceAccounts": [
    string
  ],
  "scope": enum (BrowserEnforcementScope)
}
Alanlar
serviceProvider

enum (ServiceProvider)

İsteğe bağlı. Cihaz güven bağlayıcısının servis sağlayıcısı.

urlMatchers[]

string

Zorunlu. Makineden sinyal grubu alma onay akışına dahil olmasına izin verilen URL'lerin listesi. URL'lerin HTTPS şeması olması gerekir, ör. "https://example.com". Joker karakterlere (*) izin verilir. Geçerli URL kalıpları hakkında ayrıntılı bilgi için lütfen https://cloud.google.com/docs/chrome-enterprise/policies/url-patterns adresini ziyaret edin.

serviceAccounts[]

string

Zorunlu. Doğrulanmış Erişim API'sini tam erişimle çağırmasına izin verilen hizmet hesaplarının e-posta adreslerinin listesi.

scope

enum (BrowserEnforcementScope)

Zorunlu. Bu yapılandırmanın uygulanacağı kapsam. Bu ayarın yalnızca Chrome Tarayıcı için geçerli olduğunu, ChromeOS'te ise her zaman uygulandığını unutmayın.

ServiceProvider

Cihaz güven bağlayıcısının servis sağlayıcısı.

Sıralamalar
SERVICE_PROVIDER_UNSPECIFIED Varsayılan değer.
UNIVERSAL_DEVICE_TRUST Evrensel cihaz güveni bağlayıcısı.
OKTA Okta hizmet sağlayıcısı.
PING_IDENTITY Ping Identity hizmet sağlayıcısı.
ONELOGIN OneLogin servis sağlayıcı.
DUO Duo servis sağlayıcısı.
ZSCALER Zscaler servis sağlayıcısı.
OMNISSA Omnissa servis sağlayıcısı.
JUMPCLOUD JumpCloud hizmet sağlayıcısı.

BrowserEnforcementScope

Cihaz güven bağlayıcısının zorunlu kılma düzeyi.

Sıralamalar
BROWSER_ENFORCEMENT_SCOPE_UNSPECIFIED Varsayılan değer. Bu değer kullanılmıyor.
BROWSERS_ONLY Yalnızca tarayıcılar zorunlu kılınır.
PROFILES_ONLY Yalnızca profiller zorunlu kılınır.
BROWSERS_AND_PROFILES Hem tarayıcılar hem de profiller zorunlu kılınır.

CrowdStrikeXdrConfig

CrowdStrike XDR bağlayıcı yapılandırması.

JSON gösterimi
{
  "apiKey": string,
  "host": string,
  "xdrSettings": {
    object (XdrSettings)
  }
}
Alanlar
apiKey

string

Zorunlu. Yalnızca giriş. Alma API'sinde kullanılacak API anahtarı.

host

string

Zorunlu. Etkinlikleri alacak müşteriye özel sunucuyu tanımlamak için kullanılan ana makine.

xdrSettings

object (XdrSettings)

Zorunlu. CrowdStrike XDR yapılandırması için XDR ayarları.

XdrSettings

Bağlayıcı yapılandırmaları için XDR ayarları.

JSON gösterimi
{
  "enableAllXdrEvents": boolean
}
Alanlar
enableAllXdrEvents

boolean

Zorunlu. Tüm XDR etkinliklerinin etkinleştirilip etkinleştirilmeyeceği.

PubSubXdrConfig

Pub/Sub XDR bağlayıcısı yapılandırması.

JSON gösterimi
{
  "topicFullPath": string,
  "xdrSettings": {
    object (XdrSettings)
  }
}
Alanlar
topicFullPath

string

Zorunlu. Etkinliğin gönderileceği konunun tam yolu.

xdrSettings

object (XdrSettings)

Zorunlu. Pub/Sub XDR yapılandırması için XDR ayarları.

ConnectorConfigStatus

Bağlayıcı yapılandırmasının durumu.

JSON gösterimi
{
  "state": enum (ConfigState),
  "failureStartTime": string,
  "updateTime": string
}
Alanlar
state

enum (ConfigState)

Yalnızca çıkış. Bağlayıcı yapılandırmasının durumu. Bağlayıcı son 24 saat içinde başarılı bir şekilde etkinlik göndermediyse bağlayıcı durumu devre dışı bırakılır.

failureStartTime

string (Timestamp format)

Yalnızca çıkış. Son başarı etkinliğinden bu yana en erken başarısızlığın alan kaydı zamanı. Bu alan yalnızca durum DISABLED_BY_FAILURES olduğunda ayarlanır.

Zaman damgasında RFC 3339 kullanılır. Yani oluşturulan çıkış her zaman Z ile normalleştirilir ve 0, 3, 6 veya 9 kesirli basamak kullanılır. "Z" dışındaki zaman farkları da kabul edilir. Örnekler: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" veya "2014-10-02T15:01:23+05:30".

updateTime

string (Timestamp format)

Yalnızca çıkış. Durumun en son değiştirilme işleminin alan kaydı zamanı. ENABLED için bu, durumun ENABLED olarak değiştirildiği zamandır. DISABLED_BY_FAILURES için bu, bu yapılandırmaya bir etkinlik gönderme girişiminin en son başarısız olduğu zamandır.

Zaman damgasında RFC 3339 kullanılır. Yani oluşturulan çıkış her zaman Z ile normalleştirilir ve 0, 3, 6 veya 9 kesirli basamak kullanılır. "Z" dışındaki zaman farkları da kabul edilir. Örnekler: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" veya "2014-10-02T15:01:23+05:30".

ConfigState

Bağlayıcı yapılandırmasının durumu. Daha fazla eyalet eklenebilir.

Sıralamalar
CONFIG_STATE_UNKNOWN Varsayılan değer.
ENABLED Bağlayıcı yapılandırması etkinleştirilmiş olmalıdır.
DISABLED_BY_FAILURES Bağlayıcı yapılandırması, hatalar nedeniyle geçici olarak devre dışı bırakıldı.

Yöntemler

create

Bağlayıcı yapılandırması oluşturur.

delete

Bağlayıcı yapılandırmasını siler.

get

Müşteri kimliği ve yapılandırma kimliği içeren bir bağlayıcı yapılandırması alır.

list

Bir müşterinin bağlayıcı yapılandırmalarını listeler.

patch

Bağlayıcı yapılandırmasını günceller.