Ipam 1.0.0
  • 02 Apr 2025
  • 3 Minutes to read
  • Dark
    Light
  • PDF

Ipam 1.0.0

  • Dark
    Light
  • PDF

Article summary

Ipam - 1.0.0

tags: Python | Enrichment | IPAM | OpenWISP | Subnet | Internal IP


Table of Contents


Description

Integration with OpenWISP IPAM supports CDC users by providing enrichments for internal IPs via REST API. This enables CDC users to make informed decisions regarding incident response.

OpenWISP IPAM is the IP address space administration module of OpenWISP.

CyberProof provides CLI commands to cater to different user actions such as

• Create IP, Enrich IP, Update IP, Delete IP

• Create subnet, Create subnet through csv

• Enrich host, Enrich subnet

• Create Organization, Delete Organization, Get Organization List

CyberProof has also provided custom input adaptive card form for IP, Subnet, Organization operations so that a CDC user can perform these actions on IPAM to get the required information on CDC. Custom adaptive cards are extensively used to display the enriched information on CDC.

Integration Type:Enrichment
Information read:IP, Subnet, Organization details
API Supported:Rest APIs
Input:Details required to Create, Enrich, Update, Delete IP or Subnet or Organization
Output:Details enriched information about IP, Subnet, Organization provided in Input

CDC Command Lines

* **create_ip_cli**
create ip address

OptionTypeDescriptionRequired
ipstringip address ipv4 or ipv6True
subnetstringsubnet where ip needsTrue
internet_facingbooleaninternet facing.False
host_namestringip address name.False
descriptionstringip address description.False
critical_assetstringcritical asset can be in range 1-5.False

* **create_subnet_cli**
create subnet address

OptionTypeDescriptionRequired
subnetstringtext file to upload for adding subnetTrue
subnet_namestringname of the subnetTrue
descriptionstringdescription of the subnetFalse

* **import_subnet_cli**
This Command line interface of CDC is used to upload file from CDC to ipam client server. Important point to note :- 1. Atleast one of use case config or rule config file name needs to be mentioned. 2. Input Files for this CLI shall be mandatorily in ".csv" format only. 3. Input 'overwrite' must be a boolean value (true/false). 4. While running the CLI please enter Incident ID or Channel ID or Alert ID ( in CDC version < 2.2 )

OptionTypeDescriptionRequired
subnet_filestringsubnet import file nameFalse

* **ip_operation_form_cli**
Populates form to handle IP operation

OptionTypeDescriptionRequired

* **subnet_operation_form_cli**
Populates form to handle subnet operation

OptionTypeDescriptionRequired

* **update_ip_cli**
update ip address

OptionTypeDescriptionRequired
ipstringip address.True
host_namestringip address name.False
descriptionstringip address description.False
internet_facingbooleaninternet facing.False
critical_assetstringcritical asset can be in range 1-5.False

* **update_subnet_cli**
update subnet address

OptionTypeDescriptionRequired
subnetstringtext file to upload for adding subnetTrue
subnet_namestringname of the subnetTrue
descriptionstringdescription of the subnetFalse

* **create_organization_cli**
create organization in ipam server

OptionTypeDescriptionRequired
namestringname of organization , make sure its uniqueTrue
emailstringemail to assign to organization.True
descriptionstringdescription of organizationTrue

* **delete_ip_cli**
delete ip address

OptionTypeDescriptionRequired
ipstringip address ipv4 or ipv6True

* **delete_organization_cli**
delete organization from ipam server

OptionTypeDescriptionRequired
organization_namestringname of organization , make sure its uniqueTrue

* **delete_subnet_cli**
delete subnet address

OptionTypeDescriptionRequired
subnetstringsubnet from ipamTrue

* **enrich_host_cli**
fetch host details

OptionTypeDescriptionRequired
host_namestringip address ipv4 or ipv6True

* **enrich_ip_cli**
fetch ip address details

OptionTypeDescriptionRequired
ipstringip address ipv4 or ipv6True

* **enrich_subnet_cli**
enrich subnet details

OptionTypeDescriptionRequired
subnetstringsubnetTrue

* **get_organizations_cli**
fetch organization list

OptionTypeDescriptionRequired

* **get_subnetlist_cli**
get subnet list

OptionTypeDescriptionRequired

Workflows

* **get_file_content_subworkflow**
This workflow is used to get the content of the yaml file attached to a CDC incident, alert, or channel.

* **post_create_organization**
Post create-organization in CDC by ID of incident/message/chanel.

* **post_delete_ip**
Post delete-ip in CDC by ID of incident/message/chanel.

* **post_delete_organization**
Post delete-organization in CDC by ID of incident/message/chanel.

* **post_delete_subnet**
Post delete-subnet in CDC by ID of incident/message/chanel.

* **post_enrich_host**
Post enrich-host in CDC by ID of incident/message/chanel.

* **post_enrich_ip**
Post enrich-ip in CDC by ID of incident/message/chanel.

* **post_enrich_subnet**
Post enrich-subnet in CDC by ID of incident/message/chanel.

* **post_get_organizations**
Post get-organizations in CDC by ID of incident/message/chanel.

* **post_get_subnetlist**
Post get-subnetlist in CDC by ID of incident/message/chanel.


Rules

No rules


Sensors

No sensors


Triggers

No triggers


Known Issues


Was this article helpful?