EQ Technologies Finika NAC
The Finika NAC connector allows for seamless integration with EQ Technologies' network access control system, enabling automated network security management.
EQ Technologies Finika NAC is a robust network access control solution that enables secure and efficient endpoint management. Through the Swimlane Turbine integration, users can automate the addition or removal of endpoints to and from blacklists and whitelists, perform bulk updates or deletions of assets, and retrieve IP to MAC address mappings. This connector streamlines network security operations, reduces manual workload, and enhances visibility into network assets, making it an essential tool for maintaining a secure and compliant network environment.
Additional Documents
Prerequisites
To effectively utilize the EQ Technologies Finika NAC connector with Swimlane, ensure you have the following prerequisites:
- HTTP Basic Authentication with the following parameters:
- URL: The endpoint URL for the Finika NAC API.
- Username: Your Finika NAC account username.
- Password: Your Finika NAC account password.
Authentication Methods
HTTP Basic Authenticatoin Method
- HTTP Basic Authentication with the following parameters:
- URL: The base URL for the Finika NAC API endpoint.
- Username: The username credential for API access.
- Password: The password credential for API access.
Capabilities
This Connector provides the following capabilities:
- Add to Blacklist
- Add to Whitelist
- Batch Remove Assets
- Batch Update Assets
- Get IP/MAC Mapping
- Remove Asset
- Update Asset
Add to Blacklist
- Blocks an endpoint by adding its MAC address to the blacklist in EQ Technologies Finika NAC.
Add to Whitelist
- Add an endpoint to the whitelist in EQ Technologies Finika NAC using the provided MAC address.
Batch Remove Assets
- Performs a bulk deletion of assets in EQ Technologies Finika NAC using the provided JSON body.
Batch Update Assets
- Performs a bulk update on assets within EQ Technologies Finika NAC usingthe provided JSON body.
Get IP/MAC Mapping
- Retrieve the mapping of IP addresses to MAC addresses from EQ Technologies Finika NAC.
Remove Asset
- Deletes a single asset record from EQ Technologies Finika NAC using the provided MAC address.
Update Asset
- Modify an asset's assignment in EQ Technologies Finika NAC using the provided MAC address.
Configurations
HTTP Basic Authentication
Authenticates using username and password.
Configuration Parameters
Parameter | Description | Type | Required |
|---|---|---|---|
url | A URL to the target host. | string | Required |
username | Username | string | Required |
password | Password | string | Required |
verify_ssl | Verify SSL certificate | boolean | Optional |
http_proxy | A proxy to route requests through. | string | Optional |
Actions
Add to Blacklist
Blocks an endpoint by adding its MAC address to the blacklist in EQ Technologies Finika NAC.
Endpoint
- URL: /rest/dao
- Method: POST
Input
Argument Name | Type | Required | Description |
|---|---|---|---|
parameters.do | string | Optional | Target Data Object. |
parameters.op | string | Optional | Operation type. |
parameters.translationTarget | string | Optional | Target table. |
parameters.style | string | Optional | Response format. |
macaddr | string | Optional | MAC Address. |
ammach_01 | string | Optional | Blacklist type assignment. |
Input Example
{"parameters":{"do":"AssetmngrAmmach","op":"CREATE","translationTarget":"MachineTable","style":"EQGRID"},"json_body":{"macaddr":"000000000011","ammach_01":"BLA_LIST001"}}
Output
Parameter | Type | Description |
|---|---|---|
status_code | number | HTTP status code of the response |
reason | string | Response reason phrase |
Output Example
{"status_code":200,"response_headers":{},"reason":"OK","json_body":{}}
Add to Whitelist
Adds an endpoint to the whitelist in EQ Technologies Finika NAC using a specified MAC address.
Endpoint
- URL: /rest/dao
- Method: POST
Input
Argument Name | Type | Required | Description |
|---|---|---|---|
parameters.do | string | Optional | Target Data Object. |
parameters.op | string | Optional | Operation type. |
parameters.translationTarget | string | Optional | Target table. |
parameters.style | string | Optional | Response format. |
macaddr | string | Optional | MAC Address. |
ammach_01 | string | Optional | Whitelist type assignment. |
Input Example
{"parameters":{"do":"AssetmngrAmmach","op":"CREATE","translationTarget":"MachineTable","style":"EQGRID"},"json_body":{"macaddr":"000000000011","ammach_01":"BLA_LIST001"}}
Output
Parameter | Type | Description |
|---|---|---|
status_code | number | HTTP status code of the response |
reason | string | Response reason phrase |
Output Example
{"status_code":200,"response_headers":{},"reason":"OK","json_body":{}}
Batch Remove Assets
Performs a bulk deletion of assets in EQ Technologies Finika NAC using the specified JSON body.
Endpoint
- URL: /rest/dao
- Method: POST
Input
Argument Name | Type | Required | Description |
|---|---|---|---|
parameters.do | string | Optional | Target Data Object. |
parameters.op | string | Optional | Operation type. |
parameters.translationTarget | string | Optional | Target table. |
parameters.style | string | Optional | Response format. |
Input Example
{"parameters":{"do":"AssetmngrAmmach","op":"DELETE","translationTarget":"MachineTable","style":"EQGRID"},"json_body":[{"macaddr":"000000000011"},{"macaddr":"000000000022"}]}
Output
Parameter | Type | Description |
|---|---|---|
status_code | number | HTTP status code of the response |
reason | string | Response reason phrase |
Output Example
{"status_code":200,"response_headers":{},"reason":"OK","json_body":{}}
Batch Update Assets
Performs a bulk update on assets within EQ Technologies Finika NAC using the provided JSON body.
Endpoint
- URL: /rest/dao
- Method: POST
Input
Argument Name | Type | Required | Description |
|---|---|---|---|
parameters.do | string | Optional | Target Data Object. |
parameters.op | string | Optional | Operation type. |
parameters.translationTarget | string | Optional | Target table. |
parameters.style | string | Optional | Response format. |
Input Example
{"parameters":{"do":"AssetmngrAmmach","op":"CREATE","translationTarget":"MachineTable","style":"EQGRID"},"json_body":[{"macaddr":"000000000011","ammach_01":"BLA_LIST001"},{"macaddr":"000000000022","ammach_01":"BLA_LIST002"}]}
Output
Parameter | Type | Description |
|---|---|---|
status_code | number | HTTP status code of the response |
reason | string | Response reason phrase |
Output Example
{"status_code":200,"response_headers":{},"reason":"OK","json_body":{}}
Get IP/MAC Mapping
Retrieve the mapping of IP addresses to MAC addresses from EQ Technologies Finika NAC.
Endpoint
- URL: /rest/dao
- Method: GET
Input
Argument Name | Type | Required | Description |
|---|---|---|---|
parameters.do | string | Optional | Target Data Object. |
parameters.op | string | Optional | Operation type. |
parameters.readabletitle | boolean | Optional | Readable title. |
parameters.start | number | Optional | Pagination start index. |
parameters.limit | number | Optional | Max number of records to return. |
parameters.sort | string | Optional | Field to sort by. |
parameters.order | string | Optional | Sort order. |
parameters.fields | string | Optional | Fields to return. |
Input Example
{"parameters":{"do":"AnacrowdMachineoverview","op":"READ","readabletitle":true,"start":0,"limit":200,"sort":"online","order":"desc","fields":"ipaddr"}}
Output
Parameter | Type | Description |
|---|---|---|
status_code | number | HTTP status code of the response |
reason | string | Response reason phrase |
Output Example
{"status_code":200,"response_headers":{},"reason":"OK","json_body":{}}
Remove Asset
Removes an asset from EQ Technologies Finika NAC by specifying the MAC address.
Endpoint
- URL: /rest/dao
- Method: POST
Input
Argument Name | Type | Required | Description |
|---|---|---|---|
parameters.do | string | Optional | Target Data Object. |
parameters.op | string | Optional | Operation type. |
parameters.translationTarget | string | Optional | Target table. |
parameters.style | string | Optional | Response format. |
macaddr | string | Optional | MAC Address. |
Input Example
{"parameters":{"do":"AssetmngrAmmach","op":"DELETE","translationTarget":"MachineTable","style":"EQGRID"},"json_body":{"macaddr":"000000000011"}}
Output
Parameter | Type | Description |
|---|---|---|
status_code | number | HTTP status code of the response |
reason | string | Response reason phrase |
Output Example
{"status_code":200,"response_headers":{},"reason":"OK","json_body":{}}
Update Asset
Modify an asset's assignment in EQ Technologies Finika NAC using the provided MAC address.
Endpoint
- URL: /rest/dao
- Method: POST
Input
Argument Name | Type | Required | Description |
|---|---|---|---|
parameters.do | string | Optional | Target Data Object. |
parameters.op | string | Optional | Operation type. |
parameters.translationTarget | string | Optional | Target table. |
parameters.style | string | Optional | Response format. |
macaddr | string | Optional | MAC Address. |
ammach_01 | string | Optional | Blacklist type assignment. |
Input Example
{"parameters":{"do":"AssetmngrAmmach","op":"UPDATE","translationTarget":"MachineTable","style":"EQGRID"},"json_body":{"macaddr":"000000000011","ammach_01":"BLA_LIST001"}}
Output
Parameter | Type | Description |
|---|---|---|
status_code | number | HTTP status code of the response |
reason | string | Response reason phrase |
Output Example
{"status_code":200,"response_headers":{},"reason":"OK","json_body":{}}
Response Headers
Header | Description | Example |
|---|---|---|
Content-Type | The media type of the resource | application/json |
Date | The date and time at which the message was originated | Thu, 01 Jan 2024 00:00:00 GMT |