Genians
Use the Genian NAC integration to block IP addresses using the assign tag.
Network Security · Genians
Details
| ID | Genians |
|---|---|
| Provider | Genians |
| Category | Network Security |
| From Version | 5.5.0 |
| Docker Image | demisto/python3:3.12.8.3296088 |
| Supported Modules | Agentix XSIAM |
README
Use the Genian NAC integration to block IP addresses using the assign tag.
Genian NAC network sensing technology powered by Device Platform Intelligence (DPI) discovers and presents all detected devices’ business contextual and risk-related information along with their technical information without disturbing existing network infrastructure. The resulting intelligence enhances visibility and allows operators to detect and respond to any non-compliant or compromised devices in real time.
With the result of comprehensive network visibility, Genian NAC can ensure compliance from all connected devices by leveraging Virtual In-Line Packet Inspection which operates at Layer 2. This technology has complete control over endpoint device traffic over TCP and UDP by eliminating the need for complex configurations and network changes.
Genians Genian NAC Module Requirements
Before you can use this integration in Cortex XSOAR, you need to enable certain modules in your Genian NAC environment.
Genian NAC Web Console
- This is the network address of the Genian NAC Enterprise or standalone Appliance. (The host on which the the Genian NAC is hosted.) For example, if the Genian NAC is hosted at the IP address 192.168.100.100, then you enter https://192.168.10.100:8443/mc2
Enforcement Mode
- Go to System > System > Click IP of Sensor > Click Sensor Tab > Click Sensor on the right
- Go to Sensor Operation > Sensor Mode and change the Sensor Mode to ‘host’
- Change Sensor Operationg Mode to ‘Enforcement’
- Monitoring: (Default) Monitoring mode. No blocking.
- Enforcement: Blocking mode
Specifying the Tag to be assigned to the node under control
- Go to Preferences > Properties > Tag
- Create new Tag or use existing Tag (e.g. THREAT)
Create Enforcement Policy
Reference the Enforcement Policy section in the Genian NAC Docs
Configuration Parameters
Server IP
- Input Genian NAC IP Address (e.g. 192.168.100.100)
API Key
- You can generate an API Key in the Genian NAC Web Console.
- Go to Management > User > Administrator tab > API Key to generate a key and save it.
- Input API Key (e.g. 912fae69-b454-4608-bf4b-fa142353b463)
Tag Name
- Input Tag Name for IP Block (e.g. THREAT, GUEST)
Configure Genian NAC in Cortex
- Name: a textual name for the integration instance.
- Server IP
- API Key
- Tag Name
Commands
You can execute these commands from the CLI, as part of an automation, or in a playbook. After you successfully execute a command, a DBot message appears in the War Room with the command details.
- Post IP address to a tag: genians-assign-ip-tag
- Delete IP address from a tag: genians-unassign-ip-tag
Post IP address to a tag
Assigns a tag to the Node specified.
Base Command
genians-assign-ip-tag
Input
| Argument Name | Description | Required |
|---|---|---|
| ip | IP Address (e.g. 192.168.100.87) | Required |
Context Output
| Path | Type | Description |
|---|---|---|
| genians.tag.nodeId | string | nodeid of IP |
| genians.tag.Name | string | Tag name |
Raw Output
[
{
"Type": "node",
"Description": "Threat",
"IDX": 9,
"nodeId": "dd9394cc-4495-103a-8010-2cf05d0cf498-537696fb",
"Name": "THREAT"
}
]
Delete IP address from a tag
Removes the tag(s) from the Node specified.
Base Command
genians-unassign-ip-tag
Input
| Argument Name | Description | Required |
|---|---|---|
| ip | IP Address (e.g. 192.168.100.87) | Required |
Context Output
| Path | Type | Description |
|---|---|---|
| genians.tag.nodeId | string | nodeid of IP |
| genians.tag.Name | string | Tag name |
Raw Output
[]
Configuration parameters
server_ip— Server IP (e.g. 172.29.62.26) (required)apikey— API Key (e.g. 912fae69-b454-4608-bf4b-fa142353b463) (required)insecure— Trust any certificate (not secure)tag_name— Tag Name (e.g. THREAT, GUEST) (required)feed— Fetch indicators
Commands (2)
-
genians-assign-ip-tagAssigns a tag to the Node specified.
-
genians-unassign-ip-tagRemoves the tag(s) from the Node specified.
commonfields: id: Genians version: -1 name: Genians display: Genians category: Network Security provider: Genians description: Use the Genian NAC integration to block IP addresses using the assign tag. detaileddescription: configuration: - display: Server IP (e.g. 172.29.62.26) name: server_ip defaultvalue: "" type: 0 required: true - display: API Key (e.g. 912fae69-b454-4608-bf4b-fa142353b463) name: apikey defaultvalue: "" type: 4 required: true - display: Trust any certificate (not secure) name: insecure defaultvalue: "false" type: 8 required: false - display: Tag Name (e.g. THREAT, GUEST) name: tag_name defaultvalue: "" type: 0 required: true - display: Fetch indicators name: feed type: 8 required: false script: commands: - name: genians-assign-ip-tag arguments: - name: ip required: true description: Threat IP Address (e.g. 192.168.100.87). outputs: - contextPath: genians.tag.nodeId description: nodeid of IP. type: string - contextPath: genians.tag.Name description: Tag name. type: string description: Assigns a tag to the Node specified. - name: genians-unassign-ip-tag arguments: - name: ip required: true description: IP Address (e.g. 192.168.100.87). outputs: - contextPath: genians.tag.nodeId description: nodeid of IP. type: string - contextPath: genians.tag.Name description: Tag name. type: string description: Removes the tag(s) from the Node specified. dockerimage: demisto/python3:3.12.8.3296088 runonce: false script: '-' subtype: python3 type: python fromversion: 5.5.0 tests: - No tests- test in NonCircleTests