Create, update, list and delete Infoblox authentication records. Infoblox authentication records are available for the PC/SCA module.
|
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 |
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>
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>
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>
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>
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>
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>
<platform API server>/api/2.0/batch_return.dtd
<platform API server>/api/2.0/fo/auth/infoblox/auth_infoblox_list_output.dtd