无代码连接器平台的数据连接器定义参考

要使用无代码连接器平台 (CCP) 创建数据连接器，请使用本文档作为适用于数据连接的 Microsoft Sentinel REST API 定义参考文档的补充。具体来说，此参考文档将展开以下部分：

• connectorUiConfig - 定义 Microsoft Sentinel 中数据连接器页上显示的视觉元素和文本。

有关详细信息，请参阅创建无代码连接器。

数据连接器定义 - 创建或更新

请参考 REST API 文档中的创建或更新操作，以查找最新的稳定或预览 API 版本。 只有 update 操作需要 etag 值。

PUT 方法

https://management.azure.com/subscriptions/{{subscriptionId}}/resourceGroups/{{resourceGroupName}}/providers/Microsoft.OperationalInsights/workspaces/{{workspaceName}}/providers/Microsoft.SecurityInsights/dataConnectorDefinitions/{{dataConnectorDefinitionName}}?api-version={{apiVersion}}

URI 参数

有关最新 API 版本的详细信息，请参阅数据连接器定义 - 创建或更新 URI 参数

请求正文

使用 API 创建 CCP 数据连接器定义的请求正文具有以下结构：

{
    "kind": "Customizable",
    "properties": {
        "connectorUIConfig": {}
    }
}

dataConnectorDefinition 具有以下属性：

配置连接器的用户界面

本部分介绍可用于自定义数据连接器页的用户界面的配置选项。

以下屏幕截图显示了一个示例数据连接器页，其中突出显示了与用户界面的显著区域相对应的数字。

配置用户界面所需的 connectorUiConfig 部分中以下每个元素对应于 API 的 CustomizableConnectorUiConfig 部分。

connectivityCriteria

dataTypes

graphQueries

定义显示过去两周数据引入的查询。

针对所有数据连接器的数据类型提供一个查询，或针对每种数据类型提供不同的查询。

权限

resourceProvider

sampleQueries

配置其他链接选项

若要使用 markdown 定义内联链接，请使用以下示例。

{
   "title": "",
   "description": "Make sure to configure the machine's security according to your organization's security policy\n\n\n[Learn more >](https://aka.ms/SecureCEF)"
}

若要将链接定义为 ARM 模板，请使用以下示例作为指导：

{
   "title": "Azure Resource Manager (ARM) template",
   "description": "1. Click the **Deploy to Azure** button below.\n\n\t[![Deploy To Azure](https://aka.ms/deploytoazurebutton)]({URL to custom ARM template})"
}

instructionSteps

本部分提供的参数用于定义 Microsoft Sentinel 中数据连接器页上显示的指令集，并具有以下结构：

"instructionSteps": [
    {
        "title": "",
        "description": "",
        "instructions": [
        {
            "type": "",
            "parameters": {}
        }
        ],
        "innerSteps": {}
    }
]

instructions

显示一组指令，其中包含各种参数，并能够在组中嵌套更多 instructionSteps。 此处定义的参数对应

OAuthForm

此组件要求 数据连接器模板的 auth 属性中存在该 OAuth2 类型。

"instructions": [
{
  "type": "OAuthForm",
  "parameters": {
    "clientIdLabel": "Client ID",
    "clientSecretLabel": "Client Secret",
    "connectButtonLabel": "Connect",
    "disconnectButtonLabel": "Disconnect"
  }          
}
]

文本框

下面是 Textbox 类型的一些示例。 这些示例对应于无代码连接器平台的数据连接器参考中示例 auth 部分中使用的参数。 4 种类型中的每个类型都有 label、placeholder 以及 name。

"instructions": [
{
  "type": "Textbox",
  "parameters": {
      {
        "label": "User name",
        "placeholder": "User name",
        "type": "text",
        "name": "username"
      }
  }
},
{
  "type": "Textbox",
  "parameters": {
      "label": "Secret",
      "placeholder": "Secret",
      "type": "password",
      "name": "password"
  }
}
]

