Microsoft.SecurityInsights dataConnectors 2022-09-01-preview

[アーティクル]
12/21/2024

Bicep リソース定義

dataConnectors リソースの種類は、次を対象とする操作と共にデプロイできます。

各 API バージョンで変更されたプロパティの一覧については、変更ログの参照してください。

リソースの形式

Microsoft.SecurityInsights/dataConnectors リソースを作成するには、次の Bicep をテンプレートに追加します。

resource symbolicname 'Microsoft.SecurityInsights/dataConnectors@2022-09-01-preview' = {
  etag: 'string'
  name: 'string'
  kind: 'string'
  // For remaining properties, see Microsoft.SecurityInsights/dataConnectors objects
}

Microsoft.SecurityInsights/dataConnectors オブジェクト

の種類 プロパティを設定して、オブジェクトの種類を指定します。

APIPollingの場合は、次の値を使用します。

{
  kind: 'APIPolling'
  properties: {
    connectorUiConfig: {
      availability: {
        isPreview: bool
        status: '1'
      }
      connectivityCriteria: [
        {
          type: 'string'
          value: [
            'string'
          ]
        }
      ]
      customImage: 'string'
      dataTypes: [
        {
          lastDataReceivedQuery: 'string'
          name: 'string'
        }
      ]
      descriptionMarkdown: 'string'
      graphQueries: [
        {
          baseQuery: 'string'
          legend: 'string'
          metricName: 'string'
        }
      ]
      graphQueriesTableName: 'string'
      instructionSteps: [
        {
          description: 'string'
          instructions: [
            {
              parameters: any(Azure.Bicep.Types.Concrete.AnyType)
              type: 'string'
            }
          ]
          title: 'string'
        }
      ]
      permissions: {
        customs: [
          {
            description: 'string'
            name: 'string'
          }
        ]
        resourceProvider: [
          {
            permissionsDisplayText: 'string'
            provider: 'string'
            providerDisplayName: 'string'
            requiredPermissions: {
              action: bool
              delete: bool
              read: bool
              write: bool
            }
            scope: 'string'
          }
        ]
      }
      publisher: 'string'
      sampleQueries: [
        {
          description: 'string'
          query: 'string'
        }
      ]
      title: 'string'
    }
    pollingConfig: {
      auth: {
        apiKeyIdentifier: 'string'
        apiKeyName: 'string'
        authorizationEndpoint: 'string'
        authorizationEndpointQueryParameters: any(Azure.Bicep.Types.Concrete.AnyType)
        authType: 'string'
        flowName: 'string'
        isApiKeyInPostPayload: 'string'
        isClientSecretInHeader: bool
        redirectionEndpoint: 'string'
        scope: 'string'
        tokenEndpoint: 'string'
        tokenEndpointHeaders: any(Azure.Bicep.Types.Concrete.AnyType)
        tokenEndpointQueryParameters: any(Azure.Bicep.Types.Concrete.AnyType)
      }
      isActive: bool
      paging: {
        nextPageParaName: 'string'
        nextPageTokenJsonPath: 'string'
        pageCountAttributePath: 'string'
        pageSize: int
        pageSizeParaName: 'string'
        pageTimeStampAttributePath: 'string'
        pageTotalCountAttributePath: 'string'
        pagingType: 'string'
        searchTheLatestTimeStampFromEventsList: 'string'
      }
      request: {
        apiEndpoint: 'string'
        endTimeAttributeName: 'string'
        headers: any(Azure.Bicep.Types.Concrete.AnyType)
        httpMethod: 'string'
        queryParameters: any(Azure.Bicep.Types.Concrete.AnyType)
        queryParametersTemplate: 'string'
        queryTimeFormat: 'string'
        queryWindowInMin: int
        rateLimitQps: int
        retryCount: int
        startTimeAttributeName: 'string'
        timeoutInSeconds: int
      }
      response: {
        eventsJsonPaths: [
          'string'
        ]
        isGzipCompressed: bool
        successStatusJsonPath: 'string'
        successStatusValue: 'string'
      }
    }
  }
}

AmazonWebServicesCloudTrailの場合は、次のコマンドを使用します。

