Infoblox Record

GET POST/api/2.0/fo/auth/infoblox

Create, update, list and delete Infoblox authentication records. Infoblox authentication records are available for the PC/SCA module.

Input ParametersInput Parameters

Parameter

Required/Optional

Data Type

Description

action={action}

Required String 

Specify create, update, delete (using POST) or list (using GET or POST).

ids={value}

Required to edit or delete record Integer 

Record IDs to edit/delete. Specify record IDs and/or ID ranges (for example, 1359-1407). Multiple entries are comma separated.

title={value}

Required to create record String 

A title for the record. The title must be unique. Maximum 255 characters (ascii).

ips={value}

Required to create record Integer 

The IP address(es) for the Infoblox devices you want to authenticate to. Multiple entries are comma separated. (Optional to update record) IPs specified will overwrite existing IPs in the record, and existing IPs will be removed.

api_version{value}

Required Integer 

API version required on Infoblox devices.

ssl_verify={0|1}

Required Integer 

By default set to 0. When set to 1 our service will verify the certificate of the web server. When set to 0, our service will not verify the certificate of the web server.

Login credentials

login_type={basic|vault}

Optional Boolean 

The login type is basic by default. You can choose vault (for vault based authentication).

username={value}

Required to create record, optional to update record String 

The username to be used for authentication to Infoblox server.

password={value}

Required to create record, optional to update record String

The password to be used for authentication to Infoblox server.

use_ad_hashicorp{0|1} Optional Boolean Use to manage the utilization of Active Directory (AD)Secrets Engine in HashiCorp authentication records. Specify 1 to use Active Directory (AD) Secrets Engine in the authentication records.
Vault

vault_type={value}

Required to create record when login_type=vault String 

The vault type to be used for authentication.

vault_id={value}

Required to create record when login_type=vault and you want to retrieve private key from vault Integer 

The vault ID where you want to retrieve the private key from. Certain vaults support this capability.

{vault parameters}

Required to create record when login_type=vault Integer 

Vault specific parameters required depend on the vault type you’ve selected. See Vault Parameters

Sample - Create Infoblox Record, Basic LoginSample - Create Infoblox Record, Basic Login

API request

curl -u "USERNAME:PASSWORD" -H "X-Requested-With: curl sample" -d "action=create&ips=10.20.30.40&title=Infoblox_Auth11&api_version=1v2.0123&ssl_verify=false&username=joe_user&password=abc123""https://<qualys_base_url>/api/2.0/fo/auth/infoblox/" > file.xml

XML output

<?xml version="1.0" encoding="UTF-8" ?>
<!DOCTYPE BATCH_RETURN SYSTEM
"https://<qualys_base_url>/api/2.0/batch_return.dtd">
<BATCH_RETURN>
     <RESPONSE>
          <DATETIME>2022-06-29T10:50:19Z</DATETIME>
          <BATCH_LIST>
               <BATCH>
                    <TEXT>Successfully Created</TEXT>
                    <ID_SET>
                         <ID>6317683</ID>
                    </ID_SET>
               </BATCH>
          </BATCH_LIST>
     </RESPONSE>
</BATCH_RETURN>

Sample - List Infoblox RecordsSample - List Infoblox Records

API request

curl -u "USERNAME:PASSWORD" -H "X-Requested-With: Curl Sample" -d "action=list""https://<qualys_base_url>/api/2.0/fo/auth/infoblox/" > file.xml

XML output

<?xml version="1.0" encoding="UTF-8" ?>
<!DOCTYPE AUTH_INFOBLOX_LIST_OUTPUT SYSTEM
"https://<qualys_base_url>/api/2.0/fo/auth/infoblox/auth_infoblox_list_output.dtd">
<AUTH_INFOBLOX_LIST_OUTPUT>
    <RESPONSE>
        <DATETIME>2022-06-29T11:13:21Z</DATETIME>
        <AUTH_INFOBLOX_LIST>
            <AUTH_INFOBLOX>
                <ID>6317683</ID>
                <TITLE>
                    <![CDATA[Infoblox_Auth_update]]>
                </TITLE>
                <USERNAME>
                    <![joe_user]>
                </USERNAME>
                <SSL_VERIFY>
                    <![CDATA[true]]>
                </SSL_VERIFY>
                <IP_SET>
                    <IP>1.1.1.1</IP>
                    <IP>10.20.30.40</IP>
                </IP_SET>
                <API_VERSION>
                    <![CDATA[1v2.0124]]>
                </API_VERSION>
                <SSL_VERIFY>
                    <![CDATA[true]]>
                </SSL_VERIFY>
                <LOGIN_TYPE>
                    <![CDATA[basic]]>
                </LOGIN_TYPE>
                <NETWORK_ID>0</NETWORK_ID>
                <CREATED>
                    <DATETIME>2022-06-29T10:50:19Z</DATETIME>
                    <BY>scan_at</BY>
                </CREATED>
                <LAST_MODIFIED>
                    <DATETIME>2022-06-29T11:10:12Z</DATETIME>
                </LAST_MODIFIED>
                <COMMENTS>
                    <![CDATA[added]]>
                </COMMENTS>
            </AUTH_INFOBLOX>
        </AUTH_INFOBLOX_LIST>
    </RESPONSE>
