title	description	author	ms.author	ms.topic	ms.date
Create a codeless connector for Microsoft Sentinel	Learn how to create a codeless connector in Microsoft Sentinel using the Codeless Connector Platform (CCP).	batamig	bagol	how-to	01/24/2022

Create a codeless connector for Microsoft Sentinel (Public preview)

Important

The Codeless Connector Platform (CCP) is currently in PREVIEW. The Azure Preview Supplemental Terms include additional legal terms that apply to Azure features that are in beta, preview, or otherwise not yet released into general availability.

The Codeless Connector Platform (CCP) provides partners, advanced users, and developers with the ability to create custom connectors, connect them, and ingest data to Microsoft Sentinel. Connectors created via the CCP can be deployed via API, an ARM template, or as a solution in the Microsoft Sentinel content hub.

Connectors created using CCP are fully SaaS, without any requirements for service installations, and also include health monitoring and full support from Microsoft Sentinel.

Create your data connector by defining a JSON configuration file, with settings for how the data connector page in Microsoft Sentinel looks and works and polling settings that define how the connection works between Microsoft Sentinel and your data source.

Use the following steps to create your CCP connector and connect to your data source from Microsoft Sentinel:

[!div class="checklist"]

Configure the connector's user interface

Configure the connector's polling settings

Deploy your connector to your Microsoft Sentinel workspace

Connect Microsoft Sentinel to your data source and start ingesting data

This article describes the syntax used in the CCP JSON configuration file and procedures for deploying your connector via API, an ARM template, or a Microsoft Sentinel solution.

Prerequisites

Before building a connector, we recommend that you learn and understand how your data source behaves and exactly how Microsoft Sentinel will need to connect.

For example, you'll need to understand the types of authentication, pagination, and API endpoints that are required for successful connections.

Create a connector JSON configuration file

To create your custom, CCP connector, create a JSON file with the following basic syntax:

{
    "kind": "<name>",
    "properties": {
        "connectorUiConfig": {...
        },
        "pollingConfig": {...
        }
    }
}

Fill in each of the following area with additional properties that define how your connector connects Microsoft Sentinel to your data source, and is displayed in the Azure portal:

connectorUiConfig. Defines the visual elements and text displayed on the data connector page in Microsoft Sentinel. For more information, see Configure your connector's user interface.
pollingConfig. Defines how Microsoft Sentinel collects data from your data source. For more information, see Configure your connector's polling settings.

Configure your connector's user interface

This section describes the configuration for how the user interface on the data connector page appears in Microsoft Sentinel.

Use the properties supported for the connectorUiConfig area of the JSON configuration file to configure the user interface displayed for your data connector in the Azure portal.

The following image shows a sample data connector page, highlighted with numbers that correspond to configurable areas of the user interface:

:::image type="content" source="media/create-codeless-connector/sample-data-connector-page.png" alt-text="Screenshot of a sample data connector page.":::

Title. The title displayed for your data connector.
Icon. The icon displayed for your data connector.
Status. Describes whether or not your data connector is connected to Microsoft Sentinel.
Data charts. Displays relevant queries and the amount of ingested data in the last two weeks.
Instructions tab. Includes a Prerequisites section, with a list of minimal validations before the user can enable the connector, and an Instructions, with a list of instructions to guide the user in enabling the connector. This section can include text, buttons, forms, tables, and other common widgets to simplify the process.
Next steps tab. Includes useful information for understanding how to find data in the event logs, such as sample queries.

The connectorUiConfig section of the configuration file includes the following properties:

Name	Type	Description
id	GUID	A distinct ID for the connector.
title	String	Title displayed in the data connector page.
publisher	String	Your company name.
descriptionMarkdown	String, in markdown	A description for the connector.
additionalRequirementBanner	String, in markdown	Text for the Prerequisites section of the Instructions tab.
graphQueriesTableName	String	Defines the name of the Log Analytics table from which data for your queries is pulled. The table name can be any string, but must end in `_CL`. For example: `TableName_CL`
graphQueries	GraphQuery[]	Queries that present data ingestion over the last two weeks in the Data charts pane. Provide either one query for all of the data connector's data types, or a different query for each data type.
sampleQueries	SampleQuery[]	Sample queries for the customer to understand how to find the data in the event log, to be displayed in the Next steps tab.
dataTypes	DataTypes[]	A list of all data types for your connector, and a query to fetch the time of the last event for each data type.
connectivityCriteria	ConnectivityCriteria[]	An object that defines how to verify if the connector is correctly defined.
availability	`{` `status: Number,` `isPreview: Boolean` `}`	One of the following values: - 1: Connector is generally available to customers. - isPreview: Indicates that the connector is not yet generally available.
permissions	RequiredConnectorPermissions[]	Lists the permissions required to enable or disable the connector.
instructionsSteps	InstructionStep[]	An array of widget parts that explain how to install the connector, displayed on the Instructions tab.
metadata	Metadata	ARM template metadata, for deploying the connector as an ARM template.

