Integração ACS

Introdução

A integração do sistema com o ACS facilita a comunicação direta entre ambos, tornando-se essencial para o gerenciamento remoto e a sincronização de dispositivos CPE (Customer Premises Equipment) compatíveis com o protocolo TR-069.

Acesso ao formulário:

Caminho: Meu Sistema → Provedor → ACS → Integração → Novo.

Nesta documentação compreende-se que o termo Sistema é relacionado ao Sistema IXC Soft.

Entrega de Valor

• Gerenciamento centralizado de dispositivos CPE;
• Configuração automática de equipamentos;
• Monitoramento em tempo real do status dos dispositivos;
• Redução de custos operacionais e visitas técnicas;

Estrutura da Configuração

Campos Obrigatórios

Campo	Descrição
ID	Identificação do registro, gerada automaticamente pelo sistema.
Integração	Lista apenas a integração com o ACS.
Nome	Nome da integração que está sendo criada.
Usuário API	ID do usuário API registrado no servidor do ACS.
IP	IP do domínio do servidor ACS, podendo ser IPv4 ou IPv6.
Permitir remoção automática dos dispositivos	Se este campo estiver marcado como Sim, a exclusão de um dispositivo no ACS resultará também em sua exclusão no IXC, e vice-versa. Se marcado como Não, essa exclusão mútua não ocorrerá.

Geração da Chave Pública (IXC Provedor)

1. Acesse o menu Sistema → Provedor
2. Clique em ACS
3. Selecione Integração
4. Clique em Novo
5. Preencha os campos:
   • Selecione o tipo da integração
   • Nome da Integração
   • Endereço IP do servidor IXC ACS
6. Salve as configurações
7. Copie a chave pública gerada

Cadastro da Integração no IXC ACS

1. Acesse o sistema IXC ACS
2. Vá para Sistema → Clientes API
3. Clique em Novo cliente API
4. Preencha os campos:
   • Nome da integração
   • Cole a chave pública gerada no Sistema
   • Tempo de expiração de token: 50000
   • Limite de requisições por dia: 50000
   • Limite de requisições por minuto: 5000
5. Salve as configurações
6. Configure as permissões de cliente API
7. Copie o ID e insira na opção Usuário API do Sistema
8. Salve e sincronize

Adição de Dispositivos

1. No Sistema, acesse Provedor → ACS → Integrações
2. Selecione a opção Dispositivos
3. Adicione os dispositivos que serão gerenciados pela integração
4. No ACS, acesse o módulo Ferramentas → Integrações;
5. Localize a integração com o IXC Provedor e clique em Sincronizar.

Criação Automática de Dispositivos

Quando um novo dispositivo é inserido no ACS, seus dados são transmitidos para o sistema IXC Provedor, que então interpreta essas informações e cria um novo registro na tabela de dispositivos. Caminho: Menu Sistema → Provedor → ACS → Dispositivos. As informações de login do contrato são automaticamente vinculadas ao dispositivo ACS criado.

Para assegurar que o registro foi criado no IXC, o sistema envia uma notificação via API ao ACS com os dados do plano de velocidade, confirmando o sucesso.

O vínculo do dispositivo com o login só ocorrerá quando:

• O campo pppLogin estiver preenchido no sistema (IXC Provedor).
• Caso contrário, o sistema buscará o MAC para verificar se ele corresponde ao dispositivo no ACS antes de realizar o vínculo.

O login não será vinculado quando:

• Os campos pppLogin e MAC estiverem vazios.
• O vínculo não ocorrerá apenas com base no IP do dispositivo.

Exclusão de Dispositivos

Ao excluir um dispositivo no sistema, uma requisição automática é enviada para o ACS, garantindo que todas as informações vinculadas ao equipamento, como número de série, MAC, IP, modelo e servidor ACS, sejam removidas. Além disso, o ACS elimina a associação entre o login e o plano de velocidade vinculado ao CPE, garantindo uma gestão mais precisa dos dispositivos conectados à rede. Esse processo evita inconsistências no gerenciamento da infraestrutura, proporcionando maior controle e organização ao provedor.

Caso ocorra algum erro na exclusão do dispositivo, será exibido um pop up com a mensagem:

O dispositivo foi excluído no IXC Provedor, porém, devido a uma falha na comunicação, não foi possível notificar o ACS sobre essa remoção.

Atualização em Massa de Firmware

ATENÇÃO

A atualização de firmware está disponível apenas dentro do sistema do IXC ACS

Fluxos de trabalho

sequenceDiagram
    participant IXCProvedor
    participant IXC_ACS
    participant CPE
    IXCProvedor->>IXC_ACS: Configura Integração
    IXC_ACS->>IXCProvedor: Confirma Integração
    CPE->>IXC_ACS: Solicita Configuração
    IXC_ACS->>IXCProvedor: Consulta Parâmetros
    IXCProvedor->>IXC_ACS: Envia Configurações
    IXC_ACS->>CPE: Aplica Configurações

Considerações Finais

Após concluir essas etapas, a integração entre Sistema e IXC ACS estará configurada. Certifique-se de testar a comunicação entre os sistemas.

Etiquetas

Integracao IXCACS TR069 Provedor cwmp TR181

Leia Também

• Monitoramento de Hosts
• Dispositivos Acs
• Histórico de Operações