Skip to end of metadata
Go to start of metadata

You are viewing an old version of this content. View the current version.

Compare with Current View Version History

« Previous Version 7 Next »

cropped-logo-isp-1-1.png

Essa documentação trata da integração com o sistema ISP Gestión. A integração é realizada através de chamadas de API partindo do Integrador e utilizando a API disponibilizada pelo OZmap.

Tipo de Integração

A integração OZmap-ISP Gestión é do tipo Passiva-direta, desenvolvida pela equipe ISP Gestión.

Descrição

O ISP Gestión é um sistema de Gestão (ERP) focado no controle de rede, servidor radius, controle financeiro e múltiplas opções para gerenciamento dos ISPs.

As funcionalidades desta integração entre OZmap e ISP Gestión ocorrem a partir da vinculação de uma rede criada no ISP Gestión com um projeto existente no OZmap, e tem como foco principal a criação, cancelamento e conexão de Clientes no OZmap.

Resumo de funcionalidades

Funcionalidade

Descrição

Direção da integração

Criação de Clientes no OZmap

Criação de Clientes no OZmap, com base na ativação do equipamento no ISP Gestión.

ISP Gestión => OZmap

Cancelamento de Clientes no OZmap

Remoção de clientes no OZmap, através do cancelamento de ou desligamento do equipamento no ISP Gestión.

ISP Gestión => OZmap

Atualização de Caixa, Splitter e Porta de Clientes no OZmap

Replica a informação de Caixa/Splitter/Porta do equipamente no ISP Gestión ao Cliente no OZmap.

ISP Gestión => OZmap

Funcionalidades

Abaixo serão descritas as funcionalidades apresentadas no resumo de forma a entender como funciona o fluxo de sincronização.

Criação de Clientes no OZmap

A criação de Clientes no OZmap a partir do ISP Gestión requer, inicialmente, que um equipamento esteja vinculado a um nó de rede no ISP Gestión. No contexto do ISP Gestión, um nó de rede é uma localização específica dentro de uma rede que pode abrigar diversos equipamentos. Por exemplo, em uma rede de fibra óptica, um nó pode ser um Centro de Processamento de Dados (CPD), onde estão localizados roteadores, switches e a OLT. Em outro cenário, um nó pode ser uma torre que contém múltiplos pontos de acesso (APs).

Para que a criação de um Cliente no OZmap seja possível, o nó de rede no ISP Gestión deve estar vinculado a uma rede que, por sua vez, esteja associada a um projeto no OZmap. Esse vínculo entre a rede do ISP Gestión e o projeto OZmap pode ser realizado durante a criação da rede no ISP Gestión, onde é possível selecionar o projeto OZmap ao qual a rede será vinculada. Alternativamente, é possível editar uma rede já existente no ISP Gestión para vinculá-la a um projeto OZmap.

Após garantir que no ISP Gestión o nó de rede esteja devidamente vinculado a uma rede associada a um projeto OZmap, o próximo passo é vincular esse nó a um equipamento. A seguir, o passo a passo para realizar essas ações:

  • Para realizar esse vínculo no ISP Gestión, abra o menu referente a conexão e na aba "Redes", dentro da seção "Dados generales", selecione a rede que foi vinculada ao projeto OZmap.

  • Após isso, ainda no ISP Gestión, deve ser realizado o vínculo do equipamento a essa nó de rede que foi vinculada a rede correspondente ao projeto OZmap. Para realizar esse vínculo, abra o menu do Cliente, acesse a aba “General” e na seção “Rede” selecione a conexão que foi vinculada a rede OZmap.

Após realizar esse vínculo no ISP Gestión entre um equipmaneto e um nó de rede, o processo para criação do Cliente no OZmap ocorre da seguinte forma:

  • Obrigatoriamente deve ser preenchido no ISP Gestión as coordeandas de instalação do equipamento, no menu do equipamento na aba “Datos instalación", na seção “COORDENADAS DE INSTALACIÓN", para que ao realizar a criação do Cliente no OZmap o mesmo seja criado nas coordenadas registradas no ISP Gestión.

  • Após registrar as coordenadas do equipamento no ISP Gestión, será possível acessar a aba “OZmap” no seu menu, nesta aba será possível ativar o equipamente a partir do “Alta equipo”. Ao ativar o equipamente o Cliente será criado no OZmap e será possível visualizar seu ID na aba "OZmap” do ISP Gestión.

  • Com o Cliente OZmap já criado e o equipamento ativo no ISP Gestión, será possível realizar a criação de sua propriedade no OZmap, com isso, na mesma aba "OZmap” no menu do equipamento no ISP Gestión, a partir do botão “ALTA DE PROPRIEAD”. Ao ser criada a propriedade, também será possível visualizar seu ID nessa mesma aba.

Cancelamento de Clientes no OZmap

A remoção do Cliente no OZmap pode ocorrer da seguinte forma:

  • Desativando a Propriedade no ISP Gestión

    • No menu do Cliente acessando a aba “OZmap” haverá o botão “BAJA DE PROPRIEDAD”, que caso acionado realizará a desconexão do equipamento no ISP Gestión, e com isso a Propriedade e o Cliente serão removidos no OZmap.

Conexão de Cliente no OZmap

Quando um equipamento no ISP Gestión está vinculado a um Cliente e a uma Propriedade OZmap, é possível associar uma Caixa e uma Porta a esse equipamento a partir do ISP Gestión. Durante a edição das informações de CTO no ISP Gestión, o sistema exibirá as Caixas disponíveis no OZmap. Ao selecionar uma dessas Caixas, os Splitters correspondentes e as portas disponíveis serão mostrados para seja possível escolher a conexão desejada.

Após a seleção das informações de CTO no ISP Gestión, os dados serão replicados no OZmap. Consequentemente, a Propriedade vinculada ao equipamento será conectada automaticamente à Caixa, ao Splitter, e à Porta selecionados no ISP Gestión.

Com a conexão já estabelecida no OZmap, nos dados de CTO no ISP Gestión também será possível visualizar o valor do sinal de potência a partir das informações do OZmap.

Dados Acesso

Dados de acesso necessários para as operações realizadas pelo integrador são:

Saiba mais como configurar esses dados acionando o suporte do ISP Gestión.

OZmap

Parâmetro

Descrição

Exemplo

API URL

Endereço da API OZmap

https://cliente.ozmap.com.br:9994/api/v2

Token

Token associado a conta do usuário de integração cadastrado no OZmap. (O usuário deve ter acesso aos projetos que a integração irá trabalhar (Escolha do usuário). Tutorial de como gerar usuário/chave.)

eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJtb2R1bGUiOiJhcGkiLCJ1c2VyIjoiNWQ5ZjNmYjgyMDAxNDEwMDA2NDdmNzY4IiwiY3JlYXRpb25EYXRlIjoiMjAyMC0wOC0yNFQxNjoxMjoyMS43MTdaIiwiaWF0IjoxNTk6Mjg1NTQxfQ.S215vbHlBLtZSzxmORIc2sH1lEKi5VALKBqZB1VcFCE

Liberação de IPs

Caso o servidor OZmap esteja em ambiente ON-Premisses, é necessário liberar nos firewalls o IP do servidor onde está o ISP Gestión para acessar as portas 80 e 9994 no ambiente do OZmap.

Caso seu servidor seja hospedado pelo OZmap, essas portas já estarão liberadas para o integrador.

Questionário

Pergunta

Resposta

Funcionalidade

  • No labels