{
  kind: 'AmazonWebServicesCloudTrail'
  properties: {
    awsRoleArn: 'string'
    dataTypes: {
      logs: {
        state: 'string'
      }
    }
  }
}

AmazonWebServicesS3の場合は、次を使用します。

{
  kind: 'AmazonWebServicesS3'
  properties: {
    dataTypes: {
      logs: {
        state: 'string'
      }
    }
    destinationTable: 'string'
    roleArn: 'string'
    sqsUrls: [
      'string'
    ]
  }
}

AzureActiveDirectoryをする場合は、次を使用します。

{
  kind: 'AzureActiveDirectory'
  properties: {
    dataTypes: {
      alerts: {
        state: 'string'
      }
    }
    tenantId: 'string'
  }
}

AzureAdvancedThreatProtectionの場合は、次を使用します。

{
  kind: 'AzureAdvancedThreatProtection'
  properties: {
    dataTypes: {
      alerts: {
        state: 'string'
      }
    }
    tenantId: 'string'
  }
}

AzureSecurityCenterをする場合は、次を使用します。

{
  kind: 'AzureSecurityCenter'
  properties: {
    dataTypes: {
      alerts: {
        state: 'string'
      }
    }
    subscriptionId: 'string'
  }
}

Dynamics365の場合は、次を使用します。

{
  kind: 'Dynamics365'
  properties: {
    dataTypes: {
      dynamics365CdsActivities: {
        state: 'string'
      }
    }
    tenantId: 'string'
  }
}

GenericUIには、次の値を使用します。

{
  kind: 'GenericUI'
  properties: {
    connectorUiConfig: {
      availability: {
        isPreview: bool
        status: '1'
      }
      connectivityCriteria: [
        {
          type: 'string'
          value: [
            'string'
          ]
        }
      ]
      customImage: 'string'
      dataTypes: [
        {
          lastDataReceivedQuery: 'string'
          name: 'string'
        }
      ]
      descriptionMarkdown: 'string'
      graphQueries: [
        {
          baseQuery: 'string'
          legend: 'string'
          metricName: 'string'
        }
      ]
      graphQueriesTableName: 'string'
      instructionSteps: [
        {
          description: 'string'
          instructions: [
            {
              parameters: any(Azure.Bicep.Types.Concrete.AnyType)
              type: 'string'
            }
          ]
          title: 'string'
        }
      ]
      permissions: {
        customs: [
          {
            description: 'string'
            name: 'string'
          }
        ]
        resourceProvider: [
          {
            permissionsDisplayText: 'string'
            provider: 'string'
            providerDisplayName: 'string'
            requiredPermissions: {
              action: bool
              delete: bool
              read: bool
              write: bool
            }
            scope: 'string'
          }
        ]
      }
      publisher: 'string'
      sampleQueries: [
        {
          description: 'string'
          query: 'string'
        }
      ]
      title: 'string'
    }
  }
}

IOTの場合は、次を使用します。

{
  kind: 'IOT'
  properties: {
    dataTypes: {
      alerts: {
        state: 'string'
      }
    }
    subscriptionId: 'string'
  }
}

MicrosoftCloudAppSecurityの場合は、次のコマンドを使用します。

{
  kind: 'MicrosoftCloudAppSecurity'
  properties: {
    dataTypes: {
      alerts: {
        state: 'string'
      }
      discoveryLogs: {
        state: 'string'
      }
    }
    tenantId: 'string'
  }
}

MicrosoftDefenderAdvancedThreatProtectionの場合は、次を使用します。

{
  kind: 'MicrosoftDefenderAdvancedThreatProtection'
  properties: {
    dataTypes: {
      alerts: {
        state: 'string'
      }
    }
    tenantId: 'string'
  }
}

MicrosoftThreatIntelligenceの場合は、次を使用します。

{
  kind: 'MicrosoftThreatIntelligence'
  properties: {
    dataTypes: {
      bingSafetyPhishingURL: {
        lookbackPeriod: 'string'
        state: 'string'
      }
      microsoftEmergingThreatFeed: {
        lookbackPeriod: 'string'
        state: 'string'
      }
    }
    tenantId: 'string'
  }
}

