Management::Trust::add_authority_device_v2

Introduced : BIG-IP_v13.0.0
Add an authoritative device to the trust domain. You must specify a new device object name for the device to be added. You must specify the port if the remote device httpd ssl-port is not the default 443. You may specify various arguments to authenticate the browser certificate of the device being added. Any or all of these values may be omitted. Note: Currently, the backend requires hexadecimal values to be in lower case and not include the &apos:&apos character.

Prototype

 add_authority_device_v2(
    in String address,
    in long port,
    in String username,
    in String password,
    in String device_object_name,
    in String browser_cert_serial_number,
    in String browser_cert_signature,
    in String browser_cert_sha1_fingerprint,
    in String browser_cert_md5_fingerprint
);

Parameters

Parameter Type Description
address String The Address or DNS name of device to add.
port long The port to access device with. Zero means it will use the default 443.
username String The username to access device with.
password String The password to access device with.
device_object_name String Use this as the name for the device object of the device to be added.
browser_cert_serial_number String If non-empty, verify that the browser cert serial number of the device matches this hexadecimal value (e.g. e35b0be72b4cb489).
browser_cert_signature String If non-empty, verify that the browser cert signature of the device matches this value (e.g. 9385cfeef0f82d…).
browser_cert_sha1_fingerprint String If non-empty, verify that the browser cert SHA-1 fingerprint of the device matches this hexadecimal value (e.g. 8364c09526a23ef6b967628e4e366df8c8e1a4da).
browser_cert_md5_fingerprint String If non-empty, verify that the browser cert MD5 fingerprint of the device matches this hexadecimal value (e.g. 7ff9740f82c184cd48c1321c12ebfaa2).

Return Type

Type Description
void  

Exceptions

Exception Description
Common::AccessDenied Raised if the client credentials are not valid.
Common::InvalidArgument Raised if an argument is invalid.
Common::OperationFailed Raised if an operation error occurs.

See Also

iControl ::
iControl :: Management :: Trust

Warning

The links to the sample code below are remnants of the old DevCentral wiki and will result in a 404 error. For best results, please copy the link text and search the codeshare directly on DevCentral.

Sample Code


Copyright © 1996-2012, F5 Networks, Inc. All rights reserved.

The BIG-IP API Reference documentation contains community-contributed content. F5 does not monitor or control community code contributions. We make no guarantees or warranties regarding the available code, and it may contain errors, defects, bugs, inaccuracies, or security vulnerabilities. Your access to and use of any code available in the BIG-IP API reference guides is solely at your own risk.