You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
# Check Point - Harmony Endpoint Management JS-TS SDK
2
2
3
-
---
4
-
🚧🚧🚧
3
+
This is the Harmony Endpoint management SDK for JavaScript ecosystem.
5
4
6
-
**This package is currently in EA (Early Availability) stage. Use with caution, as it may undergo significant changes and improvements. Feedback and contributions are highly encouraged.**
5
+
The SDK is based on the public [Harmony Endpoint management OpenAPI](https://app.swaggerhub.com/apis/Check-Point/web-mgmt-external-api-production) specifications.
7
6
8
-
To report a bug, please go to [Report Bug](#-report-bug)
7
+
The SDK fully supports TypeScript interfaces in parameters and responses.
9
8
10
-
For feedback please get in touch with us at [Check Point Software Technologies Ltd.](mailto:harmony-endpoint-external-api@checkpoint.com)
9
+
With the SDK, you do not have to manage log in, send keep alive requests, worry about session expiration or pull long processing jobs.
11
10
12
-
🚧🚧🚧
11
+
> 💡 The Harmony Endpoint SDK supports simultaneous instances with different tenants.
13
12
14
13
---
14
+
🚧🚧🚧
15
15
16
-
The official Harmony Endpoint management SDK for JavaScript echo-system.
16
+
**Note that the SDK package is in Early Availability (EA). Use with caution, as it may undergo changes and improvements. Feedback and contributions are highly encouraged.**
17
17
18
-
The SDK is based on the public [Harmony Endpoint management OpenAPI](https://app.swaggerhub.com/apis/Check-Point/web-mgmt-external-api-production) spec.
18
+
To report a bug, please go to [Report Bug](#-report-bug)
19
19
20
-
The SDK is straightforward to use with full TypeScript interface support in parameters and responses.
20
+
For feedback, please get in touch with us at [Check Point Software Technologies Ltd.](mailto:harmony-endpoint-external-api@checkpoint.com)
21
21
22
-
Using the SDK, no need to perform logins, send keep-alive requests, worry about session expiration or handle long processing jobs pulling, all is managed by the SDK.
22
+
🚧🚧🚧
23
23
24
-
> 💡 The SDK supports parallel instances to different tenants.
24
+
---
25
25
26
26
## ⬇️ SDK installation
27
27
@@ -46,9 +46,9 @@ import { HarmonyEndpoint } from "@chkp/harmony-endpoint-management-sdk";
46
46
47
47
Then, create a new instance of `HarmonyEndpoint`, which provides CloudInfra API credentials and a gateway to connect to.
48
48
49
-
To obtain CloudInfra credentials, open the Infinity Portal and create a suitable API Key. make sure in the `Service` field to enter `Endpoint`, for more information, refer to[Infinity Portal Administration Guide](https://sc1.checkpoint.com/documents/Infinity_Portal/WebAdminGuides/EN/Infinity-Portal-Admin-Guide/Content/Topics-Infinity-Portal/API-Keys.htm?tocpath=Global%20Settings%7C_____7#API_Keys).
49
+
To obtain CloudInfra credentials, open the Infinity Portal and create a suitable API Key. Make sure to select `Endpoint` in the `Service` field. For more information, see[Infinity Portal Administration Guide](https://sc1.checkpoint.com/documents/Infinity_Portal/WebAdminGuides/EN/Infinity-Portal-Admin-Guide/Content/Topics-Infinity-Portal/API-Keys.htm?tocpath=Global%20Settings%7C_____7#API_Keys).
50
50
51
-
Once the Client ID, Secret Key, and Authentication URL are obtained, Harmony Endpoint SDK can be started to be used.
51
+
Once the Client ID, Secret Key, and Authentication URL are obtained, Harmony Endpoint SDK can be used.
52
52
53
53
All API operations can be explored with the `HarmonyEndpoint` instance.
54
54
@@ -76,7 +76,7 @@ console.log(rulesMetadataRes.payload); // Your rulebase metadata
76
76
// Also you can query this operation using a job, no extra logic is required, in the background, it will trigger a job and will pull the status till it is finished and return the final results.
console.log(rulesMetadataJobRes.payload); // Your rulebase metadata, same as in non-kob operation
79
+
console.log(rulesMetadataJobRes.payload); // Your rulebase metadata, same as in non-job operation
80
80
81
81
// After you finish, disconnect to stop all background session management.
82
82
awaithe.disconnect();
@@ -149,13 +149,13 @@ API available at [SwaggerHub](https://app.swaggerhub.com/apis/Check-Point/harmon
149
149
150
150
## 📦 Versioning
151
151
152
-
While using cloud services it's recommended to always update to the latest published SDK version.
152
+
While using cloud services, it's recommended to constantly update to the latest published SDK version.
153
153
154
-
For on-premises, it's recommended to lock the version to the version that matches the running Endpoint service version and update it only after the Endpoint services upgrade.
154
+
For on-premises, it's recommended to align the versions of the SDK and the Harmony Endpoint Management service.
155
155
156
-
The matching SDK's add command can be seen in the web portal at `Harmony Endpoint` ->`Settings`-> `API & SDKs`.
156
+
You can view the matching SDK's pulling command from the Harmony Endpoint Web Management Portal -`Settings` > `API & SDKs`.
0 commit comments