MicrosoftThreatProtectionの場合は、次を使用します。

{
  kind: 'MicrosoftThreatProtection'
  properties: {
    dataTypes: {
      incidents: {
        state: 'string'
      }
    }
    tenantId: 'string'
  }
}

Office365の場合は、次を使用します。

{
  kind: 'Office365'
  properties: {
    dataTypes: {
      exchange: {
        state: 'string'
      }
      sharePoint: {
        state: 'string'
      }
      teams: {
        state: 'string'
      }
    }
    tenantId: 'string'
  }
}

Office365Projectの場合は、次を使用します。

{
  kind: 'Office365Project'
  properties: {
    dataTypes: {
      logs: {
        state: 'string'
      }
    }
    tenantId: 'string'
  }
}

OfficeATPの場合は、次を使用します。

{
  kind: 'OfficeATP'
  properties: {
    dataTypes: {
      alerts: {
        state: 'string'
      }
    }
    tenantId: 'string'
  }
}

OfficeIRMの場合は、次を使用します。

{
  kind: 'OfficeIRM'
  properties: {
    dataTypes: {
      alerts: {
        state: 'string'
      }
    }
    tenantId: 'string'
  }
}

OfficePowerBIの場合は、次を使用します。

{
  kind: 'OfficePowerBI'
  properties: {
    dataTypes: {
      logs: {
        state: 'string'
      }
    }
    tenantId: 'string'
  }
}

ThreatIntelligenceの場合は、次を使用します。

{
  kind: 'ThreatIntelligence'
  properties: {
    dataTypes: {
      indicators: {
        state: 'string'
      }
    }
    tenantId: 'string'
    tipLookbackPeriod: 'string'
  }
}

ThreatIntelligenceTaxiiの場合は、次を使用します。

{
  kind: 'ThreatIntelligenceTaxii'
  properties: {
    collectionId: 'string'
    dataTypes: {
      taxiiClient: {
        state: 'string'
      }
    }
    friendlyName: 'string'
    password: 'string'
    pollingFrequency: 'string'
    taxiiLookbackPeriod: 'string'
    taxiiServer: 'string'
    tenantId: 'string'
    userName: 'string'
    workspaceId: 'string'
  }
}

プロパティ値

AADDataConnector

名前	形容	価値
種類	データコネクタの種類	'AzureActiveDirectory' (必須)
プロパティ	AAD (Azure Active Directory) データコネクタのプロパティ。	AADDataConnectorProperties の

AADDataConnectorProperties

名前	形容	価値
dataTypes	コネクタで使用できるデータ型。	AlertsDataTypeOfDataConnector の
tenantId	接続してデータを取得するテナント ID。	string (必須)

AatpDataConnector

名前	形容	価値
種類	データコネクタの種類	'AzureAdvancedThreatProtection' (必須)
プロパティ	AATP (Azure Advanced Threat Protection) データコネクタのプロパティ。	AatpDataConnectorProperties

AatpDataConnectorProperties

名前	形容	価値
dataTypes	コネクタで使用できるデータ型。	AlertsDataTypeOfDataConnector の
tenantId	接続してデータを取得するテナント ID。	string (必須)

AlertsDataTypeOfDataConnector

名前	形容	価値
アラート	データ型の接続を警告します。	DataConnectorDataTypeCommon (必須)

ApiPollingParameters

名前	形容	価値
connectorUiConfig	[手順] ブレードを記述するための構成	CodelessUiConnectorConfigProperties の
pollingConfig	ポーリング命令を記述する構成	CodelessConnectorPollingConfigProperties の

ASCDataConnector

名前	形容	価値
種類	データコネクタの種類	'AzureSecurityCenter' (必須)
プロパティ	ASC (Azure Security Center) データコネクタのプロパティ。	ASCDataConnectorProperties の

ASCDataConnectorProperties

名前	形容	価値
dataTypes	コネクタで使用できるデータ型。	AlertsDataTypeOfDataConnector の
subscriptionId	接続してデータを取得するサブスクリプション ID。	糸

可用性

名前	形容	価値
isPreview	コネクタをプレビューとして設定する	bool
地位	コネクタの可用性の状態	'1'

