introduction.sgml

H.323网守实现

<sect>Introduction
<p>
<!--
Ce manuel est aussi disponible en Anglais, Portugais et Chinois traditionnel.
La version Anglaise est le document maitre et sera mise a jour en premier.
-->
<sect1>A propos
<p>
<bf>
<url url="http://www.gnugk.org/" name="OpenH323 Gatekeeper - The GNU Gatekeeper">
</bf>
est un projet open-source qui impl&#233;mente un gatekeeper H.323.
Un gatekeeper fournit des services de contr&#244;le d'appel pour les terminaux H.323.
Il s'agit une partie essentielle de la plupart des installations de t&#233;l&#233;phonie
sur internet qui sont bas&#233;es sur la norme H.323.

Selon la recommandation H.323, un gatekeeper doit fournir les services suivants:
<itemize>
<item>Traduction d'Adresse
<item>Contr&#244;le d'Admissions
<item>Contr&#244;le de Bande Passante
<item>Gestion de Zone
<item>Call Control Signaling
<item>Autorisation d'Appel
<item>Gestion de Bande Passante
<item>Gestion des Appels
</itemize>

Le GNU Gatekeeper impl&#233;mente la plupart des fonctions bas&#233;es sur
la pile du procole
<url url="http://sourceforge.net/projects/openh323" name="OpenH323">

La recommandation H.323 est une norme internationale publi&#233;e par l'
<url url="http://www.itu.int/" name="ITU">.
Il s'agit d'une norme de communication pour l'audio, vid&#233;o et donn&#233;es sur Internet.
Voir aussi
<url url="http://www.packetizer.com/voip/h323/papers/primer" name="l'introduction &#224; la s&#233;rie de normes H.323">.
de Paul Jones.

Pour une description de ce que fait un gatekeeper, voir
<url url="http://www.iec.org/online/tutorials/h323/topic06.html" name="ici">.

<sect1>Copyright
<p>
Il est couvert par la
<htmlurl url="http://www.gnu.org/licenses/gpl.html" name="GNU General Public License"> (GNU GPL).
En suppl&#233;ment de celle-ci, nous autorisons explicitement de lier ce code
&#224; la librairie OpenH323 et OpenSSL.

D'une mani&#232;re g&#233;n&#233;rale, la GNU GPL vous autorise &#224; copier,
distribuer, revendre ou modifier les logiciels, mais elle requi&#232;re que toutes
les cr&#233;ations d&#233;riv&#233;es soient aussi publi&#233;es sous GNU GPL.
Ceci signifie que vous devez publier tout le code source de toutes les extensions
&#224; gatekeeper et de tous les programmes qui incluent gatekeeper.
Voir le fichier COPYING pour les d&#233;tails.

Si ce n'est pas ce que vous voulez, vous devez vous interfacer au gatekeeper au
travers du port d'&#233;tat et communiquer par TCP avec lui.
De cette fa&#231;on vous devez seulement int&#233;grer les fonctions de base dans le
gatekeeper (et en fournir les sources) et conserver les autres parties  priv&#233;es
de votre application.

<sect1>Nom
<p>
Le nom exact de ce projet est
<em>OpenH323 Gatekeeper - The GNU Gatekeeper</em>,
en r&#233;sum&#233; <em/GnuGk/.
Merci de ne pas le confondre avec d'autres projets de gatekeeper.

Il y a plusieurs projets gatekeeper open-source bas&#233;s sur la pile de protocole OpenH323.
<itemize>
<item><url url="http://opengatekeeper.sourceforge.net/" name="OpenGatekeeper">
<quote>Un gatekeeper disponible sous MPL. Le projet a &#233;t&#233; inactif pour une certaine dur&#233;e.</quote>
<item><url url="http://sourceforge.net/projects/openh323" name="OpenGK">
<quote>Only in a very primary grades.</quote>
<item><url url="http://www.gnugk.org/" name="OpenH323 Gatekeeper - The GNU Gatekeeper">
<quote>Celui-ci, aussi appel&#233; GnuGk.</quote>
</itemize>

Avoir diff&#233;rents gatekeepers avec des noms similaires embrouille vraiment
la plupart des utilisateurs.
Comme notre "OpenH323 Gatekeeper" &#233;tait le premier sur sc&#232;ne,
ce n'est pas notre faute si d'autres ont choisi des noms similaires.
Mais pour rendre la distinction plus &#233;vidente sans embrouiller encore plus
les gens, nous avons d&#233;cid&#233; de donner un sous-titre au projet
"OpenH323 Gatekeeper - The GNU Gatekeeper" et commenc&#233; &#224;
utiliser <tt/gnugk/ comme nom pour les ex&#233;cutables.

<sect1>Caract&#233;ristiques
<p>
La version 2.2.2 contient les caract&#233;ristiques et corrections suivantes:

<itemize>
<item>
New FileIPAuth module in the contrib/ipauth directory.

<item>
Call accounting updates/call disconnect handling is now more robust
and does not lock the whole call table and (effectively) the gatekeeper
for long time periods.

<item>
Do not support mutiple rewrite targets, as this feature does not work well
if rewrite is performed more than once.

<item>
The gatekeeper could crash if the connection was closed before
the welcome message has been sent to the client.

<item>
Different Username was reported during Setup auth
and acct step, if no sourceAddress has been present for an unregistered call.

