Add iTop CMDB integration node with authentication and core operations

- Implement iTop node with get and update operations
- Add ITopApi credentials supporting username/password and token authentication
- Update README with iTop-specific documentation and setup instructions
- Configure package.json with iTop metadata and n8n node registration
- Support iTop REST/JSON API with OQL queries and object manipulation

Author: larhip

README.md

@@ -1,14 +1,13 @@
 # n8n-nodes-itop
 
-This is an n8n community node. It lets you use GitHub Issues in your n8n workflows.
+This is an n8n community node. It lets you use iTop CMDB in your n8n workflows.
 
 [n8n](https://n8n.io/) is a [fair-code licensed](https://docs.n8n.io/sustainable-use-license/) workflow automation platform.
 
 [Installation](#installation)
 [Operations](#operations)
 [Credentials](#credentials)
 [Compatibility](#compatibility)
-[Usage](#usage)
 [Resources](#resources)
 
 ## Installation
@@ -17,51 +16,41 @@ Follow the [installation guide](https://docs.n8n.io/integrations/community-nodes
 
 ## Operations
 
-- Issues
-    - Get an issue
-    - Get many issues in a repository
-    - Create a new issue
-- Issue Comments
-    - Get many issue comments
+- **Get**: Search for and retrieve iTop objects using OQL queries or object IDs
+- **Update**: Update a single iTop object with new field values
 
 ## Credentials
 
-You can use either access token or OAuth2 to use this node.
+You can use either username/password or token-based authentication to use this node.
 
-### Access token
+### Setting up credentials in n8n
 
-1. Open your GitHub profile [Settings](https://github.com/settings/profile).
-2. In the left navigation, select [Developer settings](https://github.com/settings/apps).
-3. In the left navigation, under Personal access tokens, select Tokens (classic).
-4. Select Generate new token > Generate new token (classic).
-5. Enter a descriptive name for your token in the Note field, like n8n integration.
-6. Select the Expiration you'd like for the token, or select No expiration.
-7. Select Scopes for your token. For most of the n8n GitHub nodes, add the `repo` scope.
-    - A token without assigned scopes can only access public information.
-8. Select Generate token.
-9. Copy the token.
+1. In n8n, go to **Credentials** and create a new **iTop API** credential
+2. Enter your **iTop URL** (e.g., `https://your-itop-instance.com`)
+3. Select your **Authentication Method**:
 
-Refer to [Creating a personal access token (classic)](https://docs.github.com/en/authentication/keeping-your-account-and-data-secure/managing-your-personal-access-tokens#creating-a-personal-access-token-classic) for more information. Refer to Scopes for OAuth apps for more information on GitHub scopes.
+### Username and Password
 
-![Generated Access token in GitHub](https://docs.github.com/assets/cb-17251/mw-1440/images/help/settings/personal-access-tokens.webp)
+1. Select **Username and Password** as the authentication method
+2. Enter your iTop **Username**
+3. Enter your iTop **Password**
+4. Optionally adjust the **API Version** (default: 1.3)
 
-### OAuth2
+### Token
 
-If you're self-hosting n8n, create a new GitHub [OAuth app](https://docs.github.com/en/apps/oauth-apps):
+1. Select **Token** as the authentication method
+2. Enter your iTop **Auth Token**
+   - To generate a token in iTop, go to **User Account** > **Personal Tokens**
+3. Optionally adjust the **API Version** (default: 1.3)
 
-1. Open your GitHub profile [Settings](https://github.com/settings/profile).
-2. In the left navigation, select [Developer settings](https://github.com/settings/apps).
-3. In the left navigation, select OAuth apps.
-4. Select New OAuth App.
-    - If you haven't created an app before, you may see Register a new application instead. Select it.
-5. Enter an Application name, like n8n integration.
-6. Enter the Homepage URL for your app's website.
-7. If you'd like, add the optional Application description, which GitHub displays to end-users.
-8. From n8n, copy the OAuth Redirect URL and paste it into the GitHub Authorization callback URL.
-9. Select Register application.
-10. Copy the Client ID and Client Secret this generates and add them to your n8n credential.
+### Required iTop Permissions
 
-Refer to the [GitHub Authorizing OAuth apps documentation](https://docs.github.com/en/apps/oauth-apps/using-oauth-apps/authorizing-oauth-apps) for more information on the authorization process.
+Users need the following permissions in iTop:
+- **REST Services User** profile
+- **Write access** on the classes they want to modify
+- **Bulk write** permissions on the classes they want to modify
+
+Note: Standard administrator accounts do not have REST access by default unless the REST Services User profile is explicitly granted.
 
 ## Compatibility
 
@@ -70,4 +59,4 @@ Compatible with n8n@1.60.0 or later
 ## Resources
 
 * [n8n community nodes documentation](https://docs.n8n.io/integrations/#community-nodes)
-* [GitHub API docs](https://docs.github.com/en/rest/issues)
+* [iTop REST/JSON API documentation](https://www.itophub.io/wiki/page?id=latest:advancedtopics:rest_json)

credentials/ITopApi.credentials.ts

@@ -0,0 +1,79 @@
+import type {
+	IAuthenticateGeneric,
+	ICredentialTestRequest,
+	ICredentialType,
+	INodeProperties,
+} from 'n8n-workflow';
+
+export class ITopApi implements ICredentialType {
+	name = 'iTopApi';
+
+	displayName = 'iTop API';
+
+	documentationUrl = 'https://www.itophub.io/wiki/page?id=latest:advancedtopics:rest_json';
+
+	properties: INodeProperties[] = [
+		{
+			displayName: 'iTop URL',
+			name: 'url',
+			type: 'string',
+			default: '',
+			placeholder: 'https://your-itop-instance.com',
+			description: 'The base URL of your iTop instance (without /webservices/rest.php)',
+			required: true,
+		},
+		{
+			displayName: 'Username',
+			name: 'username',
+			type: 'string',
+			default: '',
+			required: true,
+		},
+		{
+			displayName: 'Password',
+			name: 'password',
+			type: 'string',
+			typeOptions: { password: true },
+			default: '',
+			required: true,
+		},
+		{
+			displayName: 'API Version',
+			name: 'version',
+			type: 'string',
+			default: '1.3',
+			description: 'The iTop REST API version to use',
+		},
+	];
+
+	authenticate: IAuthenticateGeneric = {
+		type: 'generic',
+		properties: {},
+	};
+
+	test: ICredentialTestRequest = {
+		request: {
+			baseURL: '={{$credentials.url}}/webservices/rest.php',
+			url: '?version={{$credentials.version}}',
+			method: 'POST',
+			headers: {
+				'Content-Type': 'application/x-www-form-urlencoded',
+			},
+			body: {
+				json_data: '={{ JSON.stringify({ operation: "core/check_credentials" }) }}',
+				auth_user: '={{$credentials.username}}',
+				auth_pwd: '={{$credentials.password}}',
+			},
+		},
+		rules: [
+			{
+				type: 'responseSuccessBody',
+				properties: {
+					key: 'authorized',
+					value: true,
+					message: 'Authentication failed. Please check your username and password.',
+				},
+			},
+		],
+	};
+}

credentials/ITopTokenApi.credentials.ts

@@ -0,0 +1,72 @@
+import type {
+	IAuthenticateGeneric,
+	ICredentialTestRequest,
+	ICredentialType,
+	INodeProperties,
+} from 'n8n-workflow';
+
+export class ITopTokenApi implements ICredentialType {
+	name = 'iTopTokenApi';
+
+	displayName = 'iTop Token API';
+
+	documentationUrl = 'https://www.itophub.io/wiki/page?id=latest:advancedtopics:rest_json';
+
+	properties: INodeProperties[] = [
+		{
+			displayName: 'iTop URL',
+			name: 'url',
+			type: 'string',
+			default: '',
+			placeholder: 'https://your-itop-instance.com',
+			description: 'The base URL of your iTop instance (without /webservices/rest.php)',
+			required: true,
+		},
+		{
+			displayName: 'Auth Token',
+			name: 'authToken',
+			type: 'string',
+			typeOptions: { password: true },
+			default: '',
+			required: true,
+			description: 'Personal or application token from iTop',
+		},
+		{
+			displayName: 'API Version',
+			name: 'version',
+			type: 'string',
+			default: '1.3',
+			description: 'The iTop REST API version to use',
+		},
+	];
+
+	authenticate: IAuthenticateGeneric = {
+		type: 'generic',
+		properties: {},
+	};
+
+	test: ICredentialTestRequest = {
+		request: {
+			baseURL: '={{$credentials.url}}/webservices/rest.php',
+			url: '?version={{$credentials.version}}',
+			method: 'POST',
+			headers: {
+				'Content-Type': 'application/x-www-form-urlencoded',
+			},
+			body: {
+				json_data: '={{ JSON.stringify({ operation: "core/check_credentials" }) }}',
+				auth_token: '={{$credentials.authToken}}',
+			},
+		},
+		rules: [
+			{
+				type: 'responseSuccessBody',
+				properties: {
+					key: 'authorized',
+					value: true,
+					message: 'Authentication failed. Please check your token.',
+				},
+			},
+		],
+	};
+}