AwsCloudTrailDataConnector

名前	形容	価値
種類	データコネクタの種類	'AmazonWebServicesCloudTrail' (必須)
プロパティ	Amazon Web Services CloudTrail データコネクタのプロパティ。	awsCloudTrailDataConnectorProperties の

AwsCloudTrailDataConnectorDataTypes

名前	形容	価値
ログ	データ型をログに記録します。	AwsCloudTrailDataConnectorDataTypesLogs (必須)

AwsCloudTrailDataConnectorDataTypesLogs

名前	形容	価値
状態	このデータ型の接続が有効になっているかどうかを説明します。	'Disabled' 'Enabled' (必須)

AwsCloudTrailDataConnectorProperties

名前	形容	価値
awsRoleArn	AWS アカウントへのアクセスに使用される AWS ロール Arn (CloudTrailReadOnly ポリシーを使用)。	糸
dataTypes	コネクタで使用できるデータ型。	AwsCloudTrailDataConnectorDataTypes (必須)

AwsS3DataConnector

名前	形容	価値
種類	データコネクタの種類	'AmazonWebServicesS3' (必須)
プロパティ	Amazon Web Services S3 データコネクタのプロパティ。	awss3DataConnectorProperties の

AwsS3DataConnectorDataTypes

名前	形容	価値
ログ	データ型をログに記録します。	AwsS3DataConnectorDataTypesLogs (必須)

AwsS3DataConnectorDataTypesLogs

名前	形容	価値
状態	このデータ型の接続が有効になっているかどうかを説明します。	'Disabled' 'Enabled' (必須)

AwsS3DataConnectorProperties

名前	形容	価値
dataTypes	コネクタで使用できるデータ型。	AwsS3DataConnectorDataTypes (必須)
destinationTable	LogAnalytics のログ宛先テーブル名。	string (必須)
roleArn	AWS アカウントへのアクセスに使用される AWS ロール Arn。	string (必須)
sqsUrls	コネクタの AWS sqs URL。	string[] (必須)

CodelessApiPollingDataConnector

名前	形容	価値
種類	データコネクタの種類	'APIPolling' (必須)
プロパティ	コードレスのポリシングデータコネクタのプロパティ	ApiPollingParameters

CodelessConnectorPollingAuthProperties

名前	形容	価値
apiKeyIdentifier	実際のトークンの前にヘッダーで送信されるプレフィックス	糸
apiKeyName	トークンが送信されるヘッダー名	糸
authorizationEndpoint	Oauth 2.0 フローで使用されるユーザーの承認に使用されるエンドポイント	糸
authorizationEndpointQueryParameters	Oauth 2.0 フローで使用される承認要求で使用されるクエリパラメーター	任意
authType	認証の種類	string (必須)
flowName	フロー名 (Oauth 2.0 の場合は "AuthCode" など) について説明します	糸
isApiKeyInPostPayload	キーをヘッダーで送信する必要があるかどうかをマークします	糸
isClientSecretInHeader	Oauth 2.0 フローで使用されるヘッダーまたはペイロードでクライアントシークレットを送信する必要があるかどうかをマークします	bool
redirectionEndpoint	Oauth 2.0 フローで使用される承認コードを取得するリダイレクトエンドポイント	糸
スコープ	OAuth トークンスコープ	糸
tokenEndpoint	Oauth 2.0 フローで使用されるトークンの発行に使用されるエンドポイント	糸
tokenEndpointHeaders	Oauth 2.0 フローで使用されるトークン要求で使用されるクエリヘッダー	任意
tokenEndpointQueryParameters	Oauth 2.0 フローで使用されるトークン要求で使用されるクエリパラメーター	任意

CodelessConnectorPollingConfigProperties

名前	形容	価値
認証	ポーラーの認証の種類について説明する	CodelessConnectorPollingAuthProperties の (必須)
isActive	ポーリング者のアクティブな状態	bool
ページング	poller のポーリング要求ページング構成について説明する	CodelessConnectorPollingPagingProperties の
依頼	poller のポーリング要求構成パラメーターについて説明する	CodelessConnectorPollingRequestProperties の (必須)
応答	poller の応答構成パラメーターについて説明する	CodelessConnectorPollingResponseProperties の

