Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
Original file line number Diff line number Diff line change
@@ -0,0 +1,29 @@
# Connector Configurations

Below is an exhaustive enumeration of all configurable parameters available, each accompanied by detailed explanations of their purposes, default behaviors, and usage guidelines to help you understand and utilize them effectively.

### Type: `object`

| Property | Type | Required | Possible values | Deprecated | Default | Description |
| -------- | ---- | -------- | --------------- | ---------- | ------- | ----------- |
| OPENCTI_URL | `string` | ✅ | Format: [`uri`](https://json-schema.org/understanding-json-schema/reference/string#built-in-formats) | | | The base URL of the OpenCTI instance. |
| OPENCTI_TOKEN | `string` | ✅ | string | | | The API token to connect to OpenCTI. |
| CONNECTOR_LIVE_STREAM_ID | `string` | ✅ | string | | | The ID of the live stream to connect to. |
| MICROSOFT_SENTINEL_INTEL_TENANT_ID | `string` | ✅ | string | | | Your Azure App Tenant ID, see the screenshot to help you find this information. |
| MICROSOFT_SENTINEL_INTEL_CLIENT_ID | `string` | ✅ | string | | | Your Azure App Client ID, see the screenshot to help you find this information. |
| MICROSOFT_SENTINEL_INTEL_CLIENT_SECRET | `string` | ✅ | Format: [`password`](https://json-schema.org/understanding-json-schema/reference/string#built-in-formats) | | | Your Azure App Client secret, See the screenshot to help you find this information. |
| MICROSOFT_SENTINEL_INTEL_WORKSPACE_ID | `string` | ✅ | string | | | Your Azure Workspace ID |
| MICROSOFT_SENTINEL_INTEL_WORKSPACE_NAME | `string` | ✅ | string | | | The name of the log analytics workspace |
| MICROSOFT_SENTINEL_INTEL_SUBSCRIPTION_ID | `string` | ✅ | string | | | The subscription id where the Log Analytics is |
| CONNECTOR_NAME | `string` | | string | | `"MicrosoftSentinelIntel"` | The name of the connector. |
| CONNECTOR_SCOPE | `array` | | string | | `["sentinel"]` | The scope of the stream connector. |
| CONNECTOR_LOG_LEVEL | `string` | | `debug` `info` `warn` `warning` `error` | | `"error"` | The minimum level of logs to display. |
| CONNECTOR_TYPE | `const` | | `STREAM` | | `"STREAM"` | |
| CONNECTOR_LIVE_STREAM_LISTEN_DELETE | `boolean` | | boolean | | `true` | Whether to listen for delete events on the live stream. |
| CONNECTOR_LIVE_STREAM_NO_DEPENDENCIES | `boolean` | | boolean | | `true` | Whether to ignore dependencies when processing events from the live stream. |
| MICROSOFT_SENTINEL_INTEL_SOURCE_SYSTEM | `string` | | string | | `"Opencti Stream Connector"` | The name of the source system displayed in Microsoft Sentinel |
| MICROSOFT_SENTINEL_INTEL_DELETE_EXTENSIONS | `boolean` | | boolean | | `true` | Delete the extensions in the stix bundle sent to the SIEM |
| MICROSOFT_SENTINEL_INTEL_EXTRA_LABELS | `array` | | string | | `[]` | Extra labels added to the bundle sent. String separated by comma |
| MICROSOFT_SENTINEL_INTEL_WORKSPACE_API_VERSION | `string` | | string | | `"2024-02-01-preview"` | API version of the Microsoft log analytics workspace interface |
| MICROSOFT_SENTINEL_INTEL_MANAGEMENT_API_VERSION | `string` | | string | | `"2025-03-01"` | API version of the Microsoft management interface |
| MICROSOFT_SENTINEL_INTEL_RESOURCE_GROUP | `string` | | string | ⛔️ | `"default"` | The name of the resource group where the log analytics is |
Original file line number Diff line number Diff line change
@@ -0,0 +1,136 @@
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://www.filigran.io/connectors/microsoft-sentinel-intel_config.schema.json",
"type": "object",
"properties": {
"OPENCTI_URL": {
"description": "The base URL of the OpenCTI instance.",
"format": "uri",
"maxLength": 2083,
"minLength": 1,
"type": "string"
},
"OPENCTI_TOKEN": {
"description": "The API token to connect to OpenCTI.",
"type": "string"
},
"CONNECTOR_NAME": {
"default": "MicrosoftSentinelIntel",
"description": "The name of the connector.",
"type": "string"
},
"CONNECTOR_SCOPE": {
"default": [
"sentinel"
],
"description": "The scope of the stream connector.",
"items": {
"type": "string"
},
"type": "array"
},
"CONNECTOR_LOG_LEVEL": {
"default": "error",
"description": "The minimum level of logs to display.",
"enum": [
"debug",
"info",
"warn",
"warning",
"error"
],
"type": "string"
},
"CONNECTOR_TYPE": {
"const": "STREAM",
"default": "STREAM",
"type": "string"
},
"CONNECTOR_LIVE_STREAM_ID": {
"description": "The ID of the live stream to connect to.",
"type": "string"
},
"CONNECTOR_LIVE_STREAM_LISTEN_DELETE": {
"default": true,
"description": "Whether to listen for delete events on the live stream.",
"type": "boolean"
},
"CONNECTOR_LIVE_STREAM_NO_DEPENDENCIES": {
"default": true,
"description": "Whether to ignore dependencies when processing events from the live stream.",
"type": "boolean"
},
"MICROSOFT_SENTINEL_INTEL_TENANT_ID": {
"description": "Your Azure App Tenant ID, see the screenshot to help you find this information.",
"type": "string"
},
"MICROSOFT_SENTINEL_INTEL_CLIENT_ID": {
"description": "Your Azure App Client ID, see the screenshot to help you find this information.",
"type": "string"
},
"MICROSOFT_SENTINEL_INTEL_CLIENT_SECRET": {
"description": "Your Azure App Client secret, See the screenshot to help you find this information.",
"format": "password",
"type": "string",
"writeOnly": true
},
"MICROSOFT_SENTINEL_INTEL_WORKSPACE_ID": {
"description": "Your Azure Workspace ID",
"type": "string"
},
"MICROSOFT_SENTINEL_INTEL_WORKSPACE_NAME": {
"description": "The name of the log analytics workspace",
"type": "string"
},
"MICROSOFT_SENTINEL_INTEL_SUBSCRIPTION_ID": {
"description": "The subscription id where the Log Analytics is",
"type": "string"
},
"MICROSOFT_SENTINEL_INTEL_RESOURCE_GROUP": {
"default": "default",
"deprecated": true,
"description": "The name of the resource group where the log analytics is",
"type": "string"
},
"MICROSOFT_SENTINEL_INTEL_SOURCE_SYSTEM": {
"default": "Opencti Stream Connector",
"description": "The name of the source system displayed in Microsoft Sentinel",
"type": "string"
},
"MICROSOFT_SENTINEL_INTEL_DELETE_EXTENSIONS": {
"default": true,
"description": "Delete the extensions in the stix bundle sent to the SIEM",
"type": "boolean"
},
"MICROSOFT_SENTINEL_INTEL_EXTRA_LABELS": {
"default": [],
"description": "Extra labels added to the bundle sent. String separated by comma",
"items": {
"type": "string"
},
"type": "array"
},
"MICROSOFT_SENTINEL_INTEL_WORKSPACE_API_VERSION": {
"default": "2024-02-01-preview",
"description": "API version of the Microsoft log analytics workspace interface",
"type": "string"
},
"MICROSOFT_SENTINEL_INTEL_MANAGEMENT_API_VERSION": {
"default": "2025-03-01",
"description": "API version of the Microsoft management interface",
"type": "string"
}
},
"required": [
"OPENCTI_URL",
"OPENCTI_TOKEN",
"CONNECTOR_LIVE_STREAM_ID",
"MICROSOFT_SENTINEL_INTEL_TENANT_ID",
"MICROSOFT_SENTINEL_INTEL_CLIENT_ID",
"MICROSOFT_SENTINEL_INTEL_CLIENT_SECRET",
"MICROSOFT_SENTINEL_INTEL_WORKSPACE_ID",
"MICROSOFT_SENTINEL_INTEL_WORKSPACE_NAME",
"MICROSOFT_SENTINEL_INTEL_SUBSCRIPTION_ID"
],
"additionalProperties": true
}

This file was deleted.

170 changes: 0 additions & 170 deletions stream/microsoft-sentinel-intel/src/base_connector/config.py

This file was deleted.

9 changes: 0 additions & 9 deletions stream/microsoft-sentinel-intel/src/base_connector/enums.py

This file was deleted.

14 changes: 0 additions & 14 deletions stream/microsoft-sentinel-intel/src/base_connector/errors.py

This file was deleted.

10 changes: 5 additions & 5 deletions stream/microsoft-sentinel-intel/src/config.yml.sample
Original file line number Diff line number Diff line change
Expand Up @@ -5,12 +5,12 @@ opencti:
connector:
type: 'STREAM'
id: 'ChangeMe'
name: 'Microsoft Sentinel Intel'
scope: 'sentinel' # MIME type or SCO
log_level: 'info'
live_stream_id: 'ChangeMe'
live_stream_listen_delete: true
live_stream_no_dependencies: true
#name: 'Microsoft Sentinel Intel'
#scope: 'sentinel' # MIME type or SCO
#log_level: 'info'
#live_stream_listen_delete: true
#live_stream_no_dependencies: true

microsoft_sentinel_intel:
tenant_id: 'ChangeMe'
Expand Down
Loading