Este documento contém uma apresentação sobre como realizar a integração do sistema IXCProvedor com a plataforma de TR-069 IXC ACS.
Primeiramente é necessário que você tenha o IXC ACS já instalado em uma máquina com os serviços rodando e homologados.
Para fazer a integração é ideal que inicie-se fazendo as configurações dentro do IXCProvedor primeiro, como no passo-a-passo:
Na página principal do IXCProvedor, siga as etapas abaixo para cadastrar as informações necessárias na integração ACS:
- Acesse o menu Provedor.
- Selecione a opção ACS.
- Em seguida, clique em Integração.
Na página de Integração, você verá a lista de integrações disponíveis. Localize a opção relacionada à ACS e clique no botão Novo para cadastrar as informações necessárias.
Ao clicar em Novo, você será direcionado para uma nova página ou formulário onde poderá inserir os detalhes da integração ACS.
Neste primeiro passo iremos cadastrar o nome para identificação da integração e o endereço de IP do servidor IXC ACS e salvar.
Após isto será gerado uma chave pública que utilizaremos na comunicação com o IXC ACS, copie toda a chave para a utilização mais adiante.
Integrando o IXCProvedor no IXC ACS
Com os passos anteriores concluídos, agora vamos acessar a seção "Clientes API" no IXC ACS. Siga as instruções abaixo:
- Acesse o sistema IXC ACS.
- Vá para a seção "Sistema".
- Procure a opção "Clientes API" e clique nela.
Criaremos uma nova integração para comunicar o IXC ACS com o IXCProvedor;
No campo de cadastro será necessário preencher o nome da integração, a chave pública gerado no IXCProvedor e também os seguintes campos com estas informações:
Tempo de expiração de token: 50000
Limite de requisições por dia: 50000
Limite de requisições por minuto: 5000
Para efetivar a comunicação, será necessário deixar o WebHook ativo, aceitar o certificado invalido, então devemos preencher o WebHook URL e salvar:
WebHook URL: https://IP_DO_SEU_IXC/api-module/acs/webhook; (por padrão será esse endereço, basta inserir o endereço IP do seu IXCProvedor) .
Após salvar as configurações do seu Usuário API do IXC ACS, na aba básico o sistema irá gerar um ID para seu usuário.
Esse ID será utilizado no cadastro do ACS no seu IXCProvedor, então devemos copiá-lo. Após isso, você pode acessar o seu IXCProvedor e preencher o ID que na integração que cadastramos no IXCProvedor no campo "Usuário API" e salvar as alterações.
Após ter concluído os passos anteriores e estabelecido a comunicação entre os sistemas, você pode prosseguir para sincronizar os dispositivos. Siga as instruções abaixo:
- Acesse o menu "Provedor" no IXCProvedor.
- Em seguida, clique em "ACS" e selecione a opção "Integrações".
- No submenu "Integrações", escolha a opção "Dispositivos".
Na página de "Dispositivos", você encontrará opções relacionadas à sincronização e gerenciamento dos dispositivos na integração com o ACS.
