Microsoft.SecurityInsights dataConnectors 2021-09-01-preview

아티클
12/21/2024

Bicep 리소스 정의

dataConnectors 리소스 종류는 다음을 대상으로 하는 작업으로 배포할 수 있습니다.

각 API 버전에서 변경된 속성 목록은 변경 로그참조하세요.

리소스 형식

Microsoft.SecurityInsights/dataConnectors 리소스를 만들려면 템플릿에 다음 Bicep을 추가합니다.

resource symbolicname 'Microsoft.SecurityInsights/dataConnectors@2021-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'
    }
  }
}

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'
  }
}

officeATP경우 다음을 사용합니다.

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

officeIRM경우 다음을 사용합니다.

{
  kind: 'OfficeIRM'
  properties: {
    dataTypes: {
      alerts: {
        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

이름	묘사	값
상태	이 데이터 형식 연결이 사용되는지 여부를 설명합니다.	'사용 안 함' 'Enabled'(필수)

AwsCloudTrailDataConnectorProperties

이름	묘사	값
awsRoleArn	Aws 계정에 액세스하는 데 사용되는 Aws 역할 Arn(CloudTrailReadOnly 정책 포함)입니다.	문자열
dataTypes	커넥터에 사용할 수 있는 데이터 형식입니다.	awsCloudTrailDataConnectorDataTypes (필수)

AwsS3DataConnector

이름	묘사	값
종류	데이터 커넥터 종류	'AmazonWebServicesS3'(필수)
속성	Amazon Web Services S3 데이터 커넥터 속성.	AwsS3DataConnectorProperties

AwsS3DataConnectorDataTypes

이름	묘사	값
로그	데이터 형식을 기록합니다.	AwsS3DataConnectorDataTypesLogs(필수)

AwsS3DataConnectorDataTypesLogs

이름	묘사	값
상태	이 데이터 형식 연결이 사용되는지 여부를 설명합니다.	'사용 안 함' 'Enabled'(필수)

AwsS3DataConnectorProperties

이름	묘사	값
dataTypes	커넥터에 사용할 수 있는 데이터 형식입니다.	awsS3DataConnectorDataTypes (필수)
destinationTable	LogAnalytics의 로그 대상 테이블 이름입니다.	string(필수)
roleArn	Aws 계정에 액세스하는 데 사용되는 Aws 역할 Arn입니다.	string(필수)
sqsUrls	커넥터에 대한 AWS sqs URL입니다.	string[] (필수)

CodelessApiPollingDataConnector

이름	묘사	값
종류	데이터 커넥터 종류	'APIPolling'(필수)
속성	코드 없는 poling 데이터 커넥터 속성	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
페이징	폴러의 폴링 요청 페이징 구성 설명	CodelessConnectorPollingPagingProperties
요청	폴러의 설문 조사 요청 구성 매개 변수 설명	codelessConnectorPollingRequestProperties (필수)
응답	폴러의 응답 구성 매개 변수 설명	CodelessConnectorPollingResponseProperties

CodelessConnectorPollingPagingProperties

이름	묘사	값
nextPageParaName	다음 페이지 특성의 이름을 정의합니다.	문자열
nextPageTokenJsonPath	다음 페이지 토큰 JSON에 대한 경로를 정의합니다.	문자열
pageCountAttributePath	페이지 개수 특성의 경로를 정의합니다.	문자열
pageSize	페이징 크기를 정의합니다.	int
pageSizeParaName	페이지 크기 매개 변수의 이름을 정의합니다.	문자열
pageTimeStampAttributePath	페이징 타임 스탬프 특성에 대한 경로를 정의합니다.	문자열
pageTotalCountAttributePath	페이지 총 개수 특성의 경로를 정의합니다.	문자열
pagingType	형식을 설명합니다. 는 'None', 'PageToken', 'PageCount', 'TimeStamp'일 수 있습니다.	string(필수)
searchTheLatestTimeStampFromEventsList	이벤트 목록에서 최신 타임스탬프를 검색할지 여부를 결정합니다.	문자열

CodelessConnectorPollingRequestProperties

이름	묘사	값
apiEndpoint	데이터를 가져와야 하는 엔드포인트에 대해 설명합니다.	string(필수)
endTimeAttributeName	이는 시간 창의 끝에서 쿼리 이벤트를 사용합니다.	문자열
헤더	설문 조사 요청에서 보낸 헤더 설명	어떤
httpMethod	설문 조사 요청, GET 또는 POST에 사용할 http 메서드 형식	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

이름	묘사	값
상태	이 데이터 형식 연결이 사용되는지 여부를 설명합니다.	'사용 안 함' 'Enabled'(필수)

Dynamics365DataConnector

이름	묘사	값
종류	데이터 커넥터 종류	'Dynamics365'(필수)
속성	Dynamics365 데이터 커넥터 속성입니다.	Dynamics365DataConnectorProperties

Dynamics365DataConnectorDataTypes

이름	묘사	값
dynamics365Cds 작업	Common Data Service 데이터 형식 연결입니다.	Dynamics365DataConnectorDataTypesDynamics365CdsActivities(필수)

Dynamics365DataConnectorDataTypesDynamics365CdsActivities

이름	묘사	값
상태	이 데이터 형식 연결이 사용되는지 여부를 설명합니다.	'사용 안 함' 'Enabled'(필수)

Dynamics365DataConnectorProperties

이름	묘사	값
dataTypes	커넥터에 사용할 수 있는 데이터 형식입니다.	Dynamics365DataConnectorDataTypes(필수)
tenantId	연결하고 데이터를 가져올 테넌트 ID입니다.	string(필수)

InstructionStepsInstructionsItem

이름	묘사	값
매개 변수	설정에 대한 매개 변수	어떤
형	설정의 종류	'CopyableLabel' 'InfoMessage' 'InstructionStepsGroup'(필수)

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(필수)