@joshuanode/n8n-nodes-cipp 0.0.1

package/README.md

@@ -0,0 +1,142 @@
+# n8n-nodes-cipp
+
+[![npm version](https://badge.fury.io/js/%40joshuanode%2Fn8n-nodes-cipp.svg)](https://www.npmjs.com/package/@joshuanode/n8n-nodes-cipp)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+
+n8n community node for [CIPP.app](https://cipp.app) - Comprehensive Microsoft 365 multi-tenant management.
+
+![CIPP Node](https://img.shields.io/badge/n8n-Community%20Node-ff6d5a)
+![Beta](https://img.shields.io/badge/Status-Beta-orange)
+
+> ⚠️ **Beta Notice**: This node is currently in beta and may not be fully functional yet. Some operations may be incomplete or require adjustments. Use in production at your own risk.
+>
+> 🤝 **Contributions Welcome!** We welcome bug reports, feature requests, and pull requests. If you encounter issues or have improvements, please open an issue or PR on GitHub.
+
+## Features
+
+This node provides full integration with the CIPP API, enabling automation of:
+
+- **Identity Management** - Users, groups, MFA, devices
+- **Tenant Administration** - Alerts, licenses, standards
+- **Intune** - Applications, Autopilot, device actions
+- **Teams & SharePoint** - Teams, sites, voice numbers
+- **Security & Compliance** - Defender alerts, incidents
+- **Tools** - Breach search, Graph API requests
+- **CIPP System** - Scheduled jobs, backups
+
+## Installation
+
+### n8n (Self-hosted)
+
+```bash
+npm install @joshuanode/n8n-nodes-cipp
+```
+
+Or add to your n8n Docker container:
+
+```bash
+# In your Dockerfile
+RUN npm install -g @joshuanode/n8n-nodes-cipp
+```
+
+### n8n Cloud
+
+Community nodes can be installed via **Settings → Community Nodes → Install**.
+
+## Credentials Setup
+
+1. **Create an Azure AD App Registration** for CIPP API access
+2. Configure the following in n8n:
+   - **CIPP Instance URL**: Your CIPP deployment URL (e.g., `https://cipp.yourdomain.com`)
+   - **Azure AD Tenant ID**: The tenant where your CIPP app registration lives
+   - **Application (Client) ID**: From your Azure AD app registration
+   - **Client Secret**: Generated from your app registration
+
+For detailed authentication setup, see the [CIPP API Documentation](https://docs.cipp.app/api-documentation/setup-and-authentication).
+
+## Resources & Operations
+
+| Resource           | Operations                                                                                                                                          |
+| ------------------ | --------------------------------------------------------------------------------------------------------------------------------------------------- |
+| **Tenant**         | Get Many, Clear Cache                                                                                                                               |
+| **User**           | Add, Disable, Enable, Reset Password, Reset MFA, Revoke Sessions, Remove, Create TAP, Set Per-User MFA, Send MFA Push, Clear Immutable ID, Offboard |
+| **Group**          | Add, Edit Members, Delete, Hide from GAL, Set Delivery Management, Get Many                                                                         |
+| **Device**         | Get Many, Manage, Execute Action, Get Recovery Key, Get LAPS Password                                                                               |
+| **Autopilot**      | Get Many, Assign, Remove, Sync, Get Configurations                                                                                                  |
+| **Mailbox**        | Convert, Enable Archive, Set Out of Office, Set Email Forwarding                                                                                    |
+| **Alert**          | Add, Get Many, Get Security Alerts, Get Security Incidents, Set Alert Status, Set Incident Status                                                   |
+| **Application**    | Get Many, Assign, Remove, Add WinGet/Store/Chocolatey/MSP/Office Apps                                                                               |
+| **Team**           | Add, Get Many, Get Sites, Get Activity, Manage Site Members/Permissions                                                                             |
+| **Voice**          | Get Phone Numbers, Get Locations, Assign/Unassign Numbers                                                                                           |
+| **Scheduled Item** | Add, Get Many, Remove                                                                                                                               |
+| **Backup**         | Get Many, Run, Restore, Set Auto-Backup                                                                                                             |
+| **Tools**          | Breach Search (Account/Tenant), Graph Request                                                                                                       |
+
+## Example Usage
+
+### List All Tenants
+
+```
+Resource: Tenant
+Operation: Get Many
+Return All: true
+```
+
+### Create a New User
+
+```
+Resource: User
+Operation: Add
+Tenant: Select from dropdown
+First Name: John
+Last Name: Doe
+Domain: contoso.com
+```
+
+### Execute Device Action
+
+```
+Resource: Device
+Operation: Execute Action
+Tenant: Select from dropdown
+Device ID: <device-guid>
+Action: SyncDevice
+```
+
+### Custom Graph Request
+
+```
+Resource: Tools
+Operation: Graph Request
+Tenant: Select from dropdown
+Endpoint: users
+$select: id,displayName,userPrincipalName
+$filter: startsWith(displayName,'John')
+```
+
+## Development
+
+```bash
+# Install dependencies
+npm install
+
+# Build
+npm run build
+
+# Lint
+npm run lint
+
+# Link for local testing
+npm link
+```
+
+## Links
+
+- [CIPP.app](https://cipp.app)
+- [CIPP Documentation](https://docs.cipp.app)
+- [CIPP API Endpoints](https://docs.cipp.app/api-documentation/endpoints/)
+- [n8n Community Nodes](https://docs.n8n.io/integrations/community-nodes/)
+
+## License
+
+MIT

package/dist/credentials/CippApi.credentials.d.ts

@@ -0,0 +1,10 @@
+import type { Icon, ICredentialTestRequest, ICredentialType, INodeProperties } from 'n8n-workflow';
+export declare class CippApi implements ICredentialType {
+    name: string;
+    displayName: string;
+    icon: Icon;
+    documentationUrl: string;
+    properties: INodeProperties[];
+    test: ICredentialTestRequest;
+}
+//# sourceMappingURL=CippApi.credentials.d.ts.map

package/dist/credentials/CippApi.credentials.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CippApi.credentials.d.ts","sourceRoot":"","sources":["../../credentials/CippApi.credentials.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACX,IAAI,EACJ,sBAAsB,EACtB,eAAe,EACf,eAAe,EACf,MAAM,cAAc,CAAC;AAEtB,qBAAa,OAAQ,YAAW,eAAe;IAC9C,IAAI,SAAa;IACjB,WAAW,SAAc;IACzB,IAAI,EAAE,IAAI,CAAmB;IAC7B,gBAAgB,SAAsE;IAEtF,UAAU,EAAE,eAAe,EAAE,CAqC3B;IAIF,IAAI,EAAE,sBAAsB,CAM1B;CACF"}

package/dist/credentials/CippApi.credentials.js

@@ -0,0 +1,58 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CippApi = void 0;
+class CippApi {
+    name = 'cippApi';
+    displayName = 'CIPP API';
+    icon = 'file:cipp.svg';
+    documentationUrl = 'https://docs.cipp.app/api-documentation/setup-and-authentication';
+    properties = [
+        {
+            displayName: 'CIPP Instance URL',
+            name: 'baseUrl',
+            type: 'string',
+            default: '',
+            required: true,
+            placeholder: 'https://cipp.yourdomain.com',
+            description: 'The base URL of your CIPP deployment',
+        },
+        {
+            displayName: 'Azure AD Tenant ID',
+            name: 'tenantId',
+            type: 'string',
+            default: '',
+            required: true,
+            placeholder: 'xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx',
+            description: 'Your Azure AD Tenant ID (where the CIPP app registration lives)',
+        },
+        {
+            displayName: 'Application (Client) ID',
+            name: 'clientId',
+            type: 'string',
+            default: '',
+            required: true,
+            placeholder: 'xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx',
+            description: 'The Application (Client) ID from Azure AD App Registration',
+        },
+        {
+            displayName: 'Client Secret',
+            name: 'clientSecret',
+            type: 'string',
+            typeOptions: { password: true },
+            default: '',
+            required: true,
+            description: 'The Client Secret from Azure AD App Registration',
+        },
+    ];
+    // Custom pre-request auth - the node handles OAuth token acquisition
+    // This test validates by attempting a simple API call
+    test = {
+        request: {
+            method: 'GET',
+            url: '={{$credentials.baseUrl.replace(/\\/$/, "")}}/api/ListTenants',
+            skipSslCertificateValidation: false,
+        },
+    };
+}
+exports.CippApi = CippApi;
+//# sourceMappingURL=CippApi.credentials.js.map

package/dist/credentials/CippApi.credentials.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"CippApi.credentials.js","sourceRoot":"","sources":["../../credentials/CippApi.credentials.ts"],"names":[],"mappings":";;;AAOA,MAAa,OAAO;IACnB,IAAI,GAAG,SAAS,CAAC;IACjB,WAAW,GAAG,UAAU,CAAC;IACzB,IAAI,GAAS,eAAe,CAAC;IAC7B,gBAAgB,GAAG,kEAAkE,CAAC;IAEtF,UAAU,GAAsB;QAC/B;YACC,WAAW,EAAE,mBAAmB;YAChC,IAAI,EAAE,SAAS;YACf,IAAI,EAAE,QAAQ;YACd,OAAO,EAAE,EAAE;YACX,QAAQ,EAAE,IAAI;YACd,WAAW,EAAE,6BAA6B;YAC1C,WAAW,EAAE,sCAAsC;SACnD;QACD;YACC,WAAW,EAAE,oBAAoB;YACjC,IAAI,EAAE,UAAU;YAChB,IAAI,EAAE,QAAQ;YACd,OAAO,EAAE,EAAE;YACX,QAAQ,EAAE,IAAI;YACd,WAAW,EAAE,sCAAsC;YACnD,WAAW,EAAE,iEAAiE;SAC9E;QACD;YACC,WAAW,EAAE,yBAAyB;YACtC,IAAI,EAAE,UAAU;YAChB,IAAI,EAAE,QAAQ;YACd,OAAO,EAAE,EAAE;YACX,QAAQ,EAAE,IAAI;YACd,WAAW,EAAE,sCAAsC;YACnD,WAAW,EAAE,4DAA4D;SACzE;QACD;YACC,WAAW,EAAE,eAAe;YAC5B,IAAI,EAAE,cAAc;YACpB,IAAI,EAAE,QAAQ;YACd,WAAW,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE;YAC/B,OAAO,EAAE,EAAE;YACX,QAAQ,EAAE,IAAI;YACd,WAAW,EAAE,kDAAkD;SAC/D;KACD,CAAC;IAEF,qEAAqE;IACrE,sDAAsD;IACtD,IAAI,GAA2B;QAC9B,OAAO,EAAE;YACR,MAAM,EAAE,KAAK;YACb,GAAG,EAAE,+DAA+D;YACpE,4BAA4B,EAAE,KAAK;SACnC;KACD,CAAC;CACF;AAtDD,0BAsDC"}

package/dist/credentials/cipp.svg

@@ -0,0 +1,4 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 64 64" fill="none">
+  <rect width="64" height="64" rx="8" fill="#0078D4"/>
+  <text x="32" y="42" font-family="Arial, sans-serif" font-size="24" font-weight="bold" fill="white" text-anchor="middle">CIPP</text>
+</svg>

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+export * from './nodes/Cipp/Cipp.node';
+export * from './credentials/CippApi.credentials';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../index.ts"],"names":[],"mappings":"AAAA,cAAc,wBAAwB,CAAC;AACvC,cAAc,mCAAmC,CAAC"}

package/dist/index.js

@@ -0,0 +1,19 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./nodes/Cipp/Cipp.node"), exports);
+__exportStar(require("./credentials/CippApi.credentials"), exports);
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,yDAAuC;AACvC,oEAAkD"}

package/dist/nodes/Cipp/Cipp.node.d.ts

@@ -0,0 +1,11 @@
+import type { IExecuteFunctions, ILoadOptionsFunctions, INodeExecutionData, INodeListSearchResult, INodeType, INodeTypeDescription } from 'n8n-workflow';
+export declare class Cipp implements INodeType {
+    description: INodeTypeDescription;
+    methods: {
+        listSearch: {
+            tenantSearch(this: ILoadOptionsFunctions, filter?: string): Promise<INodeListSearchResult>;
+        };
+    };
+    execute(this: IExecuteFunctions): Promise<INodeExecutionData[][]>;
+}
+//# sourceMappingURL=Cipp.node.d.ts.map

package/dist/nodes/Cipp/Cipp.node.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Cipp.node.d.ts","sourceRoot":"","sources":["../../../nodes/Cipp/Cipp.node.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAEX,iBAAiB,EACjB,qBAAqB,EACrB,kBAAkB,EAClB,qBAAqB,EACrB,SAAS,EACT,oBAAoB,EACpB,MAAM,cAAc,CAAC;AAUtB,qBAAa,IAAK,YAAW,SAAS;IACrC,WAAW,EAAE,oBAAoB,CAkG/B;IAEF,OAAO;;+BAGE,qBAAqB,WAClB,MAAM,GACb,OAAO,CAAC,qBAAqB,CAAC;;MAqBjC;IAEI,OAAO,CAAC,IAAI,EAAE,iBAAiB,GAAG,OAAO,CAAC,kBAAkB,EAAE,EAAE,CAAC;CA2rCvE"}