REST Resource: customers.connectorConfigs

リソース: ConnectorConfig

コネクタ構成の表現。

JSON 表現 
{
  "name": string,
  "displayName": string,
  "type": enum (ConnectorType),
  "details": {
    object (ConnectorConfigDetails)
  },
  "status": {
    object (ConnectorConfigStatus)
  }
}
フィールド
name

string

ID。形式: customers/{customer}/connectorConfigs/{connectorConfig}
displayName

string

必須。構成の表示名。
type

enum (ConnectorType)

必須。コネクタのタイプ。
details

object (ConnectorConfigDetails)

必須。コネクタ構成の詳細。
status

object (ConnectorConfigStatus)

出力専用。コネクタ構成のステータス。

ConnectorType

コネクタ構成のタイプのオプション。

列挙型
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 イベント コレクター トークン。
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

デフォルトのレポート イベント。今後、イベントが追加される可能性があります。

列挙型
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

オプトイン レポート イベント。今後、イベントが追加される可能性があります。

列挙型
OPT_IN_EVENT_UNSPECIFIED デフォルト値。この値は使用されません。
ALL_OPT_IN_EVENTS すべてのオプトイン イベント。
LOGIN_EVENT ログイン イベント。
PASSWORD_BREACH_EVENT パスワード漏洩イベント。
URL_NAVIGATION_EVENT URL ナビゲーション イベント。
EXTENSION_TELEMETRY_EVENT 拡張機能のテレメトリー イベント。

DeviceEvent

デバイスのイベント。今後、イベントが追加される可能性があります。

列挙型
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

必須。完全なアクセス権限で確認済みアクセス API を呼び出すことが許可されているサービス アカウントのメールアドレスのリスト。
scope

enum (BrowserEnforcementScope)

必須。この構成が適用されるスコープ。これは Chrome ブラウザにのみ適用され、ChromeOS では常に適用されます。

ServiceProvider

デバイス トラスト コネクタのサービス プロバイダ。

列挙型
SERVICE_PROVIDER_UNSPECIFIED デフォルト値。
UNIVERSAL_DEVICE_TRUST ユニバーサル デバイス トラスト コネクタ。
OKTA Okta サービス プロバイダ。
PING_IDENTITY Ping Identity サービス プロバイダ。
ONELOGIN OneLogin サービス プロバイダ。
DUO Duo サービス プロバイダ。
ZSCALER Zscaler サービス プロバイダ。
OMNISSA Omnissa サービス プロバイダ。
JUMPCLOUD JumpCloud サービス プロバイダ。

BrowserEnforcementScope

デバイス トラスト コネクタの適用レベル。

列挙型
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)

必須。CrowdStrike XDR 構成の XDR 設定。

XdrSettings

コネクタ構成の XDR 設定。

JSON 表現 
{
  "enableAllXdrEvents": boolean
}
フィールド
enableAllXdrEvents

boolean

必須。すべての XDR イベントを有効にするかどうか。

PubSubXdrConfig

Pub/Sub XDR コネクタの構成。

JSON 表現 
{
  "topicFullPath": string,
  "xdrSettings": {
    object (XdrSettings)
  }
}
フィールド
topicFullPath

string

必須。イベントの送信先トピックのフルパス。
xdrSettings

object (XdrSettings)

必須。Pub/Sub XDR 構成の 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

コネクタ構成の状態。今後、対象となる州が追加される可能性があります。

列挙型
CONFIG_STATE_UNKNOWN デフォルト値。
ENABLED コネクタ構成が有効になっています。
DISABLED_BY_FAILURES 障害により、コネクタ構成が一時的に無効になっています。

メソッド

create

 コネクタ構成を作成します。

delete

 コネクタ構成を削除します。

get

 お客様 ID と設定 ID を使用してコネクタ設定を取得します。

list

 顧客のコネクタ構成を一覧表示します。

patch

 コネクタ構成を更新します。