Introdução
Este documento descreve o uso de um cliente de demonstração fornecido pela Cisco que pode ser usado para testar os comandos e a conectividade do OCI-P.
Pré-requisitos
Requisitos
- O asociclient pode ser instalado no seu PC ou servidor.
- O endereço IP da origem da solicitação de entrada precisa ser adicionado à lista de acesso à rede do BroadWorks.
- É necessário um comando OCI-P válido.
Configuração da BroadWorks
Nesse caso, a OCISenderTool está hospedada no servidor 172.16.30.3.
Verifique se esse IP foi adicionado à lista de acesso à rede do OCI-P AS_CLI/System/NetworkAccessLists/OCI/Provisioning>.
AS_CLI/System/NetworkAccessLists/OCI/Provisioning> get
Address Description
============================
...
172.16.30.3 OCISenderTool
Comando OCI-P
Nesse caso, use o comando 'GroupAccessDeviceGetListRequest' para Enterprise pws_ent e Group pws_grp.
Esse arquivo é chamado 'pws_GroupAccessDeviceGetListRequest.xml'.
<?xml version="1.0" encoding="ISO-8859-1"?>
<BroadsoftDocument protocol="OCI" xmlns="C" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<sessionId xmlns="">%%%OCI_SESSION_ID%%%</sessionId>
<command xsi:type="GroupAccessDeviceGetListRequest" xmlns="">
<serviceProviderId>pws_ent</serviceProviderId>
<groupId>pws_grp</groupId>
</command>
</BroadsoftDocument>
Opções de uso
Para executar esse comando, você precisa selecionar os parâmetros relevantes.
[bwadmin@bwtaclab ASOCICLIENT]$ ./startASOCIClient.sh
**** OCI Client Build Version: 1.1.2
**** Usage:
startOCIClient configFile
startOCIClient loginId password [-i inputXMLFile] [-o outputXMLFile] [-h host] [-p port]
[-m {un}secure/{s}ecure] [-c BCCT/OCS] [-t timeOut] [-s sessionID] [-l loginRequestName] [-f tabSize]
loginId LoginId of the user (mandatory)
password Password of the user (mandatory)
-i inputXMLFile File containing the XML Request
-o outputXMLFile File to write the XML Response. File is over-written.
If not provided will default to: inputXMLFile.response.xml)
-h host HostName to connect to. Default is localhost
-p port Port to connect to. Default is 31000
-m mode Unsecure/Secure mode for login
-c connection BCCT or OCS
-t timeOut Timeout in seconds to pause for a response from the server.
(Default is 30 seconds, if set to -1 will never timeout)
-s sessionID session ID
-l loginRequest name of the login request, i.e. LoginRequest or LoginRequest22
-f tab size formats the response XML to make it pretty (off by default)
Exemplo de laboratório
Provisionar em AS
- Exemplo de configuração se desejar enviar a solicitação por push através do AS (172.16.30.127) e usar BCCT (porta 2220).
loginId - admin
password - admin
inputXMLFile - /Commands/pws_GroupAccessDeviceGetListRequest.xml
host - 172.16.30.127
port - 2220
connection - BCCT
bwadmin@bwtaclab ASOCICLIENT]$ ./startASOCIClient.sh admin admin -i
./Commands/pws_GroupAccessDeviceGetListRequest.xml -h 172.16.30.127 -p 2220 -c BCCT
**** OCI Client Build Version: 1.1.2
**** Start OCIClient initialization --> 2022.05.12 04:06:14:540 EDT
**** Sending request at: 2022.05.12 04:06:14:566 EDT
==========>
<?xml version="1.0" encoding="UTF-8"?>
<BroadsoftDocument protocol = "OCI" xmlns="C" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<sessionId xmlns="">172.16.30.3,460141958,1652342774546</sessionId>
<command xsi:type="LoginRequest22V3" xmlns="">
<userId>admin</userId>
<password>admin</password>
</command>
</BroadsoftDocument>
<==========================
**** Received response (Request process time: 176 ms)
==========>
<?xml version="1.0" encoding="UTF-8"?>
<BroadsoftDocument protocol="OCI" xmlns="C" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<sessionId xmlns="">172.16.30.3,460141958,1652342774546</sessionId>
<command echo="" xsi:type="LoginResponse22V3" xmlns="">
<loginType>System</loginType>
<locale>en_US</locale>
<encoding>ISO-8859-1</encoding>
<isEnterprise>false</isEnterprise>
<passwordExpiresDays>2147483647</passwordExpiresDays>
<userDomain>calo.cisco.com</userDomain>
<tokenRevocationTime>1616017564343</tokenRevocationTime>
</command>
</BroadsoftDocument>
<==========================
LoginRequest command successful
**** Reading request(s) from file: ./Commands/pws_GroupAccessDeviceGetListRequest.xml
**** Writing response to file: ./Commands/pws_GroupAccessDeviceGetListRequest.xml.response.xml
**** Sending request from file: ./Commands/pws_GroupAccessDeviceGetListRequest.xml
at: 2022.05.12 04:06:14:745 EDT
==========>
<?xml version="1.0" encoding="ISO-8859-1"?>
<BroadsoftDocument protocol="OCI" xmlns="C" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<sessionId xmlns="">172.16.30.3,460141958,1652342774546</sessionId>
<command xsi:type="GroupAccessDeviceGetListRequest" xmlns="">
<serviceProviderId>pws_ent</serviceProviderId>
<groupId>pws_grp</groupId>
</command>
</BroadsoftDocument>
<==========================
**** Received response (Request process time: 1304 ms)
==========>
<?xml version="1.0" encoding="ISO-8859-1"?>
<BroadsoftDocument protocol="OCI" xmlns="C" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<sessionId xmlns="">172.16.30.3,460141958,1652342774546</sessionId>
<command echo="" xsi:type="GroupAccessDeviceGetListResponse"
....<snipped_response>...
Provisionar em XSP/ADP
Exemplo de configuração se desejar enviar a solicitação por push através do XSP/ADP (172.16.30.71) e usar o OCS (porta 2208).
loginId - admin
password - admin
inputXMLFile - /Commands/pws_GroupAccessDeviceGetListRequest.xml
host - 172.16.30.71
port - 2208
connection - OCS
./startASOCIClient.sh admin admin -i ./Commands/pws_GroupAccessDeviceGetListRequest.xml -h 172.16.30.71
-p 2208 -c OCS
Exemplo de registro
Exemplo de log para esse tipo de solicitação visto no PSLog.
2022.05.12 03:43:05:463 EDT | FieldDebug | Generic | BCCT Worker #1
OCI Transaction com.broadsoft.oci.transactions.group.GroupAccessDeviceGetListTransaction read38257
executed.
User: Default Administrator (admin) Authorization Level: System
Start Time: 2022.05.12 03:43:03:616 EDT
End Time: 2022.05.12 03:43:05:463 EDT
Duration: 1847 ms
Informações Relacionadas
Documentation
BW-ASProvisioningInterfaceSpec
Software
Independente da versão - Rel_2022_08_asociclient
Versão 24 - Rel_24_0_asociclient
Versão 23 - Rel_23_asociclient
Versão 22 - Rel_22_asociclient
Feedback