Infoblox record

/api/2.0/fo/auth/infoblox

[POST]

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

Input Parameters

Parameter

Description

action={action}

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

ids={value}

(Required to edit or delete record) 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) A title for the record. The title must be unique. Maximum 255 characters (ascii).

ips={value}

(Required to create record) 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) API version required on Infoblox devices.

ssl_verify={0|1}

(Required) 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) 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) The username to be used for authentication to Infoblox server.

password={value}

(Required to create record, optional to update record) The password to be used for authentication to Infoblox server.
Vault  

vault_type={value}

(Required to create record when login_type=vault) 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) 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) Vault specific parameters required depend on the vault type you’ve selected. See Vault Parameters

Sample - 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=1

v2.0123&ssl_verify=false&username=joe_user&password=abc123"

"https://qualysapi.qualys.com/api/2.0/fo/auth/infoblox/" > file.xml

XML output

<?xml version="1.0" encoding="UTF-8" ?>

<!DOCTYPE BATCH_RETURN SYSTEM

"https://qualysapi.qualys.com/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 Records

API request

curl -u "USERNAME:PASSWORD" -H "X-Requested-With: Curl Sample" -d "action=list"

"https://qualysapi.qualys.com/api/2.0/fo/auth/infoblox/" > file.xml

XML output

<?xml version="1.0" encoding="UTF-8" ?>

<!DOCTYPE AUTH_INFOBLOX_LIST_OUTPUT SYSTEM

"https://qualysapi.qualys.com/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 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://qualysapi.qualys.com/api/2.0/fo/auth/infoblox/" > file.xml

XML output

<?xml version="1.0" encoding="UTF-8" ?>

<!DOCTYPE BATCH_RETURN SYSTEM

"https://qualysapi.qualys.com/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 Records

API request

curl -u "USERNAME:PASSWORD" -H "X-Requested-With: curl sample" -d

"action=delete&ids=6317685"

"https://qualysapi.qualys.com/api/2.0/fo/auth/infoblox/" > file.xml

XML output

<?xml version="1.0" encoding="UTF-8" ?>

<!DOCTYPE BATCH_RETURN SYSTEM

"https://qualysapi.qualys.com/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)

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&logi

n_type=vault&api_version=1v2.0123&username=joe_user&vault_type=HashiCorp&vault_id=1062779&secret_kv_name=admin&secret_kv_key=Infoblo

x_vault_secret&ssl_verify=0"

"https://qualysapi.qualys.com/api/2.0/fo/auth/infoblox/" > file.xml

XML output

<?xml version="1.0" encoding="UTF-8" ?>

<!DOCTYPE BATCH_RETURN SYSTEM

"https://qualysapi.qualys.com/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)

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://qualysapi.qualys.com/api/2.0/fo/auth/infoblox/" > file.xml

XML output

<?xml version="1.0" encoding="UTF-8" ?>

<!DOCTYPE BATCH_RETURN SYSTEM

"https://qualysapi.qualys.com/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 auth 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