php-doc-en/reference/radius/reference.xml

<?xml version="1.0" encoding="iso-8859-1"?>
<!-- $Revision: 1.3 $ -->
<!-- Purpose: remote.auth -->
<!-- Membership: pecl, external -->

<reference id="ref.radius">
 <title>Radius</title>
 <titleabbrev>radius</titleabbrev>

 <partintro>
  <section id="radius.partintro">
   &reftitle.intro;
   <para>
    This package is based on the libradius of FreeBSD. This PECL adds full
    support for Radius Authentication
    (<ulink url="&url.rfc;2865">RFC 2865</ulink>) and Radius Accounting 
    (<ulink url="&url.rfc;2866">RFC 2866</ulink>). This package is available
    for Unix (tested on FreeBSD and Linux) and for Windows.
   </para>
   <note>
    <para>
     An exact description for libradius can be found
     <ulink url="&url.libradius;">here</ulink>. A detailed description of the
     configuration file can be found <ulink url="url.libradius.conf">here</ulink>.
    </para>
   </note>
  </section>

  &reference.radius.configure;
  &reference.radius.constants;

  <section id="radius.howtostart">   
   <title>Quickstart</title>
   <para>
    Howto start?
    <itemizedlist>
     <listitem><simpara>get a radius resource</simpara></listitem>
     <listitem><simpara>configure the library</simpara></listitem>
     <listitem><simpara>create the request</simpara></listitem>      
     <listitem><simpara>put attributes</simpara></listitem>
     <listitem><simpara>send the request</simpara></listitem>
     <listitem><simpara>receive attributes</simpara></listitem> 
     <listitem><simpara>close the radius resource (optional)</simpara></listitem>
    </itemizedlist>
    Take also a look at the examples in this package.
   </para>
   <para>
    The package contains an example php script. This script demonstrates howto
    authenticate with radius using PAP or CHAP (md5). If you authenticate with 
    Microsoft Radius servers then its not possible to use CHAP (md5). If you
    would like to authenticate with Microsoft Servers you have to use
    MS-CHAPv1 or MS-CHAPv2, but its more complicated, because you need md4,
    sha1 and des to generate the right data. The enclosed examples demonstrate
    all authentication-methods, including MS-CHAPv1 and MS-CHAPv2. To get the
    MS-CHAP to work you need the <link linkend="ref.mcrypt">mcrypt</link> and
    the <link linkend="ref.mhash">mhash</link> extension, starting with
    version 1.2 of the package, the mcrypt extension is no longer needed.
   </para>
  </section>

  <section id="radius.contact">
     <title>Contact Information</title>
     <para>
     If you have comments, bugfixes, enhancements or want to help
     to develop this you can send me a mail at  <ulink
     url="mailto:mbretter@php.net">mbretter@php.net</ulink>. 
     Binaries for Windows can be downloaded from <ulink url="http://www.bretterklieber.com/php">here</ulink>.
     </para>
   </section>
 </partintro>
      
&reference.radius.functions;

 </reference>  
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
sgml-omittag:t
sgml-shorttag:t
sgml-minimize-attributes:nil
sgml-always-quote-attributes:t
sgml-indent-step:1
sgml-indent-data:t
sgml-parent-document:nil
sgml-default-dtd-file:"../../../manual.ced"
sgml-exposed-tags:nil
sgml-local-catalogs:nil
sgml-local-ecat-files:nil
End:
vim600: syn=xml fen fdm=syntax fdl=2 si
vim: et tw=78 syn=sgml
vi: ts=1 sw=1
-->