documentation:adsl-fdn

Différences

Ci-dessous, les différences entre deux révisions de la page.

Lien vers cette vue comparative

Les deux révisions précédentes Révision précédente
Prochaine révision
Révision précédente
documentation:adsl-fdn [2017/08/03 01:22]
sthibaul [Déménagement de ligne]
documentation:adsl-fdn [2022/04/25 23:29] (Version actuelle)
sthibaul [Retrouver une ligne]
Ligne 1: Ligne 1:
-=====Inscription dans le SI de FDN=====+===== Inscription dans le SI de FDN =====
  
   * Pour l'instant, il faut remplir le [[https://vador.fdn.fr/souscription/adhesion.cgi|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   * Pour l'instant, il faut remplir le [[https://vador.fdn.fr/souscription/adhesion.cgi|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 à elfabixx, Benjamin-, _domi_, lulu, ou spyou+  * Il faut alors envoyer un courriel à **services** arobase **fdn.fr** 
-    * le login adhacc-XXX obtenu (section Identifiants de connexion sur vador) +    * le login adhacc-xxxx 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 :) +    * Un trigramme (i.e. 3 lettres) yyy 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+    * 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 (ou bien indiquer le login voulu, et la sortie de "mkpasswd -m sha-512"). On veut garder des comptes séparés par personne pour savoir qui pinguer sur IRC, et éviter que quelqu'un garde accès indéfiniment.
     * le choix entre tarification "marque blanche" ou "collecte groupée"     * le choix entre tarification "marque blanche" ou "collecte groupée"
 +    * Une adresse mail de contact pour être prévenu des changements sur la collecte (tarification, API, etc.)
   * qui va alors mettre à jour   * qui va alors mettre à jour
-    * le cgi +    * la liste contact-fai-locaux@lists.fdn.fr 
-    * l'authen (passwd, group) +    * le cgi: s'inspirer d'un /var/www/souscription/subs-yyy.cgi existant, penser à remplacer dedans les 2 occurrences du trigramme 
-    * le subs.cfg +    * l'authen: ajouter les paires login/passwd dans /var/www/users/htpasswd et créer un groupe yyy contenant les logins dans /var/www/users/htgroup 
-    * le subs/subs.cfg (oui, c'est pervers, il y a un deuxième fichier) +    * Dans /etc/fdn/adsl/le subs.cfg : ajouter une section [yyy] avec notamment client-id xxx et le bon tarif 
-    * la config apache (mapper le groupe sur le cgi) +    * le subs/subs.cfg (oui, c'est pervers, il y a un deuxième fichier): ajouter une section formglob-subsyyy], l'action étant subs-yyy.cgi 
-    * vérifier la grille tarifaire associée au compte+    * la config apache /etc/apache2/conf.d/adsl.conf: (require group yyy pour *-yyy.cgi), et faire reload pour que ce soit pris en compte 
 +    * le type d'adhérent pour le tarif: marque blanche ou collecte 
 +    * vérifier la grille tarifaire associée au compte (<<< où est-ce ? y a-t-il vraiment quelque chose à faire ?)
  
-====Authentification des lignes ADSL====+==== Authentification des lignes ADSL ====
  
-Les logins seront de la forme bob.sinclair/monsuperfai@fdn.nerim+Les logins seront de la forme bob.sinclair%monsuperfai@fdn.dslnet.fr
  
   * 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 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   * Soit le FAI préfère que FDN héberge l'authentification
 +
 +==== Retrouver une ligne ====
 +
 +Si un adhérent ne connait que l'adresse, on peut utiliser ''https://vador.fdn.fr/souscription/souscription.cgi?etape=ndinconnu'' pour retrouver les numéros correspondant. On peut aussi utiliser les APIs documentées ci-dessous pour faire son propre formulaire de recherche de ND
 +
 +=== Recherche d'un ND ===
 +
 +Les gens qui déménagent ne connaissent souvent pas le numéro de téléphone de la ligne du nouveau logement, seulement l'adresse. L'interface en JSON à ''https://vador.fdn.fr/souscription/cherche-nd.cgi'' permet de récupérer un numéro à partir d'une adresse, en passant en paramètres:
 +
 +  * ''?etape=cherche\_nd&city=paris&zip=75002&street=mandar&street\_nb=10''
 +
 +Le paramètre ''street\_nb'' est optionnel.
 +
 +Cela ne retourne par contre pas les numéros en liste rouge, seulement leur nombre dans nb_rouges
 +
 +=== Recherche de noms de villes / de rues ===
 +
 +Pour limiter les problèmes de saisie, il est utile de mettre un peu de javascript pour montrer une liste de villes et de rues pendant la saisie. Pour ça on peut utiliser l'interface ''https://vador.fdn.fr/souscription/cherche-ville.cgi'', en passant en paramètres:
 +
 +  * ''?etape=cherche\_ville&query=test''
 +
 +On peut ajouter le paramètre ''&zip=33400'' pour limiter à un code postal.
 +
 +De même, l'interface ''https://vador.fdn.fr/souscription/cherche-rue.cgi'' retourne des rues, en passant en paramètres:
 +
 +  * ''?etape=cherche\_rue&query=toto&city=bla&zip=12345''
 +
 +Note: il faut mettre à la fois la ville et le code postal pour que le filtrage puisse fonctionner, sinon il retourne pour toute la France.
 +
 +Seuls 100 résultats au plus sont retournés pour éviter de surcharger le tout.
 +
 +Pour un exemple d'utilisation de ces interfaces, cf par exemple le site de FDN: https://vador.fdn.fr/souscription/souscription.cgi?numadh=&etape=ndinconnu et surtout son script de branchement de typeahead: https://vador.fdn.fr/souscription/typeahead-link.js
 +
 +=== Liste des immeubles d'un CP ===
 +
 +Pour récupérer la liste des immeubles correspondant à un code postal, on peut utiliser l'interface ''https://vador.fdn.fr/souscription/cp-batiments.cgi'' en passant en paramètres:
 +
 +  * ''?etape=cp_batiments&zip=75002&city=paris''
 +
 +=== Coordonnées GPS d'une adresse et des bâtiments ===
 +
 +Pour pouvoir montrer une jolie carte, on peut récupérer les coordonnées GPS d'une adresse donnée avec l'interface ''https://vador.fdn.fr/souscription/adr-gps.cgi'' en passant en paramètres l'adresse:
 +
 +  * ''?etape=adr\_gps&city=paris&zip=75002&street=mandar&street\_nb=10''
 +
 +On peut également récupérer les coordonnées GPS des bâtiments avec l'interface ''https://vador.fdn.fr/souscription/gps-batiments.cgi'' en passant en paramètres la fenêtre GPS à utiliser:
 +
 +  * ''?etape=gps_batiments&lat1=48.857&lat2=48.859&lon1=2.294&lon2=2.296''
 +
 +=== Recherche d'un PTO ===
 +
 +On peut récupérer la liste des PTO d'un bâtiment avec la structuration de l'immeuble avec l'interface ''https://vador.fdn.fr/souscription/batiment-info.cgi'' en passant en paramètre la référence d'immeuble à utiliser:
 +
 +  * ''etape=batiment_info&refimmeuble=IMB/ABCD/1234''
 +
  
 ====Éligibilité des lignes==== ====Éligibilité des lignes====
 +
 +=== Éligibilité ===
  
 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 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
Ligne 31: Ligne 91:
 (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...) (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 (noteseulement quand FDN l'aura aussi activé de son côté).+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
 + 
 +Cela retourne du JSON, de la forme 
 + 
 +  { 
 +    "info_ligne":{"length":"1234"}, 
 +    "offres":
 +      {"debit":"18M","reserve":"affaiblissement important","fas":"78.00 E TTC","abo":"39.20 E TTC","code_offre":18MLiazoOrangeNu"}, 
 +      ... 
 +    ], 
 +    "erreur":0, 
 +    "rejets":"<p>Dégroupage Nerim non disponible</p>\n" 
 +  } 
 + 
 +i.e. une partie donnant des informations techniques sur la ligne: la longueur ; puis un tableau des différentes offres, avec le débit download, une éventuelle réserve technique sur la disponibilité de l'offre, les tarifs (fas et abo), et le code à utiliser pour la commande ; puis une éventuelle erreur (numéro non attribué, etc.) ; et un détail technique sur la raison des indisponibilités des offres non indiquées. Les codes sont de différentes formes: 
 + 
 +  * xxopt0 : dégroupé partiel Nerim 
 +  * xxopt1 : dégroupé partiel SFR / Nerim 
 +  * xxopt3 ou 5 : non-dégroupé Orange / Nerim 
 +  * xxLiazoOrange : non-dégroupé Orange / Liazo 
 +  * xxLiazoOrangeNu : dégroupé totalement Orange / Liazo 
 +  * xxLiazoKosc : FTTH Kosc / Liazo 
 + 
 +où xx peut être 128k, 512k, 512RE, 1M, 2M, 3M, 4M, 5M, 6M, 8M, 18M, 80M, 300M, 1G 
 + 
 +=== Fibre Kosc === 
 + 
 +Pour obtenir les résultats fibre Kosc, il faut ajouter `&ftth=1` pour l'activer, et ajouter l'information `&refimmeuble=IMB/truc/machin` pour donner la référence d'immeuble précise. On peut l'obtenir avec l'api ''https://vador.fdn.fr/souscription/gps-batiments.cgi'' ci-dessus, ou en utilisant https://cartefibre.arcep.fr/ 
 + 
 +=== Info sur un ND ===
  
 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 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''+  * ''?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é. 
 + 
 +Pour les numéros de pré-câblés, indiquez le numéro à 20 caractères 42CXN0000... comme numéro de téléphone, et utilisez ''&typend=precab''
 + 
 +Pour le FTTH, il faut ajouter la référence d'immeuble et le code postal 
 + 
 +  * ''&refimmeuble=IMB/TRUC/MACH&zip=12345'' 
 + 
 +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. 
  
-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é, et 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==== ====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+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 en minuscules. Le principe, c'est
  
-  * Le FAI local doit vérifier l'éligibilité de la ligne à l'aide du JSON ou autre.+  * Le FAI local doit vérifier l'éligibilité de la ligne à l'aide du JSON ou autre. **ATTENTION** ! La sélection d'un débit inapproprié entraînera un retard dans le traitement de la commande (et fera perdre beaucoup de temps à celui qui s'occupe de valider les commandes chez FDN).
   * Le FAI local reçoit et traite les papiers de l'adhérent comme il entend (automatisé ou non).   * 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.+  * 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, en général il ne vaut mieux pas mettre directement l'adresse email de l'adhérent, mais lui relayer les informations.
   * La commande atterrit chez FDN pour validation.   * La commande atterrit chez FDN pour validation.
 +  * Envoyer un mail à suivi-adsl arobase fdn.fr pour confirmer la commande de la ligne.
  
 ====Suivi de ligne==== ====Suivi de ligne====
  
-Pour l'instant, l'interface /adherents habituelle. Plus tard peut-être des interfaces sans mise en page pour parser facilement.+Pour l'instant, l'interface https://vador.fdn.fr/adherents habituelle. Plus tard peut-être des interfaces sans mise en page pour parser facilement.
  
 ====Facturation lignes ADSL==== ====Facturation lignes ADSL====
Ligne 59: Ligne 159:
 ====Déménagement de ligne==== ====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+Si l'abonné transporte aussi son abonnement téléphonique RTC, 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.+
  
 +Ensuite c'est en fait juste une résiliation + nouvel abonnement.
 ====Résiliation de ligne==== ====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. Sinonla 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 "transitnon utilisée ; la partie collecte couvre de toutes façons tout le bi-mois.+==Nérim== 
 + 
 +Nérim facture FDN au **bimestre** et FDN doit envoyer la résiliation auprès de Nérim avant le 15 du deuxième mois du bimestre. Il faut donc envoyer à suivi-adsl@ le numéro de téléphone de la ligne à résilier avant cette date en prenant en compte le temps de prise en compte de la demande par FDN. Sinon, la facturation continuera sur le bimestre 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 bimestre. 
 + 
 +==Ielo-Liazo== 
 + 
 +FDN peut demander une résiliation chez Ielo-Liazo au plus tard 2 jours **ouvrés** avant la fin du mois, pour leur permettre de faire le nécessaire. Il faut donc envoyer à suivi-adsl@ le numéro de téléphone de la ligne à résilier avant cette date en prenant en compte le temps de prise en compte de la demande par FDN. Sinon la facturation continuera sur le 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 mois.
  
 =====Outils===== =====Outils=====
Ligne 73: Ligne 178:
 Aquilenet fournit quelques outils et formulaires. Aquilenet fournit quelques outils et formulaires.
  
 +  * Documentation https://atelier.aquilenet.fr/projects/si/wiki/Installation_dolibarr
   * Partie web - git clone http://git.aquilenet.fr/tools.git   * Partie web - git clone http://git.aquilenet.fr/tools.git
   * Partie dolibarr - git clone http://git.aquilenet.fr/tools-dolibarr.git   * Partie dolibarr - git clone http://git.aquilenet.fr/tools-dolibarr.git
Ligne 98: Ligne 204:
  
   * https://gitorious.org/si-fai   * https://gitorious.org/si-fai
-  * git clone https://git.gitorious.org/si-fai/si-fai.git+  * git clone https://git.gitorious.org/si-fai/si-fai.gi
  • documentation/adsl-fdn.1501716179.txt.gz
  • Dernière modification: 2017/08/03 01:22
  • de sthibaul