php-doc-en/reference/radius/reference.xml
Hannes Magnusson c030e2adf7 Upgrade to DocBook5:
- All id attributes are now xml:id
 - Add docbook namespace to all root elements
 - Replace <ulink /> with <link xlink:href />
 - Minor markup fixes here and there


git-svn-id: https://svn.php.net/repository/phpdoc/en/trunk@238160 c90b9560-bf6c-de11-be94-00142212c4b1
2007-06-20 22:25:43 +00:00

93 lines
3.4 KiB
XML

<?xml version="1.0" encoding="iso-8859-1"?>
<!-- $Revision: 1.4 $ -->
<!-- Purpose: remote.auth -->
<!-- Membership: pecl, external -->
<reference xml:id="ref.radius" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<title>Radius</title>
<titleabbrev>radius</titleabbrev>
<partintro>
<section xml:id="radius.partintro">
&reftitle.intro;
<para>
This package is based on the libradius of FreeBSD. This PECL adds full
support for Radius Authentication
(<link xlink:href="&url.rfc;2865">RFC 2865</link>) and Radius Accounting
(<link xlink:href="&url.rfc;2866">RFC 2866</link>). 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
<link xlink:href="&url.libradius;">here</link>. A detailed description of the
configuration file can be found <link xlink:href="url.libradius.conf">here</link>.
</para>
</note>
</section>
&reference.radius.configure;
&reference.radius.constants;
<section xml: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 xml: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 <link
xlink:href="mailto:mbretter@php.net">mbretter@php.net</link>.
Binaries for Windows can be downloaded from <link xlink:href="http://www.bretterklieber.com/php">here</link>.
</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
-->