documentation:adsl-fdn

**Ceci est une ancienne révision du document !**

Inscription dans le SI de FDN

  • Pour l'instant, il faut remplir le formulaire d'adhésion à FDN, comme si on adhérait, sauf qu'en fait non, c'est juste pour rentrer dans le SI sans se faire suer à changer le code pour l'instant :) Pensez bien à renseigner la partie prélèvement, il y en aura besoin pour prélever le coût des lignes
  • Il faut alors envoyer en même temps à fsirjean, Benjamin-, domi, ou spyou:
    • le login adhacc-XXX obtenu (section Identifiants de connexion sur vador)
    • Un trigramme (i.e. 3 lettres) que FDN utilisera partout dans son SI, le FAI local peut choisir ce qu'il préfère tant que c'est pas déjà pris :)
    • une paire login / password pour chacun des membres du FAI local qui sera responsable de saisir des commandes de lignes pour leurs adhérent: à donner au format htpasswd
    • le choix entre tarification “marque blanche” ou “collecte groupée”
  • qui va alors mettre à jour
    • le cgi
    • l'authen (passwd, group)
    • le subs.cfg
    • le subs/subs.cfg (oui, c'est pervers, il y a un deuxième fichier)
    • la config apache (mapper le groupe sur le cgi)
    • vérifier la grille tarifaire associée au compte

Authentification des lignes ADSL

Les logins seront de la forme bob.sinclair/monsuperfai@fdn.nerim

  • Soit le FAI a son propre serveur radius, et FDN délègue les authentifications (il faut que le serveur ait une bonne disponibilité, sinon les adhérents ne peuvent plus se connecter !)
  • Soit le FAI préfère que FDN héberge l'authentification

Éligibilité des lignes

Une interface en JSON a été développée: on lui envoie un numéro de téléphone + code postal, et il renvoie la liste des options possibles et autres infos : https://vador.fdn.fr/souscription/eligibilite.cgi avec en paramètre

  • ?etape=eligibilite&tel=0123456789&cp=12345&tarif=blanche pour le tarif “marque blanche”;
  • ou ?etape=eligibilite&tel=0123456789&cp=12345&tarif=collecte pour le tarif “collecte seule”.

(Note: ne rassemblez pas l'URL, pour éviter que les moteurs de recherche du monde entier commencent à tous tester en permanence l'éligibilité de la ligne 0123456789…)

Pour le passage à Liazo, de nouveaux éléments d'éligibilité vont apparaître. Ce n'est pas activé par défaut. C'est activé pour une liste de numéros de téléphone à laquelle vous pouvez demander à si arobase fdn.fr de faire ajouter un numéro, pour vos tests. Une fois que cela fonctionne, vous pouvez ajouter à l'url &liazo=1 pour activer pour tous les numéros (note: cela n'aura effet qu'une fois que FDN l'aura aussi activé de son côté).

Avec la possibilité de dégroupage total, il y a une valse des numéros de désignation d'installation (NDI). Avant, c'était simple, on prenait juste le numéro actif correspondant à l'abonnement France Télécom. Maintenant, c'est plus compliqué, car un numéro peut correspondre à la fois à un abonnement que quelqu'un a emmené avec lui lors d'un déménagement (NDI actif) et à une ligne téléphonique qui n'a pas d'abonnement (NDI inactif). Le hic, c'est que c'est l'adhérent seulement qui peut savoir distinguer lequel est bon. Pour faciliter la vie, il y a une interface en JSON pour récupérer l'adresse: https://vador.fdn.fr/souscription/nd-info.cgi avec en paramètre

  • ?etape=nd_info&tel=0123456789

cela vous retourne l'adresse du NDI, selon qu'il est considéré comme actif, inactif, ou précâblé. Si plusieurs adresses sont retournées, il vous faut faire choisir la bonne par l'abonné. Dans tous les cas, il faut ajouter à la demande d'éligibilité le paramètre &typend=inactif par exemple pour préciser que c'est le numéro inactif qu'il faut tester, sinon c'est possiblement la mauvaise ligne qui sera testée ! Il faudra également choisir le bon type au moment de la commande, sinon, la commande sera livrée au mauvais endroit ! En principe le suivi ADSL de FDN vérifie l'adresse, mais l'erreur est humaine.

Commande de ligne

Un formulaire dédié pour chaque asso permet de commander une ligne en un coup: https://vador.fdn.fr/souscription/subs-XXX.cgi où XXX est le trigramme choisi . Le principe, c'est

  • Le FAI local doit vérifier l'éligibilité de la ligne à l'aide du JSON ou autre.
  • Le FAI local reçoit et traite les papiers de l'adhérent comme il entend (automatisé ou non).
  • Un des membres du bureau du FAI saisit les informations sur un formulaire, c'est là que les paires login/mdp htpasswd vont servir. C'est un CGI tout bête qui fonctionne en GET ou en POST, comme on préfère, cf le formulaire html. Attention, à l'adresse mail seront envoyés les mails standard de FDN, et notamment l'identifiant de commande qui permet d'accéder à toutes les infos de toutes les lignes du FAI local, donc il ne faut pas mettre l'adresse email de l'adhérent.
  • La commande atterrit chez FDN pour validation.

Suivi de ligne

Pour l'instant, l'interface /adherents habituelle. Plus tard peut-être des interfaces sans mise en page pour parser facilement.

Facturation lignes ADSL

Du point de vue de FDN, un FAI est une ligne dans le SI FDN, qui a pleinggg de lignes ADSL, et est donc facturé pour elles (et devra les facturer à ses adhérents s'il veut pas couler). La facturation peut se faire par prélèvement, donc même si le FAI n'adhère pas à FDN, il doit alors envoyer l'autorisation de prélèvement générée lors de l'inscription. La facturation peut aussi se faire par factures, c'est juste plus pénible pour un peu tout le monde.

Déménagement de ligne

Il vaut mieux attendre que la nouvelle ligne soit en place avec tonalité fonctionnelle, sinon ils risquent de se mélanger les pinceaux.

Envoyer à suivi-adsl@ le numéro de téléphone de l'ancienne ligne, et le numéro de téléphone et l'adresse postale de la nouvelle ligne. Les frais d'ouverture de ligne sont facturés au tarif habituel FAS.

Résiliation de ligne

Envoyer à suivi-adsl@ le numéro de téléphone de la ligne à résilier avant la 2e semaine du deuxième mois du bi-mois en cours. Sinon, la facturation continuera sur le bi-mois suivant. Préciser à quelle date couper l'accès, pour qu'il soit déduit de la facturation la partie “transit” non utilisée ; la partie collecte couvre de toutes façons tout le bi-mois.

Outils

Patches welcome !

Aquilenet

Aquilenet fournit quelques outils et formulaires.

CAFAI

Projet de SI

Projet “out of the box”, début de commencement de Spécifications SI.

  • documentation/adsl-fdn.1501763524.txt.gz
  • Dernière modification: 2017/08/03 14:32
  • de sthibaul