You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: articles/sentinel/connect-data-sources.md
+1-1Lines changed: 1 addition & 1 deletion
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -54,7 +54,7 @@ To add more data connectors, install the solution associated with the data conne
54
54
55
55
If you're unable to connect your data source to Microsoft Sentinel using any of the existing solutions available, consider creating your own data source connector. For example, many security solutions provide a set of APIs for retrieving log files and other security data from their product or service. Those APIs connect to Microsoft Sentinel with one of the following methods:
56
56
57
-
- The data source APIs are configured with the [Codeless Connector Platform](create-codeless-connector.md).
57
+
- The data source APIs are configured with the [Codeless Connector Framework](create-codeless-connector.md).
58
58
- The data connector uses the Log Ingestion API for Azure Monitor as part of an [Azure Function](connect-azure-functions-template.md) or [Logic App](create-custom-connector.md#connect-with-logic-apps).
59
59
60
60
You can also use Azure Monitor Agent directly or Logstash to create your custom connector. For more information, see [Resources for creating Microsoft Sentinel custom connectors](create-custom-connector.md).
Copy file name to clipboardExpand all lines: articles/sentinel/connect-google-cloud-platform.md
+1-1Lines changed: 1 addition & 1 deletion
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -16,7 +16,7 @@ Organizations are increasingly moving to multicloud architectures, whether by de
16
16
17
17
This article describes how to ingest GCP data into Microsoft Sentinel to get full security coverage and analyze and detect attacks in your multicloud environment.
18
18
19
-
With the **GCP Pub/Sub** connectors, based on our [Codeless Connector Platform (CCP)](create-codeless-connector.md?tabs=deploy-via-arm-template%2Cconnect-via-the-azure-portal), you can ingest logs from your GCP environment using the GCP [Pub/Sub capability](https://cloud.google.com/pubsub/docs/overview):
19
+
With the **GCP Pub/Sub** connectors, based on our [Codeless Connector Framework (CCF)](create-codeless-connector.md?tabs=deploy-via-arm-template%2Cconnect-via-the-azure-portal), you can ingest logs from your GCP environment using the GCP [Pub/Sub capability](https://cloud.google.com/pubsub/docs/overview):
20
20
21
21
- The **Google Cloud Platform (GCP) Pub/Sub Audit Logs connector** collects audit trails of access to GCP resources. Analysts can monitor these logs to track resource access attempts and detect potential threats across the GCP environment.
Copy file name to clipboardExpand all lines: articles/sentinel/create-codeless-connector.md
+21-21Lines changed: 21 additions & 21 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -1,6 +1,6 @@
1
1
---
2
2
title: Create a codeless connector for Microsoft Sentinel
3
-
description: Learn how to create a codeless connector in Microsoft Sentinel using the Codeless Connector Platform (CCP).
3
+
description: Learn how to create a codeless connector in Microsoft Sentinel using the Codeless Connector Framework (CCF).
4
4
author: austinmccollum
5
5
ms.author: austinmc
6
6
ms.topic: how-to
@@ -12,11 +12,11 @@ ms.date: 09/26/2024
12
12
---
13
13
# Create a codeless connector for Microsoft Sentinel
14
14
15
-
The Codeless Connector Platform (CCP) provides partners, advanced users, and developers the ability to create custom connectors for ingesting data to Microsoft Sentinel.
15
+
The Codeless Connector Framework (CCF) provides partners, advanced users, and developers the ability to create custom connectors for ingesting data to Microsoft Sentinel.
16
16
17
-
Connectors created using the CCP are fully SaaS, with no requirements for service installations. They also include [health monitoring](monitor-data-connector-health.md) and full support from Microsoft Sentinel.
17
+
Connectors created using the CCF are fully SaaS, with no requirements for service installations. They also include [health monitoring](monitor-data-connector-health.md) and full support from Microsoft Sentinel.
18
18
19
-
**Use the following steps to create your CCP connector and connect your data source to Microsoft Sentinel**
19
+
**Use the following steps to create your CCF connector and connect your data source to Microsoft Sentinel**
20
20
21
21
> [!div class="checklist"]
22
22
> * Build the data connector
@@ -26,9 +26,9 @@ Connectors created using the CCP are fully SaaS, with no requirements for servic
26
26
27
27
This article will show you how to complete each step and provide an [example codeless connector](#example) to build along the way.
28
28
29
-
## How is this CCP different from the previous version?
29
+
## How is this CCF different from the previous version?
30
30
31
-
The initial version of the CCP was [announced](https://techcommunity.microsoft.com/t5/microsoft-sentinel-blog/the-codeless-connector-platform/ba-p/3095455) in January of 2022. Since then, we've improved upon the platform and the [legacy release](create-codeless-connector-legacy.md) is no longer recommended. This new version of the CCP has the following key improvements:
31
+
The initial version of the CCF was [announced](https://techcommunity.microsoft.com/t5/microsoft-sentinel-blog/the-codeless-connector-platform/ba-p/3095455) in January of 2022. Since then, we've improved upon the platform and the [legacy release](create-codeless-connector-legacy.md) is no longer recommended. This new version of the CCF has the following key improvements:
32
32
33
33
1. Better support for various authentication and pagination types.
34
34
@@ -75,7 +75,7 @@ We recommend testing your components with an API testing tool like one of the fo
75
75
76
76
## Build the data connector
77
77
78
-
There are four components required to build the CCP data connector.
78
+
There are four components required to build the CCF data connector.
@@ -131,7 +131,7 @@ To learn from an example, see the [Data connector definitions reference example
131
131
132
132
### Data connection rules
133
133
134
-
There are currently two kinds of data connection rules possible for defining your CCP data connector.
134
+
There are currently two kinds of data connection rules possible for defining your CCF data connector.
135
135
136
136
-`RestApiPoller` kind allows you to customize paging, authorization and expected request/response payloads for your data source. For more information, see [RestApiPoller data connector connection rules reference](data-connector-connection-rules-reference.md).
137
137
-`GCP` kind allows you to decrease your development time by automatically configuring paging and expected response payloads for your Google Cloud Platform (GCP) data source. For more information, see [GCP data connector connection rules reference](data-connection-rules-reference-gcp.md)
@@ -140,7 +140,7 @@ Use an [API testing tool](#testing-apis) to call the data connector API to creat
140
140
141
141
## Secure confidential input
142
142
143
-
Whatever authentication is used by your CCP data connector, take these steps to ensure confidential information is kept secure. The goal is to pass along credentials from the ARM template to the CCP without leaving readable confidential objects in your deployments history.
143
+
Whatever authentication is used by your CCF data connector, take these steps to ensure confidential information is kept secure. The goal is to pass along credentials from the ARM template to the CCF without leaving readable confidential objects in your deployments history.
144
144
145
145
### Create label
146
146
@@ -218,19 +218,19 @@ Finally, the CCP utilizes the credential objects in the data connector section.
218
218
219
219
Manually package an Azure Resource Management (ARM) template using the [example template code samples](#example-arm-template) as your guide. These code samples are divided by ARM template sections which you must splice together.
220
220
221
-
If you're creating a Google Cloud Platform (GCP) CCP data connector, package the deployment template using the [example GCP CCP template](https://github.com/Azure/Azure-Sentinel/blob/master/DataConnectors/Templates/Connector_GCP_CCP_template.json). For information on how to fill out the GCP CCP template, see [GCP data connector connection rules reference](data-connection-rules-reference-gcp.md).
221
+
If you're creating a Google Cloud Platform (GCP) CCF data connector, package the deployment template using the [example GCP CCF template](https://github.com/Azure/Azure-Sentinel/blob/master/DataConnectors/Templates/Connector_GCP_CCP_template.json). For information on how to fill out the GCP CCF template, see [GCP data connector connection rules reference](data-connection-rules-reference-gcp.md).
222
222
223
-
In addition to the example templates, published solutions available in the Microsoft Sentinel content hub use the CCP for their data connectors. Review the following solutions as more examples of how to stitch the components together into an ARM template.
223
+
In addition to the example templates, published solutions available in the Microsoft Sentinel content hub use the CCF for their data connectors. Review the following solutions as more examples of how to stitch the components together into an ARM template.
- [Okta Single Sign-On](https://github.com/Azure/Azure-Sentinel/tree/master/Solutions/Okta%20Single%20Sign-On/Data%20Connectors/OktaNativePollerConnectorV2)
@@ -246,9 +246,9 @@ Deploy your codeless connector as a custom template.
246
246
247
247
### Maintain network isolation for logging source
248
248
249
-
If your logging source requires network isolation, configure an allowlist of public IP addresses used by the CCP.
249
+
If your logging source requires network isolation, configure an allowlist of public IP addresses used by the CCF.
250
250
251
-
Azure virtual networks use service tags to define network access controls. For the CCP, that service tag is [**Scuba**](/azure/virtual-network/service-tags-overview#available-service-tags).
251
+
Azure virtual networks use service tags to define network access controls. For the CCF, that service tag is [**Scuba**](/azure/virtual-network/service-tags-overview#available-service-tags).
252
252
253
253
To find the current IP range associated with the **Scuba** service tag, see [Use the Service Tag Discovery API](/azure/virtual-network/service-tags-overview#use-the-service-tag-discovery-api).
254
254
@@ -268,10 +268,10 @@ Each step in building the codeless connector is represented in the following exa
268
268
- [Example custom table](#example-custom-table)
269
269
- [Example data collection rule](#example-data-collection-rule)
270
270
- [Example data connector UI definition](data-connector-ui-definitions-reference.md#example-data-connector-definition)
271
-
- [Example data connection rules](data-connector-connection-rules-reference.md#example-ccp-data-connector)
271
+
- [Example data connection rules](data-connector-connection-rules-reference.md#example-ccf-data-connector)
272
272
- [Use example data with example template](#example-arm-template)
273
273
274
-
To demonstrate a complex data source with ingestion to more than one table, this example features an output table schema and a DCR with multiple output streams. The DCR example puts these together along with its KQL transforms. The data connector UI definition and connection rules examples continue from this same example data source. Finally, the solution template uses all these example components to show end to end how to create the example CCP data connector.
274
+
To demonstrate a complex data source with ingestion to more than one table, this example features an output table schema and a DCR with multiple output streams. The DCR example puts these together along with its KQL transforms. The data connector UI definition and connection rules examples continue from this same example data source. Finally, the solution template uses all these example components to show end to end how to create the example CCF data connector.
275
275
276
276
### Example data
277
277
@@ -451,11 +451,11 @@ This example is located in the [Data connector definitions reference](data-conne
451
451
452
452
### Example data connector connection rules
453
453
454
-
This example is located in the [Data connectors reference](data-connector-connection-rules-reference.md#example-ccp-data-connector).
454
+
This example is located in the [Data connectors reference](data-connector-connection-rules-reference.md#example-ccf-data-connector).
455
455
456
456
### Example ARM template
457
457
458
-
Build the ARM deployment template with the following structure, which includes the 4 sections of JSON components required to build the CCP data connector:
458
+
Build the ARM deployment template with the following structure, which includes the 4 sections of JSON components required to build the CCF data connector:
459
459
460
460
```json
461
461
{
@@ -554,7 +554,7 @@ These recommended variables help simplify the template. Use more or less as need
554
554
```
555
555
#### Example ARM template - resources
556
556
557
-
There are 5 ARM deployment resources in this template guide which house the 4 CCP data connector building components.
557
+
There are 5 ARM deployment resources in this template guide which house the 4 CCF data connector building components.
| **[Codeless Connector Platform (CCP)](#connect-with-the-codeless-connector-platform)** <br>Best for less technical audiences to create SaaS connectors using a configuration file instead of advanced development. | Supports all capabilities available with the code. | Yes | Low; simple, codeless development
26
+
| **[Codeless Connector Framework (CCF)](#connect-with-the-codeless-connector-framework)** <br>Best for less technical audiences to create SaaS connectors using a configuration file instead of advanced development. | Supports all capabilities available with the code. | Yes | Low; simple, codeless development
27
27
|**[Azure Monitor Agent](#connect-with-the-azure-monitor-agent)** <br>Best for collecting files from on-premises and IaaS sources | File collection, data transformation | No | Low |
28
28
|**[Logstash](#connect-with-logstash)** <br>Best for on-premises and IaaS sources, any source for which a plugin is available, and organizations already familiar with Logstash | Supports all capabilities of the Azure Monitor Agent | No; requires a VM or VM cluster to run | Low; supports many scenarios with plugins |
29
29
|**[Logic Apps](#connect-with-logic-apps)** <br>High cost; avoid for high-volume data <br>Best for low-volume cloud sources | Codeless programming allows for limited flexibility, without support for implementing algorithms.<br><br> If no available action already supports your requirements, creating a custom action may add complexity. | Yes | Low; simple, codeless development |
@@ -38,11 +38,11 @@ The following table compares essential details about each method for creating cu
The Codeless Connector Platform (CCP) provides a configuration file that can be used by both customers and partners, and then deployed to your own workspace, or as a solution to Microsoft Sentinel's content hub.
43
+
The Codeless Connector Framework (CCF) provides a configuration file that can be used by both customers and partners, and then deployed to your own workspace, or as a solution to Microsoft Sentinel's content hub.
44
44
45
-
Connectors created using the CCP are fully SaaS, without any requirements for service installations, and also include health monitoring and full support from Microsoft Sentinel.
45
+
Connectors created using the CCF are fully SaaS, without any requirements for service installations, and also include health monitoring and full support from Microsoft Sentinel.
46
46
47
47
For more information, see [Create a codeless connector for Microsoft Sentinel](create-codeless-connector.md).
0 commit comments