Wiki source code of AsteriskMinUserConf
Version 13.1 by cg on 2014/10/08 13:22
Show last authors
| author | version | line-number | content |
|---|---|---|---|
| 1 | = Configuration d'un utilisateur pour la téléphonie sur LDAP = | ||
| 2 | |||
| 3 | Les comptes de téléphonie individuels sont maintenus dans LDAP. | ||
| 4 | Voici rapidement le minimum de config à gérer | ||
| 5 | |||
| 6 | Le Mapping entre les mots clef de la config d'asterik et les atributs ldap se fait dans le fichier [[/etc/asterisk/res_ldap.conf >> res_ldap.conf]] | ||
| 7 | |||
| 8 | == Classes == | ||
| 9 | |||
| 10 | |||
| 11 | Pour qu'Asterisk puisse gérer un utilisateur il doit appartenir aux classes suivantes : | ||
| 12 | |||
| 13 | * **AsteriskExtension** : c'est la classe de base, celle qui dit que l'on a une existence dans le dialplan d'asterisk .. | ||
| 14 | Y ecrire correspond a créer une nouvelle extension dans {{{ /etc/asterisk/extensions.conf }}}. | ||
| 15 | Elle est de toute façon la classe parente des classes suivantes et donc a ce titre incontournable. | ||
| 16 | * **AsteriskSIPUser** : celle ci dépends de la première, elle décrit le compte SIP et la façon dont il va interagir avec asterisk | ||
| 17 | Y ecrire revient à créer un nouveau compte ( peer user ou friend ) dans sip.conf ( et/ou user.conf ). Elle contient les attributs minimums pour définir un compte personnel de téléphonie. | ||
| 18 | * **AsteriskVoicemail** : Cette classe permet de définir les attributs basiques et avancés ( pour le basique on aurait pu se contenter des classes précedentes ) du voicemail. Les attributs quelle contient vont permettre une gestion avancées des options de boite vocales. | ||
| 19 | |||
| 20 | == Attributs == | ||
| 21 | |||
| 22 | Voici les attributs a ne pas manquer. Le ''"mapping"'' entre les directives de configuration asterisk et les attributs LDAP se fait dans le fichier {{{ /etc/asterisk/res_ldap.conf }}}. Certains de ces attributs peuvent donc devenir obsolètes si le "mapping" est revu. | ||
| 23 | |||
| 24 | Les autres directives asterisk imperatives sont prises en charge dans la config en tant qu'options par défaut. | ||
| 25 | |||
| 26 | === AsteriskExtension === | ||
| 27 | |||
| 28 | |||
| 29 | L'équivalent d'une extension dans extensions.conf on peut s'en passer si le dialplan contient une extension par défaut du type exten => 1XXX,1,dial(SIP/${EXTEN}) mais les renseigner peux permettre une gestion plus fine par utilisateur ... | ||
| 30 | |||
| 31 | * **AstExtension :** l'extension appelée (le numéro de téléphone) | ||
| 32 | * **AstContext :** le contexte dans lequel cette extension sera trouvé ( internal pour tout les utilisateurs de l'eisti ) | ||
| 33 | * **AstPriority :** généralement 1 dans le cas présent ( cela correspond a la première ligne d'une extension dans extension.conf ) | ||
| 34 | * **AstApplication :** l'application utilsée ( Dial Gosub !VoiceMailMain etc... ) | ||
| 35 | * **AstApplicationData :** Les paramètres de l'application ( un compte sip, dans le cas de Dial par exemple ) | ||
| 36 | |||
| 37 | === AsteriskSIPUser === | ||
| 38 | |||
| 39 | Description du compte SIP | ||
| 40 | |||
| 41 | * **AstAccountHost :** positionner a dynamic pour que le compte ne soit pas lié a une une adresse ip fixe ... | ||
| 42 | * **AstAccountType :** positionner à friend ( entrant et sortant ) | ||
| 43 | * **AstAccountName :** nom du compte sip .... définit l'existence du compte sip en tant que canal | ||
| 44 | * **AstAccountSecret :** le mot de passe du compte SIP (pour enregistrer le téléphone sur le serveur) . | ||
| 45 | * **AstAccountContext :** le contexte entrant du compte sip et passé par défaut aux applications ( le contexte du voicemail est géré par exemple dans AstVMContext ...) valeurs staff ou international-staff | ||
| 46 | * **AstAccountMailBox :** définit la boite par défaut pour les messages vocaux. | ||
| 47 | * **AstAccountCallerID:** Le caller id du compte ... typiquement '''''Prénon Nom, <N°telephone>''''' | ||
| 48 | |||
| 49 | * **AstAccountSubscribeContext:** mappé par {{{ subscribecontext }}} positionné a '''BLF_Group_1''' pour le monitoring des lignes en temps réel ( touches rapides, standard ... ) | ||
| 50 | * **AstAccountCallLimit :** mappé par {{{call-limit}}} ( utile pour la gestion des BLF avec grandstream notament ) . Le positionner a 20 si il doit l'être. | ||
| 51 | * **AstAccountRegistrationServer :** Serveur d'enregistrement du compte ,permet a l'application de provisioning des téléphones de transmettre le bon registrar à ces derniers. | ||
| 52 | |||
| 53 | ==== Les attributs suivants ne sont pas a remplir mais doivent impérativement être correctement mappés pour l'enregistrement des comptes. ==== | ||
| 54 | |||
| 55 | * **AstAccountPort :** Le port Sip utilisé | ||
| 56 | * **AstAccountIPAddress :** L'adresse ip du client | ||
| 57 | * **AstAccountExpirationTimeStamp :** date d'expiration du bail ( il est renouvelé toute les 60 secondes environ ) | ||
| 58 | * **AstAccountLastQualifyMilliseconds :** stocke lui aussi une donnée temporelle . il est mappé dans res_ldap.conf par le mot clef {{{lastms}}} | ||
| 59 | * **AstAccountFullContact :** | ||
| 60 | * **AstAccountUserAgent :** User Agent du dernier téléphone enregistré | ||
| 61 | * **AstAccountFullContact :** chaine de contact protocol:Account@ipaddress:Port;stuff | ||
| 62 | |||
| 63 | |||
| 64 | |||
| 65 | === AsteriskVoicemail === | ||
| 66 | |||
| 67 | * **AstVMPassword :** Le mot de passe permettant d'écouter ses messages vocaux. | ||
| 68 | * **AstVMEmail :** Permettra de définir l'e-mail ou envoyer les notifications/messages. | ||
| 69 | il faut y copier le mail officiel de l'utilisateur. ( l'attribut mail pouvant être multiple Asterisk prend la dernière valeur ce qui n'est pas toujours pertinent ) | ||
| 70 | * **AstVMContext :** Le contexte de voicemail de l'utilisateur (staff) | ||
| 71 | * **AstVMMailbox :** L'attribut définissant la boite mail de l'utilisateur ( dans le contexte précité ) | ||
| 72 | * **AstVMAttach :** (yes/no) Définit si le message vocal sera attaché a l'email | ||
| 73 | * **AstVMDelete :** (yes/no) Définit si le message vocal sera effacé de la boite mail une fois envoyé | ||
| 74 | |||
| 75 | === Attributs Classiques === | ||
| 76 | |||
| 77 | Ceux qui sont mappés par res_ldap.conf et conditionne le bon foctionnement du compte de téléphonie | ||
| 78 | |||
| 79 | * **displayName :** le nom d'affichage. Il est utilisé en tant qu'identité par le VoiceMail et l'application d'annuaire ( Directory ). Il est mappé par le mot {{{ fullname }}} dans [[res_ldap.conf]] | ||
| 80 | * ''pager :'' Non obligatoire utilisé éventuellement par le [[Téléphonie.VoiceMail]] pour un notification de reception de message | ||
| 81 | |||
| 82 | ==== Les attributs suivants on étés remplacés (voir plus haut) ==== | ||
| 83 | |||
| 84 | * **mail :** l'e-mail utilisé par le VoiceMail pour envoyer notifications et./ou messages. Asterisk utilise pour le moment le dernier e-mail de la liste ... ce qui n'est pas toujours le plus pertinent .. d'où l'utilisation d'une classe supplémentaire et d'un autre attribut. | ||
| 85 | |||
| 86 |