Work/tw/datto rmm

.github/CODEOWNERS

@@ -4,6 +4,7 @@
 /.github/*           @squaredup/community-moderators
 
 # Request review from original author
+plugins/DattoRMM/*  @TimWheeler-SQUP
 plugins/DigiCert/*  @shaswot77
 plugins/FantasyPremierLeague/*  @TimWheeler-SQUP
 plugins/GoogleSheets/*  @kieranlangton

cspell.json

@@ -1,5 +1,6 @@
 {
     "words": [
+        "Datto",
         "Phare",
         "rdap",
         "whois",

plugins/DattoRMM/v1/cspell.json

@@ -0,0 +1,7 @@
+{
+    "words": [
+        "Datto",
+        "RMM",
+        "centrastage"
+    ]
+}

plugins/DattoRMM/v1/custom_types.json

@@ -0,0 +1,16 @@
+[
+    {
+        "icon": "building",
+        "name": "Datto Site",
+        "plural": "Sites",
+        "singular": "Site",
+        "sourceType": "Datto Site"
+    },
+    {
+        "icon": "desktop",
+        "name": "Datto Device",
+        "plural": "Devices",
+        "singular": "Device",
+        "sourceType": "Datto Device"
+    }
+]

plugins/DattoRMM/v1/dataStreams/dattoAllDevices.json

@@ -0,0 +1,132 @@
+{
+    "name": "dattoAllDevices",
+    "displayName": "Devices",
+    "description": "All devices across all sites",
+    "tags": ["Devices"],
+    "baseDataSourceName": "httpRequestUnscoped",
+    "config": {
+        "httpMethod": "get",
+        "paging": {
+            "mode": "nextUrl",
+            "pageSize": {
+                "realm": {
+                    "value": "none",
+                    "label": "none"
+                }
+            },
+            "in": {
+                "realm": {
+                    "value": "payload",
+                    "label": "payload"
+                },
+                "path": "pageDetails.nextPageUrl"
+            }
+        },
+        "expandInnerObjects": true,
+        "endpointPath": "api/v2/account/devices",
+        "pathToData": "devices",
+        "getArgs": [],
+        "headers": []
+    },
+    "metadata": [
+        {
+            "shape": "string",
+            "name": "uid",
+            "visible": false
+        },
+        {
+            "shape": "string",
+            "name": "id",
+            "visible": false
+        },
+        {
+            "shape": "string",
+            "name": "siteUid",
+            "visible": false
+        },
+        {
+            "shape": "string",
+            "name": "siteId",
+            "visible": false
+        },
+        {
+            "displayName": "Hostname",
+            "shape": "string",
+            "name": "hostname"
+        },
+        {
+            "displayName": "Site",
+            "shape": "string",
+            "name": "siteName"
+        },
+        {
+            "displayName": "Device Class",
+            "shape": "string",
+            "name": "deviceClass"
+        },
+        {
+            "displayName": "Operating System",
+            "shape": "string",
+            "name": "operatingSystem"
+        },
+        {
+            "displayName": "Online Status",
+            "shape": "string",
+            "name": "onlineStatus"
+        },
+        {
+            "displayName": "Last Seen",
+            "shape": "date",
+            "name": "lastSeen"
+        },
+        {
+            "displayName": "Creation Date",
+            "shape": ["date", { "timeZone": "Etc/UTC" }],
+            "name": "creationDate"
+        },
+        {
+            "displayName": "Last Audit Date",
+            "shape": ["date", { "timeZone": "Etc/UTC" }],
+            "name": "lastAuditDate"
+        },
+        {
+            "displayName": "Patches Approved Pending",
+            "shape": ["number", { "decimalPlaces": 0 }],
+            "name": "patchManagement.patchesApprovedPending"
+        },
+        {
+            "displayName": "Patches Installed",
+            "shape": ["number", { "decimalPlaces": 0 }],
+            "name": "patchManagement.patchesInstalled"
+        },
+        {
+            "displayName": "Patches Not Approved",
+            "shape": ["number", { "decimalPlaces": 0 }],
+            "name": "patchManagement.patchesNotApproved"
+        },
+        {
+            "displayName": "Compliance State",
+            "name": "softwareComplianceState",
+            "computed": true,
+            "valueExpression": "{{ $['softwareStatus'] }}",
+            "shape": ["state", {
+                "map": {
+                    "success": ["Compliant"],
+                    "error": ["Not Compliant"],
+                    "warning": [],
+                    "unknown": [],
+                    "unmonitored": []
+                }
+            }]
+        },
+        {
+            "pattern": "udf.*",
+            "visible": false
+        },
+        {
+            "pattern": ".*"
+        }
+    ],
+    "providesPluginDiagnostics": true,
+    "timeframes": false
+}

plugins/DattoRMM/v1/dataStreams/dattoScopeClosedAlerts.json

@@ -0,0 +1,88 @@
+{
+    "name": "dattoScopeClosedAlerts",
+    "displayName": "Closed Alerts",
+    "description": "Resolved alerts for a specific site",
+    "tags": ["Alerts"],
+    "baseDataSourceName": "httpRequestScopedSingle",
+    "matches": {
+        "sourceType": {
+            "type": "equals",
+            "value": "Datto Site"
+        }
+    },
+    "config": {
+        "httpMethod": "get",
+        "paging": {
+            "mode": "nextUrl",
+            "pageSize": {
+                "realm": { "value": "none", "label": "none" }
+            },
+            "in": {
+                "realm": { "value": "payload", "label": "payload" },
+                "path": "pageDetails.nextPageUrl"
+            }
+        },
+        "expandInnerObjects": true,
+        "endpointPath": "api/v2/site/{{objects[0].siteUid}}/alerts/resolved",
+        "pathToData": "alerts",
+        "getArgs": [],
+        "headers": []
+    },
+    "metadata": [
+        {
+            "shape": "string",
+            "name": "uid",
+            "visible": false
+        },
+        {
+            "name": "sourceId",
+            "displayName": "Object ID",
+            "shape": "string",
+            "visible": false
+        },
+        {
+            "displayName": "Alert Message",
+            "shape": "string",
+            "name": "alertSourceInfo.alertMessage"
+        },
+        {
+            "displayName": "Alert Type",
+            "shape": "string",
+            "name": "alertSourceInfo.alertTypeDescription"
+        },
+        {
+            "displayName": "Device",
+            "shape": "string",
+            "name": "alertSourceInfo.alertContext.hostname"
+        },
+        {
+            "shape": "string",
+            "name": "alertSourceInfo.alertContext.deviceUid",
+            "visible": false
+        },
+        {
+            "shape": "string",
+            "name": "alertSourceInfo.alertContext.siteUid",
+            "visible": false
+        },
+        {
+            "displayName": "Priority",
+            "shape": "string",
+            "name": "priority"
+        },
+        {
+            "displayName": "Raised",
+            "shape": ["date", { "timeZone": "Etc/UTC" }],
+            "name": "timestamp"
+        },
+        {
+            "displayName": "Resolved",
+            "shape": ["date", { "timeZone": "Etc/UTC" }],
+            "name": "resolvedOn"
+        },
+        {
+            "pattern": ".*"
+        }
+    ],
+    "timeframes": false
+}

plugins/DattoRMM/v1/dataStreams/dattoScopeOpenAlerts.json

@@ -0,0 +1,84 @@
+{
+    "name": "dattoScopeOpenAlerts",
+    "displayName": "Open Alerts",
+    "description": "Open alerts for a specific site",
+    "tags": ["Alerts"],
+    "baseDataSourceName": "httpRequestScopedSingle",
+    "matches": {
+        "sourceType": {
+            "type": "equals",
+            "value": "Datto Site"
+        }
+    },
+    "config": {
+        "httpMethod": "get",
+        "paging": {
+            "mode": "nextUrl",
+            "pageSize": {
+                "realm": { "value": "none", "label": "none" }
+            },
+            "in": {
+                "realm": { "value": "payload", "label": "payload" },
+                "path": "pageDetails.nextPageUrl"
+            }
+        },
+        "expandInnerObjects": true,
+        "endpointPath": "api/v2/site/{{objects[0].siteUid}}/alerts/open",
+        "pathToData": "alerts",
+        "getArgs": [],
+        "headers": []
+    },
+    "metadata": [
+        {
+            "shape": "string",
+            "name": "uid",
+            "visible": false
+        },
+        {
+            "name": "sourceId",
+            "displayName": "Object ID",
+            "shape": "string",
+            "visible": false
+        },
+        {
+            "displayName": "Alert Message",
+            "shape": "string",
+            "name": "alertSourceInfo.alertMessage"
+        },
+        {
+            "displayName": "Alert Type",
+            "shape": "string",
+            "name": "alertSourceInfo.alertTypeDescription"
+        },
+        {
+            "displayName": "Device",
+            "shape": "string",
+            "name": "alertSourceInfo.alertContext.hostname"
+        },
+        {
+            "shape": "string",
+            "name": "alertSourceInfo.alertContext.deviceUid",
+            "visible": false
+        },
+        {
+            "shape": "string",
+            "name": "alertSourceInfo.alertContext.siteUid",
+            "visible": false
+        },
+        {
+            "displayName": "Priority",
+            "shape": "string",
+            "name": "priority"
+        },
+        {
+            "displayName": "Timestamp",
+            "shape": ["date", { "timeZone": "Etc/UTC" }],
+            "name": "timestamp"
+        },
+        {
+            "pattern": ".*"
+        }
+    ],
+    "providesPluginDiagnostics": true,
+    "timeframes": false
+}