GraphQuery

Defines a query that presents data ingestion over the last two weeks in the Data charts pane.

Provide either one query for all of the data connector's data types, or a different query for each data type.

Name	Type	Description
metricName	String	A meaningful name for your graph. Example: `Total data received`
legend	String	The string that appears in the legend to the right of the chart, including a variable reference. Example: `{{graphQueriesTableName}}`
baseQuery	String	The query that filters for relevant events, including a variable reference. Example: `TableName

SampleQuery

Name	Type	Description
Description	String	A meaningful description for the sample query. Example: `Top 10 vulnerabilities detected`
Query	String	Sample query used to fetch the data type's data. Example: `{{graphQueriesTableName}}\n

DataTypes

Name	Type	Description
dataTypeName	String	A meaningful description for the`lastDataReceivedQuery` query, including support for a variable. Example: `{{graphQueriesTableName}}`
lastDataReceivedQuery	String	A query that returns one row, and indicates the last time data was received, or no data if there is no relevant data. Example: `{{graphQueriesTableName}}\n

ConnectivityCriteria

Name	Type	Description
type	ENUM	Always define this value as `SentinelKindsV2`.
value	deprecated	N/A

Availability

Name	Type	Description
status	Boolean	Determines whether or not the data connector is available in your workspace. Example: `1`
isPreview	Boolean	Determines whether the data connector is supported as Preview or not. Example: `false`

RequiredConnectorPermissions

Name	Type	Description
tenant	ENUM	Defines the required permissions, as one or more of the following values: `GlobalAdmin`, `SecurityAdmin`, `SecurityReader`, `InformationProtection` Example: The tenant value displays displays in Microsoft Sentinel as: Tenant Permissions: Requires `Global Administrator` or `Security Administrator` on the workspace's tenant
licenses	ENUM	Defines the required licenses, as one of the following values: `OfficeIRM`,`OfficeATP`, `Office365`, `AadP1P2`, `Mcas`, `Aatp`, `Mdatp`, `Mtp`, `IoT` Example: The licenses value displays in Microsoft Sentinel as: License: Required Azure AD Premium P2
customs	String	Describes any custom permissions required for your data connection, in the following syntax: `{` `name:string,` `description:string` `}` Example: The customs value displays in Microsoft Sentinel as: Subscription: Contributor permissions to the subscription of your IoT Hub.
resourceProvider	ResourceProviderPermissions	Describes any prerequisites for your Azure resource. Example: The resourceProvider value displays in Microsoft Sentinel as: Workspace: write permission is required. Keys: read permissions to shared keys for the workspace are required.

ResourceProviderPermissions

Name	Type	Description
provider	ENUM	Describes the resource provider, with one of the following values: - `Microsoft.OperationalInsights/workspaces` - `Microsoft.OperationalInsights/solutions` - `Microsoft.OperationalInsights/workspaces/datasources` - `microsoft.aadiam/diagnosticSettings` - `Microsoft.OperationalInsights/workspaces/sharedKeys` - `Microsoft.Authorization/policyAssignments`
providerDisplayName	String	A query that should return one row, indicating the last time that data was received, or no data if there is no relevant data.
permissionsDisplayText	String	Display text for Read, Write, or Read and Write permissions.
requiredPermissions	RequiredPermissionSet	Describes the minimum permissions required for the connector as one of the following values: `read`, `write`, `delete`, `action`
Scope	ENUM	Describes the scope of the data connector, as one of the following values: `Subscription`, `ResourceGroup`, `Workspace`

RequiredPermissionSet

Name	Type	Description
read	boolean	Determines whether read permissions are required.
write	boolean	Determines whether write permissions are required.
delete	boolean	Determines whether delete permissions are required.
action	boolean	Determines whether action permissions are required.

Metadata

This section provides metadata used when you're deploying your data connector as an ARM template.

Name	Type	Description
id	String	Defines a GUID for your ARM template.
kind	String	Defines the kind of ARM template you're creating. Always use `dataConnector`.
source	String	Describes your data source, using the following syntax: `{` `kind:string` `name:string` `}`
author	String	Describes the data connector author, using the following syntax: `{` `name:string` `}`
support	String	Describe the support provided for the data connector using the following syntax: `{` `"tier": string,` `"name": string,` `"email": string,` `"link": string` `}`

Instructions

This section provides parameters that define the set of instructions that appear on your data connector page in Microsoft Sentinel.

Name	Type	Description
title	String	Optional. Defines a title for your instructions.
description	String	Optional. Defines a meaningful description for your instructions.
innerSteps	InstructionStep	Optional. Defines an array of inner instruction steps.
bottomBorder	Boolean	When `true`, adds a bottom border to the instructions area on the connector page in Microsoft Sentinel
isComingSoon	Boolean	When `true`, adds a Coming soon title on the connector page in Microsoft Sentinel

CopyableLabel

Shows a field with a button on the right to copy the field value. For example:

:::image type="content" source="media/create-codeless-connector/copy-field-value.png" alt-text="Screenshot of a copy value button in a field.":::

Sample code:

Implementation:
instructions: [
                new CopyableLabelInstructionModel({
                    fillWith: [“MicrosoftAwsAccount”],
                    label: “Microsoft Account ID”,
                }),
                new CopyableLabelInstructionModel({
                    fillWith: [“workspaceId”],
                    label: “External ID (WorkspaceId)”,
                }),
            ]

Parameters: CopyableLabelInstructionParameters

Name	Type	Description
fillWith	ENUM	Optional. Array of environment variables used to populate a placeholder. Separate multiple placeholders with commas. For example: `{0},{1}` Supported values: `workspaceId`, `workspaceName`, `primaryKey`, `MicrosoftAwsAccount`, `subscriptionId`
label	String	Defines the text for the label above a text box.
value	String	Defines the value to present in the text box, supports placeholders.
rows	Rows	Optional. Defines the rows in the user interface area. By default, set to 1.
wideLabel	Boolean	Optional. Determines a wide label for long strings. By default, set to `false`.

InfoMessage

Defines an inline information message. For example:

:::image type="content" source="media/create-codeless-connector/inline-information-message.png" alt-text="Screenshot of an inline information message.":::

In contrast, the following image shows a non-inline information message:

:::image type="content" source="media/create-codeless-connector/non-inline-information-message.png" alt-text="Screenshot of a non-inline information message.":::

Sample code:

instructions: [
                new InfoMessageInstructionModel({
                    text:”Microsoft Defender for Endpoint… “,
                    visible: true,
                    inline: true,
                }),
                new InfoMessageInstructionModel({
                    text:”In order to export… “,
                    visible: true,
                    inline: false,
                }),

            ]

Parameters: InfoMessageInstructionModelParameters

Name	Type	Description
text	String	Define the text to display in the message.
visible	Boolean	Determines whether the message is displayed.
inline	Boolean	Determines how the information message is displayed. - `true`: (Recommended) Shows the information message embedded in the instructions. - `false`: Adds a blue background.

LinkInstructionModel

Displays a link to other pages in the Azure portal, as a button or a link. For example:

:::image type="content" source="media/create-codeless-connector/link-by-button.png" alt-text="Screenshot of a link added as a button.":::

:::image type="content" source="media/create-codeless-connector/link-by-text.png" alt-text="Screenshot of a link added as inline text.":::

Sample code:

new LinkInstructionModel({linkType: “OpenPolicyAssignment”, policyDefinitionGuid: <GUID>, assignMode = “Policy”})

new LinkInstructionModel({ linkType: LinkType.OpenAzureActivityLog } )

Parameters: InfoMessageInstructionModelParameters

Name	Type	Description
linkType	ENUM	Determines the link type, as one of the following values: `InstallAgentOnWindowsVirtualMachine` `InstallAgentOnWindowsNonAzure` `InstallAgentOnLinuxVirtualMachine` `InstallAgentOnLinuxNonAzure` `OpenSyslogSettings` `OpenCustomLogsSettings` `OpenWaf` `OpenAzureFirewall` `OpenMicrosoftAzureMonitoring` `OpenFrontDoors` `OpenCdnProfile` `AutomaticDeploymentCEF` `OpenAzureInformationProtection` `OpenAzureActivityLog` `OpenIotPricingModel` `OpenPolicyAssignment` `OpenAllAssignmentsBlade` `OpenCreateDataCollectionRule`
policyDefinitionGuid	String	Optional. For policy-based connectors, defines the GUID of the built-in policy definition.
assignMode	ENUM	Optional. For policy-based connectors, defines the assign mode, as one of the following values: `Initiative`, `Policy`
dataCollectionRuleType	ENUM	Optional. For DCR-based connectors, defines the type of data collection rule type as one of the following: `SecurityEvent`, `ForwardEvent`

To define an inline link using markdown, use the following example as a guide:

<value>Follow the instructions found on article [Connect Microsoft Sentinel to your threat intelligence platform]({0}). Once the application is created you will need to record the Tenant ID, Client ID and Client Secret.</value>

The code sample listed above shows an inline link that looks like the following image:

:::image type="content" source="media/create-codeless-connector/sample-markdown-link-text.png" alt-text="Screenshot of the link text created by the earlier sample markdown.":::

To define a link as an ARM template, use the following example as a guide:

    <value>1. Click the **Deploy to Azure** button below.
[![Deploy To Azure]({0})]({1})

The code sample listed above shows a link button that looks like the following image:

:::image type="content" source="media/create-codeless-connector/sample-markdown-link-button.png" alt-text="Screenshot of the link button created by the earlier sample markdown.":::

InstructionStep

Displays a group of instructions, as an expandable accordion or non-expandable, separate from the main instructions section.

For example:

:::image type="content" source="media/create-codeless-connector/accordion-instruction-area.png" alt-text="Screenshot of an expandable, extra instruction group.":::

Parameters: InstructionStepsGroupModelParameters

Name	Type	Description
title	String	Defines the title for the instruction step.
instructionSteps	InstructionStep[]	Optional. Defines an array of inner instruction steps.
canCollapseAllSections	Boolean	Optional. Determines whether the section is a collapsible accordion or not.
noFxPadding	Boolean	Optional. If `true`, reduces the height padding to save space.
expanded	Boolean	Optional. If `true`, shows as expanded by default.

Configure your connector's polling settings

This section describes the configuration for how data is polled from your data source for a codeless data connector.

The following code shows the syntax of the pollingConfig section of the CCP configuration file.

"pollingConfig": {
    auth": {
        "authType": <string>,
    },
    "request": {…
    },
    "response": {…
    },
    "paging": {…
    }
 }

The pollingConfig section includes the following properties:

Name	Type	Description
id	String	Mandatory. Defines a unique identifier for a rule or configuration entry, using one of the following values: - A GUID (recommended) - A document ID, if the data source resides in a Cosmos DB
auth	String	Describes the authentication properties for polling the data. For more information, see auth configuration.
auth.authType	String	Mandatory. Defines the type of authentication, nested inside the `auth` object, as one of the following values: `Basic`, `APIKey`, `Session`
request	Nested JSON	Mandatory. Describes the request payload for polling the data, such as the API endpoint. For more information, see request configuration.
response	Nested JSON	Mandatory. Describes the response object and nested message returned from the API when polling the data. For more information, see response configuration.
paging	Nested JSON.	Optional. Describes the pagination payload when polling the data. For more information, see paging configuration.

For more information, see Sample pollingConfig code.

auth configuration

The auth section of the pollingConfig configuration includes the following parameters, depending on the type defined in the authType element:

APIKey authType parameters

Name	Type	Description
APIKeyName	String	Optional. Defines the name of your API key, as one of the following values: - `XAuthToken` - `Authorization`
IsAPIKeyInPostPayload	Boolean	Determines where your API key is defined. True: API key is defined in the POST request payload False: API key is defined in the header
APIKeyIdentifier	String	Optional. Defines the name of the identifier for the API key. For example, where the authorization is defined as `"Authorization": "token <secret>"`, this parameter is defined as: `{APIKeyIdentifier: “token”})`

Session authType parameters

Name	Type	Description
QueryParameters	String	Optional. A list of query parameters, in the serialized `dictionary<string, string>` format: `{'<attr_name>': '<val>', '<attr_name>': '<val>'... }`
IsPostPayloadJson	Boolean	Optional. Determines whether the query parameters are in JSON format.
Headers	String.	Optional. Defines the header used when calling the endpoint to get the session ID, and when calling the endpoint API. Define the string in the serialized `dictionary<string, string>` format: `{'<attr_name>': '<val>', '<attr_name>': '<val>'... }`
SessionTimeoutInMinutes	String	Optional. Defines a session timeout, in minutes.
SessionIdName	String	Optional. Defines an ID name for the session.
SessionLoginRequestUri	String	Optional. Defines a session login request URI.

request configuration

The request section of the pollingConfig configuration includes the following parameters:

Name	Type	Description
apiEndpoint	String	Mandatory. Defines the endpoint to pull data from.
httpMethod	String	Mandatory. Defines the API method: `GET` or `POST`
queryTimeFormat	String, or UnixTimestamp or UnixTimestampInMills	Mandatory. Defines the format used to define the query time. This value can be a string, or in UnixTimestamp or UnixTimestampInMills format to indicate the query start and end time in the UnixTimestamp.
startTimeAttributeName	String	Optional. Defines the name of the attribute that defines the query start time.
endTimeAttributeName	String	Optional. Defines the name of the attribute that defines the query end time.
queryTimeIntervalAttributeName	String.	Optional. Defines the name of the attribute that defines the query time interval.
queryTimeIntervalDelimiter	String	Optional. Defines the query time interval delimiter.
queryWindowInMin	String	Optional. Defines the available query window, in minutes. Minimum value: `5`
queryParameters	String	Optional. Defines the parameters passed in the query in the `eventsJsonPaths` path. Define the string in the serialized `dictionary<string, string>` format: `{'<attr_name>': '<val>', '<attr_name>': '<val>'... }`
queryParametersTemplate	String object	Optional. Defines the query parameters template to use when passing query parameters in advanced scenarios. For example: `"queryParametersTemplate": "{'cid': 1234567, 'cmd': 'reporting', 'format': 'siem', 'data': { 'from': '{_QueryWindowStartTime}', 'to': '{_QueryWindowEndTime}'}, '{_APIKeyName}': '{_APIKey}'}"`
isPostPayloadJson	Boolean	Optional. Determines whether the POST payload is in JSON format.
rateLimitQPS	Double	Optional. Defines the number of calls or queries allowed in a second.
timeoutInSeconds	Integer	Optional. Defines the request timeout, in seconds.
retryCount	Integer	Optional. Defines the number of request retries to try if needed.
headers	String	Optional. Defines the request header value, in the serialized `dictionary<string, string>` format: `{'<attr_name>': '<val>', '<attr_name>': '<val>'... }`

response configuration

The response section of the pollingConfig configuration includes the following parameters:

Name	Type	Description
eventsJsonPaths	List of strings	Mandatory. Defines the path to the message in the response JSON. A JSON path expression specifies a path to an element, or a set of elements, in a JSON structure
successStatusJsonPath	String	Optional. Defines the path to the success message in the response JSON.
successStatusValue	String	Optional. Defines the path to the success message value in the response JSON
isGzipCompressed	Boolean	Optional. Determines whether the response is compressed in a gzip file.

The following code shows an example of the eventsJsonPaths value for a top-level message:

"eventsJsonPaths": [
              "$"
            ]

paging configuration

The paging section of the pollingConfig configuration includes the following parameters:

Name	Type	Description
pagingType	String	Mandatory. Determines the paging type to use in results, as one of the following values: `None`, `LinkHeader`, `NextPageToken`, `NextPageUrl`, `Offset`
linkHeaderTokenJsonPath	String	Optional. Defines the JSON path to link header in the response JSON, if the `LinkHeader` isn't defined in the response header.
nextPageTokenJsonPath	String	Optional. Defines the path to a next page token JSON.
hasNextFlagJsonPath	String	Optional. Defines the path to the `HasNextPage` flag attribute.
nextPageTokenResponseHeader	String	Optional. Defines the next page token header name in the response.
nextPageParaName	String	Optional. Determines the next page name in the request.
nextPageRequestHeader	String	Optional. Determines the next page header name in the request.
nextPageUrl	String	Optional. Determines the next page URL, if it's different from the initial request URL.
nextPageUrlQueryParameters	String	Optional. Determines the next page URL's query parameters if it's different from the initial request's URL. Define the string in the serialized `dictionary<string, object>` format: `{'<attr_name>': <val>, '<attr_name>': <val>... }`
offsetParaName	String	Optional. Defines the name of the offset parameter.
pageSizeParaName	String	Optional. Defines the name of the page size parameter.
PageSize	Integer	Defines the paging size.

Sample pollingConfig code

The following code shows an example of the pollingConfig section of the CCP configuration file:

"pollingConfig": {
    "auth": {
        "authType": "APIKey",
        "APIKeyIdentifier": "token",
        "APIKeyName": "Authorization"
     },
     "request": {
        "apiEndpoint": "https://api.github.com/../{{placeHolder1}}/audit-log",
        "rateLimitQPS": 50,
        "queryWindowInMin": 15,
        "httpMethod": "Get",
        "queryTimeFormat": "yyyy-MM-ddTHH:mm:ssZ",
        "retryCount": 2,
        "timeoutInSeconds": 60,
        "headers": {
           "Accept": "application/json",
           "User-Agent": "Scuba"
        },
        "queryParameters": {
           "phrase": "created:{_QueryWindowStartTime}..{_QueryWindowEndTime}"
        }
     },
     "paging": {
        "pagingType": "LinkHeader",
        "pageSizeParaName": "per_page"
     },
     "response": {
        "eventsJsonPaths": [
          "$"
        ]
     }
}

Add placeholders to your connector's JSON configuration file

You may want to create a JSON configuration file template, with placeholders parameters, to reuse across multiple connectors, or even to create a connector with data that you don't currently have.

To create placeholder parameters, define an additional array named userRequestPlaceHoldersInput in the Instructions section of your CCP JSON configuration file, using the following syntax:

"instructions": [
                {
                  "parameters": {
                    "enable": "true",
                    "userRequestPlaceHoldersInput": [
                      {
                        "displayText": "Organization Name",
                        "requestObjectKey": "apiEndpoint",
                        "placeHolderName": "{{placeHolder1}}"
                      }
                    ]
                  },
                  "type": "APIKey"
                }
              ]

The userRequestPlaceHoldersInput parameter includes the following attributes:

Name	Type	Description
DisplayText	String	Defines the text box display value, which is displayed to the user when connecting.
RequestObjectKey	String	Defines the ID used to identify where in the request section of the API call to replace the placeholder value with a user value. If you don't use this attribute, use the `PollingKeyPaths` attribute instead.
PollingKeyPaths	String	Defines an array of JsonPath objects that directs the API call to anywhere in the template, to replace a placeholder value with a user value. Example: `"pollingKeyPaths":["$.request.queryParameters.test1"]` If you don't use this attribute, use the `RequestObjectKey` attribute instead.
PlaceHolderName	String	Defines the name of the placeholder parameter in the JSON template file. This can be any unique value, such as `{{placeHolder}}`.

Deploy your connector in Microsoft Sentinel and start ingesting data

After creating your JSON configuration file, including both the user interface and polling configuration, deploy your connector in your Microsoft Sentinel workspace.

Use one of the following options to deploy your data connector.

[!TIP] The advantage of deploying via an Azure Resource Manager (ARM) template is that several values are built-in to the template, and you don't need to define them manually in an API call.

Deploy via ARM template

Use a JSON configuration file to create an ARM template to use when deploying your connector. To ensure that your data connector gets deployed to the correct workspace, make sure to either define the workspace for the ARM template to deploy when creating your JSON file, or select the workspace when deploying the ARM template.
1. Prepare an ARM template JSON file for your connector. For example, see the following ARM template JSON files:
  - Data connector in the Slack solution
  - Atlassian Jira Audit data connector
2. In the Azure portal, search for Deploy a custom template.
3. On the Custom deployment page, select Build your own template in the editor > Load file. Browse to and select your local ARM template, and then save your changes.
4. Select your subscription and resource group, and then enter the Log Analytics workspace where you want to deploy your custom connector.
5. Select Review + create to deploy your custom connector to Microsoft Sentinel.
6. In Microsoft Sentinel, go to the Data connectors page, search for your new connector. Configure it to start ingesting data.
For more information, see Deploy a local template in the Azure Resource Manager documentation.

Deploy via API
1. Authenticate to the Azure API. For more information, see Getting started with REST.
2. Invoke a CREATE or UPDATE API call to Microsoft Sentinel to deploy your new connector. In the request body, define the kind value as APIPolling.
Your data connector is deployed to your Microsoft Sentinel workspace, and is available on the Data connectors page.

Configure your data connector to connect your data source and start ingesting data into Microsoft Sentinel. You can connect to your data source either via the portal, as with out-of-the-box data connectors, or via API.

When you use the Azure portal to connect, user data is sent automatically. When you connect via API, you'll need to send the relevant authentication parameters in the API call.

Connect via the Azure portal

In your Microsoft Sentinel data connector page, follow the instructions you've provided to connect to your data connector.

The data connector page in Microsoft Sentinel is controlled by the InstructionStep configuration in the connectorUiConfig element of the CCP JSON configuration file. If you have issues with the user interface connection, make sure that you have the correct configuration for your authentication type.

Connect via API

Use the CONNECT endpoint to send a PUT method and pass the JSON configuration directly in the body of the message. For more information, see auth configuration.

Use the following API attributes, depending on the authType defined. For each authType parameter, all listed attributes are mandatory and are string values.

authType	Attributes
Basic	Define: - `kind` as `Basic` - `userName` as your username, in quotes - `password` as your password, in quotes
APIKey	Define: - `kind` as `APIKey` - `APIKey` as your full API key string, in quotes

If you're using a template configuration file with placeholder data, send the data together with the placeHolderValue attributes that hold the user data. For example:

"requestConfigUserInputValues": [
    {
       "displayText": "<A display name>",
       "placeHolderName": "<A placeholder name>",
       "placeHolderValue": "<A value for the placeholder>",
       "pollingKeyPaths": "<Array of items to use in place of the placeHolderName>"
     }
]

In Microsoft Sentinel, go to the Logs page and verify that you see the logs from your data source flowing in to your workspace.

If you don't see data flowing into Microsoft Sentinel, check your data source documentation and troubleshooting resources, check the configuration details, and check the connectivity. For more information, see Monitor the health of your data connectors.

Disconnect your connector

If you no longer need your connector's data, disconnect the connector to stop the data flow.

Use one of the following methods:

Azure portal: In your Microsoft Sentinel data connector page, select Disconnect.

API: Use the DISCONNECT API to send a PUT call with an empty body to the following URL:

https://management.azure.com /subscriptions/{{SUB}}/resourceGroups/{{RG}}/providers/Microsoft.OperationalInsights/workspaces/{{WS-NAME}}/providers/Microsoft.SecurityInsights/dataConnectors/{{Connector_Id}}/disconnect?api-version=2021-03-01-preview

Next steps

If you haven't yet, share your new codeless data connector with the Microsoft Sentinel community! Create a solution for your data connector and share it in the Microsoft Sentinel Marketplace.

For more information, see About Microsoft Sentinel solutions.

Files

create-codeless-connector.md

Latest commit

History

create-codeless-connector.md

File metadata and controls

Create a codeless connector for Microsoft Sentinel (Public preview)

Prerequisites

Create a connector JSON configuration file

Configure your connector's user interface

GraphQuery

SampleQuery

DataTypes

ConnectivityCriteria

Availability

RequiredConnectorPermissions

ResourceProviderPermissions

RequiredPermissionSet

Metadata

Instructions

CopyableLabel

InfoMessage

LinkInstructionModel

InstructionStep

Configure your connector's polling settings

auth configuration

APIKey authType parameters

Session authType parameters

request configuration

response configuration

paging configuration

Sample pollingConfig code

Add placeholders to your connector's JSON configuration file

Deploy your connector in Microsoft Sentinel and start ingesting data

Deploy via ARM template

Deploy via API

Connect via the Azure portal

Connect via API

Disconnect your connector

Next steps