betz Thu Jun 16 14:30:03 2005 EDT
Added files:
/phpdoc/en/reference/kadm5 .cvsignore constants.xml reference.xml
Log:
move kadm5 docs form peardoc
http://cvs.php.net/co.php/phpdoc/en/reference/kadm5/.cvsignore?r=1.1&p=1
Index: phpdoc/en/reference/kadm5/.cvsignore
+++ phpdoc/en/reference/kadm5/.cvsignore
functions.xml
http://cvs.php.net/co.php/phpdoc/en/reference/kadm5/constants.xml?r=1.1&p=1
Index: phpdoc/en/reference/kadm5/constants.xml
+++ phpdoc/en/reference/kadm5/constants.xml
<?xml version="1.0" encoding="iso-8859-1"?>
<!-- $Revision: 1.1 $ -->
<section id="kadm5.constants">
&reftitle.constants;
&extension.constants;
<section id="kadm5.constantsAF">
<title>Constants for Attribute Flags</title>
<para>
The functions <function>kadm5_create_principal</function>,
<function>kadm5_modify_principal</function>, and
<function>kadm5_modify_principal</function> allow to specify
special attributes using a bitfield. The symbols are defined below:
<table>
<title>Attributes for use by the KDC</title>
<tgroup cols="1">
<thead>
<row>
<entry>constant</entry>
</row>
</thead>
<tbody>
<row>
<entry>KRB5_KDB_DISALLOW_POSTDATED</entry>
</row>
<row>
<entry>KRB5_KDB_DISALLOW_FORWARDABLE</entry>
</row>
<row>
<entry>KRB5_KDB_DISALLOW_TGT_BASED</entry>
</row>
<row>
<entry>KRB5_KDB_DISALLOW_RENEWABLE</entry>
</row>
<row>
<entry>KRB5_KDB_DISALLOW_PROXIABLE</entry>
</row>
<row>
<entry>KRB5_KDB_DISALLOW_DUP_SKEY</entry>
</row>
<row>
<entry>KRB5_KDB_DISALLOW_ALL_TIX</entry>
</row>
<row>
<entry>KRB5_KDB_REQUIRES_PRE_AUTH</entry>
</row>
<row>
<entry>KRB5_KDB_REQUIRES_HW_AUTH</entry>
</row>
<row>
<entry>KRB5_KDB_REQUIRES_PWCHANGE</entry>
</row>
<row>
<entry>KRB5_KDB_DISALLOW_SVR</entry>
</row>
<row>
<entry>KRB5_KDB_PWCHANGE_SERVER</entry>
</row>
<row>
<entry>KRB5_KDB_SUPPORT_DESMD5</entry>
</row>
<row>
<entry>KRB5_KDB_NEW_PRINC</entry>
</row>
</tbody>
</tgroup>
</table>
</para>
</section>
<section id="pecl.kadm5.constantsOP">
<title>Constants for Options</title>
<para>
The functions <function>kadm5_create_principal</function>,
<function>kadm5_modify_principal</function>, and
<function>kadm5_get_principal</function> allow to specify or return
principal's options as an associative array. The keys for the associative
array are defined as string constants below:
<table>
<title>Options for creating/modifying/retrieving principals</title>
<tgroup cols="2">
<thead>
<row>
<entry>constant</entry>
<entry>funcdef</entry>
<entry>description</entry>
</row>
</thead>
<tbody>
<row>
<entry>KADM5_PRINCIPAL</entry>
<entry>long</entry>
<entry>The expire time of the princial as a Kerberos timestamp.</entry>
</row>
<row>
<entry>KADM5_PRINC_EXPIRE_TIME</entry>
<entry>long</entry>
<entry>The expire time of the princial as a Kerberos timestamp.</entry>
</row>
<row>
<entry>KADM5_LAST_PW_CHANGE</entry>
<entry>long</entry>
<entry>The time this principal's password was last changed.</entry>
</row>
<row>
<entry>KADM5_PW_EXPIRATION</entry>
<entry>long</entry>
<entry>
The expire time of the principal's current password, as a Kerberos
timestamp.
</entry>
</row>
<row>
<entry>KADM5_MAX_LIFE</entry>
<entry>long</entry>
<entry>
The maximum lifetime of any Kerberos ticket issued to this principal.
</entry>
</row>
<row>
<entry>KADM5_MAX_RLIFE</entry>
<entry>long</entry>
<entry>
The maximum renewable lifetime of any Kerberos ticket issued to or
for this principal.
</entry>
</row>
<row>
<entry>KADM5_MOD_NAME</entry>
<entry>string</entry>
<entry>
The name of the Kerberos principal that most recently modified this
principal.
</entry>
</row>
<row>
<entry>KADM5_MOD_TIME</entry>
<entry>long</entry>
<entry>
The time this principal was last modified, as a Kerberos timestamp.
</entry>
</row>
<row>
<entry>KADM5_KVNO</entry>
<entry>long</entry>
<entry>The version of the principal's current key.</entry>
</row>
<row>
<entry>KADM5_POLICY</entry>
<entry>string</entry>
<entry>The name of the policy controlling this principal.</entry>
</row>
<row>
<entry>KADM5_CLEARPOLICY</entry>
<entry>long</entry>
<entry>
Standard procedure is to assign the 'default' policy to new
principals. KADM5_CLEARPOLICY suppresses this behaviour.
</entry>
</row>
<row>
<entry>KADM5_LAST_SUCCESS</entry>
<entry>long</entry>
<entry>The KDC time of the last successfull AS_REQ.</entry>
</row>
<row>
<entry>KADM5_LAST_FAILED</entry>
<entry>long</entry>
<entry>The KDC time of the last failed AS_REQ.</entry>
</row>
<row>
<entry>KADM5_FAIL_AUTH_COUNT</entry>
<entry>long</entry>
<entry>The number of consecutive failed AS_REQs.</entry>
</row>
<row>
<entry>KADM5_RANDKEY</entry>
<entry>long</entry>
<entry>
Generates a random password for the principal. The parameter
<parameter>password</parameter> will be ignored.
</entry>
</row>
<row>
<entry>KADM5_ATTRIBUTES</entry>
<entry>long</entry>
<entry>A bitfield of attributes for use by the KDC.</entry>
</row>
</tbody>
</tgroup>
</table>
</para>
</section>
</section>
<!-- 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
indent-tabs-mode:nil
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
-->
http://cvs.php.net/co.php/phpdoc/en/reference/kadm5/reference.xml?r=1.1&p=1
Index: phpdoc/en/reference/kadm5/reference.xml
+++ phpdoc/en/reference/kadm5/reference.xml
<?xml version="1.0" encoding="iso-8859-1"?>
<!-- $Revision: 1.1 $ -->
<reference id="ref.kadm5">
<title>KADM5</title>
<titleabbrev>kadm5</titleabbrev>
<partintro>
<section id="kadm5.intro">
&reftitle.intro;
<simpara>
These package allows you to access Kerberos V administration servers.
You can create, modify, and delete Kerberos V principals and policies.
</simpara>
<simpara>
More information about Kerberos can be found at <ulink
url="&url.kerberos.info;">&url.kerberos.info;</ulink>.
</simpara>
<simpara>
Documentation for Kerberos and KADM5 can be found at <ulink
url="&url.kerberos.docs;">&url.kerberos.docs;</ulink>.
</simpara>
</section>
<!-- &reference.kadm5.constants; -->
<section id="kadm5.examples">
&reftitle.examples;
<para>
This simple example shows how to connect, query, print
resulting principals and disconnect from a KADM5 database.
<example>
<title>KADM5 extension overview example</title>
<programlisting role="php">
<![CDATA[
<?php
$handle = kadm5_init_with_password("afs-1", "GONICUS.LOCAL", "admin/admin",
"password");
print "<h1>get_principals</h1>\n";
$principals = kadm5_get_principals($handle);
for( $i=0; $i<count($principals); $i++)
print "$principals[$i]<br>\n";
print "<h1>get_policies</h1>\n";
$policies = kadm5_get_policies($handle);
for( $i=0; $i<count($policies); $i++)
print "$policies[$i]<br>\n";
print "<h1>get_principal [EMAIL PROTECTED]</h1>\n";
$options = kadm5_get_principal($handle, "[EMAIL PROTECTED]" );
$keys = array_keys($options);
for( $i=0; $i<count($keys); $i++) {
$value = $options[$keys[$i]];
print "$keys[$i]: $value<br>\n";
}
$options = array(KADM5_PRINC_EXPIRE_TIME => 0);
kadm5_modify_principal($handle, "[EMAIL PROTECTED]", $options);
kadm5_destroy($handle);
?>
]]>
</programlisting>
</example>
</para>
</section>
<section id="kadm5.contact">
<title>Contact Information</title>
<para>
If you have comments, bugfixes, enhancements or want to help
developping this you can send me a mail at
<ulink url="mailto:&email.hburbach;">&email.hburbach;</ulink>.
The project homepage can be found at
<ulink url="&url.kadm5;">&url.kadm5;</ulink>.
</para>
</section>
</partintro>
&reference.kadm5.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
indent-tabs-mode:nil
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
-->