CodelessConnectorPollingPagingProperties

名前	形容	価値
nextPageParaName	次のページ属性の名前を定義します	糸
nextPageTokenJsonPath	次のページトークン JSON へのパスを定義します	糸
pageCountAttributePath	ページカウント属性へのパスを定義します	糸
pageSize	ページングサイズを定義します	int
pageSizeParaName	ページサイズパラメーターの名前を定義します	糸
pageTimeStampAttributePath	ページングタイムスタンプ属性へのパスを定義します。	糸
pageTotalCountAttributePath	ページ合計カウント属性へのパスを定義します	糸
pagingType	型について説明します。は、'None'、'PageToken'、'PageCount'、'TimeStamp' です。	string (必須)
searchTheLatestTimeStampFromEventsList	イベント一覧で最新のタイムスタンプを検索するかどうかを決定します	糸

CodelessConnectorPollingRequestProperties

名前	形容	価値
apiEndpoint	データをプルするエンドポイントについて説明する	string (必須)
endTimeAttributeName	これは、時間枠の終わりからのクエリイベントを使用します	糸
ヘッダー	ポーリング要求で送信されたヘッダーについて説明する	任意
httpMethod	ポーリング要求で使用する http メソッドの型(GET または POST)	string (必須)
queryParameters	ポーリング要求で送信されるクエリパラメーターについて説明する	任意
queryParametersTemplate	入れ子になった JSON ペイロードに埋め込まれたユーザー名/パスワードなどの高度なシナリオの場合	糸
queryTimeFormat	時刻形式は、特定のウィンドウでクエリイベントを使用します	string (必須)
queryWindowInMin	データのプルを使用するウィンドウ間隔	int (必須)
rateLimitQps	レート制限 QPS を定義します	int
retryCount	障害が発生した場合にデータをポーリングする必要がある時間について説明する	int
startTimeAttributeName	これは、時間枠の先頭からクエリイベントを使用します	糸
timeoutInSeconds	要求タイムアウトと見なす秒数	int

CodelessConnectorPollingResponseProperties

名前	形容	価値
eventsJsonPaths	応答でデータを抽出する必要があるパスについて説明します	string[] (必須)
isGzipCompressed	応答内のデータが Gzip であるかどうかを示します	bool
successStatusJsonPath	応答で状態コードを抽出する必要があるパスについて説明します	糸
successStatusValue	応答で状態値を抽出する必要があるパスについて説明します	糸

CodelessParameters

名前	形容	価値
connectorUiConfig	[手順] ブレードを記述するための構成	CodelessUiConnectorConfigProperties の

CodelessUiConnectorConfigProperties

名前	形容	価値
可用性	コネクタの可用性の状態	可用性 (必須)
connectivityCriteria	コネクタが接続を確認する方法を定義する	CodelessUiConnectorConfigPropertiesConnectivityCriteriaItem[] (必須)
customImage	Azure Sentinel のコネクタのギャラリー内にコネクタを表示するときに使用するオプションのカスタムイメージ	糸
dataTypes	最後に受信したデータを確認するデータ型	CodelessUiConnectorConfigPropertiesDataTypesItem[] (必須)
descriptionMarkdown	コネクタの説明	string (必須)
graphQueries	現在のデータの状態を表示するグラフクエリ	CodelessUiConnectorConfigPropertiesGraphQueriesItem[] (必須)
graphQueriesTableName	コネクタがデータを挿入するテーブルの名前	string (必須)
instructionSteps	コネクタを有効にする手順	CodelessUiConnectorConfigPropertiesInstructionStepsItem[] (必須)
権限	コネクタに必要なアクセス許可	アクセス許可の (必須)
発行者	コネクタの発行元名	string (必須)
sampleQueries	コネクタのサンプルクエリ	CodelessUiConnectorConfigPropertiesSampleQueriesItem[] (必須)
タイトル	コネクタブレードのタイトル	string (必須)

CodelessUiConnectorConfigPropertiesConnectivityCriteriaItem

