Cisco Identity Services Engine API Reference Guide, Release 1.2

Using Reauth API Calls

A Reauth API call sends a reauthentication command to a specified session. Each session has an associated value and can be one of the following:

• 0—REAUTH_TYPE_DEFAULT
• 1—REAUTH_TYPE_LAST
• 2—REAUTH_TYPE_RERUN

Reauth API Call Schema File

Invoking a Reauth API Call

Note Make sure that you have verified that the target node is a valid Monitoring node. To verify the persona of a node, see Verifying a Monitoring Node.

Step 1 Log in to the target Monitoring node.

For example, when you initially log in to a Monitoring node with the hostname acme123, the following URL address field is displayed:

Step 2 Enter the Reauth API call in the URL address field of the target node by replacing the “/admin/” component with the API call component (/ise/mnt/CoA/<specific-api-call>/<macaddress>/
<reauthtype>):

Note You must carefully enter each API call in the URL Address field of a target node because the calls are case sensitive. The use of “mnt” in the API call convention represents a Monitoring node.

Step 3 Press Enter to issue the API call.

Reauth API Call Data

A Reauth API call returns one of the following results:

• True, which indicates that the command was successfully executed.
• False, which means that the command was not executed.

Using Disconnect API Calls

A Disconnect API call sends a disconnect command to a specified session and port. Each port has an associated value and can be one of the following:

• 0—DYNAMIC_AUTHZ_PORT_DEFAULT
• 1—DYNAMIC_AUTHZ_PORT_BOUNCE
• 2—DYNAMIC_AUTHZ_PORT_SHUTDOWN

Disconnect API Call Schema File

Invoking a Disconnect API Call

Note Make sure that the target node to which you are issuing an API call is a valid Monitoring node. To verify the persona of a node, see Verifying a Monitoring Node.

Step 1 Log in to the target Monitoring node.

For example, when you initially log in to a Monitoring node with the hostname acme123, the following URL address field is displayed:

Step 2 Enter the Disconnect API call in the URL address field of the target node by replacing the “/admin/” component with the API call component (/ise/mnt/CoA/<Disconnect>/<serverhostname>/
<macaddress>/<portoptiontype>/<nasipaddress>/<destinationipaddress>):

Note You must carefully enter each API call in the URL address field of a target node because the calls are case sensitive. The use of “mnt” in the API call convention represents a Monitoring node.

Step 3 Press Enter to issue the API call.

Disconnect API Call Data

A Disconnect API call returns one of the following results:

• True, which indicates that the command was successfully executed.
• False, which means that the command was not executed.