kadm5_modify_principal(3) [php man page]

KADM5_MODIFY_PRINCIPAL(3)						 1						 KADM5_MODIFY_PRINCIPAL(3)

kadm5_modify_principal - Modifies a kerberos principal with the given parameters

SYNOPSIS

       bool kadm5_modify_principal (resource  $handle, string  $principal, array  $options)

DESCRIPTION

	Modifies a $principal according to the given $options.

PARAMETERS

	      o $handle
		- A KADM5 handle.

	      o $principal
		- The principal.

	      o $options
		-  It  is  possible  to  specify  several  optional  parameters  within  the  array  $options.	Allowed are the following options:
		KADM5_PRINC_EXPIRE_TIME,  KADM5_PW_EXPIRATION,	KADM5_ATTRIBUTES,  KADM5_MAX_LIFE,  KADM5_KVNO,  KADM5_POLICY,	KADM5_CLEARPOLICY,
		KADM5_MAX_RLIFE.  KADM5_FAIL_AUTH_COUNT.

RETURN VALUES

	Returns TRUE on success or FALSE on failure.

EXAMPLES

       Example #1

	      Example of modifying principal

	      <?php

	      $handle = kadm5_init_with_password("afs-1", "GONICUS.LOCAL", "admin/admin", "password");

	      $attributes = KRB5_KDB_REQUIRES_PRE_AUTH;
	      $options = array(KADM5_PRINC_EXPIRE_TIME => 3451234,
			       KADM5_POLICY => "gonicus",
			       KADM5_ATTRIBUTES => $attributes);

	      kadm5_modify_principal($handle, "burbach@GONICUS.LOCAL", $options);

	      kadm5_destroy($handle);
	      ?>

SEE ALSO

       kadm5_create_principal(3), kadm5_delete_principal(3).

PHP Documentation Group 												 KADM5_MODIFY_PRINCIPAL(3)

KADM5_INIT_WITH_PASSWORD(3)						 1					       KADM5_INIT_WITH_PASSWORD(3)

kadm5_init_with_password - Opens a connection to the KADM5 library

SYNOPSIS

       resource kadm5_init_with_password (string  $admin_server, string  $realm, string  $principal, string  $password)

DESCRIPTION

	Opens  a  connection  with  the  KADM5	library  using	the  $principal  and  the  given  $password to obtain initial credentials from the
       $admin_server.

PARAMETERS

	      o $admin_server
		- The server.

	      o $realm
		- Defines the authentication domain for the connection.

	      o $principal
		- The principal.

	      o $password
		- If $password is omitted or is NULL, a random key will be generated.

RETURN VALUES

	Returns a KADM5 handle on success or FALSE on failure.

EXAMPLES

       Example #1

	      KADM5 initialization example

	      <?php

	      $handle = kadm5_init_with_password("afs-1", "GONICUS.LOCAL", "admin/admin", "password");

	      $attributes = KRB5_KDB_REQUIRES_PRE_AUTH | KRB5_KDB_DISALLOW_PROXIABLE;
	      $options = array(KADM5_PRINC_EXPIRE_TIME => 0,
			       KADM5_POLICY => "default",
			       KADM5_ATTRIBUTES => $attributes);

	      kadm5_create_principal($handle, "burbach@GONICUS.LOCAL", "password", $options);

	      kadm5_destroy($handle);
	      ?>

NOTES

       Note

	       Connection should be closed after use with kadm5_destroy(3).

SEE ALSO

       kadm5_destroy(3).

PHP Documentation Group 											       KADM5_INIT_WITH_PASSWORD(3)