Documentazione BQN
Documentazione BQN

Oltre a RADIUS e REST, i dati degli abbonati possono essere recuperati da una serie di sistemi di fatturazione supportati.

Le integrazioni di fatturazione supportano solo indirizzi IPv4.

Azotel

Il BQN recupera i dati del bucket del cliente e ne ricava i limiti di velocità da applicare(uploadrate e downloadrate).

Per attivare Azotel, nella GUI BQN andare su Configurazione->RADIUS/REST/Fatturazione->Sistemi di fatturazione, selezionare Azotel e abilitare lo switch.

Per l'accesso REST/JSON ad Azotel sono necessari anche un utente e una password, che devono essere creati nel sistema Azotel con accesso consentito dall'indirizzo IP BQN. Vedere la documentazione di Azotel qui.

Il BQN utilizzerà il suo indirizzo di gestione per le interrogazioni di Azotel, ma si tenga presente che se il BQN raggiunge Azotel tramite Internet, Azotel vedrà un indirizzo IP pubblico e questo è quello che dovrà essere autorizzato dal sistema Azotel.

Nella GUI BQN, configurare anche l'indirizzo IP del sistema Azotel o il nome del server e il numero di porta (443 per impostazione predefinita).

I clienti Azotel in uno stato diverso da "corrente" saranno bloccati (sono considerati privi di un abbonamento valido). È possibile modificare questo comportamento in un comportamento non bloccante disabilitando l'interruttore Blocca abbonati inattivi/non paganti.

Gestfy

Gestfy utilizza l'API REST di BQN. Vedere il capitolo API REST .

Soluzione ISPS

ISPSolution utilizza l'API REST di BQN. Vedere il capitolo API REST .

Microwisp

Microwip utilizza RADIUS. Vedere il capitolo Interfaccia RADIUS.

Powercode

Per attivare Powercode nella GUI BQN, andare su Configurazione->RADIUS/REST/Fatturazione->Sistemi di fatturazione, selezionare Powercode e abilitare l'interruttore.

Fornire l'indirizzo IP del sistema Powercode o il nome del server e il numero della porta SSH (22 per impostazione predefinita).

Il server BQN necessita di un accesso SSH al server Powercode utilizzando un utente/una password Unix.

Nel sistema Powercode, sono necessari un utente e una password MySQL. Se l'utente/password MySQL è diverso dall'utente/password Unix, questo deve essere specificato in Credenziali MySQL nella GUI BQN. L'utente MySQL deve avere accesso in lettura alle seguenti tabelle del database MySQL di Powercode:

  • Servizi
  • InternetInfo
  • Attrezzatura
  • Cliente
  • Servizi al cliente
  • IndirizzoCampo

I clienti Powercode in uno stato diverso da "Attivo" vengono bloccati (sono considerati privi di un abbonamento valido). È possibile modificare questo comportamento in un comportamento non bloccante disabilitando l'interruttore Blocca abbonati inattivi/non paganti.

Powercode REST-API

La fatturazione di Powercode limita l'API REST a tre richieste al secondo. Per questo motivo, l'integrazione preferita è quella che utilizza l'accesso MySQL descritto nella sezione precedente. REST-API può essere utilizzato quando non è possibile utilizzare MySQL e il numero di abbonati è basso (mille o meno).

Il BQN recupera le apparecchiature CPE di una determinata categoria (1 per impostazione predefinita). Per gli abbonati con tale categoria di apparecchiature, recupera i limiti tariffari del loro servizio Internet ("internetInfo").

Per attivare Powercode, andare su Configurazione->Dati abbonati esterni->Sistemi di fatturazione, selezionare Powercode e abilitare l'interruttore.

È necessaria anche una chiave API. La chiave API deve essere creata nel sistema Powercode, con accesso consentito dall'indirizzo IP del BQN (il BQN utilizzerà il suo indirizzo di gestione per le richieste di Powercode).

Fornire anche l'indirizzo IP del sistema Powercode o il nome del server e il numero di porta (444 per impostazione predefinita).

Se la categoria delle apparecchiature CPE nel database Powercode è diversa da 1, modificarla. È possibile specificare più di una categoria digitando i numeri di categoria separati da spazi (ad esempio, "10 11 12" per le categorie 10, 11 e 12).

Sonar

Sonar v2 è supportato (quello con API GraphQL).

Il BQN recupera le tariffe dei clienti e i limiti di velocità da applicare.

Per attivare l'integrazione Sonar, andare su Configurazione->RADIUS/REST/Fatturazione ->Sistemi di fatturazione nella GUI BQN, selezionare Sonar e abilitare l'interruttore.

È necessaria una chiave API. Deve essere creata nel sistema Sonar. Per maggiori dettagli, consultare la documentazione di Sonar.