<item>
More missing config reload locks added to allow seamless config reload.

<item>
La valeur par d&#233;faut de la variable de configuration <tt/ForwardOnFacility/ a &#233;t&#233; chang&#233;e &#224; <tt/0/.

<item>
Possibilit&#233; d'encoder tous les mots de passe dans la configuration. Nouvelle variable de
configuration<tt/EncrypAllPasswords/, utilisation &#233;tendue de la variable de configuration <tt/KeyFilled/.

<item>
La possibilit&#233; de lire les param&#232;tres de configuration depuis une base SQL
a &#233;t&#233; port&#233;e depuis la branche 2.0.
Lire <ref id="sqlconf" name="[SQLConfig]"> pour de plus amples informations.

<item>
Framed-IP-Address ne pouvait pas &#234;tre d&#233;termin&#233; pour les appels non
enregistr&#233;s sans champ, Setup-UUIE.sourceCallSignalAddress, ce qui fait
&#233;chouer l'authentification.

<item>
Fournit une gestion ad&#233;quate des alias du type partyNumber
(e164Number ou privateNumber).

<item>
Une correction pour RTP/Q931/H245/T120PortRange pour corriger une anomalie avec
le bouclage du domaine des ports si le dernier port est 65535. Ceci amenait le
port suivant &#224; &#234;tre mis &#224; 0 et les allocation ult&#233;rieures de
port &#233;chouaient.

<item>
L'allocation dynamique de ports RTP ne marchait pas, utilise un domaine de ports
fig&#233; 1024-65535 comme valeur par d&#233; pour la variable de configuration
<tt/RTPPortRange/.

<item>
Les modules auth obsol&#232;tes MySQLAliasAuth et MySQLPasswordAuth sont supprim&#233;s.

<item>
Les modules SQL acceptent un seul serveur de base de donn&#233;es dans le param&#232;tre <tt/Host/.
</itemize>

<p>
La version 2.2.1 contient les caract&#233;ristiques et corrections suivantes:

<itemize>
<item>
Am&#233;lioration de la correspondance des pr&#233;fixes pour les politiques de routage.
Un point (<tt/./) correspond &#224; n'importe quel chiffre.

<item>
Am&#233;lioration de la correspondance des voisins.
Un point (<tt/./) correspond &#224; n'importe quel chiffre.
<tt/!/ au d&#233;but d&#233;sactive le pr&#233;fixe.

<item>
Un verrou manquant pendant le rechargement de la configuration faisait crasher le gatekeeper.

<item>
S&#233;lection plus fiable de num&#233;ro de port pour les plages de port de
Q.931, H.245, T.120 et RTP (avant, un rechargement de la configuration pouvait
cause des erreurs pour beaucoup d'appels &#224;, cause de l'impossibilit&#233;
d'allouer une nouvelle socket).

<item>
La valeur par d&#233;faut de RTPPortRange est maintenant de laisser l'OS
s&#233;lectionner un num&#233;ro de port.

<item>
R&#232;gles de r&#233;&#233;criture plus flexibles (global et par passerelle)
avec les nouveaux caract&#232;res wildcard '.' et '%'.

<item>
Am&#233;lioration de la correspondance des pr&#233;fixes pour les passerelles.
Un point (<tt/./) correspond &#224; n'importe quel chiffre.
<tt/!/ au d&#233;but d&#233;sactive le pr&#233;fixe.

<item>
Ins&#232;re le Calling-Party-Number-IE/Display-IE manquant si les otpions
correspondantes <tt/Screen.../ sont activ&#233;es.

<item>
Arr&#234;te le gatekeeper si il y a des erreurs dans la configurationd es
modules SQL aut/acct

<item>
Le type de num&#233;ro Called-Station-Id peut &#234;tre s&#233;lectionn&#233;
entre le num&#233;ro original (num&#233;ro compos&#233;) et le num&#233;ro
r&#233;&#233;crit. Nouvelle option de configurgation <tt/UseDialedNumber/ pour les
modules <ref id="radauth" name="RadAuth">/<ref id="radaliasauth" name="RadAliasAuth">
/<ref id=radacct name="RadAcct">, nouvelle variable %{Dialed-Number} pour les modules
<ref id=sqlacct name="SQLAcct"> et <ref id=fileacct name="FileAcct">.

<item>
Possibilit&#233; de modifier les formats d'horodate. Nouvelle variable de configuration
<tt/TimestampFormat/ pour les parties main, <ref id="sqlacct" name="[SqlAcct]">, 
<ref id="radacct" name="[RadAcct]">, <ref id="fileacct" name="[FileAcct]">
et <ref id="calltable" name="[CallTable]">.

<item>
Les modules RadAuth/RadAliasAuth peuvent maintenant ajouter/supprimer des
alias de terminaux pendant l'enregistrement de terminaux (en utilisant
h323-ivr-in=terminal-alias: Cisco AV-Pair).

<item>
Nouvelle option <tt/TcpKeepAlive/ pour r&#233;gler le probl&#232;me avec les
erreurs r&#233;seau et les appels bloqu&#233;s dans la table d'appel. Voir
docs/keepalive.txt pour de plus amples informations.

<item>
Nouvelle commande du port d'&#233;tat <tt/RouteToGateway/.

</itemize>

<p>
La version 2.2.0 contient les caract&#233;ristiques et corrections suivantes:

<itemize>