Benutzer-Werkzeuge

Webseiten-Werkzeuge


tachtler:phpldapadmin_archlinux

phpLDAPadmin ArchLinux

Die Webanwendung phpLDAPadmin (auch bekannt unter dem Namen PLA) ist ein Web basierter LDAP Client. phpLDAPadmin bietet eine einfache, von überall zugreifbare, mehrsprachige Administration für einen z.B. OpenLDAP-Server. phpLDAPadmin verfügt über eine hierarchische Ansicht und die erweiterten Such-Funktionalitäten ermöglichen ein intuitives navigieren und administrieren innerhalb des LDAP-Verzeichnisbaumes.

Ab hier werden zur Ausführung nachfolgender Befehle root-Rechte benötigt. Um der Benutzer root zu werden, melden Sie sich bitte als root-Benutzer am System an, oder wechseln mit nachfolgendem Befehl zum Benutzer root:

$ su -
Password:

Vorbereitung

Zur Installation von phpLDAPadmin

  • phpldapadmin - ist im community-Repository von ArchLinux

enthalten.

Voraussetzungen

Als Voraussetzung für die Installation von phpLDAPadmin sind folgende Komponenten erforderlich:

Siehe auch den externen Link

Nachdem das AUR-Repository von ArchLinux - AUR

erfolgreich eingebunden wurde, können mit nachfolgendem Befehl, die AUR-Pakete -

  • php74
  • php74-cli
  • php74-gettext
  • php74-ldap
  • php74-xml

als Abhängigkeiten installiert werden:

# pikaur --noconfirm -S php74 php74-cli php74-gettext php74-ldap php74-xml

Installationsverlauf

:!: HINWEIS - Aufgrund von anderen Installationen, sind einige benötigte Pakete bereits auf diesem Server installiert!

Mit nachfolgendem Befehl kann überprüft werden, welche Inhalte mit den Paketen php74 php74-cli php74-gettext php74-ldap php74-xml installiert wurden.

# pacman -Qil php74 php74-cli php74-gettext php74-ldap php74-xml

Installierte Dateien

Installation

Zur Installation von phpLDAPadmin wird nachfolgendes Paket benötigt:

  • phpldapadmin - ist im community-Repository von ArchLinux enthalten.

Mit nachfolgendem Befehl, wird das Pakete phpldapdmin installiert:

# pacman --noconfirm -S phpldapadmin

Installationsverlauf

:!: HINWEIS - Aufgrund von anderen Installationen, sind einige benötigte Pakete bereits auf diesem Server installiert!

Mit nachfolgendem Befehl kann überprüft werden, welche Inhalte mit den Paket phpldapadmin installiert wurden.

# pacman -Qil phpldapadmin

Installierte Dateien

Basis-Konfiguration

/etc/webapps/phpldapadmin/config.php

Die Konfigurationsdatei für die Web-Anwendung phpLDAPadmin befindet sich in nachfolgendem Verzeichnis und trägt nachfolgenden Namen:

  • /etc/webapps/phpldapadmin/config.php

Zuerst sollte die Original Konfigurationsdatei mit nachfolgendem Befehl kopiert werden und so gesichert werden:

# cp -a /etc/webapps/phpldapadmin/config.php /etc/webapps/phpldapadmin/config.php.orig

Nachfolgender Befehl kann dazu genutzt werden, ob die Erstellung einer Sicherung der Original Konfigurationsdatei erfolgreich war und sollte eine Ausgabe, wie nachfolgend gezeigt, hervorbringen:

# ls -l /etc/webapps/phpldapadmin
total 56
-rw-r--r-- 1 root root 28359 Dec 21 16:44 config.php
-rw-r--r-- 1 root root 28359 Dec 21 16:44 config.php.orig

Nachfolgend sollen alle relevanten Änderungen an der Konfigurationsdatei dargestellt werden, um die Web-Anwendung phpLDAPadmin mit einem OpenLDAP-Server nutzen zu können.

Siehe dazu auch nachfolgenden internen Link:

Änderungen gegenüber dem Standard an oben genannter Konfigurationsdatei, werden mit nachfolgender Zeile vor der/den geänderten Zeile(n) vorangestellt:

# Tachtler
<?php
/** NOTE **
 ** Make sure that <?php is the FIRST line of this file!
 ** IE: There should NOT be any blank lines or spaces BEFORE <?php
 **/
 
/**
 * The phpLDAPadmin config file
 * See: http://phpldapadmin.sourceforge.net/wiki/index.php/Config.php
 *
 * This is where you can customise some of the phpLDAPadmin defaults
 * that are defined in config_default.php.
 *
 * To override a default, use the $config->custom variable to do so.
 * For example, the default for defining the language in config_default.php
 *
 * $this->default->appearance['language'] = array(
 *  'desc'=>'Language',
 *  'default'=>'auto');
 *
 * to override this, use $config->custom->appearance['language'] = 'en_EN';
 *
 * This file is also used to configure your LDAP server connections.
 *
 * You must specify at least one LDAP server there. You may add
 * as many as you like. You can also specify your language, and
 * many other options.
 *
 * NOTE: Commented out values in this file prefixed by //, represent the
 * defaults that have been defined in config_default.php.
 * Commented out values prefixed by #, dont reflect their default value, you can
 * check config_default.php if you want to see what the default is.
 *
 * DONT change config_default.php, you changes will be lost by the next release
 * of PLA. Instead change this file - as it will NOT be replaced by a new
 * version of phpLDAPadmin.
 */
 
/*********************************************
 * Useful important configuration overrides  *
 *********************************************/
 
/* If you are asked to put PLA in debug mode, this is how you do it: */
#  $config->custom->debug['level'] = 255;
#  $config->custom->debug['syslog'] = true;
#  $config->custom->debug['file'] = '/tmp/pla_debug.log';

/* phpLDAPadmin can encrypt the content of sensitive cookies if you set this
   to a big random string. */
// Tachtler
// default: // $config->custom->session['blowfish'] = null;
$config->custom->session['blowfish'] = '3755425c4a807636d93c87f4467ab7e6';
 
