# kadm5_init_with_password

(PECL kadm5 >= 0.2.3)

kadm5_init_with_password — Opens a connection to the KADM5 library

### 说明

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

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

### 参数

`admin_server`

  The server.

`realm`

  Defines the authentication domain for the connection.

`principal`

  The principal.

`password`

  If `password` is omitted or is `NULL`, a random key will be generated.

### 返回值

Returns a KADM5 handle on success 或者在失败时返回 `FALSE`.

### 范例

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);
    ?>

### 注释

> Note:

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

### 参见

- kadm5_destroy() - Closes the connection to the admin server and releases all related resources