</AUTH_INFOBLOX_LIST_OUTPUT>

Sample - Update Infobox RecordSample - Update Infobox Record

API request

curl -u "USERNAME:PASSWORD" -H "X-Requested-With: curl sample" -d"action=update&add_ips=10.20.30.40&title=Infoblox_Auth_update&api_version=1v2.0124&ssl_verify=true&comments=added&ids=6317685""https://<qualys_base_url>/api/2.0/fo/auth/infoblox/" > file.xml

XML output

<?xml version="1.0" encoding="UTF-8" ?>
<!DOCTYPE BATCH_RETURN SYSTEM
"https://<qualys_base_url>/api/2.0/batch_return.dtd">
<BATCH_RETURN>
     <RESPONSE>
          <DATETIME>2022-06-29T11:10:12Z</DATETIME>
          <BATCH_LIST>
               <BATCH>
                    <TEXT>Successfully Updated</TEXT>
                    <ID_SET>
                         <ID>6317683</ID>
                    </ID_SET>
               </BATCH>
          </BATCH_LIST>
     </RESPONSE>
</BATCH_RETURN>

Sample - Delete Infoblox RecordsSample - Delete Infoblox Records

API request

curl -u "USERNAME:PASSWORD" -H "X-Requested-With: curl sample" -d"action=delete&ids=6317685""https://<qualys_base_url>/api/2.0/fo/auth/infoblox/" > file.xml

XML output

<?xml version="1.0" encoding="UTF-8" ?>
<!DOCTYPE BATCH_RETURN SYSTEM
"https://<qualys_base_url>/api/2.0/batch_return.dtd">
<BATCH_RETURN>
     <RESPONSE>
          <DATETIME>2022-06-29T11:18:52Z</DATETIME>
          <BATCH_LIST>
               <BATCH>
                    <TEXT>Successfully Deleted</TEXT>
                    <ID_SET>
                         <ID>6317683</ID>
                    </ID_SET>
               </BATCH>
          </BATCH_LIST>
     </RESPONSE>
</BATCH_RETURN>

Sample - Create Infoblox Record (with Vault Login)Sample - Create Infoblox Record (with Vault Login)

API request

curl -u "USERNAME:PASSWORD" -H "X-Requested-With: curl sample" -d"action=create&ips=10.20.30.40&title=Infoblox_Auth_With_Vault&login_type=vault&api_version=1v2.0123&username=joe_user&vault_type=HashiCorp&vault_id=1062779&secret_kv_name=admin&secret_kv_key=Infoblox_vault_secret&ssl_verify=0""https://<qualys_base_url>/api/2.0/fo/auth/infoblox/" > file.xml

XML output

<?xml version="1.0" encoding="UTF-8" ?>
<!DOCTYPE BATCH_RETURN SYSTEM
"https://<qualys_base_url>/api/2.0/batch_return.dtd">
<BATCH_RETURN>
     <RESPONSE>
          <DATETIME>2022-07-14T07:46:29Z</DATETIME>
          <BATCH_LIST>
               <BATCH>
                    <TEXT>Successfully Created</TEXT>
                    <ID_SET>
                         <ID>1898844</ID>
                    </ID_SET>
               </BATCH>
          </BATCH_LIST>
     </RESPONSE>
</BATCH_RETURN>

Sample - Update Infoblox Record (with Vault Login)Sample - Update Infoblox Record (with Vault Login)

API request

curl -u "USERNAME:PASSWORD" -H "X-Requested-With: curl sample" -d"action=update&add_ips=10.20.30.40&title=Infoblox_Auth_update&api_version=1v2.0125&ssl_verify=1&comments=added&ids=1898844""https://<qualys_base_url>/api/2.0/fo/auth/infoblox/" > file.xml

XML output

<?xml version="1.0" encoding="UTF-8" ?>
<!DOCTYPE BATCH_RETURN SYSTEM
"https://<qualys_base_url>/api/2.0/batch_return.dtd">
<BATCH_RETURN>
     <RESPONSE>
          <DATETIME>2022-07-14T07:46:29Z</DATETIME>
          <BATCH_LIST>
               <BATCH>
                    <TEXT>Successfully Updated</TEXT>
                    <ID_SET>
                         <ID>1898844</ID>
                    </ID_SET>
               </BATCH>
          </BATCH_LIST>
     </RESPONSE>
</BATCH_RETURN>

DTDs for Authentication Type "infoblox"

<platform API server>/api/2.0/batch_return.dtd

<platform API server>/api/2.0/fo/auth/infoblox/auth_infoblox_list_output.dtd