/* If your auth_type is http, you can override your HTTP Authentication Realm. */
// $config->custom->session['http_realm'] = sprintf('%s %s',app_name(),'login');
 
/* The language setting. If you set this to 'auto', phpLDAPadmin will attempt
   to determine your language automatically.
   If PLA doesnt show (all) strings in your language, then you can do some
   translation at http://translations.launchpad.net/phpldapadmin and download
   the translation files, replacing those provided with PLA.
   (We'll pick up the translations before making the next release too!) */
// Tachtler
// default: // $config->custom->appearance['language'] = 'auto';
$config->custom->appearance['language'] = 'de_DE';
 
/* The temporary storage directory where we will put jpegPhoto data
   This directory must be readable and writable by your web server. */
// $config->custom->jpeg['tmpdir'] = '/tmp';     // Example for Unix systems
#  $config->custom->jpeg['tmpdir'] = 'c:\\temp'; // Example for Windows systems

/* Set this to (bool)true if you do NOT want a random salt used when
   calling crypt().  Instead, use the first two letters of the user's
   password.  This is insecure but unfortunately needed for some older
   environments. */
#  $config->custom->password['no_random_crypt_salt'] = true;

/* If you want to restrict password available types (encryption algorithms)
	 Should be subset of:
	 array(
		''=>'clear',
		'bcrypt'=>'bcrypt',
		'blowfish'=>'blowfish',
		'crypt'=>'crypt',
		'ext_des'=>'ext_des',
		'md5'=>'md5',
		'k5key'=>'k5key',
		'md5crypt'=>'md5crypt',
		'sha'=>'sha',
		'smd5'=>'smd5',
		'ssha'=>'ssha',
		'sha256'=>'sha256',
		'ssha256'=>'ssha256',
		'sha384'=>'sha384',
		'ssha384'=>'ssha384',
		'sha512'=>'sha512',
		'ssha512'=>'ssha512',
		'sha256crypt'=>'sha256crypt',
		'sha512crypt'=>'sha512crypt',
		'argon2i'=>'argon2i',
		'argon2id'=>'argon2id',
	 )*/
#  $config->custom->password['available_types'] = array(''=>'clear','md5'=>'md5');

/* PHP script timeout control. If php runs longer than this many seconds then
   PHP will stop with an Maximum Execution time error. Increase this value from
   the default if queries to your LDAP server are slow. The default is either
   30 seconds or the setting of max_exection_time if this is null. */
// $config->custom->session['timelimit'] = 30;
 
/* Our local timezone
   This is to make sure that when we ask the system for the current time, we
   get the right local time. If this is not set, all time() calculations will
   assume UTC if you have not set PHP date.timezone. */
// $config->custom->appearance['timezone'] = null;
// Tachtler
// default: #  $config->custom->appearance['timezone'] = 'Australia/Melbourne';
$config->custom->appearance['timezone'] = 'Europe/Berlin';
 
/*********************************************
 * Commands                                  *
 *********************************************/
 
/* Command availability ; if you don't authorize a command the command
   links will not be shown and the command action will not be permitted.
   For better security, set also ACL in your ldap directory. */
/*
$config->custom->commands['cmd'] = array(
	'entry_internal_attributes_show' => true,
	'entry_refresh' => true,
	'oslinks' => true,
	'switch_template' => true
);
 
$config->custom->commands['script'] = array(
	'add_attr_form' => true,
	'add_oclass_form' => true,
	'add_value_form' => true,
	'collapse' => true,
	'compare' => true,
	'compare_form' => true,
	'copy' => true,
	'copy_form' => true,
	'create' => true,
	'create_confirm' => true,
	'delete' => true,
	'delete_attr' => true,
	'delete_form' => true,
	'draw_tree_node' => true,
	'expand' => true,
	'export' => true,
	'export_form' => true,
	'import' => true,
	'import_form' => true,
	'login' => true,
	'logout' => true,
	'login_form' => true,
	'mass_delete' => true,
	'mass_edit' => true,
	'mass_update' => true,
	'modify_member_form' => true,
	'monitor' => true,
	'purge_cache' => true,
	'query_engine' => true,
	'rename' => true,
	'rename_form' => true,
	'rdelete' => true,
	'refresh' => true,
	'schema' => true,
	'server_info' => true,
	'show_cache' => true,
	'template_engine' => true,
	'update_confirm' => true,
	'update' => true
);
*/
 
/*********************************************
 * Appearance                                *
 *********************************************/
 
/* If you want to choose the appearance of the tree, specify a class name which
   inherits from the Tree class. */
// $config->custom->appearance['tree'] = 'AJAXTree';
#  $config->custom->appearance['tree'] = 'HTMLTree';

/* Just show your custom templates. */
// $config->custom->appearance['custom_templates_only'] = false;
 
/* Disable the default template. */
// $config->custom->appearance['disable_default_template'] = false;
 
/* Hide the warnings for invalid objectClasses/attributes in templates. */
// Tachtler
// default: // $config->custom->appearance['hide_template_warning'] = false;
$config->custom->appearance['hide_template_warning'] = true;
 
/* Set to true if you would like to hide header and footer parts. */
// $config->custom->appearance['minimalMode'] = false;
 
/* Configure what objects are shown in left hand tree */
// $config->custom->appearance['tree_filter'] = '(objectclass=*)';
 
/* The height and width of the tree. If these values are not set, then
   no tree scroll bars are provided. */
// $config->custom->appearance['tree_height'] = null;
#  $config->custom->appearance['tree_height'] = 600;
// $config->custom->appearance['tree_width'] = null;
#  $config->custom->appearance['tree_width'] = 250;

/* Number of tree command icons to show, 0 = show all icons on 1 row. */
// $config->custom->appearance['tree_icons'] = 0;
#  $config->custom->appearance['tree_icons'] = 4;

/* Confirm create and update operations, allowing you to review the changes
   and optionally skip attributes during the create/update operation. */
// $config->custom->confirm['create'] = true;
// $config->custom->confirm['update'] = true;
 