ConnectionToggleButton

"instructions": [
{
  "type": "ConnectionToggleButton",
  "parameters": {
    "connectLabel": "toggle",
    "name": "toggle"
  }          
}
]

CopyableLabel

例如：

示例代码：

{
    "parameters": {
        "fillWith": [
            "WorkspaceId",
            "PrimaryKey"
            ],
        "label": "Here are some values you'll need to proceed.",
        "value": "Workspace is {0} and PrimaryKey is {1}"
    },
    "type": "CopyableLabel"
}

InfoMessage

下面是内联信息消息的示例：

相比之下，下图显示了非内联信息消息：

InstructionStepsGroup

下面是可展开的指令组的示例：

有关详细示例，请参阅 Windows DNS 连接器的配置 JSON。

InstallAgent

某些 InstallAgent 类型显示为按钮，其他类型则显示为链接。 以下是这两者的示例：

示例数据连接器定义

以下示例将本文中定义的一些组件组合为 JSON 正文格式，以用于创建或更新数据连接器定义 API。

有关 connectorUiConfig 的更多示例，请查看其他 CCP 数据连接器示例。 即使是使用旧式 CCP 的连接器也具有 UI 创建的有效示例。

{
    "kind": "Customizable",
    "properties": {
        "connectorUiConfig": {
          "title": "Example CCP Data Connector",
          "publisher": "My Company",
          "descriptionMarkdown": "This is an example of data connector",
          "graphQueriesTableName": "ExampleConnectorAlerts_CL",
          "graphQueries": [
            {
              "metricName": "Alerts received",
              "legend": "My data connector alerts",
              "baseQuery": "{{graphQueriesTableName}}"
            },   
           {
              "metricName": "Events received",
              "legend": "My data connector events",
              "baseQuery": "ASIMFileEventLogs"
            }
          ],
            "sampleQueries": [
            {
                "description": "All alert logs",
                "query": "{{graphQueriesTableName}} \n | take 10"
            }
          ],
          "dataTypes": [
            {
              "name": "{{graphQueriesTableName}}",
              "lastDataReceivedQuery": "{{graphQueriesTableName}} \n | summarize Time = max(TimeGenerated)\n | where isnotempty(Time)"
            },
             {
              "name": "ASIMFileEventLogs",
              "lastDataReceivedQuery": "ASIMFileEventLogs \n | summarize Time = max(TimeGenerated)\n | where isnotempty(Time)"
             }
          ],
          "connectivityCriteria": [
            {
              "type": "HasDataConnectors"
            }
          ],
          "permissions": {
            "resourceProvider": [
              {
                "provider": "Microsoft.OperationalInsights/workspaces",
                "permissionsDisplayText": "Read and Write permissions are required.",
                "providerDisplayName": "Workspace",
                "scope": "Workspace",
                "requiredPermissions": {
                  "write": true,
                  "read": true,
                  "delete": true
                }
              },
            ],
            "customs": [
              {
                "name": "Example Connector API Key",
                "description": "The connector API key username and password is required"
              }
            ] 
        },
          "instructionSteps": [
            {
              "title": "Connect My Connector to Microsoft Sentinel",
              "description": "To enable the connector provide the required information below and click on Connect.\n>",
              "instructions": [
               {
                  "type": "Textbox",
                  "parameters": {
                    "label": "User name",
                    "placeholder": "User name",
                    "type": "text",
                    "name": "username"
                  }
                },
                {
                  "type": "Textbox",
                  "parameters": {
                    "label": "Secret",
                    "placeholder": "Secret",
                    "type": "password",
                    "name": "password"
                  }
                },
                {
                  "type": "ConnectionToggleButton",
                  "parameters": {
                    "connectLabel": "toggle",
                    "name": "toggle"
                  }
                }
              ]
            }
          ]
        }
    }
}