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