/* Confirm copy operations, and treat them like create operations. This allows
   you to edit the attributes (thus changing any that might conflict with
   uniqueness) before creating the new entry. */
// $config->custom->confirm['copy'] = true;
 
/*********************************************
 * User-friendly attribute translation       *
 *********************************************/
 
/* Use this array to map attribute names to user friendly names. For example, if
   you don't want to see "facsimileTelephoneNumber" but rather "Fax". */
// $config->custom->appearance['friendly_attrs'] = array();
$config->custom->appearance['friendly_attrs'] = array(
// Tachtler
// default:     'facsimileTelephoneNumber' => 'Fax',
// 'facsimileTelephoneNumber' => 'Fax',
// Tachtler
// default:     'gid'                      => 'Group',
// 'gid'                      => 'Group',
// Tachtler
// default:     'mail'                     => 'Email',
// 'mail'                     => 'Email',
// Tachtler
// default:     'telephoneNumber'          => 'Telephone',
// 'telephoneNumber'          => 'Telephone',
// Tachtler
// default:     'uid'                      => 'User Name',
// 'uid'                      => 'User Name',
// Tachtler
// default:     'userPassword'             => 'Password'    
// 'userPassword'             => 'Password'
);
 
/*********************************************
 * Hidden attributes                         *
 *********************************************/
 
/* You may want to hide certain attributes from being edited. If you want to
   hide attributes from the user, you should use your LDAP servers ACLs.
   NOTE: The user must be able to read the hide_attrs_exempt entry to be
   excluded. */
// $config->custom->appearance['hide_attrs'] = array();
#  $config->custom->appearance['hide_attrs'] = array('objectClass');

/* Members of this list will be exempt from the hidden attributes. */
// $config->custom->appearance['hide_attrs_exempt'] = null;
#  $config->custom->appearance['hide_attrs_exempt'] = 'cn=PLA UnHide,ou=Groups,c=AU';

/*********************************************
 * Read-only attributes                      *
 *********************************************/
 
/* You may want to phpLDAPadmin to display certain attributes as read only,
   meaning that users will not be presented a form for modifying those
   attributes, and they will not be allowed to be modified on the "back-end"
   either. You may configure this list here:
   NOTE: The user must be able to read the readonly_attrs_exempt entry to be
   excluded. */
// $config->custom->appearance['readonly_attrs'] = array();
 
/* Members of this list will be exempt from the readonly attributes. */
// $config->custom->appearance['readonly_attrs_exempt'] = null;
#  $config->custom->appearance['readonly_attrs_exempt'] = 'cn=PLA ReadWrite,ou=Groups,c=AU';

/*********************************************
 * Group attributes                          *
 *********************************************/
 
/* Add "modify group members" link to the attribute. */
// $config->custom->modify_member['groupattr'] = array('member','uniqueMember','memberUid','sudoUser');
 
/* Configure filter for member search. This only applies to "modify group members" feature */
// $config->custom->modify_member['filter'] = '(objectclass=Person)';
 
/* Attribute that is added to the group member attribute. */
// $config->custom->modify_member['attr'] = 'dn';
 
/* For Posix attributes */
// $config->custom->modify_member['posixattr'] = 'uid';
// $config->custom->modify_member['posixfilter'] = '(uid=*)';
// $config->custom->modify_member['posixgroupattr'] = 'memberUid';
 
/*********************************************
 * Support for attrs display order           *
 *********************************************/
 
/* Use this array if you want to have your attributes displayed in a specific
   order. You can use default attribute names or their fridenly names.
   For example, "sn" will be displayed right after "givenName". All the other
   attributes that are not specified in this array will be displayed after in
   alphabetical order. */
// $config->custom->appearance['attr_display_order'] = array();
#  $config->custom->appearance['attr_display_order'] = array(
#   'givenName',
#   'sn',
#   'cn',
#   'displayName',
#   'uid',
#   'uidNumber',
#   'gidNumber',
#   'homeDirectory',
#   'mail',
#   'userPassword'
#  );

/*********************************************
 * Define your LDAP servers in this section  *
 *********************************************/
 
$servers = new Datastore();
 
/* $servers->NewServer('ldap_pla') must be called before each new LDAP server
   declaration. */
$servers->newServer('ldap_pla');
 
/* A convenient name that will appear in the tree viewer and throughout
   phpLDAPadmin to identify this LDAP server to users. */
// Tachtler
// default: $servers->setValue('server','name','My LDAP Server');
$servers->setValue('server','name','ldap.idmz.tachtler.net');
 
/* Examples:
   'ldap.example.com',
   'ldaps://ldap.example.com/',
   'ldapi://%2fusr%local%2fvar%2frun%2fldapi'
           (Unix socket at /usr/local/var/run/ldap) */
// Tachtler
// default: // $servers->setValue('server','host','127.0.0.1');
$servers->setValue('server','host','ldaps://ldap.idmz.tachtler.net');
 
/* The port your LDAP server listens on (no quotes). 389 is standard. */
// $servers->setValue('server','port',389);
 
/* Array of base DNs of your LDAP server. Leave this blank to have phpLDAPadmin
   auto-detect it for you. */
// $servers->setValue('server','base',array(''));
 
/* Five options for auth_type:
   1. 'cookie': you will login via a web form, and a client-side cookie will
      store your login dn and password.
   2. 'session': same as cookie but your login dn and password are stored on the
      web server in a persistent session variable.
   3. 'http': same as session but your login dn and password are retrieved via
      HTTP authentication.
   4. 'config': specify your login dn and password here in this config file. No
      login will be required to use phpLDAPadmin for this server.
   5. 'sasl': login will be taken from the webserver's kerberos authentication.
      Currently only GSSAPI has been tested (using mod_auth_kerb).
   6. 'sasl_external': login will be taken from SASL external mechanism.
 
   Choose wisely to protect your authentication information appropriately for
   your situation. If you choose 'cookie', your cookie contents will be
   encrypted using blowfish and the secret your specify above as
   session['blowfish']. */
// $servers->setValue('login','auth_type','session');
 
