Global List Site Mapping

LAST UPDATED: FEB 12, 2025

Global list site mapping is a feature that ensures that events are automatically created in the correct client site based on a unique identifier within the incoming raw ingestion data. This ensures proper site-level segregation, making events accessible only within their assigned site.

To enable this mapping, the integration connection must be configured with the Site field set to Shared to Client Sites.

Impact of Connection Site Configuration on Global List Site Mapping

Frame 1 (47)-20250211-223520.png — **Site Configuration: (a) Shared to Internal Sites (b) Shared to Client Sites**

Frame 2 (50)-20250211-224711.png — **Connection Site: Shared to Internal Sites | Global List for Site Mapping:** ABSENT

Frame 5 (31)-20250212-034204.png — **Connection Site: Shared to Client Sites | Global List for Site Mapping:** PRESENT

Before setting up global list site mapping, MSSPs must coordinate with their clients to identify the field in the incoming ingestion data that will provide the unique identifier for site mapping. Consider the following as the expected incoming ingestion data:

SAMPLE DATA

JSON

{
    "demoField1": "value1",
    "demoField2": "value2",
    "demoField3": {
        "demoField3A": "value3A",
        "demoField3B": {
            "keyToTheUniqueIdentifier": "uniqueIdentifier"
        }
    },
    "demoField4": [
        "value4A",
        "value4B",
        "value4C"
    ],
    "demoField5": "value5"
}

The D3 system will extract the (line 7) value of keyToTheUniqueIdentifier (uniqueIdentifier) and match it against a key in a selected global list to determine the correct client site for event creation.

Frame 4 (43)-20250212-024130.png — **Demo Global List – A Global List Containing Site Mappings**

If a match is found (i.e., uniqueIdentifier), the corresponding value (demo-site) will be used to determine the site where the event will be stored.
If no match is found, the event will be assigned to the Unknown Client Site.

Ensuring Correct Site Mapping in Global List

NOTICE

D3 currently does not support moving events between sites once they have been created. Users are advised to double-check that the unique identifier extracted from the incoming data has a corresponding key in the global list and that it maps to an existing client site.

Frame 6 (38)-20250212-190143.png — **Verifying Global List Values Against Existing Sites**

Once the unique identifier has been defined and communicated to clients, and a corresponding global list has been established, users can proceed with configuring data ingestion. Two pieces of information are needed before completing ingestion setup:

The JSON path to locate the unique identifier key ($.demoField3.demoField3B.keyToTheUniqueIdentifier for the sample data above )
The name of the global list storing the site mappings (Demo Global List)

Ingestions and Results

Webhook Push

Navigate to the Data Ingestion module.
Add a new webhook ingestion.
Select the integration with the pre-configured Shared to Client Sites connection, specify the site as Shared to All Client Sites, choose the authentication method (API Key for this demonstration), and generate an API key if one does not already exist.
Select Shared to All Client Sites from the dropdown.
Copy the POST request URL from vSOC and paste it into Postman.
Copy the request header key and value from vSOC and paste them into Postman.
Input the JSON path to locate the unique identifier key, then select the global list for site mapping.
1. JSON path: $.demoField3.demoField3B.keyToTheUniqueIdentifier
2. Global list: Demo Global List

Copy and paste the following code into Postman, then click on the Send button.

CODE

{
    "demoField1": "value1",
    "demoField2": "value2",
    "demoField3": {
        "demoField3A": "value3A",
        "demoField3B": {
            "keyToTheUniqueIdentifier": "uniqueIdentifier"
        }
    },
    "demoField4": [
        "value4A",
        "value4B",
        "value4C"
    ],
    "demoField5": "value5"
}

Navigate back to the Data Ingestion module, verify event creation and note the eventId.
Event 4312516 Created
Navigate to the Investigation Dashboard to find the event.
Unmatching Sites from Demo Global List Will Not Have Access to Event 4312516
Only demo-site Will Contain Event 4312516

Scheduled Pull

Copy and paste the following Python code into a custom Fetch Event command:

PY

def fetchEvent(startTime, endTime, TopN, SearchCon):
    
    eventData = {
        "id": str(uuid.uuid4()),  # Generate a unique ID for the event
        "demoField1": "value1",
        "demoField2": "value2",
        "demoField3": {
            "demoField3A": "value3A",
            "demoField3B": {
                "keyToTheUniqueIdentifier": "uniqueIdentifier"
            }
        },
        "demoField4": [
            "value4A",
            "value4B",
            "value4C"
        ],
        "demoField5": "value5"
    }

    return pb.returnOutputModel(eventData, eventData, None, eventData, eventData, None)

Add a connection with the Site field set to Shared to Client Sites.
Test the command and verify that the output contains the intended structure.
Submit the command.
Set up a new schedule.
JSON Path for Site: $.demoField3.demoField3B.keyToTheUniqueIdentifier
Global list for Site Mapping: Demo Global List
Navigate to the Data Ingestion module, verify event creation and note the eventId.
Event 4312749 Created
Navigate to the Investigation Dashboard to find the event.
Unmatching Sites from Demo Global List Will Not Have Access to Event 4312749
Only demo-site Will Contain Event 4312749