---
title: Infoblox Nios Ddi
slug: connectors/infoblox-nios-ddi
docTags: 
createdAt: 2026-06-09T16:30:21.671Z
---

The Infoblox NIOS DDI Connector integrates with Swimlane Turbine to add MAC filter, Get Host by IP and Get Host by Name.

## Prerequisites

The Infoblox NIOS DDI asset requires an **Username** and **password**.

## Capabilities

The Infoblox NIOS DDI Connector has the following capabilities:

- Add MAC Filter
- Get Host IP Search
- Get Host Search
- Search Related Objects by IP

## Notes

- [API Documentation](https://ipam.illinois.edu/wapidoc/index.html#)

# Configurations

## Infoblox NIOS DDI 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 Mac Filter

To add a MAC address to a MAC address filter.

### Endpoint

- **URL:** `/wapi/v{{api_version}}/macfilteraddress`
- **Method:** `POST`

### Input

| **Argument Name**             | **Type** | **Required** | **Description**                                                                             |
| ----------------------------- | -------- | ------------ | ------------------------------------------------------------------------------------------- |
| `path_parameters.api_version` | string   | Required     | The version of the API to use.                                                              |
| `parameters.mac`              | string   | Required     | A MAC address present in any FixedAddr object in the ipv4addrs member (regular expression). |
| `parameters.filter`           | string   | Required     | Name of the MAC filter to add.                                                              |

### Input Example

`{"parameters":{"mac":"00:01:de:ad:be:ef","filter":"my_filter"}}`

### 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":{"Date":"Thu, 22 Feb 2024 10:26:28 GMT","Strict-Transport-Security":"max-age=31536000; includeSubDomains","Cache-Control":"no-cache, no-store","Pragma":"no-cache","Content-Type":"application/json","set-cookie":"ibapauth=\"ip=10.20.10.252,sessionID=1708032884,client=API,group=admin-group,ctim...","X-Frame-Options":"SAMEORIGIN","X-XSS-Protection":"1; mode=block","X-Content-Type-Options":"nosniff","Referrer-Policy":"no-referrer-when-downgrade","Content-Security...`

## Host IP Search

Get DNS Host record object by IP address.

### Endpoint

- **URL:** `/wapi/v{{api_version}}/record:host_ipv4addr`
- **Method:** `GET`

### Input

| **Argument Name**             | **Type** | **Required** | **Description**                                                                                   |
| ----------------------------- | -------- | ------------ | ------------------------------------------------------------------------------------------------- |
| `path_parameters.api_version` | string   | Required     | The version of the API to use.                                                                    |
| `parameters.ipv4addr`         | string   | Required     | An IP address in string format.                                                                   |
| `parameters._return_fields`   | string   | Optional     | Comma separated list of fields to be returned.                                                    |
| `parameters.network_view`     | string   | Optional     | The network view in which the host record is located. By default, all network views are searched. |

### Input Example

`{"parameters":{"ipv4address":"10.10.20.1","network_view":"default"}}`

### 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":{"Date":"Thu, 22 Feb 2024 10:29:10 GMT","Strict-Transport-Security":"max-age=31536000; includeSubDomains","Cache-Control":"no-cache, no-store","Pragma":"no-cache","Content-Type":"application/json","set-cookie":"ibapauth=\"ip=10.20.10.252,sessionID=1708032884,client=API,group=admin-group,ctim...","X-Frame-Options":"SAMEORIGIN","X-XSS-Protection":"1; mode=block","X-Content-Type-Options":"nosniff","Referrer-Policy":"no-referrer-when-downgrade","Content-Security...`

## Host Search

Search Host by name.

### Endpoint

- **URL:** `/wapi/v{{api_version}}/record:host`
- **Method:** `GET`

### Input

| **Argument Name**             | **Type** | **Required** | **Description**                                                                                   |
| ----------------------------- | -------- | ------------ | ------------------------------------------------------------------------------------------------- |
| `path_parameters.api_version` | string   | Required     | The version of the API to use.                                                                    |
| `parameters.name`             | string   | Optional     | Host name in FQDN. FQDN consists of the host name followed by the domain name (abc.com).          |
| `parameters._return_fields`   | string   | Optional     | Comma separated list of fields to be returned.                                                    |
| `parameters.network_view`     | string   | Optional     | The network view in which the host record is located. By default, all network views are searched. |

### Input Example

`{"parameters":{"host":"testing.sifbaksh.com","return_fields":"comment","network_view":"default"}}`

### 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":{"Date":"Thu, 22 Feb 2024 10:34:13 GMT","Strict-Transport-Security":"max-age=31536000; includeSubDomains","Cache-Control":"no-cache, no-store","Pragma":"no-cache","Content-Type":"application/json","set-cookie":"ibapauth=\"ip=10.20.10.2,sessionID=1708032884,client=API,group=admin-group,ctime=...","X-Frame-Options":"SAMEORIGIN","X-XSS-Protection":"1; mode=block","X-Content-Type-Options":"nosniff","Referrer-Policy":"no-referrer-when-downgrade","Content-Security...`

## Search Related Objects by IP

Search ip related objects.

### Endpoint

- **URL:** `/wapi/v{{api_version}}/search`
- **Method:** `GET`

### Input

| **Argument Name**             | **Type** | **Required** | **Description**                                        |
| ----------------------------- | -------- | ------------ | ------------------------------------------------------ |
| `path_parameters.api_version` | string   | Required     | Parameters for the Search Related Objects by IP action |
| `parameters.address`          | string   | Required     | Parameters for the Search Related Objects by IP action |
| `parameters._max_results`     | number   | Optional     | Parameters for the Search Related Objects by IP action |

### Input Example

`{"parameters":{"address":"8.8.8.8","_max_results":10},"path_parameters":{"api_version":"2.11"}}`

### 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":{"Date":"Tue, 19 Mar 2024 19:28:53 GMT","Strict-Transport-Security":"max-age=31536000; includeSubDomains","Cache-Control":"no-cache, no-store","Pragma":"no-cache","Content-Type":"application/json","set-cookie":"ibapauth=\"ip=10.20.10.2,sessionID=1708032884,client=API,group=admin-group,ctime=...","X-Frame-Options":"SAMEORIGIN","X-XSS-Protection":"1; mode=block","X-Content-Type-Options":"nosniff","Referrer-Policy":"no-referrer-when-downgrade","Content-Security...`

# Response Headers

| **Header**                | **Description**                                       | **Example**                                                                                                                                                                                                                       |
| ------------------------- | ----------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Cache-Control             | Directives for caching mechanisms                     | no-cache, no-store                                                                                                                                                                                                                |
| Connection                | HTTP response header: Connection                      | close                                                                                                                                                                                                                             |
| Content-Security-Policy   | HTTP response header: Content-Security-Policy         | default-src 'self' \*.splunk.com img-src 'self' 'unsafe-inline' 'unsafe-eval' data: https: style-src 'self' 'unsafe-inline' 'unsafe-eval'                                                                                         |
| Content-Type              | The media type of the resource                        | application/json                                                                                                                                                                                                                  |
| Date                      | The date and time at which the message was originated | Tue, 19 Mar 2024 19:28:53 GMT                                                                                                                                                                                                     |
| Pragma                    | HTTP response header: Pragma                          | no-cache                                                                                                                                                                                                                          |
| Referrer-Policy           | HTTP response header: Referrer-Policy                 | no-referrer-when-downgrade                                                                                                                                                                                                        |
| set-cookie                | HTTP response header: set-cookie                      | ibapauth="ip=10.20.10.252,sessionID=1708032884,client=API,group=admin-group,ctime=1708597588,timeout=600,mtime=1708597588,su=1,auth=LOCAL,user=admin,U09LKJNO7sGL+CXTjRK3TCPk0pTVL9VQ2v0"; httponly; Path=/; secure; SameSite=Lax |
| Strict-Transport-Security | HTTP response header: Strict-Transport-Security       | max-age=31536000; includeSubDomains                                                                                                                                                                                               |
| Transfer-Encoding         | HTTP response header: Transfer-Encoding               | chunked                                                                                                                                                                                                                           |
| X-Content-Type-Options    | HTTP response header: X-Content-Type-Options          | nosniff                                                                                                                                                                                                                           |
| X-Frame-Options           | HTTP response header: X-Frame-Options                 | SAMEORIGIN                                                                                                                                                                                                                        |
| X-XSS-Protection          | HTTP response header: X-XSS-Protection                | 1; mode=block                                                                                                                                                                                                                     |