/* The DN of the user for phpLDAPadmin to bind with. For anonymous binds or
   'cookie','session' or 'sasl' auth_types, LEAVE THE LOGIN_DN AND LOGIN_PASS
   BLANK. If you specify a login_attr in conjunction with a cookie or session
   auth_type, then you can also specify the bind_id/bind_pass here for searching
   the directory for users (ie, if your LDAP server does not allow anonymous
   binds. */
// $servers->setValue('login','bind_id','');
// Tachtler
// default: #  $servers->setValue('login','bind_id','cn=Manager,dc=example,dc=com');
$servers->setValue('login','bind_id','cn=Manager,dc=tachtler,dc=net');
 
/* Your LDAP password. If you specified an empty bind_id above, this MUST also
   be blank. */
// $servers->setValue('login','bind_pass','');
#  $servers->setValue('login','bind_pass','secret');

/* Use TLS (Transport Layer Security) to connect to the LDAP server. */
// $servers->setValue('server','tls',false);
 
/* TLS Certificate Authority file (overrides ldap.conf, PHP 7.1+) */
// $servers->setValue('server','tls_cacert',null);
#  $servers->setValue('server','tls_cacert','/etc/openldap/certs/ca.crt');

/* TLS Certificate Authority hashed directory (overrides ldap.conf, PHP 7.1+) */
// $servers->setValue('server','tls_cacertdir',null);
#  $servers->setValue('server','tls_cacertdir','/etc/openldap/certs');

/* TLS Client Certificate file (PHP 7.1+) */
// $servers->setValue('server','tls_cert',null);
#  $servers->setValue('server','tls_cert','/etc/pki/tls/certs/ldap_user.crt');

/* TLS Client Certificate Key file (PHP 7.1+) */
// $servers->setValue('server','tls_key',null);
#  $servers->setValue('server','tls_key','/etc/pki/tls/private/ldap_user.key');

/************************************
 *      SASL Authentication         *
 ************************************/
 
/* Enable SASL authentication LDAP SASL authentication requires PHP 5.x
   configured with --with-ldap-sasl=DIR. If this option is disabled (ie, set to
   false), then all other sasl options are ignored. */
#  $servers->setValue('login','auth_type','sasl');

/* SASL GSSAPI auth mechanism (requires auth_type of sasl) */
// $servers->setValue('sasl','mech','GSSAPI');
 
/* SASL PLAIN support... this mech converts simple binds to SASL
   PLAIN binds using any auth_type (or other bind_id/pass) as credentials.
   NOTE: auth_type must be simple auth compatible (ie not sasl) */
#  $servers->setValue('sasl','mech','PLAIN');

/* SASL EXTERNAL support... really a different auth_type */
#  $servers->setValue('login','auth_type','sasl_external');

/* SASL authentication realm name */
// $servers->setValue('sasl','realm','');
#  $servers->setValue('sasl','realm','EXAMPLE.COM');

/* SASL authorization ID name
   If this option is undefined, authorization id will be computed from bind DN,
   using authz_id_regex and authz_id_replacement. */
// $servers->setValue('sasl','authz_id', null);
 
/* SASL authorization id regex and replacement
   When authz_id property is not set (default), phpLDAPAdmin will try to
   figure out authorization id by itself from bind distinguished name (DN).
 
   This procedure is done by calling preg_replace() php function in the
   following way:
 
   $authz_id = preg_replace($sasl_authz_id_regex,$sasl_authz_id_replacement,
    $bind_dn);
 
   For info about pcre regexes, see:
   - pcre(3), perlre(3)
   - http://www.php.net/preg_replace */
// $servers->setValue('sasl','authz_id_regex',null);
// $servers->setValue('sasl','authz_id_replacement',null);
#  $servers->setValue('sasl','authz_id_regex','/^uid=([^,]+)(.+)/i');
#  $servers->setValue('sasl','authz_id_replacement','$1');

/* SASL auth security props.
   See http://beepcore-tcl.sourceforge.net/tclsasl.html#anchor5 for explanation. */
// $servers->setValue('sasl','props',null);
 
/* Default password hashing algorithm. One of md5, ssha, sha, md5crpyt, smd5,
   blowfish, crypt or leave blank for now default algorithm. */
// Tachtler
// default: // $servers->setValue('appearance','pla_password_hash','md5');
$servers->setValue('appearance','pla_password_hash','ssha');
 
/* If you specified 'cookie' or 'session' as the auth_type above, you can
   optionally specify here an attribute to use when logging in. If you enter
   'uid' and login as 'dsmith', phpLDAPadmin will search for (uid=dsmith)
   and log in as that user.
   Leave blank or specify 'dn' to use full DN for logging in. Note also that if
   your LDAP server requires you to login to perform searches, you can enter the
   DN to use when searching in 'bind_id' and 'bind_pass' above. */
// $servers->setValue('login','attr','dn');
 
/* Base DNs to used for logins. If this value is not set, then the LDAP server
   Base DNs are used. */
// $servers->setValue('login','base',array());
 
/* If 'login,attr' is used above such that phpLDAPadmin will search for your DN
   at login, you may restrict the search to a specific objectClasses. EG, set this
   to array('posixAccount') or array('inetOrgPerson',..), depending upon your
   setup. */
// $servers->setValue('login','class',array());
 
/* If login_attr was set to 'dn', it is possible to specify a template string to
   build the DN from. Use '%s' where user input should be inserted. A user may
   still enter the complete DN. In this case the template will not be used. */
// $servers->setValue('login','bind_dn_template',null);
#  $servers->setValue('login','bind_dn_template','cn=%s,ou=people,dc=example,dc=com');

/* If you specified something different from 'dn', for example 'uid', as the
   login_attr above, you can optionally specify here to fall back to
   authentication with dn.
   This is useful, when users should be able to log in with their uid, but
   the ldap administrator wants to log in with his root-dn, that does not
   necessarily have the uid attribute.
   When using this feature, login_class is ignored. */
// $servers->setValue('login','fallback_dn',false);
 
/* Specify true If you want phpLDAPadmin to not display or permit any
   modification to the LDAP server. */
