List, create, update DNS BIND authentication records for compliance scans (using PC). Compliance scans are supported (using PC).
Parameter |
Required/Optional |
Data Type |
Description |
---|---|---|---|
action |
Required | String | Specify to list, create, update, delete, authentication records. |
ids |
Required | Integer | Specify a single or comma separated valid DNS BIND type authentication record ID(s). |
title |
Required | Alphanumeric |
Specify the title for the authentication record. |
ips | Required | Integer | Specify the IP address(es) the server will log into using the record’s credentials. Multiple entries are comma separated. |
unix_bin_path | Required | Path | Specify absolute path of the DNS BIND Base64 encoded binary file location. Base64 encoded binary file path. Example- "/usr/sbin/named". |
unix_conf_path | Required | Path | Specify absolute path of the DNS BIND Base64 encoded configuration file path. Example- "/etc/named.conf". |
base_directory | Optional | Path | Specify Base64 encoded base directory. In BIND configuration file, if an include file is relative path, it is relative to this base_dir. Optional field, if not present, it will be derived from conf_path. Example- If conf_path is /etc/named.conf and if base_dir is not specified, then base_dir is set to "/etc". It must be absolute path if specified. |
chroot_directory | Optional | Path | Specify Base64 encoded chroot directory. Optional field, only needed if BIND runs in a self contained environment. If present, must be absolute path and it will be prefixed to all other 3 paths. Example- If chroot_dir is "/var/bind" and if bin_path is "/usr/sbin/named", then the final bin_path will be "/var/bind/usr/sbin/named". |
API request
curl" -d "action=list" "<qualys_base_url>/api/2.0/fo/auth/bind/"
XML output
<?xml version="1.0" encoding="UTF-8" ?> <!DOCTYPE AUTH_CISCO_APIC_LIST_OUTPUT SYSTEM "<qualys_base_url>/api/2.0/fo/auth/cisco_apic/auth_cisco_apic_list_ output.dtd"> <AUTH_CISCO_APIC_LIST_OUTPUT> <RESPONSE> <AUTH_CISCO_APIC_LIST> <AUTH_CISCO_APIC> <ID>dummy text</ID> <TITLE><![CDATA[user 1]]></TITLE> <USERNAME><![CDATA[user 1]]></USERNAME> <PORT>444</PORT> <WINDOWS_DOMAIN><![CDATA[aaaa]]></WINDOWS_DOMAIN> <SSL_VERIFY><![CDATA[1]]></SSL_VERIFY> <IP_SET> <IP>3.3.3.3</IP> </IP_SET> <REQUIRE_CERT><![CDATA[1]]></REQUIRE_CERT> <DOMAIN><![CDATA[aaaa]]></DOMAIN> <PORT><![CDATA[444]]></PORT> <SSL_VERIFY_WITH_HOST><![CDATA[1]]></SSL_VERIFY_WITH_HOST> <LOGIN_TYPE><![CDATA[basic]]></LOGIN_TYPE> <CREATED> <BY>user_1</BY> </CREATED> </AUTH_CISCO_APIC> </AUTH_CISCO_APIC_LIST> </RESPONSE> </AUTH_CISCO_APIC_LIST_OUTPUT>
API request
curl" -d"action=create&ips=40.40.40.6&title=user_1bind2c&unix_bin_path=/etc&unix_conf_path=/etc/bind" "<qualys_base_url>:48443/api/2.0/fo/auth/bind/"
XML output
<?xml version="1.0" encoding="UTF-8" ?> <!DOCTYPE BATCH_RETURN SYSTEM "<qualys_base_url>/api/2.0/batch_return.dtd"> <BATCH_RETURN> <BATCH_LIST> <BATCH> <TEXT>Successfully Created</TEXT> <ID_SET> <ID>dummy text</ID> </ID_SET> </BATCH> </BATCH_LIST> </RESPONSE> </BATCH_RETURN>
API request
curl" -d "action=update&ids=7882778&title=testbind""<qualys_base_url>:48443/api/2.0/fo/auth/bind/"
XML output
<?xml version="1.0" encoding="UTF-8" ?> <!DOCTYPE BATCH_RETURN SYSTEM "<qualys_base_url>/api/2.0/batch_return.dtd"> <BATCH_RETURN> <BATCH_LIST> <BATCH> <TEXT>Successfully Updated</TEXT> <ID_SET> <ID>dummy text</ID> </ID_SET> </BATCH> </BATCH_LIST> </RESPONSE> </BATCH_RETURN>
Qualys API Server URL/api/2.0/batch_return.dtd
Qualys API Server URL/api/2.0/fo/auth/auth_bind_list_output.dtd