名前	形容	価値
種類	接続の種類	'IsConnectedQuery'
価値	接続を確認するためのクエリ	string[]

CodelessUiConnectorConfigPropertiesDataTypesItem

名前	形容	価値
lastDataReceivedQuery	最後に受信したデータを示すクエリ	糸
名前	グラフに表示するデータ型の名前。 {{graphQueriesTableName}} プレースホルダーと共に使用できます	糸

CodelessUiConnectorConfigPropertiesGraphQueriesItem

名前	形容	価値
baseQuery	グラフの基本クエリ	糸
伝説	グラフの凡例	糸
metricName	クエリがチェックしているメトリック	糸

CodelessUiConnectorConfigPropertiesInstructionStepsItem

名前	形容	価値
形容	命令ステップの説明	糸
指示	手順の詳細	InstructionStepsInstructionsItem[]
タイトル	手順のタイトル	糸

CodelessUiConnectorConfigPropertiesSampleQueriesItem

名前	形容	価値
形容	サンプルクエリの説明	糸
クエリ	サンプルクエリ	糸

CodelessUiDataConnector

名前	形容	価値
種類	データコネクタの種類	'GenericUI' (必須)
プロパティ	コードレス UI データコネクタのプロパティ	CodelessParameters

DataConnectorDataTypeCommon

名前	形容	価値
状態	このデータ型の接続が有効になっているかどうかを説明します。	'Disabled' 'Enabled' (必須)

Dynamics365DataConnector

名前	形容	価値
種類	データコネクタの種類	'Dynamics365' (必須)
プロパティ	Dynamics365 データコネクタのプロパティ。	Dynamics365DataConnectorProperties

Dynamics365DataConnectorDataTypes

名前	形容	価値
dynamics365CdsActivities	Common Data Service データ型の接続。	Dynamics365DataConnectorDataTypesDynamics365CdsActivities (必須)

Dynamics365DataConnectorDataTypesDynamics365CdsActivities

名前	形容	価値
状態	このデータ型の接続が有効になっているかどうかを説明します。	'Disabled' 'Enabled' (必須)

Dynamics365DataConnectorProperties

名前	形容	価値
dataTypes	コネクタで使用できるデータ型。	Dynamics365DataConnectorDataTypes (必須)
tenantId	接続してデータを取得するテナント ID。	string (必須)

InstructionStepsInstructionsItem

名前	形容	価値
パラメーター	設定のパラメーター	任意
種類	設定の種類	'CopyableLabel' 'InfoMessage' 'InstructionStepsGroup' (必須)

IoTDataConnector

名前	形容	価値
種類	データコネクタの種類	'IOT' (必須)
プロパティ	IoT データコネクタのプロパティ。	IoTDataConnectorProperties の

IoTDataConnectorProperties

名前	形容	価値
dataTypes	コネクタで使用できるデータ型。	AlertsDataTypeOfDataConnector の
subscriptionId	接続してデータを取得するサブスクリプション ID。	糸

McasDataConnector

名前	形容	価値
種類	データコネクタの種類	'MicrosoftCloudAppSecurity' (必須)
プロパティ	MCAS (Microsoft Cloud App Security) データコネクタのプロパティ。	McasDataConnectorProperties をする

McasDataConnectorDataTypes

名前	形容	価値
アラート	データ型の接続を警告します。	DataConnectorDataTypeCommon (必須)
discoveryLogs	検出ログのデータ型の接続。	DataConnectorDataTypeCommon

McasDataConnectorProperties

名前	形容	価値
dataTypes	コネクタで使用できるデータ型。	McasDataConnectorDataTypes (必須)
tenantId	接続してデータを取得するテナント ID。	string (必須)

MdatpDataConnector

名前	形容	価値
種類	データコネクタの種類	'MicrosoftDefenderAdvancedThreatProtection' (必須)
プロパティ	MDATP (Microsoft Defender Advanced Threat Protection) データコネクタのプロパティ。	MdatpDataConnectorProperties の

MdatpDataConnectorProperties

名前	形容	価値
dataTypes	コネクタで使用できるデータ型。	AlertsDataTypeOfDataConnector の
tenantId	接続してデータを取得するテナント ID。	string (必須)