// $servers->setValue('server','read_only',false);
 
/* Specify false if you do not want phpLDAPadmin to draw the 'Create new' links
   in the tree viewer. */
// $servers->setValue('appearance','show_create',true);
 
/* Set to true if you would like to initially open the first level of each tree. */
// $servers->setValue('appearance','open_tree',false);
 
/* Set to true to display authorization ID in place of login dn (PHP 7.2+) */
// $servers->setValue('appearance','show_authz',false);
 
/* This feature allows phpLDAPadmin to automatically determine the next
   available uidNumber for a new entry. */
// $servers->setValue('auto_number','enable',true);
 
/* The mechanism to use when finding the next available uidNumber. Two possible
   values: 'uidpool' or 'search'.
   The 'uidpool' mechanism uses an existing uidPool entry in your LDAP server to
   blindly lookup the next available uidNumber. The 'search' mechanism searches
   for entries with a uidNumber value and finds the first available uidNumber
   (slower). */
// $servers->setValue('auto_number','mechanism','search');
 
/* The DN of the search base when the 'search' mechanism is used above. */
#  $servers->setValue('auto_number','search_base','ou=People,dc=example,dc=com');

/* The minimum number to use when searching for the next available number
   (only when 'search' is used for auto_number. */
// $servers->setValue('auto_number','min',array('uidNumber'=>1000,'gidNumber'=>500));
 
/* If you set this, then phpldapadmin will bind to LDAP with this user ID when
   searching for the uidnumber. The idea is, this user id would have full
   (readonly) access to uidnumber in your ldap directory (the logged in user
   may not), so that you can be guaranteed to get a unique uidnumber for your
   directory. */
// $servers->setValue('auto_number','dn',null);
 
/* The password for the dn above. */
// $servers->setValue('auto_number','pass',null);
 
/* Enable anonymous bind login. */
// Tachtler
// default: // $servers->setValue('login','anon_bind',true);
$servers->setValue('login','anon_bind',false);
 
/* Use customized page with prefix when available. */
#  $servers->setValue('custom','pages_prefix','custom_');

/* If you set this, then only these DNs are allowed to log in. This array can
   contain individual users, groups or ldap search filter(s). Keep in mind that
   the user has not authenticated yet, so this will be an anonymous search to
   the LDAP server, so make your ACLs allow these searches to return results! */
#  $servers->setValue('login','allowed_dns',array(
#   'uid=stran,ou=People,dc=example,dc=com',
#   '(&(gidNumber=811)(objectClass=groupOfNames))',
#   '(|(uidNumber=200)(uidNumber=201))',
#   'cn=callcenter,ou=Group,dc=example,dc=com'));

/* Set this if you dont want this LDAP server to show in the tree */
// $servers->setValue('server','visible',true);
 
/* Set this if you want to hide the base DNs that dont exist instead of
   displaying the message "The base entry doesnt exist, create it?"
// $servers->setValue('server','hide_noaccess_base',false);
#  $servers->setValue('server','hide_noaccess_base',true);
 
/* This is the time out value in minutes for the server. After as many minutes
   of inactivity you will be automatically logged out. If not set, the default
   value will be ( session_cache_expire()-1 ) */
#  $servers->setValue('login','timeout',30);

/* Set this if you want phpldapadmin to perform rename operation on entry which
   has children. Certain servers are known to allow it, certain are not. */
// $servers->setValue('server','branch_rename',false);
 
/* If you set this, then phpldapadmin will show these attributes as
   internal attributes, even if they are not defined in your schema. */
// $servers->setValue('server','custom_sys_attrs',array(''));
#  $servers->setValue('server','custom_sys_attrs',array('passwordExpirationTime','passwordAllowChangeTime'));

/* If you set this, then phpldapadmin will show these attributes on
   objects, even if they are not defined in your schema. */
// $servers->setValue('server','custom_attrs',array(''));
#  $servers->setValue('server','custom_attrs',array('nsRoleDN','nsRole','nsAccountLock'));

/* These attributes will be forced to MAY attributes and become option in the
   templates. If they are not defined in the templates, then they wont appear
   as per normal template processing. You may want to do this because your LDAP
   server may automatically calculate a default value.
   In Fedora Directory Server using the DNA Plugin one could ignore uidNumber,
   gidNumber and sambaSID. */
// $servers->setValue('server','force_may',array(''));
#  $servers->setValue('server','force_may',array('uidNumber','gidNumber','sambaSID'));

/*********************************************
 * Unique attributes                         *
 *********************************************/
 
/* You may want phpLDAPadmin to enforce some attributes to have unique values
   (ie: not belong to other entries in your tree. This (together with
   'unique','dn' and 'unique','pass' option will not let updates to
   occur with other attributes have the same value. */
#  $servers->setValue('unique','attrs',array('mail','uid','uidNumber'));

/* If you set this, then phpldapadmin will bind to LDAP with this user ID when
   searching for attribute uniqueness. The idea is, this user id would have full
   (readonly) access to your ldap directory (the logged in user may not), so
   that you can be guaranteed to get a unique uidnumber for your directory. */
// $servers->setValue('unique','dn',null);
 
/* The password for the dn above. */
// $servers->setValue('unique','pass',null);
 
/**************************************************************************
 * If you want to configure additional LDAP servers, do so below.         *
 * Remove the commented lines and use this section as a template for all  *
 * your other LDAP servers.                                               *
 **************************************************************************/
 