Infine, nella GUI BQN, configurare l'indirizzo IP del sistema Sonar o il nome del server e il numero di porta (443 per impostazione predefinita) in Configurazione->RADIUS/REST/Fatturazione ->Sistemi di fatturazione, con Sonar selezionato e abilitato.

I clienti Sonar con il campo account_status->namecon un valore diverso da "Attivo" vengono bloccati (sono considerati privi di un abbonamento valido). È possibile modificare questo comportamento in un comportamento non bloccante, disabilitando l'interruttore Blocca abbonati inattivi/non paganti.

Splynx

Il BQN recupera le tariffe del cliente, i limiti di velocità da applicare e le tariffe di burst, insieme alle soglie di burst e alla durata del burst.

Per attivare Splynx nell'interfaccia grafica BQN, andare su Configurazione->RADIUS/REST/Fatturazione->Sistemi di fatturazione, selezionare Splynx e abilitare lo switch.

Saranno necessari una chiave API e un segreto. Devono essere creati nel sistema Splynx con le seguenti impostazioni:

  • Abilita l'autorizzazione di base per questa chiave.
  • Lasciare vuoto l'elenco Allowed per gli IP o includere l'indirizzo IP del BQN. Il BQN utilizzerà il suo indirizzo di gestione per le query di Splynx, ma tenete presente che se il BQN raggiunge Splynx tramite Internet, Splynx vedrà un indirizzo IP pubblico che dovrà essere autorizzato dal sistema Splynx.
  • Aggiungere le autorizzazioni di visualizzazione per le voci del database Piani tariffari ->Internet e Clienti->Clienti online.

Le schermate seguenti mostrano la CHIAVE API e i permessi di accesso:

Nella GUI BQN, configurare anche l'indirizzo IP del sistema Splynx o il nome del server e il numero di porta (443 per impostazione predefinita).

I clienti Splynx con "1" nel campo bloccato vengono bloccati (sono considerati privi di un abbonamento valido). È possibile modificare questo comportamento in un comportamento non bloccante disabilitando l'interruttore Blocca abbonati inattivi/non paganti.

UISP

È disponibile un plug-in open source su github. È supportato dalla comunità (nessun supporto ufficiale). Utilizza l'API REST di BQN.

Visp.net

Il BQN recupera la tariffa del cliente e ne ricava i limiti di velocità da applicare e le velocità di burst, le soglie e la durata.

Per attivare Visp, andare in Configurazione->RADIUS/REST/Fatturazione ->Sistemi di fatturazione, selezionare Visp e abilitare lo switch.

Per richiedere i token API temporali è necessario fornire al BQN un id e un segreto del cliente, un nome utente e una password validi. L'id del client è unico per ogni installazione di Visp. Un utente è uno qualsiasi degli account utente validi in quel client per accedere al sistema.

The provided IP address or server name will be used, along with the port (443 by default), to requests API tokens (https://<server>:<port>/token) and also to send API queries (https://<server>:<port>/graphql).  

La schermata seguente mostra un esempio di configurazione di Visp:

I clienti Visp con "8" o "9" nel loro campo di stato saranno bloccati( rispettivamente in stato disospensione e ibernazione , sono considerati privi di un abbonamento valido). È possibile modificare questo comportamento in un comportamento non bloccante disabilitando l'interruttore Blocca abbonati inattivi/non paganti.

WISPControl

WISPControl utilizza RADIUS. Vedere il capitolo Interfaccia RADIUS.

Wisphub

Wisphub ha sviluppato un'integrazione con BQN utilizzando BQN REST API. Vedere la documentazione del prodotto Wisphub qui.

Wispro

Il BQN recupera clienti, contratti e piani per applicare i limiti di velocità.

Per attivare Visp, andare in Configurazione->RADIUS/REST/Fatturazione->Sistemi di fatturazione, selezionare Wispro e abilitare lo switch.

È necessario fornire una chiave API valida. La chiave API deve essere generata nel sistema Wispro. Vedere le istruzioni qui.

The provided IP address or server name will be used, along with the port (443 by default), to send API queries to Wispro (https://<server>:<port>/api/v1).  

La schermata seguente mostra un esempio di configurazione di Wispro:

Verranno bloccati solo i clienti Wispro con contratti in stato disattivato . È possibile cambiare questo comportamento in non bloccante disabilitando l'interruttore Blocca abbonati inattivi/non paganti.

I seguenti campi della fatturazione Wispro possono essere utilizzati come fonte dell'ID dell'abbonato:

  • Nome.
  • Indirizzo MAC.
  • Accesso (campo "e-mail" nel client Wispro).

 

precedente
AVANTI