/*
$servers->newServer('ldap_pla');
$servers->setValue('server','name','LDAP Server');
$servers->setValue('server','host','127.0.0.1');
$servers->setValue('server','port',389);
$servers->setValue('server','base',array(''));
$servers->setValue('login','auth_type','cookie');
$servers->setValue('login','bind_id','');
$servers->setValue('login','bind_pass','');
$servers->setValue('server','tls',false);
 
# SASL auth
$servers->setValue('login','auth_type','sasl');
$servers->setValue('sasl','mech','GSSAPI');
$servers->setValue('sasl','realm','EXAMPLE.COM');
$servers->setValue('sasl','authz_id',null);
$servers->setValue('sasl','authz_id_regex','/^uid=([^,]+)(.+)/i');
$servers->setValue('sasl','authz_id_replacement','$1');
$servers->setValue('sasl','props',null);
 
$servers->setValue('appearance','pla_password_hash','md5');
$servers->setValue('login','attr','dn');
$servers->setValue('login','fallback_dn',false);
$servers->setValue('login','class',null);
$servers->setValue('server','read_only',false);
$servers->setValue('appearance','show_create',true);
 
$servers->setValue('auto_number','enable',true);
$servers->setValue('auto_number','mechanism','search');
$servers->setValue('auto_number','search_base',null);
$servers->setValue('auto_number','min',array('uidNumber'=>1000,'gidNumber'=>500));
$servers->setValue('auto_number','dn',null);
$servers->setValue('auto_number','pass',null);
 
$servers->setValue('login','anon_bind',true);
$servers->setValue('custom','pages_prefix','custom_');
$servers->setValue('unique','attrs',array('mail','uid','uidNumber'));
$servers->setValue('unique','dn',null);
$servers->setValue('unique','pass',null);
 
$servers->setValue('server','visible',true);
$servers->setValue('login','timeout',30);
$servers->setValue('server','branch_rename',false);
$servers->setValue('server','custom_sys_attrs',array('passwordExpirationTime','passwordAllowChangeTime'));
$servers->setValue('server','custom_attrs',array('nsRoleDN','nsRole','nsAccountLock'));
$servers->setValue('server','force_may',array('uidNumber','gidNumber','sambaSID'));
*/
 
 
/***********************************************************************************
 * If you want to configure Google reCAPTCHA on autentication form, do so below.   *
 * Remove the commented lines and use this section as a template for all           *
 * reCAPTCHA v2  Generate on https://www.google.com/recaptcha/                     *
 *                                                                                 *
 * IMPORTANT: Select reCAPTCHA v2   on  Type of reCAPTCHA                          *
 ***********************************************************************************/
 
 
$config->custom->session['reCAPTCHA-enable'] = false;
$config->custom->session['reCAPTCHA-key-site'] = '<put-here-key-site>';
$config->custom->session['reCAPTCHA-key-server'] = '<put-here-key-server>';
 
?>

Nachfolgend die Erklärungen zu den Änderungen in der oben vollständig gezeigten Konfigurationsdatei

  • /* phpLDAPadmin can encrypt the content of sensitive cookies if you set this
       to a big random string. */
    // Tachtler
    // default: // $config->custom->session['blowfish'] = null;
    $config->custom->session['blowfish'] = '3755425c4a807636d93c87f4467ab7e6';

Es wird eine Zeichenfolge als Zufalls-„Salt“ gesetzt.

Sprache

  • /* The language setting. If you set this to 'auto', phpLDAPadmin will attempt
       to determine your language automatically. Otherwise, available lanaguages
       are: 'ct', 'de', 'en', 'es', 'fr', 'it', 'nl', and 'ru'
       Localization is not complete yet, but most strings have been translated.
       Please help by writing language files. See lang/en.php for an example. */
    // $config->custom->appearance['language'] = 'auto';
    # Tachtler
    $config->custom->appearance['language'] = 'de_DE';

Die Standardsprache wird hier auf de_DE (deutsch) gesetzt.

Zeitzone

  • /* Our local timezone
       This is to make sure that when we ask the system for the current time, we
       get the right local time. If this is not set, all time() calculations will
       assume UTC if you have not set PHP date.timezone. */
    // $config->custom->appearance['timezone'] = null;
    #  $config->custom->appearance['timezone'] = 'Australia/Melbourne';
    # Tachtler
    $config->custom->appearance['timezone'] = 'Europe/Berlin';

Die Zeitzone wird hier auf Europe/Berlin (Standard in Deutschland) gesetzt.

Fehlermeldungen zu ungültigen Objekten in Vorlagen

  • /* Hide the warnings for invalid objectClasses/attributes in templates. */
    // $config->custom->appearance['hide_template_warning'] = false;
    # Tachtler
    $config->custom->appearance['hide_template_warning'] = true;

Die Ausblenden von überflüssigen Warnmeldungen wird unterdrückt.

Benutzerfreundliche Feldnamen

  • /*********************************************
     * User-friendly attribute translation       *
     *********************************************/
     
    /* Use this array to map attribute names to user friendly names. For example, if
       you don't want to see "facsimileTelephoneNumber" but rather "Fax". */
    // $config->custom->appearance['friendly_attrs'] = array();
    $config->custom->appearance['friendly_attrs'] = array(
    // Tachtler
    // default:     'facsimileTelephoneNumber' => 'Fax',
    // 'facsimileTelephoneNumber' => 'Fax',
    // Tachtler
    // default:     'gid'                      => 'Group',
    // 'gid'                      => 'Group',
    // Tachtler
    // default:     'mail'                     => 'Email',
    // 'mail'                     => 'Email',
    // Tachtler
    // default:     'telephoneNumber'          => 'Telephone',
    // 'telephoneNumber'          => 'Telephone',
    // Tachtler
    // default:     'uid'                      => 'User Name',
    // 'uid'                      => 'User Name',
    // Tachtler
    // default:     'userPassword'             => 'Password'    
    // 'userPassword'             => 'Password'
    );

Die Übersetzung einieger Feldnamen in benutzerfreundliche Bezeichnungen soll, um keine verfälschte Ausgabe zu erzeugen, unterbunden werden.

Anzeige LDAP-Server Name

  • /* A convenient name that will appear in the tree viewer and throughout
       phpLDAPadmin to identify this LDAP server to users. */
    # Tachtler
    # default: $servers->setValue('server','name','Local LDAP Server');
    $servers->setValue('server','name','ldap.idmz.tachtler.net');

Der Name des LDAP-Servers im Objektbaum.

LDAP-URL

  • /* Examples:
       'ldap.example.com',
       'ldaps://ldap.example.com/',
       'ldapi://%2fusr%local%2fvar%2frun%2fldapi'
               (Unix socket at /usr/local/var/run/ldap) */
    // $servers->setValue('server','host','127.0.0.1');
    # Tachtler
    $servers->setValue('server','host','ldaps://ldap.idmz.tachtler.net');

Die URL zum LDAP-Server - hier eine URL mit SSL/TLS-Verschlüsseltem Aufruf.

LDAP BIND ID

  • /* The DN of the user for phpLDAPadmin to bind with. For anonymous binds or
       'cookie' or 'session' auth_types, LEAVE THE LOGIN_DN AND LOGIN_PASS BLANK. If
       you specify a login_attr in conjunction with a cookie or session auth_type,
       then you can also specify the bind_id/bind_pass here for searching the
       directory for users (ie, if your LDAP server does not allow anonymous binds. */
    // $servers->setValue('login','bind_id','');
    #  $servers->setValue('login','bind_id','cn=Manager,dc=example,dc=com');
    # Tachtler
    $servers->setValue('login','bind_id','cn=Manager,dc=tachtler,dc=net');

Der Benutzer, bzw. das Objekt, mit dessen die Authentifizierung durchgeführt werden soll Standard ist hier das Manager-Objekt.

Standard Passwort Algorithmus

  • /* Default password hashing algorithm. One of md5, ssha, sha, md5crpyt, smd5,
       blowfish, crypt or leave blank for now default algorithm. */
    // $servers->setValue('appearance','password_hash','md5');
    # Tachtler
    # default: $servers->setValue('appearance','password_hash','');
    $servers->setValue('appearance','password_hash','ssha');

Hier aufgrund der gestiegenen Sicherheitsanforderungen ssha und NICHT mehr md5.

Anonymous BIND

  • /* Enable anonymous bind login. */
    // $servers->setValue('login','anon_bind',true);
    # Tachtler
    $servers->setValue('login','anon_bind',false);

:!: WICHTIG Falls der OpenLDAP-Server keinen anonymous bind erlaubt, kann dies hier deaktiviert werden !!!

Bei der Konfiguration eines OpenLDAP-Servers wie unter nachfolgendem Link beschrieben, ist das deaktivieren eines anonymous bind erforderlich:

PHP74-FPM

Aktuell ist die PHP Net Installation in der Version 7.x noch in Verwendung, welche als PHP7-FPM zur Interpretation von PHP-Code verwendet wird.

/etc/php7/php.ini

Nachfolgende Konfigurationen sind in der Konfigurationsdatei

  • /etc/php7/php.ini

ebenfalls noch durchzuführen.

(Nur relevanter Ausschnitt)

;;;;;;;;;;;;;;;;;;;;;;
; Dynamic Extensions ;
;;;;;;;;;;;;;;;;;;;;;;
 
; If you wish to have an extension loaded automatically, use the following
; syntax:
;
;   extension=modulename
;
; For example:
;
;   extension=mysqli
;
; When the extension library to load is not located in the default extension
; directory, You may specify an absolute path to the library file:
;
;   extension=/path/to/extension/mysqli.so
;
; Note : The syntax used in previous PHP versions ('extension=<ext>.so' and
; 'extension='php_<ext>.dll') is supported for legacy reasons and may be
; deprecated in a future PHP major version. So, when it is possible, please
; move to the new ('extension=<ext>) syntax.
;
;extension=bcmath
;extension=bz2
;extension=calendar
extension=curl
;extension=dba
;extension=enchant
;extension=exif
;extension=ffi
;extension=ftp
;extension=gd
; Tachtler
; default: ;extension=gettext
extension=gettext
;extension=gmp
;extension=iconv
;extension=imap
;extension=intl
; Tachtler
; default: ;extension=ldap
extension=ldap
;extension=mysqli
;extension=odbc
;zend_extension=opcache
;extension=pdo_dblib
;extension=pdo_mysql
;extension=pdo_odbc
;extension=pdo_pgsql
;extension=pdo_sqlite
;extension=pgsql
;extension=pspell
;extension=shmop
;extension=snmp
;extension=soap
;extension=sockets
;extension=sodium
;extension=sqlite3
;extension=sysvmsg
;extension=sysvsem
;extension=sysvshm
;extension=tidy
;extension=xmlrpc
;extension=xsl
extension=zip

Nachfolgende Anpassungen wurden zusätzlich noch durchgeführt:

Extension: gettext

Aktivierung der Verwendung der Erweiterung (extension) - gettext.

Extension: ldap

  • ; Tachtler
    ; default: ;extension=ldap
    extension=ldap

Aktivierung der Verwendung der Erweiterung (extension) - ldap.

Neustart: PHP7-FPM Service

Bevor weitere Konfigurationsschritte erfolgen, sollte ein Neustart erfolgen, was mit nachfolgendem Befehl durchgeführt werden kann:

# systemctl restart php-fpm7.service

:!: HINWEIS - Es erfolgen keine weiteren Ausgaben, wenn der Start erfolgreich war !

Apache Webserver

Nachfolgend soll ein Apache HTTPD Webserver zur Auslieferung von phpLDAPadmin verwendet werden.

Dazu ist es erforderlich einen Apache HTTPD Webserver, wie unter nachfolgendem internen Link zu installieren:

/etc/httpd/conf/vhosts/phpldapadmin.conf

Zusätzlich ist die Einrichtung eines virtuellen Host mit nachfolgender Konfiguration erforderlich. Die Konfigurationsdatei sollte unter nachfolgendem Verzeichnis mit nachfolgendem Namen neu erstellt werden:

# mkdir /etc/httpd/conf/vhosts
# vim /etc/httpd/conf/vhosts/phpldapadmin.conf

Der Inhalt der so neu erstellten Konfigurationsdatei für den virtuellen Host des Apache HTTPD Webserver könnt in etwa wie folgt aussehen:

<VirtualHost *:80>
    ServerAdmin webmaster@tachtler.net
    ServerName phpldapadmin.tachtler.net
    ServerPath /
 
    # ----------------------------------------------------------
    # Rewrite settings
    # Rewrite the requestet URI - PERMANENT - to HTTPS and leave
    # this virtual Host to the HTTPS variant of it.
    # ----------------------------------------------------------
    <IfModule rewrite_module>
        RewriteEngine On
        RewriteCond "%{HTTPS}" "!=on"
        RewriteRule "^(.*)$" "https://%{HTTP_HOST}%{REQUEST_URI}" [R=301,L]
    </IfModule>
 
    # ----------------------------------------------------------
    # Logging settings
    # ----------------------------------------------------------
    <IfModule log_config_module>
        ErrorLog /var/log/httpd/phpldapadmin.tachtler.net_error.log
        SetEnvIF User-Agent "HAProxy" dontlog=yes
        SetEnvIf X-Forwarded-For "^.*\..*\..*\..*" forwarded=yes
        <IfModule logio_module>
            CustomLog /var/log/httpd/phpldapadmin.tachtler.net_access.log combined_deflate_ssl "expr=(reqenv('forwarded') != 'yes' && reqenv('dontlog') != 'yes')"
            CustomLog /var/log/httpd/phpldapadmin.tachtler.net_access.log combined_deflate_proxypass_ssl "expr=(reqenv('forwarded') == 'yes' && reqenv('dontlog') != 'yes')"
        </IfModule>
    </IfModule>
</VirtualHost>
 
<VirtualHost *:443>
    ServerAdmin webmaster@tachtler.net
    ServerName phpldapadmin.tachtler.net
    ServerPath /
 
    # ----------------------------------------------------------
    # SSL settings
    # ----------------------------------------------------------
    <IfModule ssl_module>
        SSLEngine On
        SSLCertificateFile /etc/letsencrypt/live/tachtler.net/fullchain.pem
        SSLCertificateKeyFile /etc/letsencrypt/live/tachtler.net/privkey.pem
 
        <FilesMatch "\.(cgi|shtml|phtml|php)$">
            SSLOptions +StdEnvVars
        </FilesMatch>
        <Directory "/srv/http/cgi-bin">
            SSLOptions +StdEnvVars
        </Directory>
 
        BrowserMatch "MSIE [2-5]" \
            nokeepalive ssl-unclean-shutdown \
            downgrade-1.0 force-response-1.0
    </IfModule>
 
    # ----------------------------------------------------------
    # Rewrite settings
    # Rewrite the requestet URI - PERMANENT - to HTTPS and leave
    # this virtual Host to the HTTPS variant of it.
    # ----------------------------------------------------------
    <IfModule rewrite_module>
        RewriteEngine On
        RewriteCond "%{HTTPS}" "!=on"
        RewriteRule "^(.*)$" "https://%{HTTP_HOST}%{REQUEST_URI}" [R=301,L]
    </IfModule>
 
    # ----------------------------------------------------------
    # Alias settings - The "/" must be at the end!
    # ----------------------------------------------------------
    <IfModule alias_module>
        Alias / "/usr/share/webapps/phpldapadmin/"
    </IfModule>
 
    # ----------------------------------------------------------
    # Directory access settings
    # URL of https://servername/
    # ----------------------------------------------------------
    <Directory "/usr/share/webapps/phpldapadmin">
        DirectoryIndex index.php
        Options +Indexes +FollowSymLinks
        AllowOverride None
        Require all granted
 
        <FilesMatch \.php$>
            SetHandler "proxy:unix:/run/php-fpm/php-fpm.sock|fcgi://localhost"
        </FilesMatch>
 
    </Directory>
 
    # ----------------------------------------------------------
    # Logging settings
    # ----------------------------------------------------------
    <IfModule log_config_module>
        ErrorLog /var/log/httpd/phpldapadmin.tachtler.net_error.log
        SetEnvIF User-Agent "HAProxy" dontlog=yes
        SetEnvIf X-Forwarded-For "^.*\..*\..*\..*" forwarded=yes
        <IfModule logio_module>
            CustomLog /var/log/httpd/phpldapadmin.tachtler.net_access.log combined_deflate_ssl "expr=(reqenv('forwarded') != 'yes' && reqenv('dontlog') != 'yes')"
            CustomLog /var/log/httpd/phpldapadmin.tachtler.net_access.log combined_deflate_proxypass_ssl "expr=(reqenv('forwarded') == 'yes' && reqenv('dontlog') != 'yes')"
        </IfModule>
    </IfModule>
</VirtualHost> 

/etc/httpd/conf/httpd.conf

Damit die zuvor unter

neu erstellte Konfigurationsdatei auch durch den Apache HTTPD Webserver eingelesen wird, ist nachfolgende Ergänzung in der bereits bestehnden Konfigurationsdatei

  • /etc/httpd/conf/httpd.conf

wie folgt am Ende der Konfigurationsdatei hinzuzufügen:

# Load *.conf files in the "conf/vhost" directory, if any.
IncludeOptional conf/vhost/*.conf  

Neustart: Apache HTTPD Webserver

Bevor weitere Konfigurationsschritte erfolgen, sollte ein Neustart erfolgen, was mit nachfolgendem Befehl durchgeführt werden kann:

# systemctl restart httpd.service

:!: HINWEIS - Es erfolgen keine weiteren Ausgaben, wenn der Start erfolgreich war !

Erster Aufruf

Nachdem die Installation und die Basis-Konfiguration abgeschlossen sind, kann nun der erste Aufruf mit nachfolgender URL erfolgen:

wodurch nachfolgender Bildschirm zur Anzeige kommen sollte, in dem die Anmeldedaten nun eingegeben werden müssen, um eine erfolgreiche Anmeldung durchzuführen:

phpLDAPadmin - Startseite

Diese Website verwendet Cookies. Durch die Nutzung der Website stimmen Sie dem Speichern von Cookies auf Ihrem Computer zu. Außerdem bestätigen Sie, dass Sie unsere Datenschutzbestimmungen gelesen und verstanden haben. Wenn Sie nicht einverstanden sind, verlassen Sie die Website.Weitere Information
tachtler/phpldapadmin_archlinux.txt · Zuletzt geändert: 2023/10/13 11:15 von klaus