From a3730f6703e2f086c8a248b43d5cedeb0fdfe8c8 Mon Sep 17 00:00:00 2001 From: Benjamin Date: Wed, 19 Jun 2024 16:03:38 +0000 Subject: [PATCH] Deployed 6646ca9 to 4.2.0-1-30-g6646ca9 in doc/dist with MkDocs 1.6.0 and mike 2.2.0.dev0 --- doc/dist/4.2.0-1-30-g6646ca9/404.html | 3411 +++++ doc/dist/4.2.0-1-30-g6646ca9/LdapSaisie.epub | Bin 0 -> 107644 bytes doc/dist/4.2.0-1-30-g6646ca9/LdapSaisie.html | 8739 +++++++++++ doc/dist/4.2.0-1-30-g6646ca9/LdapSaisie.pdf | Bin 0 -> 1652828 bytes doc/dist/4.2.0-1-30-g6646ca9/api/index.html | 4336 ++++++ .../assets/images/favicon.png | Bin 0 -> 503 bytes .../assets/images/logo.png | Bin 0 -> 5293 bytes .../assets/javascripts/bundle.ad660dcc.min.js | 29 + .../javascripts/bundle.ad660dcc.min.js.map | 7 + .../javascripts/lunr/min/lunr.ar.min.js | 1 + .../javascripts/lunr/min/lunr.da.min.js | 18 + .../javascripts/lunr/min/lunr.de.min.js | 18 + .../javascripts/lunr/min/lunr.du.min.js | 18 + .../javascripts/lunr/min/lunr.el.min.js | 1 + .../javascripts/lunr/min/lunr.es.min.js | 18 + .../javascripts/lunr/min/lunr.fi.min.js | 18 + .../javascripts/lunr/min/lunr.fr.min.js | 18 + .../javascripts/lunr/min/lunr.he.min.js | 1 + .../javascripts/lunr/min/lunr.hi.min.js | 1 + .../javascripts/lunr/min/lunr.hu.min.js | 18 + .../javascripts/lunr/min/lunr.hy.min.js | 1 + .../javascripts/lunr/min/lunr.it.min.js | 18 + .../javascripts/lunr/min/lunr.ja.min.js | 1 + .../javascripts/lunr/min/lunr.jp.min.js | 1 + .../javascripts/lunr/min/lunr.kn.min.js | 1 + .../javascripts/lunr/min/lunr.ko.min.js | 1 + .../javascripts/lunr/min/lunr.multi.min.js | 1 + .../javascripts/lunr/min/lunr.nl.min.js | 18 + .../javascripts/lunr/min/lunr.no.min.js | 18 + .../javascripts/lunr/min/lunr.pt.min.js | 18 + .../javascripts/lunr/min/lunr.ro.min.js | 18 + .../javascripts/lunr/min/lunr.ru.min.js | 18 + .../javascripts/lunr/min/lunr.sa.min.js | 1 + .../lunr/min/lunr.stemmer.support.min.js | 1 + .../javascripts/lunr/min/lunr.sv.min.js | 18 + .../javascripts/lunr/min/lunr.ta.min.js | 1 + .../javascripts/lunr/min/lunr.te.min.js | 1 + .../javascripts/lunr/min/lunr.th.min.js | 1 + .../javascripts/lunr/min/lunr.tr.min.js | 18 + .../javascripts/lunr/min/lunr.vi.min.js | 1 + .../javascripts/lunr/min/lunr.zh.min.js | 1 + .../assets/javascripts/lunr/tinyseg.js | 206 + .../assets/javascripts/lunr/wordcut.js | 6708 +++++++++ .../workers/search.b8dbb3d2.min.js | 42 + .../workers/search.b8dbb3d2.min.js.map | 7 + .../assets/stylesheets/main.6543a935.min.css | 1 + .../stylesheets/main.6543a935.min.css.map | 1 + .../stylesheets/palette.06af60db.min.css | 1 + .../stylesheets/palette.06af60db.min.css.map | 1 + .../assets/templates/custom_cover_page.tpl | 30 + .../assets/templates/print_site_banner.tpl | 8 + .../index.html | 3469 +++++ .../conf/LSaddon/LSaddon_accesslog/index.html | 3506 +++++ .../conf/LSaddon/LSaddon_asterisk/index.html | 3467 +++++ .../index.html | 3502 +++++ .../LSaddon/LSaddon_impersonate/index.html | 3486 +++++ .../conf/LSaddon/LSaddon_mail/index.html | 3608 +++++ .../conf/LSaddon/LSaddon_maildir/index.html | 3465 +++++ .../conf/LSaddon/LSaddon_mailquota/index.html | 3509 +++++ .../LSaddon/LSaddon_phpldapadmin/index.html | 3494 +++++ .../conf/LSaddon/LSaddon_ppolicy/index.html | 3609 +++++ .../LSaddon_showSupportInfo/index.html | 3495 +++++ .../LSaddon/LSaddon_showTechInfo/index.html | 3489 +++++ .../conf/LSaddon/index.html | 3465 +++++ .../LSauthMethod/LSauthMethod_CAS/index.html | 3575 +++++ .../LSauthMethod/LSauthMethod_HTTP/index.html | 3567 +++++ .../LSauthMethod_anonymous/index.html | 3468 +++++ .../conf/LSauthMethod/index.html | 3465 +++++ .../LSattr_html_boolean/index.html | 3506 +++++ .../LSattr_html/LSattr_html_date/index.html | 3674 +++++ .../LSattr_html_gpg_pub_key/index.html | 3468 +++++ .../LSattr_html/LSattr_html_image/index.html | 3468 +++++ .../index.html | 3565 +++++ .../LSattr_html_labeledValue/index.html | 3491 +++++ .../LSattr_html/LSattr_html_mail/index.html | 3490 +++++ .../LSattr_html_mailQuota/index.html | 3482 +++++ .../LSattr_html_maildir/index.html | 3528 +++++ .../LSattr_html_password/index.html | 3708 +++++ .../LSattr_html_postaladdress/index.html | 3513 +++++ .../LSattr_html/LSattr_html_pre/index.html | 3470 +++++ .../LSattr_html/LSattr_html_rss/index.html | 3473 +++++ .../LSattr_html_sambaAcctFlags/index.html | 3515 +++++ .../LSattr_html_select_box/index.html | 3483 +++++ .../LSattr_html_select_list/index.html | 3675 +++++ .../LSattr_html_select_object/index.html | 3557 +++++ .../LSattr_html_ssh_key/index.html | 3468 +++++ .../LSattr_html/LSattr_html_tel/index.html | 3473 +++++ .../LSattr_html/LSattr_html_text/index.html | 3633 +++++ .../LSattr_html_textarea/index.html | 3469 +++++ .../LSattr_html/LSattr_html_url/index.html | 3474 +++++ .../LSattr_html_valueWithUnit/index.html | 3528 +++++ .../LSattr_html_wysiwyg/index.html | 3485 +++++ .../LSattr_html/LSattr_html_xmpp/index.html | 3479 +++++ .../LSattribute/LSattr_html/index.html | 3468 +++++ .../LSattr_ldap/LSattr_ldap_ascii/index.html | 3468 +++++ .../LSattr_ldap_boolean/index.html | 3491 +++++ .../index.html | 3471 +++++ .../LSattr_ldap/LSattr_ldap_date/index.html | 3529 +++++ .../LSattr_ldap/LSattr_ldap_image/index.html | 3468 +++++ .../LSattr_ldap_naiveDate/index.html | 3489 +++++ .../LSattr_ldap_numeric/index.html | 3468 +++++ .../LSattr_ldap_password/index.html | 3557 +++++ .../LSattr_ldap_postaladdress/index.html | 3472 +++++ .../LSattr_ldap_pwdHistory/index.html | 3537 +++++ .../LSattr_ldap_sambaAcctFlags/index.html | 3471 +++++ .../LSattr_ldap_shadowExpire/index.html | 3475 +++++ .../LSattribute/LSattr_ldap/index.html | 3468 +++++ .../check_data/alphanumeric/index.html | 3474 +++++ .../check_data/callable/index.html | 3476 +++++ .../LSattribute/check_data/date/index.html | 3482 +++++ .../check_data/differentPassword/index.html | 3479 +++++ .../LSattribute/check_data/email/index.html | 3482 +++++ .../check_data/filesize/index.html | 3480 +++++ .../check_data/gpg_pub_key/index.html | 3468 +++++ .../check_data/imagefile/index.html | 3474 +++++ .../check_data/imagesize/index.html | 3492 +++++ .../LSattribute/check_data/inarray/index.html | 3482 +++++ .../LSattribute/check_data/index.html | 3497 +++++ .../LSattribute/check_data/integer/index.html | 3493 +++++ .../check_data/ldapSearchURI/index.html | 3538 +++++ .../check_data/lettersonly/index.html | 3468 +++++ .../check_data/maxlength/index.html | 3474 +++++ .../check_data/mimetype/index.html | 3482 +++++ .../check_data/minlength/index.html | 3474 +++++ .../LSattribute/check_data/nonzero/index.html | 3467 +++++ .../check_data/nopunctuation/index.html | 3469 +++++ .../check_data/numberOfValues/index.html | 3480 +++++ .../LSattribute/check_data/numeric/index.html | 3467 +++++ .../check_data/password/index.html | 3502 +++++ .../check_data/rangelength/index.html | 3475 +++++ .../LSattribute/check_data/regex/index.html | 3474 +++++ .../check_data/required/index.html | 3467 +++++ .../check_data/ssh_pub_key/index.html | 3470 +++++ .../check_data/telephonenumber/index.html | 3468 +++++ .../LSattribute/check_data/zxcvbn/index.html | 3515 +++++ .../conf/LSobject/LSattribute/index.html | 3738 +++++ .../LSobject/LSattribute/triggers/index.html | 3624 +++++ .../LSattribute/validation/index.html | 3640 +++++ .../conf/LSobject/LSform/index.html | 3740 +++++ .../conf/LSobject/LSrelation/index.html | 3624 +++++ .../conf/LSobject/LSsearch/index.html | 4021 +++++ .../LSobject/container_auto_create/index.html | 3496 +++++ .../conf/LSobject/customActions/index.html | 3674 +++++ .../conf/LSobject/index.html | 3707 +++++ .../conf/LSobject/ioFormat/index.html | 3903 +++++ .../conf/LSobject/triggers/index.html | 3628 +++++ .../conf/global/LDAP_search_params/index.html | 3509 +++++ .../conf/global/LSformat/index.html | 3499 +++++ .../conf/global/LSlog/index.html | 3732 +++++ .../conf/global/index.html | 3764 +++++ .../conf/global/ldap/LSprofile/index.html | 3788 +++++ .../conf/global/ldap/index.html | 3762 +++++ .../global/ldap/recoverPassword/index.html | 3516 +++++ .../conf/global/ldap/subDn/index.html | 3527 +++++ doc/dist/4.2.0-1-30-g6646ca9/conf/index.html | 3468 +++++ .../contrib/addons/cli-commands/index.html | 3697 +++++ .../contrib/addons/custom-views/index.html | 3527 +++++ .../contrib/addons/index.html | 3726 +++++ .../contrib/form-elements/index.html | 3562 +++++ .../contrib/form-rules/index.html | 3498 +++++ .../4.2.0-1-30-g6646ca9/contrib/index.html | 3462 +++++ .../css/print-site-material.css | 46 + .../4.2.0-1-30-g6646ca9/css/print-site.css | 394 + doc/dist/4.2.0-1-30-g6646ca9/index.html | 3590 +++++ .../install/arbo/index.html | 3575 +++++ .../install/download/index.html | 3571 +++++ .../install/howto/index.html | 3603 +++++ .../install/requirements/index.html | 3530 +++++ doc/dist/4.2.0-1-30-g6646ca9/js/print-site.js | 123 + .../4.2.0-1-30-g6646ca9/print_page/index.html | 12110 ++++++++++++++++ .../search/search_index.json | 1 + doc/dist/4.2.0-1-30-g6646ca9/sitemap.xml | 598 + doc/dist/4.2.0-1-30-g6646ca9/sitemap.xml.gz | Bin 0 -> 1120 bytes .../upgrade/2_4_1-to-3_0_0/index.html | 4097 ++++++ .../4.2.0-1-30-g6646ca9/upgrade/index.html | 3463 +++++ .../upgrade/method/index.html | 3571 +++++ doc/dist/dev | 2 +- doc/dist/versions.json | 9 +- 178 files changed, 454941 insertions(+), 3 deletions(-) create mode 100644 doc/dist/4.2.0-1-30-g6646ca9/404.html create mode 100644 doc/dist/4.2.0-1-30-g6646ca9/LdapSaisie.epub create mode 100644 doc/dist/4.2.0-1-30-g6646ca9/LdapSaisie.html create mode 100644 doc/dist/4.2.0-1-30-g6646ca9/LdapSaisie.pdf create mode 100644 doc/dist/4.2.0-1-30-g6646ca9/api/index.html create mode 100644 doc/dist/4.2.0-1-30-g6646ca9/assets/images/favicon.png create mode 100644 doc/dist/4.2.0-1-30-g6646ca9/assets/images/logo.png create mode 100644 doc/dist/4.2.0-1-30-g6646ca9/assets/javascripts/bundle.ad660dcc.min.js create mode 100644 doc/dist/4.2.0-1-30-g6646ca9/assets/javascripts/bundle.ad660dcc.min.js.map create mode 100644 doc/dist/4.2.0-1-30-g6646ca9/assets/javascripts/lunr/min/lunr.ar.min.js create mode 100644 doc/dist/4.2.0-1-30-g6646ca9/assets/javascripts/lunr/min/lunr.da.min.js create mode 100644 doc/dist/4.2.0-1-30-g6646ca9/assets/javascripts/lunr/min/lunr.de.min.js create mode 100644 doc/dist/4.2.0-1-30-g6646ca9/assets/javascripts/lunr/min/lunr.du.min.js create mode 100644 doc/dist/4.2.0-1-30-g6646ca9/assets/javascripts/lunr/min/lunr.el.min.js create mode 100644 doc/dist/4.2.0-1-30-g6646ca9/assets/javascripts/lunr/min/lunr.es.min.js create mode 100644 doc/dist/4.2.0-1-30-g6646ca9/assets/javascripts/lunr/min/lunr.fi.min.js create mode 100644 doc/dist/4.2.0-1-30-g6646ca9/assets/javascripts/lunr/min/lunr.fr.min.js create mode 100644 doc/dist/4.2.0-1-30-g6646ca9/assets/javascripts/lunr/min/lunr.he.min.js create mode 100644 doc/dist/4.2.0-1-30-g6646ca9/assets/javascripts/lunr/min/lunr.hi.min.js create mode 100644 doc/dist/4.2.0-1-30-g6646ca9/assets/javascripts/lunr/min/lunr.hu.min.js create mode 100644 doc/dist/4.2.0-1-30-g6646ca9/assets/javascripts/lunr/min/lunr.hy.min.js create mode 100644 doc/dist/4.2.0-1-30-g6646ca9/assets/javascripts/lunr/min/lunr.it.min.js create mode 100644 doc/dist/4.2.0-1-30-g6646ca9/assets/javascripts/lunr/min/lunr.ja.min.js create mode 100644 doc/dist/4.2.0-1-30-g6646ca9/assets/javascripts/lunr/min/lunr.jp.min.js create mode 100644 doc/dist/4.2.0-1-30-g6646ca9/assets/javascripts/lunr/min/lunr.kn.min.js create mode 100644 doc/dist/4.2.0-1-30-g6646ca9/assets/javascripts/lunr/min/lunr.ko.min.js create mode 100644 doc/dist/4.2.0-1-30-g6646ca9/assets/javascripts/lunr/min/lunr.multi.min.js create mode 100644 doc/dist/4.2.0-1-30-g6646ca9/assets/javascripts/lunr/min/lunr.nl.min.js create mode 100644 doc/dist/4.2.0-1-30-g6646ca9/assets/javascripts/lunr/min/lunr.no.min.js create mode 100644 doc/dist/4.2.0-1-30-g6646ca9/assets/javascripts/lunr/min/lunr.pt.min.js create mode 100644 doc/dist/4.2.0-1-30-g6646ca9/assets/javascripts/lunr/min/lunr.ro.min.js create mode 100644 doc/dist/4.2.0-1-30-g6646ca9/assets/javascripts/lunr/min/lunr.ru.min.js create mode 100644 doc/dist/4.2.0-1-30-g6646ca9/assets/javascripts/lunr/min/lunr.sa.min.js create mode 100644 doc/dist/4.2.0-1-30-g6646ca9/assets/javascripts/lunr/min/lunr.stemmer.support.min.js create mode 100644 doc/dist/4.2.0-1-30-g6646ca9/assets/javascripts/lunr/min/lunr.sv.min.js create mode 100644 doc/dist/4.2.0-1-30-g6646ca9/assets/javascripts/lunr/min/lunr.ta.min.js create mode 100644 doc/dist/4.2.0-1-30-g6646ca9/assets/javascripts/lunr/min/lunr.te.min.js create mode 100644 doc/dist/4.2.0-1-30-g6646ca9/assets/javascripts/lunr/min/lunr.th.min.js create mode 100644 doc/dist/4.2.0-1-30-g6646ca9/assets/javascripts/lunr/min/lunr.tr.min.js create mode 100644 doc/dist/4.2.0-1-30-g6646ca9/assets/javascripts/lunr/min/lunr.vi.min.js create mode 100644 doc/dist/4.2.0-1-30-g6646ca9/assets/javascripts/lunr/min/lunr.zh.min.js create mode 100644 doc/dist/4.2.0-1-30-g6646ca9/assets/javascripts/lunr/tinyseg.js create mode 100644 doc/dist/4.2.0-1-30-g6646ca9/assets/javascripts/lunr/wordcut.js create mode 100644 doc/dist/4.2.0-1-30-g6646ca9/assets/javascripts/workers/search.b8dbb3d2.min.js create mode 100644 doc/dist/4.2.0-1-30-g6646ca9/assets/javascripts/workers/search.b8dbb3d2.min.js.map create mode 100644 doc/dist/4.2.0-1-30-g6646ca9/assets/stylesheets/main.6543a935.min.css create mode 100644 doc/dist/4.2.0-1-30-g6646ca9/assets/stylesheets/main.6543a935.min.css.map create mode 100644 doc/dist/4.2.0-1-30-g6646ca9/assets/stylesheets/palette.06af60db.min.css create mode 100644 doc/dist/4.2.0-1-30-g6646ca9/assets/stylesheets/palette.06af60db.min.css.map create mode 100644 doc/dist/4.2.0-1-30-g6646ca9/assets/templates/custom_cover_page.tpl create mode 100644 doc/dist/4.2.0-1-30-g6646ca9/assets/templates/print_site_banner.tpl create mode 100644 doc/dist/4.2.0-1-30-g6646ca9/conf/LSaddon/LSaddon_LSaccessRightsMatrixView/index.html create mode 100644 doc/dist/4.2.0-1-30-g6646ca9/conf/LSaddon/LSaddon_accesslog/index.html create mode 100644 doc/dist/4.2.0-1-30-g6646ca9/conf/LSaddon/LSaddon_asterisk/index.html create mode 100644 doc/dist/4.2.0-1-30-g6646ca9/conf/LSaddon/LSaddon_exportSearchResultAsCSV/index.html create mode 100644 doc/dist/4.2.0-1-30-g6646ca9/conf/LSaddon/LSaddon_impersonate/index.html create mode 100644 doc/dist/4.2.0-1-30-g6646ca9/conf/LSaddon/LSaddon_mail/index.html create mode 100644 doc/dist/4.2.0-1-30-g6646ca9/conf/LSaddon/LSaddon_maildir/index.html create mode 100644 doc/dist/4.2.0-1-30-g6646ca9/conf/LSaddon/LSaddon_mailquota/index.html create mode 100644 doc/dist/4.2.0-1-30-g6646ca9/conf/LSaddon/LSaddon_phpldapadmin/index.html create mode 100644 doc/dist/4.2.0-1-30-g6646ca9/conf/LSaddon/LSaddon_ppolicy/index.html create mode 100644 doc/dist/4.2.0-1-30-g6646ca9/conf/LSaddon/LSaddon_showSupportInfo/index.html create mode 100644 doc/dist/4.2.0-1-30-g6646ca9/conf/LSaddon/LSaddon_showTechInfo/index.html create mode 100644 doc/dist/4.2.0-1-30-g6646ca9/conf/LSaddon/index.html create mode 100644 doc/dist/4.2.0-1-30-g6646ca9/conf/LSauthMethod/LSauthMethod_CAS/index.html create mode 100644 doc/dist/4.2.0-1-30-g6646ca9/conf/LSauthMethod/LSauthMethod_HTTP/index.html create mode 100644 doc/dist/4.2.0-1-30-g6646ca9/conf/LSauthMethod/LSauthMethod_anonymous/index.html create mode 100644 doc/dist/4.2.0-1-30-g6646ca9/conf/LSauthMethod/index.html create mode 100644 doc/dist/4.2.0-1-30-g6646ca9/conf/LSobject/LSattribute/LSattr_html/LSattr_html_boolean/index.html create mode 100644 doc/dist/4.2.0-1-30-g6646ca9/conf/LSobject/LSattribute/LSattr_html/LSattr_html_date/index.html create mode 100644 doc/dist/4.2.0-1-30-g6646ca9/conf/LSobject/LSattribute/LSattr_html/LSattr_html_gpg_pub_key/index.html create mode 100644 doc/dist/4.2.0-1-30-g6646ca9/conf/LSobject/LSattribute/LSattr_html/LSattr_html_image/index.html create mode 100644 doc/dist/4.2.0-1-30-g6646ca9/conf/LSobject/LSattribute/LSattr_html/LSattr_html_jsonCompositeAttribute/index.html create mode 100644 doc/dist/4.2.0-1-30-g6646ca9/conf/LSobject/LSattribute/LSattr_html/LSattr_html_labeledValue/index.html create mode 100644 doc/dist/4.2.0-1-30-g6646ca9/conf/LSobject/LSattribute/LSattr_html/LSattr_html_mail/index.html create mode 100644 doc/dist/4.2.0-1-30-g6646ca9/conf/LSobject/LSattribute/LSattr_html/LSattr_html_mailQuota/index.html create mode 100644 doc/dist/4.2.0-1-30-g6646ca9/conf/LSobject/LSattribute/LSattr_html/LSattr_html_maildir/index.html create mode 100644 doc/dist/4.2.0-1-30-g6646ca9/conf/LSobject/LSattribute/LSattr_html/LSattr_html_password/index.html create mode 100644 doc/dist/4.2.0-1-30-g6646ca9/conf/LSobject/LSattribute/LSattr_html/LSattr_html_postaladdress/index.html create mode 100644 doc/dist/4.2.0-1-30-g6646ca9/conf/LSobject/LSattribute/LSattr_html/LSattr_html_pre/index.html create mode 100644 doc/dist/4.2.0-1-30-g6646ca9/conf/LSobject/LSattribute/LSattr_html/LSattr_html_rss/index.html create mode 100644 doc/dist/4.2.0-1-30-g6646ca9/conf/LSobject/LSattribute/LSattr_html/LSattr_html_sambaAcctFlags/index.html create mode 100644 doc/dist/4.2.0-1-30-g6646ca9/conf/LSobject/LSattribute/LSattr_html/LSattr_html_select_box/index.html create mode 100644 doc/dist/4.2.0-1-30-g6646ca9/conf/LSobject/LSattribute/LSattr_html/LSattr_html_select_list/index.html create mode 100644 doc/dist/4.2.0-1-30-g6646ca9/conf/LSobject/LSattribute/LSattr_html/LSattr_html_select_object/index.html create mode 100644 doc/dist/4.2.0-1-30-g6646ca9/conf/LSobject/LSattribute/LSattr_html/LSattr_html_ssh_key/index.html create mode 100644 doc/dist/4.2.0-1-30-g6646ca9/conf/LSobject/LSattribute/LSattr_html/LSattr_html_tel/index.html create mode 100644 doc/dist/4.2.0-1-30-g6646ca9/conf/LSobject/LSattribute/LSattr_html/LSattr_html_text/index.html create mode 100644 doc/dist/4.2.0-1-30-g6646ca9/conf/LSobject/LSattribute/LSattr_html/LSattr_html_textarea/index.html create mode 100644 doc/dist/4.2.0-1-30-g6646ca9/conf/LSobject/LSattribute/LSattr_html/LSattr_html_url/index.html create mode 100644 doc/dist/4.2.0-1-30-g6646ca9/conf/LSobject/LSattribute/LSattr_html/LSattr_html_valueWithUnit/index.html create mode 100644 doc/dist/4.2.0-1-30-g6646ca9/conf/LSobject/LSattribute/LSattr_html/LSattr_html_wysiwyg/index.html create mode 100644 doc/dist/4.2.0-1-30-g6646ca9/conf/LSobject/LSattribute/LSattr_html/LSattr_html_xmpp/index.html create mode 100644 doc/dist/4.2.0-1-30-g6646ca9/conf/LSobject/LSattribute/LSattr_html/index.html create mode 100644 doc/dist/4.2.0-1-30-g6646ca9/conf/LSobject/LSattribute/LSattr_ldap/LSattr_ldap_ascii/index.html create mode 100644 doc/dist/4.2.0-1-30-g6646ca9/conf/LSobject/LSattribute/LSattr_ldap/LSattr_ldap_boolean/index.html create mode 100644 doc/dist/4.2.0-1-30-g6646ca9/conf/LSobject/LSattribute/LSattr_ldap/LSattr_ldap_compositeValueToJSON/index.html create mode 100644 doc/dist/4.2.0-1-30-g6646ca9/conf/LSobject/LSattribute/LSattr_ldap/LSattr_ldap_date/index.html create mode 100644 doc/dist/4.2.0-1-30-g6646ca9/conf/LSobject/LSattribute/LSattr_ldap/LSattr_ldap_image/index.html create mode 100644 doc/dist/4.2.0-1-30-g6646ca9/conf/LSobject/LSattribute/LSattr_ldap/LSattr_ldap_naiveDate/index.html create mode 100644 doc/dist/4.2.0-1-30-g6646ca9/conf/LSobject/LSattribute/LSattr_ldap/LSattr_ldap_numeric/index.html create mode 100644 doc/dist/4.2.0-1-30-g6646ca9/conf/LSobject/LSattribute/LSattr_ldap/LSattr_ldap_password/index.html create mode 100644 doc/dist/4.2.0-1-30-g6646ca9/conf/LSobject/LSattribute/LSattr_ldap/LSattr_ldap_postaladdress/index.html create mode 100644 doc/dist/4.2.0-1-30-g6646ca9/conf/LSobject/LSattribute/LSattr_ldap/LSattr_ldap_pwdHistory/index.html create mode 100644 doc/dist/4.2.0-1-30-g6646ca9/conf/LSobject/LSattribute/LSattr_ldap/LSattr_ldap_sambaAcctFlags/index.html create mode 100644 doc/dist/4.2.0-1-30-g6646ca9/conf/LSobject/LSattribute/LSattr_ldap/LSattr_ldap_shadowExpire/index.html create mode 100644 doc/dist/4.2.0-1-30-g6646ca9/conf/LSobject/LSattribute/LSattr_ldap/index.html create mode 100644 doc/dist/4.2.0-1-30-g6646ca9/conf/LSobject/LSattribute/check_data/alphanumeric/index.html create mode 100644 doc/dist/4.2.0-1-30-g6646ca9/conf/LSobject/LSattribute/check_data/callable/index.html create mode 100644 doc/dist/4.2.0-1-30-g6646ca9/conf/LSobject/LSattribute/check_data/date/index.html create mode 100644 doc/dist/4.2.0-1-30-g6646ca9/conf/LSobject/LSattribute/check_data/differentPassword/index.html create mode 100644 doc/dist/4.2.0-1-30-g6646ca9/conf/LSobject/LSattribute/check_data/email/index.html create mode 100644 doc/dist/4.2.0-1-30-g6646ca9/conf/LSobject/LSattribute/check_data/filesize/index.html create mode 100644 doc/dist/4.2.0-1-30-g6646ca9/conf/LSobject/LSattribute/check_data/gpg_pub_key/index.html create mode 100644 doc/dist/4.2.0-1-30-g6646ca9/conf/LSobject/LSattribute/check_data/imagefile/index.html create mode 100644 doc/dist/4.2.0-1-30-g6646ca9/conf/LSobject/LSattribute/check_data/imagesize/index.html create mode 100644 doc/dist/4.2.0-1-30-g6646ca9/conf/LSobject/LSattribute/check_data/inarray/index.html create mode 100644 doc/dist/4.2.0-1-30-g6646ca9/conf/LSobject/LSattribute/check_data/index.html create mode 100644 doc/dist/4.2.0-1-30-g6646ca9/conf/LSobject/LSattribute/check_data/integer/index.html create mode 100644 doc/dist/4.2.0-1-30-g6646ca9/conf/LSobject/LSattribute/check_data/ldapSearchURI/index.html create mode 100644 doc/dist/4.2.0-1-30-g6646ca9/conf/LSobject/LSattribute/check_data/lettersonly/index.html create mode 100644 doc/dist/4.2.0-1-30-g6646ca9/conf/LSobject/LSattribute/check_data/maxlength/index.html create mode 100644 doc/dist/4.2.0-1-30-g6646ca9/conf/LSobject/LSattribute/check_data/mimetype/index.html create mode 100644 doc/dist/4.2.0-1-30-g6646ca9/conf/LSobject/LSattribute/check_data/minlength/index.html create mode 100644 doc/dist/4.2.0-1-30-g6646ca9/conf/LSobject/LSattribute/check_data/nonzero/index.html create mode 100644 doc/dist/4.2.0-1-30-g6646ca9/conf/LSobject/LSattribute/check_data/nopunctuation/index.html create mode 100644 doc/dist/4.2.0-1-30-g6646ca9/conf/LSobject/LSattribute/check_data/numberOfValues/index.html create mode 100644 doc/dist/4.2.0-1-30-g6646ca9/conf/LSobject/LSattribute/check_data/numeric/index.html create mode 100644 doc/dist/4.2.0-1-30-g6646ca9/conf/LSobject/LSattribute/check_data/password/index.html create mode 100644 doc/dist/4.2.0-1-30-g6646ca9/conf/LSobject/LSattribute/check_data/rangelength/index.html create mode 100644 doc/dist/4.2.0-1-30-g6646ca9/conf/LSobject/LSattribute/check_data/regex/index.html create mode 100644 doc/dist/4.2.0-1-30-g6646ca9/conf/LSobject/LSattribute/check_data/required/index.html create mode 100644 doc/dist/4.2.0-1-30-g6646ca9/conf/LSobject/LSattribute/check_data/ssh_pub_key/index.html create mode 100644 doc/dist/4.2.0-1-30-g6646ca9/conf/LSobject/LSattribute/check_data/telephonenumber/index.html create mode 100644 doc/dist/4.2.0-1-30-g6646ca9/conf/LSobject/LSattribute/check_data/zxcvbn/index.html create mode 100644 doc/dist/4.2.0-1-30-g6646ca9/conf/LSobject/LSattribute/index.html create mode 100644 doc/dist/4.2.0-1-30-g6646ca9/conf/LSobject/LSattribute/triggers/index.html create mode 100644 doc/dist/4.2.0-1-30-g6646ca9/conf/LSobject/LSattribute/validation/index.html create mode 100644 doc/dist/4.2.0-1-30-g6646ca9/conf/LSobject/LSform/index.html create mode 100644 doc/dist/4.2.0-1-30-g6646ca9/conf/LSobject/LSrelation/index.html create mode 100644 doc/dist/4.2.0-1-30-g6646ca9/conf/LSobject/LSsearch/index.html create mode 100644 doc/dist/4.2.0-1-30-g6646ca9/conf/LSobject/container_auto_create/index.html create mode 100644 doc/dist/4.2.0-1-30-g6646ca9/conf/LSobject/customActions/index.html create mode 100644 doc/dist/4.2.0-1-30-g6646ca9/conf/LSobject/index.html create mode 100644 doc/dist/4.2.0-1-30-g6646ca9/conf/LSobject/ioFormat/index.html create mode 100644 doc/dist/4.2.0-1-30-g6646ca9/conf/LSobject/triggers/index.html create mode 100644 doc/dist/4.2.0-1-30-g6646ca9/conf/global/LDAP_search_params/index.html create mode 100644 doc/dist/4.2.0-1-30-g6646ca9/conf/global/LSformat/index.html create mode 100644 doc/dist/4.2.0-1-30-g6646ca9/conf/global/LSlog/index.html create mode 100644 doc/dist/4.2.0-1-30-g6646ca9/conf/global/index.html create mode 100644 doc/dist/4.2.0-1-30-g6646ca9/conf/global/ldap/LSprofile/index.html create mode 100644 doc/dist/4.2.0-1-30-g6646ca9/conf/global/ldap/index.html create mode 100644 doc/dist/4.2.0-1-30-g6646ca9/conf/global/ldap/recoverPassword/index.html create mode 100644 doc/dist/4.2.0-1-30-g6646ca9/conf/global/ldap/subDn/index.html create mode 100644 doc/dist/4.2.0-1-30-g6646ca9/conf/index.html create mode 100644 doc/dist/4.2.0-1-30-g6646ca9/contrib/addons/cli-commands/index.html create mode 100644 doc/dist/4.2.0-1-30-g6646ca9/contrib/addons/custom-views/index.html create mode 100644 doc/dist/4.2.0-1-30-g6646ca9/contrib/addons/index.html create mode 100644 doc/dist/4.2.0-1-30-g6646ca9/contrib/form-elements/index.html create mode 100644 doc/dist/4.2.0-1-30-g6646ca9/contrib/form-rules/index.html create mode 100644 doc/dist/4.2.0-1-30-g6646ca9/contrib/index.html create mode 100644 doc/dist/4.2.0-1-30-g6646ca9/css/print-site-material.css create mode 100644 doc/dist/4.2.0-1-30-g6646ca9/css/print-site.css create mode 100644 doc/dist/4.2.0-1-30-g6646ca9/index.html create mode 100644 doc/dist/4.2.0-1-30-g6646ca9/install/arbo/index.html create mode 100644 doc/dist/4.2.0-1-30-g6646ca9/install/download/index.html create mode 100644 doc/dist/4.2.0-1-30-g6646ca9/install/howto/index.html create mode 100644 doc/dist/4.2.0-1-30-g6646ca9/install/requirements/index.html create mode 100644 doc/dist/4.2.0-1-30-g6646ca9/js/print-site.js create mode 100644 doc/dist/4.2.0-1-30-g6646ca9/print_page/index.html create mode 100644 doc/dist/4.2.0-1-30-g6646ca9/search/search_index.json create mode 100644 doc/dist/4.2.0-1-30-g6646ca9/sitemap.xml create mode 100644 doc/dist/4.2.0-1-30-g6646ca9/sitemap.xml.gz create mode 100644 doc/dist/4.2.0-1-30-g6646ca9/upgrade/2_4_1-to-3_0_0/index.html create mode 100644 doc/dist/4.2.0-1-30-g6646ca9/upgrade/index.html create mode 100644 doc/dist/4.2.0-1-30-g6646ca9/upgrade/method/index.html diff --git a/doc/dist/4.2.0-1-30-g6646ca9/404.html b/doc/dist/4.2.0-1-30-g6646ca9/404.html new file mode 100644 index 00000000..ca06592f --- /dev/null +++ b/doc/dist/4.2.0-1-30-g6646ca9/404.html @@ -0,0 +1,3411 @@ + + + + + + + + + + + + + + + + + + + + + + + LdapSaisie + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ +
+
+ +
+ + + + + + + + +
+ + +
+ +
+ + + + + + +
+
+ + + +
+
+
+ + + + + +
+
+
+ + + +
+
+
+ + + +
+
+
+ + + +
+
+ +

404 - Not found

+ +
+
+ + + +
+ +
+ + + +
+
+
+
+ + + + + + + + + + + + \ No newline at end of file diff --git a/doc/dist/4.2.0-1-30-g6646ca9/LdapSaisie.epub b/doc/dist/4.2.0-1-30-g6646ca9/LdapSaisie.epub new file mode 100644 index 0000000000000000000000000000000000000000..5948e117848278933a69d115ba668b6f9f7134ca GIT binary patch literal 107644 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 G!2bdDUQ;Xp literal 0 HcmV?d00001 diff --git a/doc/dist/4.2.0-1-30-g6646ca9/LdapSaisie.html b/doc/dist/4.2.0-1-30-g6646ca9/LdapSaisie.html new file mode 100644 index 00000000..0da1a183 --- /dev/null +++ b/doc/dist/4.2.0-1-30-g6646ca9/LdapSaisie.html @@ -0,0 +1,8739 @@ + + + + + + + + + + +Documentation - LdapSaisie + + + + + + + + + + + + + + +
+
+
+
+ +
+ +
+
+
+
+ + +
+
+
+
+
+

LdapSaisie

+

Documentation

+
+

+ + Auteur: Benjamin Renard + (brenard@easter-eggs.com / + brenard@zionetrix.net) +
+Site web: https://ldapsaisie.org/doc/
+Repo: https://gitlab.easter-eggs.com/ee/ldapsaisie
+Easter-eggs
+

+
+ +
+
+ +
+
+

Introduction

+

LdapSaisie est une application web d'administration d'annuaire LDAP développée en PHP/Javascript. +Cette application a pour but d'abstraire la complexité d'un annuaire par l'intermédiraire d'une +interface d'administration simple et intuitive. L'application a été concue avec pour objectif +premier une modularité maximum, ce qui permet l'extention ou l'adaptation facile de l'application +par l'intermédiaire de modules, d'extentions et de greffons. Cette application peut être utilisée +pour administrer le système d'information basé sur l'annuaire LDAP et également en paralèlle pour +permettre aux utilisateurs d'avoir accès aux données les concernants et éventuellement de les +modifier.

+

Fonctionnalités

+

De part sa modularité, LdapSaisie est facilement extensible. Cependant, voici une liste +non-exhaustive de ses fonctionnalités :

+
    +
  • Gestion d'annuaire simple et multi-branches
    • +
  • Gestion d'un nombre illimité de types d'objets
    • +
  • Gestion d'un nombre illimité de populations se connectant à l'interface
    • +
  • Gestion fine des droits des utilisateurs, permettant la maitrise des droits d'accès sur les objets + de l'annuaire et leurs atributs, tout en permettant la délégation de droits.
    • +
  • +

    Gestion d'un grand nombre de types d'attributs :

    +
      +
    • Texte (court ou long)
      • +
    • Date (format paramétrable)
      • +
    • Booléen (valeurs paramétrables)
      • +
    • Image/Photo
      • +
    • Mot de passe (génération de mot passe avec gestion d'une politique fine)
      • +
    • Adresse mail
      • +
    • Flux RSS
      • +
    • Lien web (URL)
      • +
    • Adresse XMPP
      • +
    • Maildir
      • +
    • Quota de mails
      • +
    • Clef publique SSH
      • +
    • Liste déroulante à choix simple ou multiple
      • +
    • +

      Relation à d'autres objets de l'annuaire/ Exemple : membres d'un groupe, parrain d'un + utilisateur, ... (valeur clé paramétrable)

      +
      +

      Note

      +

      Chaque type d'attribut à des fonctionnalités qui lui sont propres et qui rendent plus facile +et agréable l'utilisation de l'interface (génération automatique de mot de passe, génération +des valeurs d'un champ à partir d'autres, ...).

      +
      +
      • +
    +
    • +
+
    +
  • Gestion d'un grand nombre de règles de vérification des valeurs des attributs :
      +
    • Alpha-numérique
      • +
    • Lettres uniquement
      • +
    • Longeur maximale/minimale d'une chaine de caractères
      • +
    • Valeur différente de zéro
      • +
    • Pas de signe de ponctuation
      • +
    • Valeur numérique
      • +
    • Comparaison de valeur
      • +
    • Date
      • +
    • Adresse mail
      • +
    • Poids d'une image
      • +
    • Taille d'une image
      • +
    • Type de fichiers images
      • +
    • Politique de mot de passe (longueur/caractères autorisés/caractères obligatoires)
      • +
    +
    • +
+
    +
  • Gestion simplifiée des relations entre les objets de l'annuaire
    • +
  • Interface facilement personnalisable grâce à l'utilisation d'un système de template.
    • +
  • Possibilité de postionner des déclencheurs permettant d'exécuter vos propres scripts, fonctions ou + méthodes au moments précis ou l'utilisateur créé, modifie ou supprime un objet ou un de ses + attributs. Ces déclencheurs, en fonction de leur positionnement, peuvent influencer le + comportement de l'application en empêchant par exemple, la validation des données d'un formulaire.
    • +
  • Gestion fine de l'affichage des attributs en fonction de l'écran (=vue) sur lequel se trouve + l'utilisateur.
    • +
  • Gestion des dépendances entre attributs, permettant par exemple de regénérer automatiquement la + valeur d'un attribut caché lors de la modification d'un autre.
    • +
  • Possibilité de gérer des attributs entièrement cachés, dont les valeurs seront modifiées lors de + la modification d'attribut en dépendance.
    • +

Installation

Pré-requis

+
    +
  • Le service Apache HTTP avec le module mod_rewrite d'activé. Les règles de réécriture d'URL sont + définies dans le fichier .htaccess fourni avec l'application et il est donc nécessaire + d'autoriser une telle configuration à ce niveau via la directive AllowOverride devant inclure à + minima FileInfo.
    • +
+
    +
  • L'utisateur exécutant le serveur web doit avoir les droits d'écriture sur le dossier tmp. En cas + d'installation à partir du paquet Debian, ce dossier est remplacé par un lien symbolique vers + le dossier /var/cache/ldapsaisie/.
    • +
+
    +
  • PHP 5.6 (ou supérieur) avec magic_quotes_gpc et register_globals à off. L'outil CLI de PHP + est par ailleurs nécessaire pour l'utilisation des outils CLI fournis avec l'application (fourni + par le paquet php-cli dans Debian).
    • +
+
    +
  • Le support LDAP dans PHP (paquet php-ldap dans Debian)
    • +
+
    +
  • Le support mhash dans PHP (paquet php5-mhash dans Debian Lenny, intégré à php-common dans les + versions supérieurs)
    • +
+
    +
  • Le support json dans PHP (pear install pecl/json sur RedHat, intégré au paquet php5-common + précédement)
    • +
+
    +
  • Net_LDAP2 (paquet php-net-ldap2 dans Debian ou + pear install net_ldap2)
    • +
+
    +
  • Le support mbstring dans PHP (paquet php-mbstring depuis Debian Stretch, intégré au paquet + php-common dans Debian)
    • +
+
    +
  • Smarty (paquet smarty3 dans Debian)
    • +
+
    +
  • La librairie Console_Table (nécessaire pour le + fonctionnement de l'outil CLI, paquet php-console-table dans Debian)
    • +
+
    +
  • Les librairies Mail et + PEAR_Mail_Mime (nécessaire pour l'envoi de courriels, + paquets php-mail et php-mail-mime dans Debian)
    • +
+ +
    +
  • La librairie PhpSecLib (nécessaire pour le + fonctionnement du LSaddon SSH, paquet + php-phpseclib dans Debian)
    • +
+
+

Warning

+

La librairie Net_LDAP2 oblige le fait que la racine DSE +de l'annuaire soit lisible en anonyme sinon la connexion à l'annuaire échouera systématiquement.

+
+
+

Note

+

Cette documentation est écrite à l'aide du langage Markdown et est mis en forme pour une +consultation en ligne à l'aide de mkdocs et son thème +mkdocs-material. Le dépendances pour construire +cette documentation sont listées dans le fichier doc/requirements.txt et sont installables à +l'aide de la commande pip install -r doc/requirements.txt.

+

Téléchargement

+

À partir du paquet Debian

+

L'installation à partir du paquet Debian peut être réalisée soit en téléchargeant manuellement le +paquet, soit en déclarant le dépôt APT suivant dans votre fichier /etc/apt/sources.list :

+
deb http://ldapsaisie.org/debian stable main
+
+

Il ne vous restera ensuite plus qu'a installer le paquet ldapsaisie avec la commande suivante :

+
apt-get install ldapsaisie
+
+

Le fichier /etc/ldapsaisie/apache.conf est un example de configuration du serveur web Apache. La +configuration du logiciel ce fera ensuite dans le dossier /etc/ldapsaisie/local/.

+

À partir de Git

+

Le dépôt Git peut être récupéré anonymement en utilisant la commande suivante :

+
git clone https://gitlab.easter-eggs.com/ee/ldapsaisie.git
+
+

La racine web de l'application se trouvera alors dans le dossier /ldapsaisie/src/public_html/.

+

À partir des snapshot

+

Toutes les nuits, un snapshot de l'arbre Git est réalisé et est téléchargeable au format tar.gz à +l'adresse suivante :

+

http://ldapsaisie.org/download/ldapsaisie-snapshoot.tar.gz

Arborescence du projet

+
    +
  • +

    doc/

    +

    Les fichiers sources de la documentation (Markdown & configuration Mkdocs).

    +
    • +
+
    +
  • +

    lsexample/

    +

    Les fichiers relatifs à l'annuaire d'exemple.

    +
    • +
+
    +
  • +

    src/

    +

    Les sources de l'application.

    +
      +
    • +

      public_html/

      +

      La racine web de l'application : celle-ci ne contient que les fichiers .htaccess et +index.php qui configure et déclenche la réécriture d'URL.

      +
      • +
    +
      +
    • +

      conf/

      +

      Contient les fichiers de configuration.

      +
        +
      • +

        LSobjects/

        +

        Configuration des LSobjects.

        +
        • +
      +
        +
      • +

        LSaddons/

        +

        Configuration des LSaddons.

        +
        • +
      + +
      • +
    +
      +
    • +

      includes/

      +

      Contient les fichiers des ressources.

      +
        +
      • +

        addons/

        +

        Les addons au projet.

        +
        • +
      +
        +
      • +

        class/

        +

        Les fichiers de définition des classes PHP.

        +
        • +
      +
        +
      • +

        js/

        +

        Les fichiers Javascript.

        +
        • +
      +
        +
      • +

        libs/

        +

        Les librairies utilisées.

        +
        • +
      +
      • +
    +
      +
    • +

      lang/

      +

      Les fichiers d'internationalisation.

      +
      • +
    +
      +
    • +

      templates/

      +

      Les fichiers template de l'interface. Il y a un sous-dossier par template.

      +
      • +
    +
      +
    • +

      css/

      +

      Les fichiers css de l'interface. Il y a un sous-dossier par template CSS.

      +
      • +
    +
      +
    • +

      images/

      +

      Les images de l'interface. Il y a un sous-dossier par template d'image.

      +
      • +
    +
      +
    • +

      local/

      +

      Les fichiers personnalisés de l'installation.

      +
      • +
    +
      +
    • +

      tmp/

      +

      Les fichiers temporaires (y compris le cache des templates).

      +
      • +
    +
    • +

Tutoriel d'installation

+

Cette section décrit les différentes étapes de l'installation de LdapSaisie. Deux méthodes +d'installation sont présentées ici, l'une à partir des sources du projet et l'autre à partir du +paquet Debian.

+

Dans ce tutoriel, nous partirons du principe que vous avez pleinement la main sur votre serveur +(installation de nouveau paquet et configuration de votre serveur web). Nous partons également du +principe que votre annuaire LDAP est déjà en place. Nous utiliserons pour cette exemple de mise en +oeuvre l'annuaire correspondant au schéma et à la configuration présente dans les sources du projet +dans le dossier lsexample.

+

La première étape consiste à installer le locigiel en tant que tel. Pour cela, référez vous au +chapitre Téléchargement.

+

En cas d'installation à partir du paquet Debian, la configuration du logiciel se fera dans le +dossier /etc/ldapsaisie/local/. Les fichiers placés dans ce dossier prévaleront toujours aux +fichiers fournis par le paquet Debian, vous permettant facilement de modifier un composant existant +ou dans écrire de nouveaux. Ainsi, pour modifier un fichier CSS par exemple, il vous suffira de le +placer dans le dossier /etc/ldapsaisie/local/css/.

+

Pour une installation à partir du code source, il vous faut cloner le dépôt Git du projet dans le +dossier /var/www/ldapsaisie. Pour cela il vous faut avoir installés les outils de Git contenu, +dans Debian, dans le paquet git-core. Le dépôt Git doit ensuite être récupéré anonymement en +utilisant la commande suivante :

+
git clone https://gitlab.easter-eggs.com/ee/ldapsaisie.git /var/www/ldapsaisie
+
+
+

Note

+

Pour que cette commande se déroule correctement, vous devez avoir accès au port TCP 443 du +serveur gitlab.easter-eggs.com. En cas de problème vérifiez votre parefeu.

+
+

La suite des opérations se déroulera donc maintenant dans le dossier /var/www/ldapsaisie. Pour +avoir plus de détails sur les élements qu'on retrouve dans ce dossier, vous pouvez consulter +la section concernée. Nous allons nous instérésser plus particulièrement :

+
    +
  • au script upgradeFromGit.sh permettant la mise à jour de votre repos tout en concervant les + adaptations que nous ferons pour l'usage d'LdapSaisie adapté à notre annuaire ;
    • +
+
    +
  • au dossier config.local dans lequel seront stockés vos fichiers et vos adaptations de + l'application ;
    • +
+
    +
  • au dossier src/public_html qui correspond à la futur racine du site web de l'application.
    • +
+

Le principe de l'adaptation est ici de mettre vos fichiers personnalisés dans le dossier +config.local, de les déclarer dans votre fichier config.local/local.sh contenant la liste des +fichiers devant être installés. Le fichier local.sh est la source de configuration du script +upgradeFromGit.sh. Il faut donc dans un premier temps créer votre fichier local.sh en copiant le +fichier d'example local.sh.example. Ce fichier est un script bash déclarant les variables de +configurations suivantes :

+
    +
  • +

    LOCAL_FILES

    +

    La liste des chemins des fichiers à installer dans l'arboressence du site. Cette élément doivent +être séparés par des espaces ou des retour à la liste. Exemple :

    +
    conf/config.inc.php
+lang/fr_FR.UTF8/lang.php
+
    +
    • +
+
    +
  • +

    LOG_FILE

    +

    Nom du fichier de log des mises à jour.

    +
    • +
+
    +
  • +

    THEME

    +

    Le nom du theme à installer (facultatif et non traité dans ce tutoriel).

    +
    +

    Note

    +

    Il est possible d'utiliser dans ce fichier de configuration la variable bash $ROOT_DIR +correspondant au chemin du dossier d'installation, c'est à dire dans notre exemple +/var/www/ldapsaisie.

    +
    +
    • +
+

La deuxième étape concerne la configuration globale de l'application : Cette partie est +principalement contenue dans le fichier src/conf/config.inc.php (ou +/etc/ldapsaisie/local/conf/config.inc.php en cas d'installation à partir du paquet Debian). En cas +d'installation à partir du code source, il faut donc dans un premier temps copier ce fichier dans le +dossier config.local et le déclarer dans la liste des fichiers à déployer lors des mises à jour +(variable LOCAL_FILES dans le fichier local.sh). Il s'agit en particulier dans ce fichier de +configurer la connexion à votre annuaire. Vous pouvez vous inspirer du fichier d'exemple fourni et +pour plus de détails, reportez-vous à la section concernée.

+
+

Note

+

Notez qu'il est possible de passer l'application en mode debug ce qui peut être utile par la +suite.

+
+

La troisième étape concerne la configuration des types de +LSobjects : Chaque type d'objet manipulé par +LdapSaisie doit correspondre avec un type de LSobject.

+
    +
  1. +

    Création du fichier de classe (optionnel) : Ce fichier contient la déclaration de la classe PHP + correspondant au type de LSobject. Cette classe étend la classe LSldapObject qui contient pour + ainsi dire toute les méthodes et proprités nécessaires pour les types de LSobject simples. Si + votre type de LSobject nécessite des méthodes ou propriétés particulières, vous pouvez implémenter + cette classe. À défaut, une classe vierge d'adaptation sera automatiquement déclarée.

    +

    Les fichiers des classes sont contenus dans le dossier /includes/class/ et portent les noms +composés de la manière suivante :

    +
    class.LSobjects.[nom du type d'LSobject].php
+
    +
    2. +
  2. +

    Configurer vos LSobject : Cette partie est certainement la plus longue et consiste à déclarer + l'ensemble des informations relatives aux types des objets LDAP manipulés. Les fichiers d'exemples + fournis vous seront alors d'une aide précieuse. Basez vous sur l'un de pour créer le votre. Pour + cela le fichier de configuration du type d'LSobjet LSpeople est le plus complet et est un bon + point de départ. Pour plus de détails sur les élements de configuration de ce fichier, + reportez-vous à la section concernée.

    +
    3. +
  3. +

    Configurer si nécessaire les relations entre les objets appelés LSrelations. Les + relations les plus simples (via un attribut de liaison) pourront être implémentées à l'aide d'un + simple paramètrage. Pour des relations, plus complexes, il sera possible d'implémenter des + méthodes personnalisées pour les gérer. Pour plus de détails, reportez-vous à + la section concernée.

    +
    +

    Note

    +

    Pour avoir un exemple de fichier de classe PHP implémentant des methodes de gestion de +LSrelations complexes, vous pouvez consulter le fichier de classe LSgroup.

    +
    +
    4. +
+
+

Important

+

En cas d'installation à partir du code source, pensez à déclarer les fichiers que vous venez de +créer dans la variable LOCAL_FILES du fichier local.sh. Exemple pour le type d'LSobjet +portant comme nom LSexample :

+
src/conf/LSobjects/config.LSobjects.LSexample.php
+src/includes/class/class.LSobjects.LSexample.php
+
+
+
+

Note

+

Vous pouvez également personnaliser l'interface : Il est possible de personnaliser à votre goût +l'interface en écrivant votre template ou en modifiant simplement les fichiers CSS. Une partie +de cette documentation concernera bientôt cette problématique. Patience...

+
+

En cas d'installation à partir du code source, une dernière étape à ce niveau consiste à lancer le +script upgradeFromGit.sh pour qu'il installe les fichiers que vous venez de créer. Ce script est +conçu pour dire tout ce qu'il fait donc en cas de problème vous devriez rapidement comprendre où +cela coince. Dans tout les cas, n'hésitez pas à poser vos questions à la communauté sur la liste +ldapsaisie-users@lists.ldapsaisie.org.

Ended: Installation

Mise à jour

Mise à jour

+

Cette section de la documentation détaille la procédure de mise à jour d'une installation existante +et regroupe des informations pratiques et utiles pour des montées de versions spécifiques entraînant +par exemple une perte de rétrocompatibilité de la configuration.

Procédure de mise à jour

+

Installation via paquet Debian

+

Lors d’une installation par paquet Debian, la mise à jour est grandement facilité par le packaging : +Il vous suffit de mettre à jour le paquet ldapsaisie :

+
apt update
+apt install ldapsaisie
+
+

Une fois l’application mise à jour, prêté attention aux nouveautés et point de vigilances décrite +dans la section suivante.

+

Installation à partir des sources

+

Lors d’une installation par à partir des sources, le script upgradeFromGit.sh permet d’automatiser +la mise à jour, à condition que vous ayez suivi la procédure d’installation à ce sujet.

+

Ce script s’occupera alors de :

+
    +
  • Nettoyer working-tree Git des liens symboliques des fichiers locaux (et éventuellement du + thème) mis en place lors d’une précédente exécution ;
    • +
+
    +
  • Vider le cache des templates ;
    • +
+
    +
  • Mettre à jour le working-tree Git via un git pull de la mise à jour ;
    • +
+
    +
  • Installer des liens symboliques pour les fichiers locaux. En cas de fichier remplacant un fichier + livré avec l’application, le script vous notifiera en cas de changement intervenu dans le fichier + fourni avec l’application et vous permettra de le mettre à jour simplement votre fichier local + (via un vim -d) ;
    • +
+
    +
  • Détecter des changements dans les fichiers MO (traduction) et de déclencher dans ce cas un + rechargement du serveur web pour prise en compte ;
    • +
+
    +
  • Option : de compiler une version locale à jour de la documentation ;
    • +
+

Une fois l’application mise à jour, prêté attention aux nouveautés et point de vigilances décrite +dans la section suivante.

Mise à jour 2.4.1 -> 3.0.0

+

Cette mise à jour majeure apporte de nombreuses nouveautés auxquelles il est important de prêter +attention. Cette section ne parlera pas particulièrement de ces nouveautés, mais vous pouvez +consulter le fichier +debian/ldapsaisie.NEWS +pour cela. Cette section listera en outre les points de vigilances à avoir et les adaptations à +apporter sur votre configuration et votre code personnalisé.

+

Fichier config.inc.php

+
    +
  • ajout du paramètre ConsoleTable avec pour valeur par défaut sous Debian + /usr/share/php/Console/Table.php
    • +
+
    +
  • ajout du paramètre public_root_url avec pour valeur par défaut sous Debian /ldapsaisie
    • +
+
    +
  • paramètre $GLOBALS['defaultCSSfiles'] : il est nécessaire de modifier les URLs des fichiers + listés : seul le nom du fichier doit rester, sa localisation sera détectée automatiquement. Par + exemple, $GLOBALS['defaultCSSfiles'] = array('../light-blue.css'); devient + $GLOBALS['defaultCSSfiles'] = array('light-blue.css');.
    • +
+
    +
  • +

    les paramètres authObjectType, authObjectFilter et authObjectTypeAttrPwd sont remplacés par + le tablau LSobjects dans le paramètre LSauth.

    +

    Par exemple:

    +
    'authObjectType' => 'LSpeople',
+'authObjectFilter' => '(|(uid=%{user})(mail=%{user}))',
+'authObjectTypeAttrPwd' => 'userPassword',
+
    +

    Devient:

    +
    'LSauth' => array (
+  'LSobjects' => array(
+    'LSpeople' => array(
+      'filter' => '(|(uid=%{user})(mail=%{user}))',
+      'password_attribute' => 'userPassword',
+    ),
+  ),
+  [...]
+),
+
    +
    • +
+
    +
  • Une erreur de frappe historique a été corrigé dans le nom de la variable + $GLOBALS['defaultJSscripts'], à savoir un "R" manquant.
    • +
+
    +
  • Les fichiers Javascript utilisés par défaut par l'application ne sont désormais plus listés dans + la variable $GLOBALS['defaultJSscripts']. Seul doit y demeurer vos propres fichiers. Voici la + liste des fichiers concernés et qui n'ont plus à être inclus via ce paramètre :

    - mootools-core.js + - mootools-more.js + - functions.js + - LSdefault.js + - LSinfosBox.js

    +
    • +
+

Fichiers CSS

+
+

Note

+

Les fichiers light-*.css ont été retravaillés pour tous hériter du fichier light-blue.css +qui défini les couleurs de l'interface au travers des variables. Ainsi, il est très simple +d'ajuster ce thème à vos couleurs. Si cela vous intéresse, vous pouvez prendre exemple sur les +autres fichiers light-*.css.

+

Au passage, ce thème a été retravaillé pour prendre en compte la mise en forme d'un maximum de +composants de l'application tout en profitant du côté responsive de l'interface apporter par +cette mise à jour. Si vous avez un thème personnalisé, il est conseillé de regarder si celui-ci +ne pourrait pas tirer partie du fichier light-blue.css en le surchargeant. À minima, vous +pouvez analyser les évolutions de ce fichier pour identifier les modifications intéressantes à +reporter sur votre thème personnel.

+
+
    +
  • Si vous utilisez un des fichiers light-*.css autre que le fichier light-blue.css, vous devez + désormais également charger ce dernier en premier.
    • +
+
    +
  • +

    corriger les URL des images : url(../../images/default/find.png) devient url(../image/find). + Pour identifier les fichiers CSS concernés, vous pouvez utiliser les commandes suivantes :

    +
    grep -Er 'url\(.*images' /etc/ldapsaisie/local/css
+grep -Er 'url\(.*\.(png|gif|jpg)' /etc/ldapsaisie/local/css
+
    +
    • +
+
    +
  • modification CSS page fatal_error (fichier base.css) : #fatal_error devient #error
    • +
+

Fichiers PHP

+
    +
  • +

    LSsession :: redirect() devient LSurl :: redirect(). Pour identifier les fichiers CSS + concernés, vous pouvez utiliser la commande suivante :

    +
    grep -Er 'LSsession *:: *redirect *\(' /etc/ldapsaisie/local/
+
    +
    • +
+
    +
  • +

    Les méthodes de gestion des Javascript et CSS additionels ont été migrées de la classe LSsession + vers la classe LStemplate :

    +
      +
    • +

      LSsession :: addJSscript() devient LStemplate :: addJSscript().

      +

      Par ailleurs le paramètre $path disparait et la méthode addLibJSscript a été ajoutée pour +permettre spécifiquement l'inclusion des fichiers Javascript des librairies. Voici quelques +exemples d'utilisation et leur équivalent à présent:

      +
        +
      • LSsession :: addJSscript('../../local/includes/js/LSformElement_eetelephone.js'); + devient LStemplate :: addJSscript('LSformElement_eetelephone.js');
        • +
      +
        +
      • LSsession :: addJSscript('../../local/includes/js/LSformElement_eetelephone.js'); + devient LStemplate :: addJSscript('LSformElement_eetelephone.js');
        • +
      +
        +
      • LSsession :: addJSscript('click-to-dial_view.js', 'local/includes/js/'); devient + LStemplate :: addJSscript('click-to-dial_view.js');
        • +
      +
        +
      • LSsession :: addJSscript('Picker.js',LS_LIB_DIR.'arian-mootools-datepicker/'); + devient LStemplate :: addLibJSscript('arian-mootools-datepicker/Picker.js');
        • +
      +
      • +
    +
      +
    • LSsession :: addJSconfigParam() devient LStemplate :: addJSconfigParam().
      • +
    +
      +
    • LSsession :: addHelpInfos() devient LStemplate :: addHelpInfo().
      • +
    +
      +
    • +

      LSsession :: addCssFile() devient LStemplate :: addCssFile().

      +

      Par ailleurs le paramètre $path disparait et la méthode addLibCssFile à été ajoutée pour +permettre spécifiquement l'inclusion des fichiers CSS des librairies. Voici quelques exemples +d'utilisation et leur équivalent à présent:

      +
        +
      • LSsession :: addCssFile('test.css', '../../local/css/'); devient + LStemplate :: addCssFile('test.css');. Doit donc être conservé, que le nom du fichier CSS, + pas de chemin vers celui-ci.
        • +
      +
        +
      • LSsession :: addCssFile('datepicker_vista.css',LS_LIB_DIR.'arian-mootools-datepicker/datepicker_vista/'); + devient + LStemplate :: addLibCssFile('arian-mootools-datepicker/datepicker_vista/datepicker_vista.css');
        • +
      +
      • +
    +

    Pour identifier les fichiers concernés, vous pouvez utiliser les commandes suivantes :

    +
    grep -Er 'LSsession *:: *(addJSscript|addLibJSscript|addJSconfigParam|addHelpInfos|addCssFile|addLibCssFile) *\(' /etc/ldapsaisie/local/
+grep -Er '(LSsession|LStemplate) *:: *addJSscript\(.*local' /etc/ldapsaisie/local/
+grep -Er '(LSsession|LStemplate) *:: *addJSscript\(.*\.\.\/' /etc/ldapsaisie/local/
+grep -Er '(LSsession|LStemplate) *:: *addCssFile\(.*local' /etc/ldapsaisie/local/
+grep -Er '(LSsession|LStemplate) *:: *addCssFile\(.*\.\.\/' /etc/ldapsaisie/local/
+
    +
    • +
+
    +
  • +

    LSlog vs LSdebug : L’utilisation de LSdebug est dépriorisée en faveur de LSlog. Ce dernier + ajoute désormais la notion de logger, permettant d’identifier la source des logs. Ce mécanisme + permet la configuration d’un niveau de log spécifique pour un logger donné, ainsi que la mise en + place de filtres au niveau des handers pour ne logger par exemple que certains loggers, ou à + l’inverse en exclure d’autres.

    +
      +
    • Pour vos classes personnalisées : si celles-ci héritent d’une classe standard, il est fort + probable qu’il soit possible d’utiliser des méthodes fournies par cette classe pour logguer + au travers un logger dédié (voir les méthodes log_debug, log_info, …). À défaut, il est + possible d’utiliser la classe LSlog_staticLoggerClass qui facilite l’implémentation.
      • +
    +
      +
    • +

      Pour vos LSaddons : il est conseillé d’utiliser un + logger LSaddon_[addon] dédié. Le logger peut facilement être récupéré de la manière + suivante :

      +
      LSlog :: get_logger("LSaddon_[addon]")
+
      +

      Cette méthode retourne une référence au logger et il est possible d’appeler directement une +méthode de log, par exemple :

      +
      LSlog :: get_logger("LSaddon_[addon]") -> debug("message");
+
      +
      • +
    +
    • +
+

Fichiers templates :

+

Changement de l’inclusion des templates

+
    +
  • +

    Le cas des fichiers top.tpl et bottom.tpl

    +
    {include file='ls:top.tpl'}
+
+[...]
+
+{include file='ls:bottom.tpl'}
+
    +

    devient :

    +
    {extends file='ls:base_connected.tpl'}
+{block name="content"}
+
+[...]
+
+{/block}
+
    +
    +

    Note

    +

    Pages à l’état connecté uniquement (incluant le menu, l’entête…).

    +
    +
    • +
+
    +
  • +

    Fichiers avec entête HTML :

    +
    <html>
+  <head>
+    [...]
+  </head>
+  <body>
+    [...]
+  </body>
+</html>
+
    +

    devient :

    +
    {extends file='ls:base.tpl'}
+{block name="body"}
+[...]
+{/block}
+
    +

    Au besoin, si vous avez besoin :

    +
      +
    • +

      de remplacer les fichiers CSS chargés par défaut (base.css par exemple) : ajouter le block + css :

      +
      {block name="css"}
+  <link rel="stylesheet" type="text/css" href="{css name='custom.css'}" media="screen" title="Normal" />
+  {include file='ls:css.tpl'}
+{/block}
+
      +
      +

      Note

      +

      Ce block contient tous les CSS, y compris ceux gérés par LSsession :: addCssFile(). +Pensez à ajouter {include file='ls:css.tpl'} pour conserver ces derniers.

      +
      +
      • +
    +
      +
    • +

      d’ajouter des infos dans <head> : ajouter le block head (vide par défaut) :

      +
      {block name="head"}
+[...]
+{/block}
+
      +
      • +
    +
      +
    • +

      d’ajouter des fichiers Javascript personnalisés : ajouter le block js (vide par défaut):

      +
      {block name="js"}
+[...]
+{/block}
+
      +
      +

      Note

      +

      Ce block sera ajouté APRÈS les autres fichiers Javascript chargés (ceux par défaut et ceux +ajoutés via LSsession :: addJSscript().

      +
      +
      • +
    +
    • +
+
    +
  • +

    Autres fichiers remplacés :

    +
      +
    • blank.tpl remplacé par base.tpl
      • +
    • empty.tpl remplacé par base_connected.tpl
      • +
    • accueil.tpl remplacé par homepage.tpl
      • +
    +
    • +
+

Pour identifier les fichiers concernés, vous pouvez utiliser la commande suivante :

+
grep -Er '(accueil|blank|empty|top|bottom)\.tpl' /etc/ldapsaisie/local/
+
+

Fichiers templates fournis par défaut :

+

Vérifier les modifications des fichiers templates fourni avec l’application et que vous auriez +personnalisé. Pour cela, vous pouvez utiliser la commande suivante :

+
for i in $( ls /etc/ldapsaisie/local/templates/* )
+do
+    default_file="/usr/share/ldapsaisie/templates/default/$( basename "$i" )"
+    [ ! -e "$default_file" ] && continue
+    vi -d $default_file $i
+done
+
+
+

Note

+

Une attention particulière doit être porté aux fichiers login.tpl et recoverpassword.tpl qui +ont particulièrement changés.

+
+

Corriger les URL des images :

+

../../images/default/find.png devient ../image/find

+

Pour identifier les fichiers concernés, vous pouvez utiliser les commandes suivantes :

+
grep -Er 'images' /etc/ldapsaisie/local/templates
+grep -Er '\.(png|gif|jpg)' /etc/ldapsaisie/local/templates
+
+

Le cas de variable de template {$LSsession_css} et {$LSsession_js} :

+
+

Note

+

Ceci est déjà géré si vous étendez bien vos templates du fichier base.tpl (pour les pages +non-connectées) ou base_connected.tpl (pour les pages connectées).

+
+
    +
  • {$LSsession_css} doit être remplacé par {include file='ls:css.tpl'}
    • +
+
    +
  • {$LSsession_js} doit être remplacé par {include file='ls:js.tpl'}
    • +
+

Tous les fichiers : Modification des URLs

+
    +
  • +

    view.php :

    +
      +
    • page recherche : view.php?LSobject=LSpeople devient object/LSpeople
      • +
    +
      +
    • page d'un objet : view.php?LSobject=LSpeople&dn=$dn devient object/LSpeople/$dn
      • +
    +
    • +
+
    +
  • addon_view.php : addon_view.php?LSaddon=ee&view=copyContract devient addon/ee/copyContract
    • +
+
    +
  • +

    index_ajax.php :

    +
      +
    • +

      Pour les méthodes Ajax de classes :

      +
      var data = {
+  template:   'LSformElement_eetelephone',
+  action:     'make_call',
+  telephoneNumber: tel,
+  name: name,
+};
+new Request({url: 'index_ajax.php', data: data, onSuccess: ...});
+
      +

      Devient :

      +
      var data = {
+  telephoneNumber: tel,
+  name: name,
+};
+new Request({url: 'ajax/class/LSformElement_eetelephone/make_call', data: data, onSuccess: ...});
+
      +
      • +
    +
      +
    • +

      Pour les méthodes Ajax d'addon :

      +
      var data = {
+  addon: 'asterisk',
+  action: 'LSasterisk_make_call',
+  telephoneNumber: tel,
+  name: name,
+  nocache: new Date().getTime()
+};
+new Request({url: 'index_ajax.php', data: data, onSuccess: ...});
+
      +

      Devient :

      +
      var data = {
+  telephoneNumber: tel,
+  name: name,
+  nocache: new Date().getTime()
+};
+new Request({url: 'ajax/addon/asterisk/LSasterisk_make_call', data: data, onSuccess: ...});
+
      +
      • +
    +
    • +
+
    +
  • global_search.php : global_search.php?refresh devient search?refresh
    • +
+
    +
  • index.php : index.php?LSsession_recoverPassword devient index?LSsession_recoverPassword
    • +
+
    +
  • create.php : create.php?LSobject=LSpeople devient object/LSpeople/create
    • +
+
    +
  • modify.php : modify.php?LSobject=LSpeople&dn=$dn devient object/LSpeople/$dn/modify
    • +
+
    +
  • import.php : import.php?LSobject=LSpeople devient object/LSpeople/import
    • +
+
    +
  • +

    remove.php : remove.php?LSobject=LSpeople&dn=$dn devient object/LSpeople/$dn/remove

    +

    Avec validation : remove.php?LSobject=LSpeople&dn=$dn&valid devient +object/LSpeople/$dn/remove?valid

    +
    • +
+
    +
  • select.php : select.php?LSobject=LSpeople devient object/LSpeople/select
    • +
+
    +
  • +

    custom_action.php : + custom_action.php?LSobject=LSpeople&dn=$dn&customAction=$customAction + devient object/LSpeople/$dn/customAction/$customAction

    +

    Avec validation : +custom_action.php?LSobject=LSpeople&dn=$dn&customAction=$customAction&valid +devient object/LSpeople/$dn/customAction/$customAction?valid

    +
    • +
+
    +
  • +

    custom_search_action.php : + custom_search_action.php?LSobject=LSpeople&customAction=$customAction + devient object/LSpeople/customAction/$customAction

    +

    Avec validation : +custom_search_action.php?LSobject=LSpeople&customAction=$customAction&valid +devient object/LSpeople/customAction/$customAction?valid

    +
    • +
+

Pour identifier les fichiers concernés, vous pouvez utiliser la commande suivante :

+
grep -Er '(index|global_search|view|select|create|modify|import|remove|index_ajax|custom_action|custom_search_action|addon_view)\.php' /etc/ldapsaisie/local/
+

Ended: Mise à jour

Configuration

Configuration

+

La configuration du projet est située principalement dans le dossier conf/. Les exceptions seront +détaillées par la suite.

+
+

Warning

+

Toute la configuration du projet se fait par l'intermédiaire de fichiers définissant des +variables PHP dont les valeurs sont utilisées par le programme. Ceci signifie que la syntaxe de +ces fichiers doit être valide avec l'interpréteur PHP utilisé.

+

Configuration globale

Configuration globale

+

La plus grande partie de la configuration globale se trouve dans le fichier config.inc.php.

+
// Variables globales
+$GLOBALS['LSconfig'] = array(
+  // Variables globales
+);
+
+// Variables et constantes indépendantes
+$var1 = 'val1'
+$var2 = 'val2'
+...
+define('CONST1','val1')
+define('CONST2','val2')
+...
+
+

Variables globales

+
    +
  • +

    NetLDAP2

    +

    Chemin vers la librairie PEAR +Net_LDAP2.

    +
    /usr/share/php/Net/LDAP2.php
+
    +
    • +
+
    +
  • +

    Smarty

    +

    Chemin vers le moteur de template Smarty.

    +
    /usr/share/php/smarty/libs/Smarty.class.php
+
    +
    • +
+
    +
  • +

    public_root_url

    +

    URL publique de la racine web de l'application. Il peut s'agir d'une URL relative bien qu'une URL +absolue soit préférable, notament pour éviter l'auto-détection de celle-ci lorsque nécessaire +(lien dans un e-mail par exemple. Par défaut : /.)

    +
    +

    Important

    +

    Il est indispensable que ce paramètre soit configuré en adéquation avec votre environement +pour que l'application fonctionne correctement (notament en cas en cas de déploiement dans un +sous-dossier ou encore dans le cadre d'un accès à l'application au travers un +reverse-proxy).

    +
    +
    • +
+
    +
  • +

    lang

    +

    Paramètre utilisé pour l'internationalisation : code de la langue (fr_FR ou en_US)

    +
    • +
+
    +
  • +

    encoding

    +

    Encodage de caractère (UTF8)

    +
    • +
+ +

Préférences globales

+
+

Important

+

Les variables globales suivantes ont une action globale, mais non-prioritaire sur le +comportement de l'application. Il peux être redéfini pour chacun des serveurs LDAP.

+
+
    +
  • +

    cacheLSprofiles

    +

    Activation/Désactivation de la mise en cache des profils des utilisateurs connectés +(LSprofiles).

    +

    Valeurs possibles : True ou False

    +

    Valeur recommandée : True

    +

    Valeur par défaut : False

    +
    • +
+
    +
  • +

    cacheSubDn

    +

    Activation/Désactivation de la mise en cache des niveaux de connexion +(subDn) dans l'annuaire.

    +

    Valeurs possibles : True ou False

    +

    Valeur recommandée : True

    +

    Valeur par défaut : False

    +
    • +
+
    +
  • +

    cacheSearch

    +

    Activation/Désactivation de la mise en cache du résultat des recherches dans l'annuaire.

    +

    Valeurs possibles : True ou False

    +

    Valeur recommandée : True

    +

    Valeur par défaut : False

    +
    • +
+
    +
  • +

    globalSearch

    +

    Activation/Désactivation de la recherche globale dans l'annuaire.

    +

    Valeurs possibles : True ou False

    +

    Valeur par défaut : True

    +
    • +
+
    +
  • +

    keepLSsessionActive

    +

    Activation/Désactivation du maintient de la LSsession active.

    +

    Valeurs possibles : True ou False

    +

    Valeur par défaut : False

    +
    • +
+

Variables et constantes indépendantes

+
    +
  • +

    LS_THEME

    +

    Constante déterminant le nom du theme utilisé.

    +

    Valeur par défaut : default

    +
    • +
+
    +
  • +

    LS_TEMPLATES_DIR

    +

    Constante déterminant le chemin du dossier des templates.

    +

    Valeur par défaut : templates

    +
    • +
+
    +
  • +

    LS_IMAGES_DIR

    +

    Constante déterminant le chemin du dossier des images.

    +

    Valeur par défaut : images

    +
    • +
+
    +
  • +

    LS_CSS_DIR

    +

    Constante déterminant le chemin du dossier des CSS.

    +

    Valeur par défaut : css

    +
    • +
+
    +
  • +

    LSdebug

    +

    Variable booléenne déterminant si le débogage à l'écran est activé.

    +
    • +
+
    +
  • +

    $GLOBALS['LSlog']

    +

    Variable permettant de configurer la journalisation de l'application. +Voir section concernée.

    +
    • +
+
    +
  • +

    NB_LSOBJECT_LIST

    +

    Constante déterminant le nombre d'objet affichés par page de résultat de recherche.

    +
    • +
+
    +
  • +

    NB_LSOBJECT_LIST_SELECT

    +

    Constante déterminant le nombre d'objet affichés par page de résultat de recherche dans une +fenêtre LSselect.

    +
    • +
+
    +
  • +

    $GLOBALS['NB_LSOBJECT_LIST_CHOICES']

    +

    Variable permettant de configurer la liste des choix proposés à l'utilisateur pour le nombre +maximum d'objets affichés par page de résultat de recherche.

    +
    • +
+
    +
  • +

    MAX_SEND_FILE_SIZE

    +

    Constante déterminant la taille maximale d'un fichier envoyé à travers les formulaires.

    +
    • +
+
    +
  • +

    $GLOBALS['defaultJSscripts']

    +

    Tableau déterminant les fichiers Javascript à charger sur toute les pages.

    +
    • +
+
    +
  • +

    $GLOBALS['defaultCSSfiles']

    +

    Tableau déterminant les fichiers CSS à charger sur toute les pages. Ces fichiers seront chargés +dans l'ordre et en dernier permettant de surcharger tous paramètres de style.

    +
    • +

Connexion LDAP

Configuration des serveurs LDAP

+

Cette section décrit le tableau de configuration des différents serveurs LDAP utilisés par +l'application. Ce tableau contient lui même un tableau par serveur LDAP.

+
$GLOBALS['LSconfig'] = array(
+  ...
+  'ldap_servers' => array(
+    array (
+      'name' => [nom de l'annuaire],
+      'ldap_config'=> array(
+        // Définition des paramètres de connexion à l'annuaire
+      ),
+      'useUserCredentials' => [boolean],
+      'useAuthzProxyControl' => [boolean],
+      'LSauth' => array (
+        'method' => [LSauth method],
+        'api_method' => [LSauth method],
+        'LSobjects' => array(
+          '[object type 1]',
+          '[object type 2]' => array(
+            'filter' => '[LDAP filter]',
+            'filter_function' => [callable],
+            'password_attribute' => '[attribute name]',
+            'web_access' => [booléen],
+            'api_access' => [booléen],
+          )
+        )
+      ),
+      'LSprofiles' => array (
+        // Définition des LSprofiles
+      ),
+      'cacheLSprofiles' => [boolean],
+      'cacheSearch' => [boolean],
+      'globalSearch' => [boolean],
+      'LSaccess' => array (
+        [Type LSobject 1],
+        [Type LSobject 2],
+        ...
+      ),
+      'subDn' => array(
+        // Définition des sous-niveaux de l'annuaire
+      ),
+      'subDnLabel' => [nom des sous-niveaux],
+      'recoverPassword' => array(
+        // Définition des paramètres de configuration de la récupération de mot de passe
+      ),
+      'defaultView' => [view],
+      'emailSender' => [email],
+      'keepLSsessionActive' => [booléen]
+    )
+  ...
+);
+...
+
+
    +
  • +

    name

    +

    Le nom d'affichage de ce serveur Ldap (utilisé lorsque plusieurs serveur LDAP sont déclarés).

    +
    • +
+
    +
  • +

    ldap_config

    +

    Informations de connexion au serveur LDAP. Ces informations sont structurées selon les attentes de +la librairie Net_LDAP2. +Plus d'informations

    +
    • +
+
    +
  • +

    useUserCredentials

    +

    Booléen définissant si il faut utiliser les identifiants de l'utilisateur pour se connecter à +l'annuaire (false par défaut). Si cette option est activée, la connexion à l'annuaire LDAP sera +établie avec la configuration fournie dans le paramètre ldap_config en écrasant les informations +de connexion (binddn et bindpwd) par ceux de l'utilisateur. Si l'utilisateur n'est pas encore +connecté, la connexion sera étalie sans modifier la configuration fournie.

    +
    • +
+
    +
  • +

    useAuthzProxyControl

    +

    Booléen définissant si, lorsqu'on utilise les identifiants de l'utilisateur pour se connecter à +l'annuaire, il faut utiliser une authentification via proxy authorization. Dans ce cas, les +identifiants de l'utilisateur ne seront pas, à proprement parlé, utilisés pour se connecter à +l'annuaire, mais une demande de proxy authorization en tant que l'utilisateur connecté sera +faites à l'aide des identifiants de l'application. Ce mode nécessite une configuration +particulière au niveau de l'annuaire pour autoriser le compte de l'application à faire des +demandes de proxy authorization en tant que les autres utilisateurs de l'annuaire.

    +
    • +
+ +
    +
  • +

    LSauth

    +

    Ce tableau défini les paramètres d'authentification à l'application.

    +
      +
    • +

      method

      +

      Nom de la méthode d'authentification +LSauthMethod. Exemple : pour +utiliser la classe LSauthMethod_HTTP, la valeur de ce paramètre sera HTTP. +Paramètre facultatif, méthode par défaut : basic.

      +
      • +
    +
      +
    • +

      api_method

      +

      Nom de la méthode d'authentification +LSauthMethod à utilisée lors +d'une connexion à l'API. Exemple : pour utiliser la classe LSauthMethod_HTTP, la valeur +de ce paramètre sera HTTP. Paramètre facultatif, méthode par défaut : HTTP.

      +
      +

      Warning

      +

      Toutes les LSauthMethod ne +supportent pas forcément le mode API.

      +
      +
      • +
    +
      +
    • +

      LSobjects

      +

      Tableau listant les types LSobjects pouvant se +connecter à l'application. Les valeurs de ce tableau peuvent être un nom de type d'objet ou bien +tableau détaillant les paramètres de connexion de ce type d'objet.

      +
        +
      • +

        filter

        +

        LSformat du filtre de recherche de l'utilisateur à sa +connexion. Ce format sera composé avec l'identifiant fourni par l'utilisateur. Cela peut par +exemple permettre à l'utilisateur de se connecter en fournissant son login ou son email comme +identifiant. Exemple de valeur : (|(uid=%{user})(mail=%{user})). +Paramètre facultatif, filtre par défaut composé à l'aide de l'attribut RDN.

        +
        • +
      +
        +
      • +

        filter_function

        +

        Callable (au sens PHP) utilisé pour filtrer les utilisateurs trouvés dans l'annuaire à +partir des autres paramètres : cette fonction, si elle est définie, sera appelée pour chaque +utilisateur trouvé, avec pour unique paramètre, une référence à l'objet LDAP correspondant +(LSldapObject). Cette méthode devra alors retourner true ou false pour respectivement +autoriser ou interdire l'accès à l'application à l'utilisateur.

        +
        +

        Note

        +

        Si un utilisateur est exclus par cette méthode et qu'aucun autre utilisateur correspondant +n'a été trouvé dans l'annuaire, une page d'erreur sera affichée et indiquera que l'accès à +l'application est refusée.

        +
        +
        • +
      +
        +
      • +

        password_attribute

        +

        Nom de l'attribut stockant le mot de passe de ce type +d'LSobject. +Paramètre facultatif, valeur par défaut : userPassword.

        +
        +

        Note

        +

        C'est cet attribut de l'utilisateur qui sera modifié par la fonctionnalité de récupération +de mot de passe.

        +
        +
        • +
      +
        +
      • +

        web_access

        +

        Permet de définir si ce type d'objet à le droit d'utiliser l'interface web (facultatif, par +défaut : True).

        +
        • +
      +
        +
      • +

        api_access

        +

        Permet de définir si ce type d'objet à le droit d'utiliser l'API (facultatif, par défaut : +False).

        +
        • +
      +
      • +
    +
      +
    • +

      allow_multi_match

      +

      Booléen permettant de définir si un doublon d'identifiant utilisateur est autorisé. Si c'est le +cas et lorsqu'un identifiant fourni par l'utilisateur a sa connexion a permi de trouver plus +d'un utilisateur possible correspondant, l'application tentera de déterminer lequel de ces +utilisateurs correspond à la tentative d'authentification. La méthodologie employée dépendra de +la LSauthMethod configurée. Par +exemple, la LSauthMethod basic +tentera de s'identifier avec le mot de passe. Dans tous cas, si cette méthode n'a pas permis +d'identifier un seul utilisateur, l'authentification échoura. Paramètre facultatif, valeur par +défaut : False.

      +
      • +
    +
    • +
+
    +
  • +

    cacheLSprofiles

    +

    Activation/Désactivation de la mise en cache des LSprofiles +des utilisateurs connectés à ce serveur.

    +

    Valeur par défaut : valeur de la variable globale du même nom

    +
    • +
+
    +
  • +

    cacheSearch

    +

    Activation/Désactivation de la mise en cache du résultat des recherches sur ce serveur.

    +

    Valeur par défaut : valeur de la variable globale du même nom

    +
    • +
+
    +
  • +

    globalSearch

    +

    Activation/Désactivation de la recherche globale sur ce serveur en particulier. Par défaut, la +valeur du paramètre global globalSearch est utilisée.

    +

    Valeur par défaut : valeur de la variable globale du même nom

    +
    • +
+
    +
  • +

    LSaccess

    +

    Définition des types d'LSobjects devant +apparaître dans le menu de l'interface.

    +
    +

    Important

    +

    Ce paramètre n'est utilisé que pour les annuaires n'ayant pas de sous-niveaux +(subDn).

    +
    +
    • +
+
    +
  • +

    subDn

    +

    Définition des sous-niveaux de connexion à l'annuaire. +Voir section concernée.

    +
    +

    Important

    +

    Ce paramètre remplace le paramètre LSaccess dans le cas d'un annuaire +multi-niveaux.

    +
    +
    • +
+
    +
  • +

    subDnLabel

    +

    Définition du label utilisé pour qualifier les sous-niveaux de connexion.

    +
    +

    Important

    +

    Ce paramètre est utile uniquement dans le cas d'un annuaire multi-niveaux.

    +
    +
    • +
+ +
    +
  • +

    defaultView

    +

    Définition de la vue par défaut de l'application. Par défaut, une page blanche est affichée et il +est possible de définir à l'aide de ce paramètre la vue qui s'affichera. Ce paramètre peut prendre +comme valeur :

    +
      +
    • SELF pour la vue Mon compte
      • +
    +
      +
    • Le nom d'un LSobject pour afficher la liste de + ce type d'objet
      • +
    +
      +
    • Le nom d'une vue d'un LSaddon au format + [addon]::[viewId] pour afficher cette vue
      • +
    +
    • +
+
    +
  • +

    emailSender

    +

    Adresse mail utilisée par LdapSaisie pour envoyer des e-mails en relation avec cet annuaire. Cette +adresse est celle utilisée par défaut. L'adresse utilisée peut également être configurée dans le +contexte de configuration du module devant envoyer des e-mails.

    +
    • +
+
    +
  • +

    keepLSsessionActive

    +

    Activation/Désactivation du maintient de la LSsession active.

    +

    Valeurs possibles : True ou False

    +

    Valeur par défaut : valeur de la variable globale du même nom

    +
    • +

Profils d'utilisateurs (LSprofile)

+

Cette section décrit la manière dont sont définis les profils d'utilisateurs se connectant à +l'interface appelés LSprofile. Il est possible d'attribuer un profil à l'utilisateur connecté sur +tout ou partie de l'annuaire LDAP.

+

Profils d'utilisateurs par défaut

+

Il existe des profils d'utilisateurs par défaut, non liée à la configuration de l'application:

+
    +
  • +

    user

    +

    Tous les utilisateurs connectés à l'utilisateur. Ce LSprofile est valide sur l'ensemble de +l'annuaire.

    +
    • +
+
    +
  • +

    self

    +

    L'utilisateur connecté sur son objet correspondant dans l'annuaire. Ce LSprofile est utile pour +donner des droits à l'utilisateur sur lui-même.

    +
    • +
+
    +
  • +

    nom du type de l'objet connecté

    +

    Un LSprofile du nom du type d'objet utilisateur connecté est automatiquement ajouté à +l'utilisateur. Ainsi, si l'utilisateur connecté est un +LSobject LSpeople par exemple, il aura le +LSprofile LSpeople sur tous l'annuaire. Ce LSprofile est utile pour donner des droits à tous +un type d'objets pouvant se connecter à l'application (par exemple, tous les utilisateurs +applicatifs).

    +
    • +
+

Profils d'utilisateurs personalisés

+

Il est possible de définir autant de profils d'utilisateurs que l'on souhaite. Pour chaque profil +d'utilisateur personnalisé, il faudra définir dans quelles parties de l'annuaire ce profil existe +(Exemple : les admistrateurs de groupes existent uniquement dans la branche de l'annuaire stockant +les groupes). Enfin pour chaque partie de l'annuaire, il faudra définir la manière d'identifier si +l'utilisateur qui se connecte appartient à ce profil.

+
'LSprofile' => array (
+  [nom d'un LSprofile] => array (
+    [label] => [label du LSprofile],
+    [basedn] => [dn utilisateur],
+    [autre basedn] => array (
+      [dn d'un utilisateur] => NULL,
+      [autre dn] => array ( // via un listage de l'attribut d'un objet
+        'attr' => [nom de l'attribut clé de l'objet],
+        'attr_value' => [format de la valeur de l'attribut clé],
+        'LSobject' => [nom du type LSobject de l'objet]
+      )
+    ),
+    'LSobjects' => array ( // via une liste d'objet sur lequel l'utilisateur a des pouvoirs
+      [nom du LSobject] => array (
+        'attr' => [nom de l'attribut clé],
+        'attr_value' => [format de la valeur de l'attribut clé],
+        // ou
+        'filter' => [format du filtre de recherche],
+
+        'basedn' => [basedn de recherche],
+        'params' => [configuration de la recherche]
+      ),
+      [nom quelconque] => array (
+        'filters' => array(
+          array(
+            'LSobject' => [nom du LSobject],
+            'attr' => [nom de l'attribut clé],
+            'attr_value' => [format de la valeur de l'attribut clé],
+            // ou
+            'filter' => [format du filtre de recherche],
+
+            'basedn' => [basedn de recherche],
+            'params' => [configuration de la recherche]
+          ),
+        ),
+      ),
+      ...
+    )
+  ),
+  ...
+),
+...
+
+

Le paramètre LSprofiles est un tableau associatif contenant, en valeur clé, le nom d'un +LSprofile et en valeur associée, la configuration nécessaire pour déterminer si l'utilisateur +connecté appartient à ce LSprofile pour tout ou partie de l'annuaire.

+

Dans chaque configuration de LSprofile, il est possible d'identifier l'appartenance ou non de +l'utilisateur connecté de deux manières :

+
    +
  • +

    Pour une branche de l'annuaire donnée (basedn) : en listant les utilisateurs appartenant à ce + LSprofile pour tous les objets de la branche. Il sera possible de lister les utilisateurs dont + on connait le DN ou de lister les utilisateurs appartenant à une liste stockée dans l'annuaire + (par exemple la liste des membres d'un groupe).

    +
      +
    • +

      Liste des DNs d'utilisateurs :

      +
      'LSprofile' => array (
+  [nom du LSprofile] => array (
+    [basedn] => [dn utilisateur],
+    // ou si plusieurs DNs
+    [autre basedn] => array (
+      [dn d'un utilisateur] => NULL,
+      [dn d'un utilisateur 2] => NULL
+    ),
+    ...
+  ),
+  ...
+),
+...
+
      +

      Explication : Pour un LSprofile et un basedn donnés, on définit l'utilisateur appartenant au +LSprofile en donnant son DN. Si on souhaite lister plusieurs utilisateurs, on utilise un +tableau associatif dans lequel les clés sont les DNs des utilisateurs et les valeurs associées +sont toutes NULL.

      +
      • +
    +
      +
    • +

      Liste d'utilisateurs stockée dans l'annuaire :

      +
      'LSprofile' => array (
+  [nom du LSprofile] => array (
+    [basedn] => array (
+      [DN d'un object] => array (
+        'attr' => [nom de l'attribut clé de l'objet],
+        'attr_value' => [format de la valeur de l'attribut clé],
+        'LSobject' => [nom du type LSobject de l'objet]
+      )
+    ),
+  ...
+),
+...
+
      +

      Explication : Pour un LSprofile et un basedn donnés, on liste les utilisateurs du +LSprofile référencés dans l'attribut attr de l'object de type LSobject et selon le format +de valeur décrit dans attr_value.

      +
      • +
    +
    • +
+
    +
  • +

    Pour un type de LSobject donné : en listant les objets pour lesquels l'utilisateur aura les + droits du LSprofile. Il sera possible, à travers une recherche paramétrable dans l'annuaire, de + lister les objets pour lesquels l'utilisateur appartiendra au LSprofile.

    +
    'LSprofile' => array (
+  [nom d'un LSprofile] => array (
+    'LSobjects' => array ( // via un liste d'objet pour lequel l'utilisateur
+                           // appartient au LSprofile
+      [nom du LSobject] => array (
+        'attr' => [nom de l'attribut clé],
+        'attr_value' => [format de la valeur de l'attribut clé],
+        // or
+        'filter' => [format du filtre de recherche],
+
+        'basedn' => [format du basedn de recherche],
+        'params' => [configuration de la recherche]
+      ),
+      array (
+        'filters' => array(
+          array(
+            'LSobject' => [nom du LSobject],
+            'attr' => [nom de l'attribut clé],
+            'attr_value' => [format de la valeur de l'attribut clé],
+            // ou
+            'filter' => [format du filtre de recherche],
+
+            'basedn' => [format du basedn de recherche],
+            'params' => [configuration de la recherche]
+          ),
+        ),
+      ),
+      ...
+    )
+  ),
+  ...
+),
+...
+
    +

    Explications : Dans la configuration d'un LSprofile, la valeur clé LSobjects signifie qu'on +est dans un cas de la délégation de droits sur des types d'LSobject. Dans ce tableau associatif, +il est possible de définir un ou plusieurs types de LSobject pour lesquels on délègue des droits +via des recherches simples ou enchaînées. Le fonctionnement simple consiste à partir de l'objet de +l'utilisateur et à générer un filtre et une base de recherche sur un type de LSobject. Le +fonctionnement enchainée consiste à faire un première recherche à partir de l'objet de +l'utilisateur puis à recommencer à partir des objets trouvés en construisant une liste de filtres +de recherche pour chaque objet qui seront combinés via l'opérateur booléen ou. Dans le cadre +d'un fonctionnement enchainée, la base de recherche est toujours générer à partir de l'objet de +l'utilisateur connecté.

    +

    Pour configurer une délégation de type simple on mettra le nom du LSobject dans la clé du tableau +et dans la valeur un tableau définissant la recherche. Il est possible de ne pas utiliser la clé +du tableau comme nom du LSobject grâce à la clé de configuration LSobject.

    +

    Pour configurer une délégation de type enchaîné on pourra utiliser n'importe quelle valeur unique +pour la clé du tableau et pour la valeur un tableau contenant une unique clé filters. La valeur +associée à cette clé est celle d'une délégation de type simple où la clé LSobject est devenue +obligatoire.

    +

    Cette configuration contient les paramètres d'une ou plusieurs recherches dans l'annuaire en +considérant que l'utilisateur connecté aura les droits du LSprofile sur les objets retournés. Les +paramètres de la recherche sont :

    +
      +
    • +

      LSobject

      +

      C'est le nom du LSobject recherché. (Paramètre facultatif pour +une délégation de type simple)

      +
      • +
    +
      +
    • +

      attr

      +

      Nom de l'attribut des LSobjets contenant une valeur clé qui +permettra d'identifier l'utilisateur comme ayant droit.

      +
      • +
    +
      +
    • +

      attr_value

      +

      Le format de la valeur clé prise par l'attribut attr. Ce format est composé à partir des +données de l'objet de l'utilisateur connecté. Voir le paragraphe +Format paramètrable pour plus d'informations sur +l'écriture du format.

      +
      • +
    +
      +
    • +

      filter

      +

      Ce paramètre remplace les paramètres attr et attr_value. Il est possible ici d'écrire +directement le format paramètrable du filtre recherche dans l'annuaire. Ce filtre sera +automatiquement agrémenté des conditions sur l'attribut objectclass. Voir le paragraphe +Format paramètrable pour plus d'informations sur +l'écriture du format.

      +
      • +
    +
      +
    • +

      basedn

      +

      C'est le format paramétrable du basedn de la recherche généré à partir de l'utilisateur +connecté. Il est possible ainsi de la limiter sur les LSojects d'une branche précise de +l'annuaire. Voir le paragraphe Format paramètrable pour +plus d'informations sur l'écriture du format. (Paramètre facultatif)

      +
      • +
    + +
    • +
+

Par ailleurs, il est possible d'attribuer un label plus explicite à chaque LSprofile à l'aide de +la clé label. Ce label sera utilisé pour faire référence au LSprofile lorsque nécéssaire. +(Paramètre facultatif)

Sous-niveaux de connexion

+

Cette section décrit la manière de définir des sous-niveaux de connexion à l'annuaire (subDn). Le +concept de sous-niveau de connexion sert à déclarer les niveaux logiques de l'annuaire. Par exemple, +dans un annuaire dans lequel sont stockés des objets concernant plusieurs organisations et que +celles-ci se distinguent grâce à la présence d'une séparation dans l'arbre, il sera alors possible +de définir des sous-niveaux de connexion pour chacune des organisations.

+

Exemple d'arborescence d'annuaire utilisant le concept de sous-niveaux correspondant à des sociétés :

+
|- o=ls
+| |- ou=companies
+| | |- ou=company1
+| | | |- ou=people
+| | | |- ou=groups
+| | |- ou=company2
+| | | |- ou=people
+| | | |- ou=groups
+| |- ou=people
+| |- ou=groups
+
+

Explications : Il est possible dans cet exemple de définir des sous-niveaux de connexion +correspondants aux sociétés. Dans chacune de ces sociétés, on retrouve les OU correspondant au +type d'LSobjets. Lors de la connexion à l'interface, l'utilisateur devra choisir dans quel +sous-niveau de l'annuaire il souhaite se connecter. Une fois connecté, l'utilisateur manipulera +uniquement les objets du sous-niveau de l'annuaire dans lequel il se trouve. Il lui sera également +possible de changer de sous-niveau de connexion à travers l'interface : une liste déroulante est +disponible pour cela dans le menu.

+

Il existe deux manières de déclarer des sous-niveaux de connexion à l'annuaire :

+
    +
  • En déclarant manuellement un subDn de l'annuaire et en lui donnant un nom.
    • +
+
    +
  • En listant les LSobjets d'un type précis et en utilisant leurs données pour constituer le nom + des sous-niveaux. Cette liste est constituée en effectuant une recherche dans l'annuaire. Il est + possible de définir un basedn particulier pour cette recherche.
    • +
+

Pour chacune de ces méthodes on définira également les types d'LSobjets qui sont présents dans +cette branche de l'annuaire.

+
'subDn' => array(
+  // Déclaration manuelle
+  '[Nom du sous-niveau]' => array(
+    'dn' => '[basedn du sous-niveau]',
+    'nologin' => true, // Désactive la connection dans ce subDn
+    'LSobjects' => array( // Liste des types d'LSobjets présents dans le sous-niveau
+      [LSobject1],
+      [LSobject2],
+      ...
+    )
+  ),
+  // Liste de LSobjets
+  'LSobject' => array(
+    '[type d'LSobject]' => array( // le type d'LSobjet à lister
+      'basedn' => '[basedn]', // Le basedn de la recherche
+      'displayValue' => '[format]', // Format du nom des sous-niveaux
+      'nologin' => true, // Désactive la connection dans ces subDn
+      'onlyAccessible' => True, // Pour que seul les LSobjet accessible à l'utilisateur soit listé
+      'LSobjects' => array( // Liste des types d'LSobjets présents dans les sous-niveaux
+        [LSobject1],
+        [LSobject2],
+        ...
+      )
+    )
+  )
+),
+...
+

Récupération de mot de passe

+

Cette section décrit la manière de configurer la récupération de mot de passe par les utilisateurs. +Le mécanisme de récupération de mot de passe fonctionne en deux parties :

+
    +
  • +

    Dans un premier lieu, l'utilisateur ayant perdu son mot de passe accède à l'interface de + récupération à partir de la page de connexion. L'interface lui demande de saisir son identifiant + et éventuellement de sélectionner le serveur LDAP concerné. Une fois ces informations saisies, une + recherche de l'utilisateur est effectuée dans l'annuaire et si celui-ci est trouvé, la valeur de + l'attribut recoveryHashAttr de l'objet est alors redéfinie avec une valeur aléatoire.

    +

    Un mail est ensuite envoyé à l'utilisateur en utilisant la première valeur de l'attribut +mailAttr comme adresse. Ce mail est formé à partir des paramètres du tableau associatif +recoveryHashMail. +Celui-ci doit contenir le sujet du mail dans subject et le corps du message dans msg. Ces deux +informations sont des formats paramètrables composés avec, +comme valeur clé, l'URL de retour à laquelle l'utilisateur devra se rendre pour accèder à la +seconde étape de la récupération de son mot de passe.

    +
    • +
+
    +
  • +

    L'utilisateur doit donc se rendre sur l'interface par l'intermédiaire de l'URL qui lui aura été + fournie dans le mail de l'étape précédente. Cette URL contient la valeur de l'attribut + recoveryHashAttr précédement définie. A partir de cette information, une recherche est effectuée + dans l'annuaire pour retrouver l'utilisateur correspondant.

    +

    Si l'utilisateur est retrouvé, un nouveau mot de passe lui est généré en utilisant les paramètres +de configuration éventuellement définis dans la configuration HTML de l'attribut "mot de passe". +Pour avoir plus d'information sur ces paramètres, consulter la documentation du type d'attribut +HTML +LSattr_html_password. +L'attribut recoveryHashAttr est quant à lui supprimé.

    +

    Ensuite, un mail est composé à partir des paramètres du tableau associatif newPasswordMail et +est envoyé à l'utilisateur. Ce tableau doit contenir le sujet du mail dans subject et le corps +du message dans msg. Ces deux informations sont des +formats paramètrables composés avec, comme valeur clé, le +nouveau mot de passe de l'utilisateur.

    +
    • +
+
'recoverPassword' => array(
+  'mailAttr' => '[attribut mail]',
+  'recoveryHashAttr' => '[attribut hash]',
+  'recoveryEmailSender' => '[adresse mail utilisée par LdapSaisie pour l'envoi des mails]',
+  'recoveryHashMail' => array(  // 1er mail : avec l'URL pour l'accès à la 2nde partie
+    'subject' => '[sujet du mail]',
+    'msg' => "[message contenant le mot clé %{url}]"
+  ),
+  'newPasswordMail' => array(  // 2nd mail : avec le mot de passe
+    'subject' => '[sujet du mail]',
+    'msg' => "[message contenant le mot clé %{mdp}]"
+  )
+),
+...
+

Ended: Connexion LDAP

Configuration de la journalisation (LSlog)

+

Cette section décrit le tableau de configuration de la journalisation de l'application.

+
$GLOBALS['LSlog'] = array(
+  'enable' => [booléen],
+  'level' => '[niveau]',
+  'handlers' => array(
+    '[handler 1]',
+    array (
+      'handler' => [handler 2],
+      'enabled' => [booléen],
+      'level' => '[niveau]',
+      'loggers' => array('logger1', [...]),
+      'excluded_loggers' => array('logger2', [...]),
+      'format' => '[LSformat]',
+      'cli_format' => '[LSformat]',
+      'datetime_prefix' => [booléen],
+      'datetime_format' => '[format date()]',
+      // Autres paramètres propre à ce handler
+      [...]
+    ),
+    [...]
+  ),
+  'loggers' => array (
+    'logger1' => array (
+      'level' => 'DEBUG',
+    ),
+    'logger2' => array (
+      'enabled' => false,
+    ),
+    [...]
+  );
+);
+...
+
+
    +
  • +

    enable

    +

    Booléen permatant d'activer ou désactiver complètement la journalisation. Par défaut : False

    +
    • +
+
    +
  • +

    level

    +

    Ce paramètre défini le niveau minimum de la journalisation : tous les messages des niveaux +inférieurs ne seront pas inclus dans le journal de l'application. Les niveaux de journalisation +gérés par l'application sont (dans l'ordre du plus petit au plus grand) :

    +
      +
    • TRACE
      • +
    • DEBUG
      • +
    • INFO
      • +
    • WARNING
      • +
    • ERROR
      • +
    • FATAL
      • +
    +
    • +
+
    +
  • +

    handlers

    +

    Tableau permettant de configurer les handlers de la journalisation. Chaque handler gère les +messages journalisés d'une manière qui lui est propre.

    +

    Plusieurs handlers peuvent être configurés en même temps (y compris plusieurs handlers du même +type).

    +

    Ce tableau peut contenir simplement le nom du type de handler à utiliser ou bien des tableaux +configurant un à un chacun des handlers. Dans ce second cas, la structure de la configuration +d'un handler est la suivante :

    +
    array(
+  'handler' => [type],
+  'level' => '[niveau]',
+  'loggers' => array('logger1', [...]),
+  'excluded_loggers' => array('logger2', [...]),
+  'format' => '[LSformat]',
+  'cli_format' => '[LSformat]',
+  'datetime_prefix' => [booléen],
+  'datetime_format' => '[format date()]',
+  // Autres paramètres propre à ce handler
+  [...]
+)
+...
+
    +
      +
    • +

      handler

      +

      Type du handler (voir ci-dessous).

      +
      • +
    +
      +
    • +

      level

      +

      Ce paramètre défini le niveau minimum de la journalisation spécifique à cet handler. Si ce +paramètre est omis, le niveau global sera utilisé. Les valeurs possibles de ce paramètre sont +les mêmes que pour le paramètre $GLOBALS['LSlog']['level'].

      +
      • +
    +
      +
    • +

      enabled

      +

      Booléen permettant d'activer ou désactiver cet handler (paramètre facultatif, par défaut : +True).

      +
      • +
    +
      +
    • +

      loggers

      +

      Liste exhautive des composants dont les messages doivent être traités par ce handler (paramètre +facultatif, par défaut : tous les composants).

      +
      • +
    +
      +
    • +

      excluded_loggers

      +

      Liste exhautive des composants dont les messages ne doivent pas être traités par ce handler +(paramètre facultatif, par défaut : aucun composant).

      +
      • +
    +
      +
    • +

      format

      +

      LSformat des messages de cet journalisé par ce handler. Ce +format est composé à partir des informations décritent ci-dessous. Par défaut :

      +
      %{requesturi} - %{remoteaddr} - %{ldapservername} - %{authuser} - %{logger} - %{level} - %{message}
+
      +
        +
      • +

        level

        +

        Le niveau du message.

        +
        • +
      +
        +
      • +

        message

        +

        Le message.

        +
        • +
      +
        +
      • +

        logger

        +

        Le composant ayant déchenché cette journalisation.

        +
        • +
      +
        +
      • +

        clibinpath

        +

        Le nom du script ayant déclenché cette jounalisation (uniquement en cas d'exécution en ligne +de commande).

        +
        • +
      +
        +
      • +

        requesturi

        +

        L'URL de la page courante (uniquement dans un contexte Web).

        +
        • +
      +
        +
      • +

        remoteaddr

        +

        L'adresse IP du client (uniquement dans un contexte Web).

        +
        • +
      +
        +
      • +

        ldapservername

        +

        Le nom du serveur LDAP courant.

        +
        • +
      +
        +
      • +

        authuser

        +

        Le DN de l'utilisateur connecté (uniquement dans un contexte Web).

        +
        • +
      +
      • +
    +
      +
    • +

      cli_format

      +

      LSformat des messages de cet journalisé par ce handler dans +le cas d'une exécution en ligne de commande. Ce format est composé à partir des même +informations que le paramètre format (voir ci-dessus). Par défaut : +

      %{clibinpath} - %{logger} - %{level} - %{message}
+

      +
      • +
    +
      +
    • +

      datetime_format

      +

      Booléen permettant de définir si le message doit être préfixé de la date et heure courante. La +valeur par défaut dépends de l'handler (en règle général, toujours actif sauf lorsque le canal +de journalisation l'ajoute déjà).

      +
      • +
    +
      +
    • +

      datetime_format

      +

      Format de la date et heure lorsque celle-ci est ajoutée en préfixe du message (voir paramètre +datetime_format). Le format correspond à celui attendu par la function date() de +PHP. Consultez la documentation officielle pour +plus de détails (Par défaut : Y/m/d H:i:s).

      +
      • +
    +

    Il existe plusieurs types d'handlers gérés par l'application :

    +
      +
    • +

      file

      +

      Journalisation dans un simple fichier texte. Le chemin du fichier peut être configuré via le +paramètre path. Si ce paramètre est omis, le chemin du fichier par défaut est soit la +valeur de la variable $GLOBALS['LSlog']['filename'] (pour la rétro-compatibilité avec les +anciennes versions d'LdapSaisie) ou à défaut : tmp/LS.log.

      +
      • +
    +
      +
    • +

      syslog

      +

      Journalisation via le service syslog. Il est possible de configurer une priorité +systématique pour les messages journalisés. À défaut, la priorité sera déterminée +automatiquement en fonction du niveau du message. Les valeurs +possibles de ce paramètre sont : EMERG, ALERT, CRITICAL,ERROR, WARNING, NOTICE, INFO, DEBUG

      +
      • +
    +
      +
    • +

      system

      +

      Journalisation via le gestionnaire d'erreurs PHP. Cet handler utilise la fonction +PHP error_log. Pour plus d'informations sur comment configurer le +gestionnaire d'erreurs PHP, consulter la +documentation officielle.

      +
      • +
    +
      +
    • +

      email

      +

      Journalisation via l'envoi d'un email : chaque message journalisé déclenchera l'envoi d'un email +au destinataire configuré. L'adresse email du destinataire peut-être configurée via le paramètre +recipient.

      +
      +

      Note

      +

      Il est conseillé d'utiliser ce type d'handler avec un niveau minimum de journalisation +important (FATAL recommandé) pour ne pas déclencher un nombre trop important d'envois +d'emails.

      +
      +
      • +
    +
    • +
+
    +
  • +

    loggers

    +

    Tableau permettant de configurer la journalisation composant par composant. Chaque composant peut +avoir son propre logger ce qui permet alors, par exemple, de configurer le niveau de log +spécifiquement pour ce composant.

    +

    Le nom des composant correspond en général au nom de la classe PHP correspondante, ou bien encore +le nom d'une commande (lors d'une exécution en ligne de commande).

    +
    +

    Note

    +

    Par défaut, le nom du composant ayant déclenché un message journalisé est affiché juste avant +le niveau de log.

    +
    +
      +
    • +

      enabled

      +

      Booléen permettant de désactiver complètement les logs du composant (par défaut: True).

      +
      • +
    +
      +
    • +

      level

      +

      Niveau de log spécifique pour ce composant (par défaut: le niveau de log global).

      +
      • +
    +
    • +

Format paramétrable (LSfomat)

+

Un format paramétrable est une chaîne de caractères contenant des mots clés formés comme dans +l'exemple suivant :

+
%{[nom du mot clé][:A][:B][! ou _][~][%]}
+
+

Le nom du mot clé peut contenir des lettres de "a" à "z", de "A" à "Z" et des chiffres de 0 à 9. Ces +mots clés seront remplacés par les valeurs passées en paramètres et liées au contexte d'utilisation. +Les paramètres :A et :B permettent d'extraire une partie de la chaîne complète avant la +substitution.

+

Le paramètre A correspond, lorsque B n'est pas défini, au nombre maximum de caractères à +extraire de la chaîne de substitution. A doit être un entier dont le signe influ, comme expliqué +ci-dessous :

+
    +
  • Si A est positif, les A premiers caractères de la chaîne de substitution seront extraits.
    • +
+
    +
  • Si A est négatif, les |A| derniers caractères de la chaîne de substitution seront extraits.
    • +
+

Lorsque le paramètre B est défini, A correspond au rang du premier caractère à partir duquel la +chaîne de substitution sera découpée et B le nombre maximum de caractères à extraire. Le signe de +B influera comme expliqué dans le premier cas. Si B vaut zéro, la totalité de la longeur de la +chaîne sera retournée en tenant compte de A pour le rang du premier caractère.

+

Il existe par ailleurs des paramètres permettant de modifier la valeur de substitution avant son +utilisation :

+
    +
  • Les paramètres ! ou _ permettre respectivement de forcer la mise en majuscule ou en minuscule ;
    • +
+
    +
  • Le paramètre ~ permet de forcer la suppression des accents ;
    • +
+
    +
  • Le paramètre % permet de protéger les caractères éligibles en entités HTML.
    • +
+
+

Important

+

Lorsque qu'une seule valeur clé est disponible pour la substitution, le nom du mot clé n'importe +pas. Tous les mots clés trouvés dans le format seront remplacés par cette seule valeur.

+

Paramètres étendus des recherches dans l'annuaire

+

Les paramètres des recherches sont ceux supportés par +Net_LDAP2. Ces paramètres sont passés sous la forme d'un +tableau associatif. Les paramètres supportés sont détaillés ci-dessous :

+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
NomDescriptionValeur par défaut
scope

Définition de l'étendue de la recherche :

+
    +

  • base - Sur une entrée seulement

    • +

  • one - Sur les entrées imédiatement contenu par le basedn de la recherche

    • +

  • sub - Sur l'arbre entier

    • +
sub
sizelimitLe nombre maximum d'entrées retournées par la recherche.0 (illimité)
timelimitLe délai d'attente maximum de la réponse du serveur en secondes.0 (illimité)
attrsonlySi vrai, seuls les noms des atttributs seront retournés.false
attributesTableau contenant les noms des attributs que les entrées retournées peuvent contenir et que l'on souhaite récupérer.array()(tous)
+

Pour plus d'information sur le sujet, vous pouvez consulter la documentation officiel du projet +Net_LDAP2.

Ended: Configuration globale

Objets de l'annuaire

Configuration LSobject

+

Cette partie décrit la manière de configurer les différents types de LSobjets manipulés par +LdapSaisie.

+

La configuration des LSobjects est stockée dans le dossier /conf/LSobjects. Dans ce dossier, on +retrouve un fichier par type d'LSobject, nommé de la manière suivante :

+
config.LSobjects.[nom du type d'LSobject].php
+
+

Ce fichier contient la déclaration de la configuration du type d'LSobject qui est stocké dans la +variable globale $GLOBALS['LSobjects']['[nom du type d'LSobject]'].

+
$GLOBALS['LSobjects']['[nom du type d'LSobject]'] = array (
+  'objectclass' => array(
+    'objetclass1',
+    'objetclass2',
+    ...
+  ),
+  'filter' => '[filtre LDAP]',
+
+  'rdn' => 'attr1',
+
+  'LSaddons' => [LSaddon(s)],
+
+  'container_dn' => 'ou=people',
+  'generate_container_dn' => '[callable]',
+  'container_auto_create' => array(
+    // Information des configurations pour la création du conteneur du type d'LSobjet
+    // lors de la création nouveau subDn
+  ),
+
+  'disable_creation' => [boolean]',
+
+  'before_modify' => 'function1',
+  'after_modify' => 'function2',
+  'after_create' => 'function3',
+  'after_delete' => 'function4',
+
+  'label' => 'objet1',
+  'display_name_format' => '[format]',
+  'displayAttrName' => '[booleen]',
+
+  //Custom Actions
+  'customActions' => array (
+    // Configuration des customActions pour ce type d'objet
+  ),
+
+  // LSrelation
+  'LSrelation' => array(
+    // Configuration des LSrelations entre ce type d'objet et les autres
+  ),
+
+  // LSform
+  'LSform' => array (
+    // Configuration des formulaires de l'objet
+  ), // fin LSform
+
+  // LSsearch
+  'LSsearch' => array (
+    // Configuration des recherches de l'objet
+  ), // fin LSsearch
+
+  'globalSearch' => [booleen],
+  'globalSearch_extraDisplayedColumns' => [booleen],
+
+  // ioFormat
+  'ioFormat' => array (
+    // Configuration des formats d'import/export de l'objet
+  ),
+
+  // Attributs
+  'attrs' => array (
+    // Configuration des attributs du type d'LSobjet
+  )
+);
+...
+
+
    +
  • +

    objectclass

    +

    La liste des objectclass des objets.

    +
    • +
+
    +
  • +

    filter

    +

    Filtre de recherche LDAP applicable à tout les objets de ce type et qui sera utilisé lors de +chaque recherche de ce type d'objet.

    +
    • +
+
    +
  • +

    rdn

    +

    Nom de l'attribut correspondant au RDN des objets LDAP.

    +
    • +
+
    +
  • +

    LSaddons

    +

    LSaddon(s) dont le type d'objet dépend. Ce peut être un tableau de chaînes de caractères ou une +simpe chaîne de caractères correspondant au(x) nom(s) du/des LSaddon(s) en dépendance.

    +
    • +
+
    +
  • +

    container_dn

    +

    Elément pour construire le basedn de stockage de ce type d'objet. Par exemple, si le basedn de +l'annuaire est o=ls et que les objets utilisateurs sont stockés dans la branche de l'annuaire +ou=people,o=ls, alors container_dn devra valoir ou=people.

    +

    Lorsque l'annuaire possède des subDn, les +objets seront cherchés dans le basedn résultant de la concaténation du paramètre container_dn, +d'une virgule et du basedn correspondant au +subDn courant.

    +
    • +
+
    +
  • +

    generate_container_dn

    +

    Callable (au sens PHP), utilisé pour générer la valeur du paramètre container_dn +dynamiquement. Ce callable prend en paramètre l'objet LSobject à +créer et retourne la valeur du paramètre container_dn.

    +
    • +
+
    +
  • +

    container_auto_create

    +

    Tableau associatif contenant les paramètres de configuration nécessaires à la création des +container_dn dans les nouveaux objets utilisés comme +subDn. +Voir la section concernée.

    +
    • +
+
    +
  • +

    disable_creation

    +

    Booléen permetant de desactiver la creation de ce type d'objet de manière globale.

    +
    • +
+
    +
  • +

    before_modify

    +

    Chaîne de caractères (ou tableau de chaine de caractères) correspondant au nom d'une ou plusieurs +fonctions qui seront exécutées avant la modification d'un objet. +Voir la section concernée.

    +
    • +
+
    +
  • +

    after_modify

    +

    Chaîne de caractères (ou tableau de chaine de caractères) correspondant au nom d'une ou plusieurs +fonctions qui seront exécutées après la modification d'un objet. +Voir la section concernée.

    +
    • +
+
    +
  • +

    after_create

    +

    Chaîne de caractères (ou tableau de chaine de caractères) correspondant au nom d'une ou plusieurs +fonctions qui seront exécutées après la création d'un objet. +Voir la section concernée.

    +
    • +
+
    +
  • +

    after_delete

    +

    Chaîne de caractères (ou tableau de chaine de caractères) correspondant au nom d'une ou plusieurs +fonctions qui seront exécutées après la suppression d'un objet. +Voir la section concernée.

    +
    • +
+
    +
  • +

    label

    +

    Nom générique au pluriel qualifiant le type d'objet. Exemple : Utilisateurs.

    +
    • +
+
    +
  • +

    display_name_format

    +

    Format paramètrable du nom des objets composés à +partir des valeurs d'affichage des attributs de l'objet.

    +
    • +
+
    +
  • +

    displayAttrName

    +

    Booléen définissant si le nom des attributs doit être affiché en préfixe de leur message d'aide +(paramètre help_info).

    +
    • +
+ + + +
    +
  • +

    LSsearch

    +

    Tableau associatif contenant les paramètres de configuration des recherches de +LSobject de ce type dans l'annuaire. +Voir la section concernée.

    +
    • +
+
    +
  • +

    globalSearch

    +

    Inclure ou non ce type d'objet dans le résultat des recherches globales (Par défaut : True).

    +
    • +
+
    +
  • +

    globalSearch_extraDisplayedColumns

    +

    Afficher ou non les colonnes supplémentaires pour ce type d'objet dans le résultat des recherches +globales (Par défaut : True). Pour plus de détails les colonnes supplémentaires, +voir la section dédiée.

    +
    • +
+
    +
  • +

    ioFormat

    +

    Tableau associatif contenant les paramètres de configuration des formats de fichiers +d'import/export de ce type d'LSobject. +Voir la section concernée.

    +
    • +
+
    +
  • +

    attrs

    +

    Tableau associatif contenant les paramètres de configuration des attributs des objets. +Voir la section concernée.

    +
    • +

Attributs

Configuration des attributs

+

Cette section décrit les options de configuration des attributs des +LSobjects. Les attributs sont définis dans le tableau +associatif attrs de la configuration des LSobjects. Dans ce +tableau, les clé les noms des attributs et les valeurs liés sont la configuration des attributs.

+
+

Warning

+

Contrairement à ce qui existe dans le standard LDAP, les noms des attributs sont sensibles à la +casse. Il faut que le nom des attributs dans LdapSaisie soient scrupuleusement les mêmes que +ceux retourné par Net_LDAP2

+
+
'attrs' => array (
+  /* ----------- start -----------*/
+  'attr1' => array (
+    'label' => '[label de l'attr1',
+    'displayAttrName' => '[booleen]',
+    'help_info' => '[Message d'aide sur l'attribut attr1]',
+    'help_info_in_view' => '[booleen]',
+    'ldap_type' => 'ldaptype1',
+    'ldap_options' => array(
+      // Options LDAP liées au type LDAP de l'attribut
+    ),
+    'html_type' => 'htmltype1',
+    'html_options' => array(
+      // Options HTML liées au type HTML de l'attribut
+    ),
+    'no_value_label' => '[No set value label]',
+    'multiple' => 0,
+    'required' => 1,
+    'generate_function' => 'fonction1',
+    'generate_value_format' => '[LSformat]',
+    'default_value' => 'valeur1',
+    'set_default_value_on_creation_if_empty' => [booleen],
+    'force_generation_if_empty' => [booleen],
+    'check_data' => array (
+      // Régle de vérification syntaxique des données saisies
+    ),
+    'validation' => array (
+      // Règle de vérification d'intégrité des données saisies
+    ),
+    'rights' => array(
+      'LSprofile1' => 'droit1',
+      'LSprofile2' => 'droit2',
+      ...
+    ),
+    'view' => 1,
+    'form' => array (
+      'create' => 1,
+      'modify' => 0,
+      ...
+    ),
+    'dependAttrs' => array(
+      // Attributs en dépendance
+    ),
+    'onDisplay' => 'fonction2'
+
+    'before_modify' => 'function1',
+    'after_modify' => 'function2'
+  ),
+  /* ----------- end -----------*/
+  ...
+);
+...
+
+
    +
  • +

    label

    +

    Le label de l'attribut.

    +
    • +
+
    +
  • +

    displayAttrName

    +

    Booléen définissant si le nom de l'attribut doit être affiché en préfixe du message d'aide +(paramètre help_info).

    +
    • +
+
    +
  • +

    help_info

    +

    Message d'aide qui sera affiché dans une bulle d'aide à côté du nom de l'attribut dans les +formulaires.

    +
    • +
+
    +
  • +

    help_info_in_view

    +

    Booléen définissant si le message d'aide doit être affiché sur la vue de visualisation de l'objet.

    +

    Valeurs possibles : 0 ou 1

    +

    Valeur par défaut : 0

    +
    • +
+ +
    +
  • +

    ldap_options

    +

    Tableau associatif contenant les paramètres de configuration du type LDAP de l'attribut. +Voir la section concernée.

    +
    • +
+ +
    +
  • +

    html_options

    +

    Tableau associatif contenant les paramètres de configuration du type HTML de l'attribut. +Voir la section concernée.

    +
    • +
+
    +
  • +

    no_value_label

    +

    Label affiché lorsque l'attribut n'a pas de valeur (facultatif).

    +
    • +
+
    +
  • +

    multiple

    +

    Booléen définissant si cet attribut peut stocker plusieurs valeurs.

    +

    Valeurs possibles : 0 ou 1

    +

    Valeur par défaut : 0

    +
    • +
+
    +
  • +

    required

    +

    Booléen définissant si cet attribut doit obligatoirement être défini.

    +

    Valeurs possibles : 0 ou 1

    +

    Valeur par défaut : 0

    +
    • +
+
    +
  • +

    generate_function

    +

    Nom de la fonction permettant de générer la valeur de l'attribut. Cette fonction sera éxecutée, en +passant en premier paramètre, l'objet LSobject courant.

    +
    • +
+
    +
  • +

    generate_value_format

    +

    LSformat permettant la génération de l'attribut.

    +
    +

    Note

    +

    Cette méthode de génération est utilisée uniquement si aucune fonction de génération de la +valeur n'est définie (paramètre generate_function).

    +
    +
    • +
+
    +
  • +

    default_value

    +

    Valeur par défaut de l'attribut.

    +
    +

    Warning

    +

    Il doit s'agir de la valeur telque retournée par le formulaire web. Ainsi, par exemple dans le +cas d'un attribut booléen, les valeurs possibles sont yes ou no.

    +
    +
    +

    Note

    +

    Cette valeur est également utilisée dans le cadre de la génération automatique de la valeur de +l'attribut si aucune autre méthode n'est disponible (via une fonction ou un +LSformat).

    +
    +
    • +
+
    +
  • +

    set_default_value_on_creation_if_empty

    +

    Booléen permettant de définir si la valeur de l'attribut doit être initialisée avec sa valeur par +défaut à la création de l'objet si aucune autre valeur n'as été fournie dans le contexte de +création (par défaut : 1).

    +
    • +
+
    +
  • +

    force_generation_if_empty

    +

    Booléen permettant de définir si la valeur de l'attribut doit être générée si elle est vide, que +ce soit à la création ou la modification de l'objet (par défaut : 0).

    +
    +

    Warning

    +

    Si la génération échoue, cela bloquera l'action. Par ailleurs, cette génération est +prioritaire sur l'utilisation de la valeur par défaut de l'attribut induit par le paramètre +set_default_value_on_creation_if_empty.

    +
    +
    • +
+
    +
  • +

    check_data

    +

    Tableau associatif contenant les règles de vérification syntaxique des données de l'attribut. +Voir la section concernée.

    +
    • +
+
    +
  • +

    validation

    +

    Tableau associatif contenant les règles de vérification d'intégrité des données de l'attribut. +Voir la section concernée.

    +
    • +
+
    +
  • +

    rights

    +

    Tableau associatif dont les clés sont les noms des +LSprofiles ayant des droits sur cet +attribut et les valeurs associées sont les droits correspondants. La valeur des droits d'un +LSprofile peut être r pour le droit de +lecture ou w pour le droit de lecture-écriture. Par défaut, un +LSprofile n'a aucun droit.

    +
    • +
+
    +
  • +

    view

    +

    Booléen définissant si l'attribut est, ou non, affiché lors de la visualisation des objets du type +courant.

    +

    Valeurs possibles : 0 ou 1

    +

    Valeur par défaut : 0

    +
    • +
+
    +
  • +

    form

    +

    Tableau associatif dont les clés sont les noms des LSforms et les valeurs +associées la définition de l'affichage dans ce LSform. Si cette valeur vaut +0, alors l'attribut sera lecture-seule et si cette valeur vaut 1, cet attribut sera affiché +en lecture-écriture.

    +
    • +
+
    +
  • +

    dependAttrs

    +

    Tableau associatif listant les attributs dépendants de celui-ci. Les attributs listés ici seront +regénérés lors de chaque modification de l'attribut courant. Cette génération sera effectuée avec +la fonction définie dans le paramètre generate_function de l'attribut.

    +
    • +
+
    +
  • +

    onDisplay

    +

    Nom ou liste de nom des fonctions retournant les valeurs d'affichages de l'attribut. Si c'est une +liste, chacune des fonctions seront executée les unes après les autres. Ces fonctions seront +éxecutées, en passant en premier paramètre, le tableau des valeurs de l'objet.

    +
    • +
+
    +
  • +

    before_modify

    +

    Chaîne de caractères (ou tableau de chaine de caractères) correspondant au nom d'une ou plusieurs +fonctions qui seront exécutées avant toutes modifications de la valeur de l'attribut. +Voir la section concernée

    +
    • +
+
    +
  • +

    after_modify

    +

    Chaîne de caractères (ou tableau de chaine de caractères) correspondant au nom d'une ou plusieurs +fonctions qui seront exécutées après toutes modifications de la valeur de l'attribut. +Voir la section concernée

    +
    • +

Types d'attribut LDAP (LSattr_ldap)

Configuration des attributs LDAP (LSattr_ldap)

+

Cette section décrit les options propres à chacun des types d'attributs LDAP supportés par +LdapSaisie.

LSattr_ldap_ascii

+

Ce type est utilisé pour la gestion des attributs dont la valeur est une chaine de caractère. Ce +type est le type par défaut.

LSattr_ldap_boolean

+

Ce type est utilisé pour la gestion des attributs dont la valeur est une booléen. On attend ici par +booléen, tout attribut ne pouvant prendre que deux valeurs pré-définies correspond pour l'un à Oui +et l'autre à Non

+
'ldap_options' => array (
+  'true_value' => '[valeur correspondant à Vrai]',
+  'false_value' => '[valeur correspondant à Faux]'
+),
+...
+
+
    +
  • +

    true_value

    +

    La valeur de l'attribut correspondant à Vrai­. (Par défaut : TRUE)

    +
    • +
+
    +
  • +

    false_value

    +

    La valeur de l'attribut correspondant à False­. (Par défaut : FALSE)

    +
    • +
+
+

Important

+

Les valeurs possibles pour le paramètre default_value sont yes et no.

+

LSattr_ldap_compositeValueToJSON

+

Ce type est utilisé pour la gestion des attributs composites dont les valeurs respectent le format +suivant : [key1=value1][key2=value2][...]

+

Ce type d'attribut LDAP sera utilisé pour convertir la valeur en son équivalent JSON pour pouvoir +être traité à l'aide du type d' attribut HTML +LSattr_html_jsonCompositeAttribute.

LSattr_ldap_date

+

Ce type est utilisé pour la gestion des attributs dont la valeur est une date.

+
+

Note

+

Au sein d'LdapSaisie, les dates manipulées au travers ce type d'attribut LDAP, sont au format +timestamp. Il s'agit donc de nombres entiers correpondants au nombre de secondes depuis le 1 +janvier 1970.

+

Le type d'attribut HTML utilisé conjointement avec ce type d'attribut LDAP devra être prévu pour +recevoir et fournir des dates au format timestamp, comme c'est le cas pour le type d'attribut +HTML date.

+
+
'ldap_options' => array (
+  'timestamp' => [Booléen], // Si la date est stockée au format timestamp
+  'formats' => array(
+    '[Format de stockage principal]', // Par défaut : "YmdHisO"
+    '[Formats de stockage alternatifs]', // Par défaut : "YmdHis.vO" & "YmdHis.uO"
+    [...]
+  ),
+  'timezone' => '[Fuseau horaire]', // Default : "UTC"
+),
+...
+
+
    +
  • +

    timestamp

    +

    Booléen définissant si la date est stockée sous la forme d'un timestamp Unix (nombre de secondes +depuis le 1er janvier 1970 à 00:00:00 UTC)­.

    +

    Si timestamp est vrai, LdapSaisie ne tient pas compte du paramètre format.

    +
    • +
+
    +
  • +

    formats

    +

    Formats de stockage de la date dans l'annuaire. Ces formats sont composés à partir des motifs clés +gérés par la fonction date() de PHP. Pour plus d'information, consulter +la documentation officielle. Plusieurs formats peuvent être définis, +mais en cas de stockage d'une nouvelle valeur, se sera le premier format défini qui sera utilisé.

    +
    +

    Note

    +

    La valeur par défaut est ["YmdHisO", "YmdHis.vO", "YmdHis.uO"], correspondant à la syntaxe +Generalized Time (sans et avec les milli-secondes ou micro-secondes) telle que définie dans +la RFC4517. +Exemples : 20091206230506Z (=2009/12/06 23:05:66 UTC), 20190613143537+0200 +(=2019/06/13 14:35:37 UTC+0200) ou 20230818121005.307+0200 +(=2023/08/18 12:10:05.307 UTC+0200).

    +
    +
    +

    Warning

    +

    Si vous exploitez un attribut stockant une date incluant les milli-secondes ou les +micro-secondes, ce type d'attribut LDAP sera capable de gérer l'interpratation des valeurs +stockées, en outre le type d'attribut +LSattr_html_date, s'appuyant sur les +méthodes standards strftime() et strptime(), ne permettra pas aujourd'hui leur saisie et +affichage.

    +
    +
    • +
+
    +
  • +

    timezone

    +

    Fuseau horaire de stockage des dates dans l'annuaire LDAP. Les valeurs possibles sont documentées +dans la documentation officielle de PHP. (Par défaut : UTC)

    +
    • +

LSattr_ldap_image

+

Ce type est utilisé pour la gestion des attributs dont la valeur est une image. Pour le moment, +aucun traitement particulier n'est appliqué pour le stockage.

LSattr_ldap_naiveDate

+

Ce type est utilisé pour la gestion des attributs dont la valeur est une date dont la timezone +doit être ignorée. Côté LDAP, les dates seront stockées au format UTC étant donnée que la syntaxe +LDAP exige une timezone, cependant celle-ci sera complètement ignorée. Ce type peut-être utilisé +à la place du type LSattr_ldap_date.

+
'ldap_options' => array (
+  'format' => '[Format de stockage]', // Default : "%Y%m%d%H%M%SZ"
+),
+...
+
+
    +
  • +

    format

    +

    Format de stockage de la date dans l'annuaire. Ce format est composé à partir des motifs clés +gérés par la fonction strftime() de PHP. Pour plus d'information, consulter +la documentation officielle.

    +
    +

    Note

    +

    La valeur par défaut est %Y%m%d%H%M%SZ, correspondant à la syntaxe Generalized Time (sans +les micro-secondes) telle que définie dans la RFC4517. +Exemple : 20091206230506Z (=2009/12/06 23:05:66 UTC).

    +
    +
    • +

LSattr_ldap_numeric

+

Ce type est utilisé pour la gestion des attributs dont la valeur est un nombre. Pour le moment, +aucun traitement particulier est n'appliqué pour le stockage.

LSattr_ldap_password

+

Ce type est utilisé pour la gestion des attributs dont la valeur est un mot de passe.

+
'ldap_options' => array (
+  'encode' => '[Type d'encodage du mot de passe]',
+  'encode_function' => '[Nom de la fonction d'encodage]',
+  'verify_function' => '[Nom de la fonction de vérification]',
+  'no_random_crypt_salt' => '[Booléen]', // Désactivation de l'utilisation d'une salt aléatoire
+  'wildcardPassword' => '[mot de passe(s) en clair]',
+  'encodedWildcardPassword' => '[mot de passe(s) encodé(s)]'
+),
+...
+
+
    +
  • +

    encode

    +

    Nom du type d'encodage du mot de passe utilisé. Les types d'encodages supportés sont les +suivants :

    +
      +
    • argon2 (ou argon2i, PHP >= 7.2)
      • +
    • argon2id (PHP >= 7.3)
      • +
    • md5crypt
      • +
    • crypt
      • +
    • ext_des
      • +
    • blowfish
      • +
    • sha
      • +
    • sha256
      • +
    • sha512
      • +
    • ssha
      • +
    • ssha256
      • +
    • ssha512
      • +
    • smd5
      • +
    • md5
      • +
    • clear
      • +
    +
    +

    Note

    +

    Valeur par défaut : md5crypt

    +
    +
    +

    Important

    +

    Si le type d'encodage est inconnu, ou qu'il n'est pas supporté par le serveur web, un message +d'erreur alertera l'utilisateur et le mot de passe sera stocké en clair.

    +
    +
    • +
+
    +
  • +

    encode_function

    +

    Nom d'une function qui sera utilisée afin d'encoder le mot de passe. Cette fonction recevra deux +paramètres : le LSldapObject et le mot de passe en clair.

    +
    • +
+
    +
  • +

    verify_function

    +

    Nom d'une function qui sera utilisée afin de valider un mot de passe soumis par l'utilisateur par +rapport à celui stocké dans l'annuaire. Cette fonction recevra trois paramètres : le +LSldapObject,le mot de passe en clair et le mot de passe hashé. Si ce paramètre est omis et que +le paramètre encode_function est défini, le mot de passe à tester sera encodé à nouveau à l'aide +de la fonction encode_function et le résultat sera comparé avec le mot de passe stocké dans +l'annuaire.

    +
    • +
+
    +
  • +

    no_random_crypt_salt

    +

    Désactivation de l'utilisation d'une salt générée aléatoirement au profit de l'utilisation des +deux premiers caractères du mot de passe. Ce paramètre impacte uniquement le type de cryptage +crypt.

    +
    • +
+
    +
  • +

    wildcardPassword

    +

    Mot de passe (ou tableau de mot de passe) qui sera ajouté systématiquement, en plus du mot de +passe choisi. Il sera encodé de la même manière que pour le mot de passe choisi avant +enregistrement.

    +
    • +
+
    +
  • +

    encodedWildcardPassword

    +

    Mot de passe (ou tableau de mot de passe) qui sera ajouté systématiquement, en plus du mot de +passe choisi. Contrairement à la directive wildcardPassword, le mot de passe ne sera pas encodé +avant enregistrement.

    +
    +

    Note

    +

    Cette directive peut cohabiter avec sa cousine wildcardPassword. Les mot de passes contenus +dans les deux directives seront alors ajoutés.

    +
    +
    • +

LSattr_ldap_postaladdress

+

Ce type est utilisé pour la gestion des attributs dont la valeur est construite sur le modèle de +l'attribut standard postalAddress, c'est à dire dont les lignes sont séparées à l'aide du +caractère de délimiteur $.

+

Lors de la lecture des valeurs de ce type d'attribut dans l'annuaire, les caractères $ seront +remplacés par des caractères \n et, à l'inverse, lors de l'écriture des valeurs de ce type +d'attribut dans l'annuaire, les caractères \n seront remplacés par des caractères $.

LSattr_ldap_pwdHistory

+

Ce type est utilisé pour la gestion de l'attribut standard pwdHistory. Cet attribut, accessible en +lecture uniquement, stocke dans un format prédéfini l'historique des mots de passe d'une utilisateur +avec pour chaque entrée :

+
    +
  • la date et heure de l'ajout du mot de passe dans l'historique
    • +
  • l'OID de la syntaxe du mot de passe
    • +
  • la longueur du mot de passe
    • +
  • le mot de passe (hâché)
    • +
+

Ce type d'attribut LDAP permettra de convertir la valeur en son équivalent JSON pour pouvoir être +traité à l'aide du type d'attribut HTML +LSattr_html_jsonCompositeAttribute.

+

Exemple de valeur de l'attribut pwdHistory :

+
20201202144718Z#1.3.6.1.4.1.1466.115.121.1.40#105#{SSHA512}XDSiR6Sh6W7gyVIk6Rr2OUv8rNPr+0rHF99d9lcirE/TnnEdkjkncIi5iPubErL5lpfgh8gXLgSfmqvmFcMqXLToC25xIqyk
+
+

Exemple de valeur tranformée :

+
{"time":1606920438,"syntaxOID":"1.3.6.1.4.1.1466.115.121.1.40","length":105,"hashed_password":"{SSHA512}XDSiR6Sh6W7gyVIk6Rr2OUv8rNPr+0rHF99d9lcirE/TnnEdkjkncIi5iPubErL5lpfgh8gXLgSfmqvmFcMqXLToC25xIqyk"}
+
+

Exemple de configuration complète de l'attribut :

+
'pwdHistory' => array (
+    'label' => 'Passwords in history',
+    'ldap_type' => 'pwdHistory',
+    'html_type' => 'jsonCompositeAttribute',
+    'html_options' => array (
+      'components' => array (
+        'time' => array (
+          'label' => 'Date added to history',
+          'type' => 'text',
+          'required' => true,
+          'multiple' => false,
+        ),
+        'syntaxOID' => array (
+          'label' => 'Syntax OID',
+          'type' => 'text',
+          'required' => true,
+          'multiple' => false,
+        ),
+        'length' => array (
+          'label' => 'Length',
+          'type' => 'text',
+          'required' => true,
+          'multiple' => false,
+        ),
+        'hashed_password' => array (
+          'label' => 'Hashed password',
+          'type' => 'text',
+          'required' => true,
+          'multiple' => false,
+        ),
+      ),
+    ),
+    'no_value_label' => 'History is empty.',
+    'multiple' => 1,
+    'rights' => array(
+      'admin' => 'r',
+    ),
+    'view' => 1,
+),
+
+

La date et heure de l'ajout du mot de passe dans l'historique est convertie dans un format lisible. +Par défaut, ce format est AAAA/MM/JJ HH:MM:SS, mais il peut aussi est personnalisé via le +paramètre date_format. Ce format est composé à partir des motifs clés gérés par la fonction +date() de PHP. Pour plus d'information, consulter +la documentation officielle.

+
+

Note

+

La valeur par défaut est YmdHisO, correspondant à la syntaxe Generalized Time telle que +définie dans la RFC4517 et prévu par le +Draft-behera-ldap-password-policy +spécifiant cet attribut standard.

+

LSattr_ldap_sambaAcctFlags

+

Ce type est prévu pour gérer l'attribut sambaAcctFlags du schéma Samba, qui au travers d'une seule +et unique valeur, respectant un format prévu, liste l'ensemble des drapeaux actifs d'un compte +Samba. Il transforme l'unique valeur de l'attribut LDAP en une liste de drapeaux actuellement +activés sur le compte. Il est conçu pour être utilisé conjointement avec le type d'attribut HTML +LSattr_html_sambaAcctFlags.

LSattr_ldap_shadowExpire

+

Ce type est prévu pour gérer l'attribut shadowExpire du schéma POSIX, qui une stocke une date sous +la forme d'un entier correspondant au nombre de jours depuis le premier 1er 1970. Il est prévu pour +être utilisé conjointement avec le type d'attribut HTML +LSattr_html_date.

+
+

Note

+

Malgrés son nom, ce type d'attribut LDAP peux être utilisé pour d'autres attributs stockant ce +même format de date, tel-que l'attribut shadowLastChange.

+

Ended: Types d'attribut LDAP (LSattr_ldap)

Types d'attribut HTML (LSattr_html)

Configuration des attributs HTML (LSattr_html)

+

Cette section décrit les options propres à chacun des types d'attributs HTML supportés par +LdapSaisie.

LSattr_html_boolean

+

Ce type est utilisé pour la gestion des attributs dont la valeur est un booléen.

+

La valeur retournée est l'une des chaînes de caractères suivantes :

+
    +
  • yes pour Vrai
    • +
+
    +
  • no pour False
    • +
+
'html_options' => array (
+  'true_label' => '[label]',
+  'false_label' => '[label]',
+),
+...
+
+
    +
  • +

    true_label

    +

    Label affiché pour désigner la valeur True.

    +
    • +
+
    +
  • +

    false_label

    +

    Label affiché pour désigner la valeur False.

    +
    • +
+
+

Note

+

Pour le moment, les attributs à valeurs multiples ne sont pas gérés.

+
+
+

Note

+

Pour maîtriser les valeurs stockées dans l'annuaire, il faut coupler ce type d'attribut HTML +avec le type d'attribut LDAP boolean

+
+
+

Important

+

La définition de la valeur par défaut d'un attribut utilisant ce type HTML (paramètre +default_value), doit se faire à l'aide des valeurs yes ou no.

+

LSattr_html_date

+

Ce type est utilisé pour la gestion des attributs dont la valeur est une date. L'outil de sélection +de date MooTools-DatePicker est utilisé pour la +sélection graphique de la date et de l'heure.

+
'html_options' => array (
+  'format' => '[Format d'affichage de la date]',
+  'time' => '[Booleen pour le choix ou non de l heure]',
+  'manual' => '[Booleen pour l edition manuelle ou non]',
+  'showNowButton' => '[Booleen]',
+  'showTodayButton' => '[Booleen]',
+  'style' => '[Nom du style utilise]',
+  'special_values' => array (
+    '[value]' => '[label]',
+    [...]
+  ),
+),
+...
+
+
    +
  • +

    format

    +

    Format d'affichage de la date dans le champ de saisie. Ce format est composé à partir des motifs +clés suivants :

    + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
    Mot cléValeur de substitutionExemple de valeur
    %aNom abrégé du jour de la semaineDe Sun à Sat
    %ANom complet du jour de la semaineDe Sunday à Saturday
    %bNom du mois, abrégé, suivant la localeDe Jan à Dec
    %BNom complet du mois, suivant la localeDe January à December
    %cDate et heure préférées, basées sur la localeExemple : Tue Feb 5 00:45:10 2009 pour le 5 Février 2009 à 12:45:10 AM
    %dJour du mois en numérique, sur 2 chiffres (avec le zéro initial)De 01 à 31
    %eJour du mois, avec un espace précédant le premier chiffre. L'implémentation Windows est différente, voyez après pour plus d'informations.De 1 à 31
    %HL'heure, sur 2 chiffres, au format 24 heuresDe 00 à 23
    %IHeure, sur 2 chiffres, au format 12 heuresDe 01 à 12
    %jJour de l'année, sur 3 chiffres avec un zéro initial001 à 366
    %mMois, sur 2 chiffresDe 01 (pour Janvier) à 12 (pour Décembre)
    %MMinute, sur 2 chiffresDe 00 à 59
    %p'AM' ou 'PM', en majuscule, basé sur l'heure fournieExemple : AM pour 00:31, PM pour 22:23
    %sTimestamp de l'époque Unix (identique à la fonction time())Exemple : 305815200 pour le 10 Septembre 1979 08:40:00 AM
    %SSeconde, sur 2 chiffresDe 00 à 59
    %TIdentique à "%H:%M:%S" Exemple : 21:34:17 pour 09:34:17 PM
    %UNuméro de la semaine de l'année donnée, en commençant par le premier Lundi comme première semaine13 (pour la 13ème semaine pleine de l'année)
    %wReprésentation numérique du jour de la semaineDe 0 (pour Dimanche) à 6 (pour Samedi)
    %yL'année, sur 2 chiffresExemple : 09 pour 2009, 79 pour 1979
    %YL'année, sur 4 chiffresExemple : 2038
    %zSoit le décalage horaire depuis UTC, ou son abréviation (suivant le système d'exploitation)Exemple : -0500 ou EST pour l'heure de l'Est
    %ZLe décalage horaire ou son abréviation NON fournie par %z (suivant le système d'exploitation)Exemple : -0500 ou EST pour l'heure de l'Est
    %%Le caractère de pourcentage ("%")---
    +
    +

    Note

    +

    La valeur par défaut est %d/%m/%Y, %T. Exemple : 23/04/2009, 23:03:04

    +
    +
    • +
+
    +
  • +

    time

    +

    Booléen définissant si l'outil de sélection permetra ou non le choix de l'heure en plus de la date

    +
    • +
+
    +
  • +

    manual

    +

    Booléen autorisant ou non l'édition manuelle du champs. Si ce paramètre vaut False, la sélection +se fera uniquement à l'aide de l'outil graphique

    +
    • +
+
    +
  • +

    showNowButton

    +

    Booléen définissant si le bouton Maintenant est affiché ou non. Par défaut, il est affiché.

    +
    • +
+
    +
  • +

    showTodayButton

    +

    Booléen définissant si le bouton Aujourd'hui est affiché ou non. Par défaut, il est affiché.

    +
    • +
+
    +
  • +

    style

    +

    Nom du style d'affichage de l'outil de sélection. Les valeurs possibles sont par défaut :

    +
      +
    • default
      • +
    • dashboard
      • +
    • vista
      • +
    • jqui
      • +
    +
    +

    Note

    +

    La création de nouveau thème est possible. Pour plus d'information, consulter +l'aide de l'outil de sélection de date.

    +
    +
    • +
+
    +
  • +

    special_values

    +

    Tableau listant les valeurs spéciales que peut prendre l'attribut. Dans ce tableau associatif, la +clé doit correspondre à la valeur de l'attribut (telle que fournie par +l'attribut LDAP) et la valeur associée au +label associé.

    +

    Ces valeurs spéciales seront proposées à l'utilisateur sous la forme de cases à cocher dans le +formulaire. Elles peuvent permettre par exemple de données une signification particulière au zéro +pour un attribut LDAP stockant un timestamp.

    +
    • +

LSattr_html_gpg_pub_key

+

Ce type est utilisé pour la gestion des attributs dont la valeur est une clef publique GPG. Il +permet dans l'interface, d'avoir un affichage adapté à ce type de donnée.

LSattr_html_image

+

Ce type est utilisé pour la gestion des attributs dont la valeur est une image. Pour le moment, les +attributs à valeurs multiples ne sont pas gérés.

LSattr_html_jsonCompositeAttribute

+

Ce type est utilisé pour la gestion des attributs dont les valeurs sont des dictionnaires de valeurs +encodées aux formats JSON.

+

Exemple de valeur gérée :

+
{"component1": "value1", "component2": "value2", "component3": "value3"}
+
+

Le principe est que ces dictionnaires contienent plusieurs composants référencés par leur clé et +stockant une valeur dont le type peut être un texte libre ou bien être issue d'une liste déroulante +configurable selon le même principe que le type d'attribut +LSattr_html_select_list.

+
'html_options' => array (
+   'components' => array (
+     '[clé composant 1]' => array (
+       'label' => '[Label du composant]',
+       'help_info' => '[Message d'aide sur le composant]',
+       'type' => '[Type de la valeur stocké]',
+       'required' => [Booléen],
+       'multiple' => [Booléen],
+       'check_data' => => array (
+         // Régle de vérification syntaxique des données saisies
+       ),
+     ),
+     '[clé composant 2]' => array (
+       'label' => '[Label du composant 2]',
+       'type' => 'select_list',
+       'required' => [Booléen],
+       'options' => array (
+         [Configuration équivalente à un attribut LSattr_html_select_list]
+       )
+     ),
+     [...]
+   ),
+   'fullWidth' => [booléen],
+),
+...
+
+
    +
  • +

    components

    +

    Tableau associatif obligatoire contenant en valeur clé, l'identifiant des composants, +correspondant à la clé dans le dictionnaire JSON, et en valeurs associés, la configuration du +composant.

    +
      +
    • +

      label

      +

      Le label du composant.

      +
      • +
    +
      +
    • +

      help_info

      +

      Message d'aide sur le composant (affiché uniquement en mode édition).

      +
      • +
    +
      +
    • +

      type

      +

      Le type de valeur du composant. Les types possibles sont text ou select_list pour +respectivement soit une valeur saisie librement, soit une valeur sélectionnée parmis une liste +déroulante.

      +
      • +
    +
      +
    • +

      options

      +

      Dans le cadre d'un composant de type select_list, cela correspond à la configuration de la +liste déroulante. Cette configuration utilise la même syntaxe de configuration que celle du type +d'attribut LSattr_html_select_list et son +paramètre html_options.

      +
      • +
    +
      +
    • +

      multiple

      +

      Booléen définissant si ce composant peut stocker plusieurs valeurs (Par défaut : False).

      +
      • +
    +
      +
    • +

      required

      +

      Booléen définissant si ce composant doit obligatoirement être défini (Par défaut : False).

      +
      • +
    +
      +
    • +

      check_data

      +

      Tableau associatif contenant les règles de vérification syntaxique des données du composant. Ces +règles sont configurables de la même manière que les celles des valeurs attributs. +Voir la section concernée.

      +
      • +
    +
    • +
+
    +
  • +

    fullWidth

    +

    Booléen permettant de définir si l'affichage dans le formulaire doit se faire sur toute la largeur +disponible de la page (Par défaut : False).

    +
    • +

LSattr_html_labeledValue

+

Ce type est utilisé pour la gestion des attributs dont la valeur est prefixé d'un label et qui +respecte le format suivant : [label]valeur.

+
'html_options' => array(
+  'labels' => array ( // Liste des labels possible
+    'label1' => 'Libellé label1',
+    'label2' => 'Libellé label2',
+    [...]
+  ),
+  'translate_labels' => [booléen],
+),
+...
+
+
    +
  • +

    labels

    +

    Tableau associatif obligatoire contenant en valeur clé, le label utilisé dans la valeur stockée +et en valeur associée, le valeur d'affichage du label.

    +
    • +
+
    +
  • +

    translate_labels

    +

    Booléen permettant d'activer/désactiver la traduction des labels (Par défaut : True).

    +
    • +

LSattr_html_mail

+

Ce type est utilisé pour la gestion des attributs dont la valeur est une adresse e-mail. En plus +d'un affichage adapté, il offre la possibilité d'envoyer des mails directement depuis l'interface de +l'application.

+
'html_options' => array(
+  'disableMailSending' => [booléen],
+),
+...
+
+
    +
  • +

    disableMailSending

    +

    Désactive l'envoi de mail depuis l'interface pour cet attribut.

    +
    +

    Note

    +

    Ceci ne désactive pas pour autant le lien HTML de type mailto:. Pour cela, utilisez plutôt +le type d'attribut HTML text.

    +
    +
    • +
+
+

Important

+

Ce type d'attribut HTML est dérivé du type text. Il +profite donc de toutes les fonctionnalités d'un champ de ce type (autogénération, ...).

+

LSattr_html_maildir

+

Ce type est utilisé pour la gestion des attributs dont la valeur est le chemin d'une maildir. +Typiquement, ce type attribut HTML est utile dans le cas de l'attribut mailbox utilisé par +maildrop pour stocker le chemin des boites mails. Ce type d'attribut offre la possibilité de gérér +un niveau de l'attribut et à travers les déclencheurs gérés par LdapSaisie la création, la +modification et ou la suppression de la boite mails. +Le LSaddon +maildir est utilisé pour manipuler la boite +mail à distance.

+
+

Note

+

Actuellement, cet LSaddon ne gérant que l'accès via FTP +au serveur distant, l'API d'accès via FTP est attaquée directement.

+
+
'html_options' => array (
+  'LSform' => array (
+    '[LSform1]' => [booléen],
+    '[LSform2]' => [booléen],
+    ...
+  ),
+  'remoteRootPathRegex' => "[Expression régulière pour matcher le dossier à créer]",
+  'archiveNameFormat' => "[LSformat du chemin/nom du fichier une fois archiver]"
+ ),
+...
+
+
    +
  • +

    LSform

    +

    Tableau associatif obligatoire contenant en valeur clé le nom des LSforms +dans lesquels la fonctionnalité de modification de la boite mail sera présente. Les valeurs +attachées sont des booléens définissant si la modification est active par défaut.

    +
    • +
+
    +
  • +

    remoteRootPathRegex

    +

    Expression régulière (compatible Perl) facultative dont le but est de matcher dans la valeur +complète du chemin distant de la maildir, le chemin de la maildir à créer une fois connecté +sur le serveur.

    +

    Exemple : Si le chemin complet de la maildir est /home/vmail/user, mais que l'utilisateur FTP +lorsqu'il se connecte arrive directement dans /home/vmail, et faut définir le paramètre +remoteRootPathRegex de la manière suivante :

    +
    /^\/home\/vmail\/([^\/]*)\/+$/
+
    +
    • +
+
    +
  • +

    archiveNameFormat

    +

    LSformat du nom du dossier de la maildir une +fois archivée. Si ce format est défini, le dossier ne sera pas supprimé mais déplacé ou rénommé. +Le format sera construit avec pour seul mot clé, le nom de l'ancien dossier. Exemple : Si le +dossier de la maildir est /home/vmail/user et le paramètre archiveNameFormat vaut +%{old}.bckp, le dossier sera renommé en /home/vmail/user.bckp.

    +
    +

    Important

    +

    Ce format est interprété après application de la routine liée au paramètre +remoteRootPathRegex. Ainsi, dans l'exemple précédent, si le paramètre remoteRootPathRegex +tronquait uniquement le nom du dossier final, c'est à dire user, le format une fois +interprété donnerai user.bckp.

    +
    +
    • +

LSattr_html_mailQuota

+

Ce type est utilisé pour la gestion des attributs dont la valeur est le quota d'une boite mail. Le +format de la valeur générée correspondant au format attendu par le serveur de mail +Courier] par défaut. Exemple : 50000000S correspond à un quota de +50Mio.

+
'html_options' => array(
+    'suffix' => '[suffix]',
+  )
+),
+...
+
+
    +
  • +

    suffix

    +

    Chaine de caractères suffixant la valeur du quota (Par défaut : S).

    +
    • +

LSattr_html_password

+

Ce type est utilisé pour la gestion des attributs dont la valeur est un mot de passe.

+
'html_options' => array(
+  'isLoginPassword' => [booleen],
+  'generationTool' => [booleen],
+  'autoGenerate' => [booleen],
+  'length' => [nombre de caractères],
+  'chars' => array ( // Caractères que peut contenir le mot de passe
+    array( // Liste caractère avec un nombre mininum d'apparition supérieur à 1
+      'nb' => [nb caractères],
+      'chars' => '[liste de caractères possibles]'
+    ),
+    '[autre liste de caractères possibles]', // Liste caractère avec un nombre
+                                             // d'apparitions égal à 1
+    ...
+  ),
+  'use_pwgen' => [booléen], // Utiliser pwgen pour la génération du mot de passe
+  'pwgen_path' => "/path/to/pwgen",
+  'pwgen_opts' => "[options à passer à pwgen]",
+  'verify' => [booléen],  // Activation de l'outil de vérification du mot de passe
+  'viewHash' => [booléen],  // Activation de l'outil de visualisation du mot de passe haché
+  'confirmChange' => [booléen],  // Activation de la confirmation en cas de changement du mot de passe
+  'confirmChangeQuestion' => "[LSformat]",  // LSformat de la question de confirmation du changement du mot de passe
+  'mail' => array( // Configuration de l'envoi du mot de passe par mail
+    'subject' => "[LSformat du sujet du mail]",
+    'msg' => "[LSformat du message du mail]",
+    'mail_attr' => 'mail', // Attribut mail de l'objet
+    'get_mail_attr_function' => '[function]', // Fonction retournant l'attribut mail de l'objet
+    'send' => 1,  // Activation par défaut de l'envoi du mot de passe
+    'ask' => 1,   // Laisser le choix à l'utilisateur
+    'canEdit' => 1,   // Activation de l'édition du LSformat du message par l'utilisateur
+    'checkDomain' => false, // Désactivation de la vérification du domaine de l'adresse email
+    'domain' => '[nom de domaine]', // Nom de domaine obligatoire lors de la validation de l'adresse email
+  )
+),
+...
+
+
    +
  • +

    isLoginPassword

    +

    Booléen définissant si le mot de passe est celui utilisé par l'utilisateur pour se logguer à +l'annuaire LDAP. Si c'est le cas, pour vérifier si le mot de passe correspond avec un autre, une +tentative de connexion de l'utilisateur à l'annuaire sera faite. (Par défaut : False)

    +
    • +
+
    +
  • +

    generationTool

    +

    Booléen définissant si l'outil de génération de mot de passe est activé.

    +
    • +
+
    +
  • +

    autoGenerate

    +

    Active la génération automatique du mot de passe lorsque l'attribut n'a encore aucune valeur de +définie. Il faut également que l'outil de génération soit activé (generationTool).

    +
    • +
+
    +
  • +

    length

    +

    Nombre de caractères que devront contenir les mots de passe générés.

    +
    • +
+
    +
  • +

    chars

    +

    Tableau contenant une liste de listes de caractères possibles pour composer le mot de passe. Dans +chacune de ces listes, au moins un caractère sera utilisé dans le nouveau mot de passe. Il est +possible de définir un nombre supérieur de caractères d'une liste devant apparaître dans les mots +de passe générés en spécifiant un tableau associatif dont la clé nb associra le nombre entier de +caractères et la clé chars la liste de caractères. Une liste de caractères est un chaîne.

    +
    • +
+
    +
  • +

    use_pwgen

    +

    Booléen définissant si la commande pwgen doit être utilisé pour générer le mot de passe.

    +
    • +
+
    +
  • +

    pwgen_path

    +

    Chemin d'accès au binaire pwgen. (Par défaut : pwgen).

    +
    • +
+
    +
  • +

    pwgen_opts

    +

    Options à passer à la commande pwgen.

    +
    • +
+
    +
  • +

    verify

    +

    Booléen définissant si l'outil de vérification du mot de passe est activé. Si celui-ci est activé, +l'utilisateur pourra entrer un mot de passe dans le champ et cliquer sur un bouton qui lancera une +procédure de vérification du mot de passe via un test de connexion à l'annuaire.

    +
    • +
+
    +
  • +

    viewHash

    +

    Booléen définissant si l'utilisateur aura accès à la fonctionnalité de visualisation du mot de +passe haché.

    +
    • +
+
    +
  • +

    confirmInput

    +

    Booléen définissant si un second champ mot de passe sera affiché dans le formulaire pour que +l'utilisateur confirme la saisie du nouveau mot de passe.

    +
    • +
+
    +
  • +

    confirmInputError

    +

    LSformat du message d'erreur affiché à +l'utilisateur si le mot de passe saisie dans le champs de confirmation ne correspond pas au +nouveau mot de passe. Paramètre facultatif.

    +
    • +
+
    +
  • +

    confirmChange

    +

    Booléen définissant si l'utilisateur devra confirmer le changement de ce mot de passe. Lorsque +cette fonctionnalité est activée, l'utilisateur verra apparaître une popup de confirmation à la +validation du formulaire s'il a saisi un nouveau mot de passe.

    +
    • +
+
    +
  • +

    confirmChangeQuestion

    +

    LSformat de la question posée à l'utilisateur +en cas de changement du mot de passe et si la fonctionnalité est activée. Il sera composé à l'aide +du label de l'attribut. Paramètre facultatif.

    +
    • +
+
    +
  • +

    clearView

    +

    Booléen définissant si l'utilisateur pourra voir le mot de passe en clair par défaut (y comris en +mode visualisation uniquement).

    +
    • +
+
    +
  • +

    clearEdit

    +

    Booléen définissant si l'utilisateur éditera le mot de passe au travers un champs HTML de type +text et donc lisible ou au travers un champs HTML de type password.

    +
    • +
+
    +
  • +

    mail

    +

    Paramètres de configuration de l'envoi par mail du mot de passe à l'utilisateur. Lorsque cet outil +est activé, lors de la modification/création du mot de passe, l'utilisateur pourra recevoir un +mail lui spécifiant son nouveau mot de passe.

    +
      +
    • +

      send

      +

      Booléen définissant si l'envoi du mot de passe est activé par défaut.

      +
      • +
    +
      +
    • +

      ask

      +

      Booléen définissant si on laisse le choix à l'utilisateur d'activer ou non l'envoi du mot de +passe par mail.

      +
      • +
    +
      +
    • +

      canEdit

      +

      Booléen définissant si on laisse la possibilité à l'utilisateur d'éditer le +LSformat du message et du sujet.

      +
      • +
    +
      +
    • +

      subject

      +

      LSformat du sujet du mail. Ce format sera +composé avec la valeur du nouveau mot de passe de l'utilisateur.

      +
      • +
    +
      +
    • +

      msg

      +

      LSformat du message du mail. Ce format sera +composé avec les informations de l'object LDAP, y compris le mot clé %{password} correspondant +à la valeur du nouveau mot de passe de l'utilisateur.

      +
      • +
    +
      +
    • +

      mail_attr

      +

      Le nom de l'attribut listant les mails possibles de l'utilisateur. Par défaut, la première +valeur de l'attribut sera utilisée comme adresse mail destinatrice. Cet attribut peut également +être un tableau de plusieurs noms d'attributs. Dans ce cas, la première valeur correcte sera +retenue. Si canEdit est activé, l'utilisateur pourra choisir l'adresse mail destinatrice parmi +la liste des valeurs de l'attribut.

      +
      • +
    +
      +
    • +

      get_mail_attr_function

      +

      Nom de la fonction (ou callable au sens PHP) qui sera utilisé pour récupérer le nom de +l'attribut listant les mails possibles de l'utilisateur. Cette fonction prendra en paramètre, +l'objet LSformElement courant et devra retourner une valeur équivalente au paramètre de +configuration mail_attr. Si ce paramètre est défini, il prévalera toujours sur le paramètre +mail_attr.

      +
      • +
    +
      +
    • +

      bcc

      +

      Mettre en BCC un mail systématiquement (ou plusieurs en les séparant par des virgules).

      +
      • +
    +
      +
    • +

      headers

      +

      Un tableau de type clé/valeur ou la clé est le nom d'un header à ajouter au mail et la valeur +est la valeur de l'header en question.

      +
      • +
    +
      +
    • +

      checkDomain

      +

      Booléen définissant si le domaine de l'adresse mail doit être validée. *Paramètre facultatif, +par défaut: True

      +
      • +
    +
      +
    • +

      domain

      +

      Nom de domaine obligatoire lors de la validation de l'adresse mail. Ce paramètre peut être une +simple chaine correspondant au domaine ou un tableau listant plusieurs domaines valides. +Paramètre facultatif, par défaut tous les domaines sont acceptés.

      +
      • +
    +
    • +

LSattr_html_postaladdress

+

Ce type est utilisé pour la gestion des attributs du type de l'attribut standard postalAddress. +Ce type d'attribut permet d'afficher, en plus de l'adresse, un lien composé à partir d'informations +de l'objet permettant par exemple d'afficher un lien vers une carte géocalisant l'adresse postale.

+

Par défaut, le lien ajouté sera un lien de recherche de l'adresse postale générée à partir de la +valeur de l'attribut (en remplaçant les retours à la ligne (\n) par des espaces) via le service +Nominatim d'OpenStreetMap.

+
+

Note

+

Dans le cadre du fonctionnement par défaut et pour maîtriser les valeurs stockées dans +l'annuaire, il faut coupler ce type d'attribut HTML avec le type d'attribut LDAP +postaladdress

+
+
'html_options' => array(
+  'map_url_pattern_format' => '[LSformat]',
+  'map_url_pattern_generate_function' => '[callable]',
+  'map_url_format' => '[LSformat]',
+),
+...
+
+
    +
  • +

    map_url_pattern_format

    +

    Ce LSformat doit permettre de générer la valeur +de l'adresse postale qui sera insérée dans l'URL du lien ajouté dans l'interface.

    +
    • +
+
    +
  • +

    map_url_pattern_generate_function

    +

    Ce paramètre permet de définir une fonction qui sera utilisée à la place du paramètre +map_url_pattern_format pour générer la valeur de l'adresse postale qui sera insérée dans l'URL +du lien ajouté dans l'interface. Cette fonction prendra en paramètre l'objet LSformElement +courant et devra retourner une chaîne de caractères correspondant à l'adresse postale à insérer +dans le lien de l'interface. Par défaut, la fonction +LSformElement_postaladdress__generate_pattern est utilisée.

    +
    • +
+
    +
  • +

    map_url_format

    +

    Ce LSformat doit permettre de générer l'URL du +lien ajouté dans l'interface. Il sera composé avec les informations de l'objet LDAP, y compris le +mot clé %{pattern} correspondant à la valeur de l'adresse postale générée à l'aide des +paramètres précédents. Par défaut, la format suivant sera utilisé : +http://nominatim.openstreetmap.org/search.php?q=%{pattern}

    +
    • +

LSattr_html_pre

+

Ce type est dérivé du type LSattr_html_textarea et +permet simplement que lors de l'affichage de la valeur, celle-ci soit affichée en respectant les +retours à la ligne et en utilisant une police de caractères monospace. Cela reproduit l'affichage +d'une balise HTML pre.

LSattr_html_rss

+

Ce type est utilisé pour la gestion des attributs dont la valeur est l'URL d'un flux RSS. Il propose +directement dans l'interface, la possibilité d'accèder au flux RSS.

+
+

Important

+

Ce type d'attribut HTML est dérivé du type text. Il +profite donc de toutes les fonctionnalités d'un champ de ce type (autogénération, ...).

+

LSattr_html_sambaAcctFlags

+

Ce type est prévu pour gérer l'attribut sambaAcctFlags du schéma Samba, qui au travers d'une seule +et unique valeur, respectant un format prévu, liste l'ensemble des drapeaux actifs d'un compte +Samba. Il est conçu pour être utilisé conjointement avec le type d'attribut LDAP +LSattr_ldap_sambaAcctFlags.

+

Pour définir la valeur par défaut de cet attribut, il faut définir paramètre default_value comme +un tableau des drapeaux telque prévu par Samba :

+

- U

+
Compte utilisateur standard
+
+

- W

+
Compte de poste de travail approuvé
+
+

- S

+
Compte de serveur approuvé
+
+

- I

+
Compte de domaine approuvé
+
+

- M

+
Compte de connexion Majority Node Set (MNS)
+
+

- H

+
Dossier personnel requis
+
+

- N

+
Compte sans mot de passe
+
+

- X

+
Le mot de passe n'expire jamais
+
+

- D

+
Compte désactivé
+
+

- T

+
Copie temporaire d'un autre compte
+
+

- L

+
Compte automatiquement bloqué
+
+
  Exemple de valeur par défaut...
+'default_value' => array('U', 'X'),
+...
+
+
+

Note

+

Ce type d'attribut est implémenté en dérivant le type LSattr_html_select_box dont les valeurs +possibles sont pré-configurées (paramètre possible_values). Même si cela n'est pas forcément +utiles, les autres paramètres du type parent restent utilisables.

+

LSattr_html_select_box

+

Ce type est identique au type LSattr_html_select_list excepté qu'il utilise en lieu et place d'une +balise HTML select, plusieurs balises HTML input de type checkbox en cas de valeurs multiples +ou de type radio en cas de valeur unique. Les paramètres de configuration de la classe +LSattr_html_select_list sont tous hérités et fonctionnent donc de la même manière. Par ailleurs, +ce type dispose également de paramètres qui lui sont propre (voir ci-dessous).

+
'html_options' => array (
+   'inline' => [Booléen],
+),
+...
+
+
    +
  • +

    inline

    +

    Booléen définissant si les valeurs possibles doivent être affichées sur une même ligne ou non +(Faux par défaut).

    +
    • +

LSattr_html_select_list

+

Ce type est utilisé pour la gestion des attributs dont les valeurs font partie d'une liste statique +ou dynamique. Il est possible de lister des valeurs statiques et également des références à d'autres +LSobjects. La référence à un objet correspond à une +valeur clé, référente à un objet précis, qui peut être soit la valeur d'un de ses attributs, soit +son DN.

+
'html_options' => array (
+   'possible_values' => array (
+     '[LSformat de la valeur clé]' => '[LSformat du nom d'affichage]',
+     ...
+     'OTHER_OBJECT' => array (
+       'object_type' => '[Type d'LSobject]',
+       'display_name_format' => '[LSformat du nom d'affichage des LSobjects]',
+       'value_attribute' => '[Nom de l'attribut clé]',
+       'values_attribute' => '[Nom de l'attribut clé multi-valeur]',
+       'filter' => '[Filtre de recherche des LSobject]',
+       'scope' => '[Scope de la recherche]',
+       'basedn' => '[Basedn de la recherche]',
+       'onlyAccessible' => '[Booléen]'
+     ),
+     'OTHER_ATTRIBUTE' => '[attr]',
+     // Or :
+     'OTHER_ATTRIBUTE' => array(
+       '[attr1]' => '[label1]',
+       '[attr2]' => '[label2]',
+       [...]
+     ),
+     // Or :
+     'OTHER_ATTRIBUTE' => array(
+       'attr' => [attr],
+       'json_component_key' => '[Composant JSON clé]',
+       'json_component_label' => '[Composant JSON label]',
+     ),
+     array (
+       'label' => '[LSformat du nom du groupe de valeurs]',
+       'possible_values' => array (
+         '[LSformat de la valeur clé]' => '[LSformat du nom d'affichage]',
+         ...
+         'OTHER_OBJECT' => array (
+           ...
+         )
+       )
+     )
+   ),
+   'get_possible_values' => [callable],
+   'translate_labels' => [booléen],
+   'sort' => [Booléen],
+   'sortDirection' => '[ASC|DESC]'
+),
+...
+
+
    +
  • +

    possible_values

    +

    Tableau associatif obligatoire contenant en valeur clé le +LSformat des valeurs clés prisent par +l'attribut et en valeurs associées, le LSformat +des noms d'affichage de ces valeurs. Ces LSformats +sont composés à partir des valeurs de l'objet courant (attributs, dn, ...).

    +

    Si la valeur clé est égale à OTHER_OBJECT, une liste +d'LSobject sera insérée dans la liste des valeurs +possibles. La valeur associée est alors un tableau associatif dont les valeurs clés sont les noms +des paramètres de configuration de la recherche de ces +LSobjects et les valeurs associées, les valeurs des +paramètres.

    +

    Il est possible de regrouper des valeurs de l'attribut en plaçant leur déclaration dans un +sous-tableau. Ce sous-tableau devra contenir la clé label dont la valeur associé sera le +LSformat du nom du groupe de valeurs. Ce +LSformat est composé à partir des valeurs de +l'objet courant (attributs, dn, ...). Une seconde clé possible_values regroupera les valeurs +possibles du groupe. Comme pour le tableau principal, la clé OTHER_OBJECT permet d'imcorporer +une liste d'LSobject.

    +
      +
    • +

      object_type

      +

      Nom du type d'LSobject en référence.

      +
      • +
    +
      +
    • +

      display_name_format

      +

      LSformat du nom d'affichage des objets lors +de leur sélection.

      +
      • +
    +
      +
    • +

      value_attribute

      +

      Nom de l'attribut des LSobjects en référence servant +de valeur clé et permettant de les identifier (Exemple : dn ou uid).

      +
      • +
    +
      +
    • +

      values_attribute

      +

      Nom de l'attribut des LSobjects en référence servant +de catalogue de valeurs. Dans ce mode, la valeur n'a pas de label et est affichée directement +dans l'interface. Ce paramètre peut-être utilisé en complément ou non du paramètre +value_attribute.

      +
      • +
    +
      +
    • +

      filter

      +

      Filtre falcultatif de la recherche des LSobjets. Il sera dans tous les cas agrémenté des valeurs +des objectclass du type d'LSobject.

      +
      • +
    +
      +
    • +

      scope

      +

      Scope falcultatif de la recherche des LSobjets.

      +
      • +
    +
      +
    • +

      basedn

      +

      Basedn falcultatif de la recherche des LSobjets.

      +
      • +
    +
      +
    • +

      onlyAccessible

      +

      Booléen falcultatif définissant si seul les LSobjets auxquels l'utilisateur connecté à accès +doivent être considérés comme sélectionnables (Faux par défaut).

      +
      • +
    +

    Si la valeur clé est égale à OTHER_ATTRIBTE, une liste de valeur possible sera composée à l'aide +des valeurs d'un (ou plusieurs) autre attribut de l'objet courant. La valeur associée peut être +alors :

    +
      +
    • soit le nom d'un attribut dont les valeurs seront utilisées comme valeurs possibles (la valeur + affichée est égale à la valeur stockée).
      • +
    +
      +
    • soit un tableau associatif dont les valeurs clés sont les noms des attributs dont les valeurs + seront utilisés comme valeurs possibles et dont les valeurs associés seront les labels sous + lesquels ces valeurs seront regroupées (la valeur affichée est égale à la valeur stockée).
      • +
    +
      +
    • soit un tableau associatif référençant un attribut sous la clé attr dont les valeurs seront + utilisées comme valeurs possibles. Cet attribut peut-être du type + LSattr_html_jsonCompositeAttribute. + Il sera alors possible d'utiliser les valeurs d'un composant en particulier en le référençant à + l'aide de la clé json_component_key. Il est également possible de référencer un autre + composant à l'aide de la clé json_component_label et dont les valeurs seront utilisées comme + valeurs affichées lors de la sélection. À défaut, les valeurs affichées seront identiques à + celles stockées.
      • +
    +
    • +
+
    +
  • +

    get_possible_values

    +

    Paramètre permettant de spécifier un callable qui sera utilisé pour lister les valeurs possibles +de l'attribut. Il recevra en paramètres les informations suivantes:

    +
      +
    • +

      $options

      +

      Les options HTML de l'attribut.

      +
      • +
    +
      +
    • +

      $name

      +

      Le nom de l'attribut.

      +
      • +
    +
      +
    • +

      &$ldapObject

      +

      Une référence à l'objet LSldapObject.

      +
      • +
    +

    La valeur de retour attendue est un tableau associatif des valeurs possibles de l'attribut avec la +valeur que prendra l'attribut en tant que clé et le label correspondant en tant que valeur. Tout +autre retour sera considéré comme un échec et déclenchera une erreur.

    +

    Il est également possible de regrouper des valeurs possibles de l'attribut: pour cela, le tableau +retourné devra lui-même contenir un tableau associatif contenant la label traduit du groupe sous +la clé label et les valeurs possibles du groupe sous la clé possible_values.

    +

    Les valeurs retournées pourront être combinées avec les autres valeurs possibles configurées de +l'attribut. La prise en charge du tri des valeurs possibles est assurée par la fonction appelante +sauf dans le cas des sous-groupes de valeurs possibles. Dans ce cas, la méthode +LSattr_html_select_list :: _sort() pourra être utilisée pour trier les valeurs du sous-groupe : +cette méthode accepte en paramètre une référence du tableau des valeurs possibles ainsi que les +options HTML de l'attribut.

    +

    Si la traduction des labels des valeurs possibles de l'attribut est activées (voir ci-dessous), +celle-ci doit être prise en charge par la fonction configurée.

    +
    • +
+
    +
  • +

    translate_labels

    +

    Booléen permettant d'activer/désactiver la traduction des labels (Par défaut : True).

    +
    • +
+
    +
  • +

    sort

    +

    Booléen définissant si les valeurs possibles doivent être triées ou non (Vrai par défaut). Le trie +est effectué sur les libellés des valeurs possibles.

    +
    • +
+
    +
  • +

    sortDirection

    +

    Mot clé déterminant le sens du trie des valeurs possibles.

    +

    Valeurs possibles : ASC ou DESC (ASC par défaut).

    +
    • +

LSattr_html_select_object

+

Ce type est utilisé pour la gestion des attributs dont les valeurs sont des références à d'autres +LSobjects. Chaque référence à un objet correspond à une +valeur prise par l'attribut. Les valeurs clés référant à un +LSobject sont soit la valeur d'un de leurs attributs, +soit leur DN.

+
'html_options' => array (
+   selectable_object => array (
+     array (
+       'object_type' => '[Type d'LSobject selectionnable]',
+       'display_name_format' => '[LSformat du nom d'affichage des LSobjects]',
+       'value_attribute' => '[Nom de l'attribut clé des LSobjects]',
+       'filter' => '[Filtre de recherche]',
+       'onlyAccessible' => '[Booléen]'
+     ),
+     [...]
+   ),
+   'ordered' => [Booléen],
+   'sort' => [Booléen],
+   'sortDirection' => '[ASC|DESC]'
+),
+...
+
+
    +
  • +

    selectable_object

    +

    Tableau dont chaque valeur correspond à un tableau associatif spécifiant un type +d'LSobject sélectionnable. Pour chaque type d'objet +sélectionnable, les paramètres suivants doivent être renseignés :

    +
      +
    • +

      object_type

      +

      Nom du type d'LSobject en référence +(Paramètre obligatoire).

      +
      • +
    +
      +
    • +

      display_name_format

      +

      LSformat du nom d'affichage des objets lors +de leur sélection (Paramètre facultatif).

      +
      • +
    +
      +
    • +

      value_attribute

      +

      Nom de l'attribut des LSobjects en référence servant +de valeur clé et permettant de les identifier (Paramètre obligatoire, exemples : dn ou uid).

      +
      • +
    +
      +
    • +

      filter

      +

      Filtre de recherche qui sera ajouter au filtre par défaut lors de la sélection des objets +(Paramètre facultatif).

      +
      • +
    +
      +
    • +

      onlyAccessible

      +

      Booléen définissant si seul les LSobjets auxquels l'utilisateur connecté à accès doivent être +considérés comme sélectionnables (Paramètre facultatif, par défaut: False).

      +
      • +
    +
    • +
+
    +
  • +

    ordered

    +

    Booléen définissant si la liste des objets choisis doit être ordonnable ou non (Paramètre +facultatif, par défaut: False). Cela aura pour effet d'activer une fonctionnalité dynamique de +l'interface permettant de remonter ou descendre dans la liste les objets choisis.

    +
    +

    Note

    +

    Cette fonctionnalité désactive automatiquement le trie des objets à l'affichage.

    +
    +
    • +
+
    +
  • +

    sort

    +

    Booléen définissant si la liste des objets choisis doit être triée ou non (Paramètre facultatif, +par défaut: True). Le trie est effectué sur les libellés des objets choisis.

    +
    • +
+
    +
  • +

    sortDirection

    +

    Mot clé déterminant le sens du trie des objets choisis.

    +

    Valeurs possibles : ASC ou DESC (ASC par défaut).

    +
    • +

LSattr_html_ssh_key

+

Ce type est utilisé pour la gestion des attributs dont la valeur est une clef publique SSH. Il +permet dans l'interface, d'avoir un affichage adapté à ce type de donnée.

LSattr_html_tel

+

Ce type est utilisé pour la gestion des attributs dont la valeur est un numéro de téléphone. Lors de +l'affichage, un lien hypertexte avec une URI de type tel:~~ est affiché.

+
+

Important

+

Ce type d'attribut HTML est dérivé du type text. Il +profite donc de toutes les fonctionnalités d'un champ de ce type (autogénération, ...).

+

LSattr_html_text

+

Ce type est utilisé pour la gestion des attributs dont la valeur est une chaîne de caractères devant +être affichée dans un champ input HTML de type text.

+
'html_options' => array(
+  'generate_value_format' => '[LSformat pour la génération de la valeur]',
+  'autoGenerateOnCreate' => [booléen],
+  'autoGenerateOnModify' => [booléen],
+  'withoutAccent' => [booleen],
+  'replaceSpaces' => "[chaîne de remplacement]",
+  'upperCase' => [booleen],
+  'lowerCase' => [booleen],
+
+  // Autocomplétion
+  'autocomplete' => array (
+    'object_type' => '[Type d'LSobject]', // facultatif (voir ci-dessous)
+    'value_attributes' => array (
+      '[attr1]',
+      '[attr2]',
+      [...]
+    ),
+    'filter' => '[filtre LDAP]',
+    'basedn' => '[base DN spécifique]',
+    'scope' => '[scope de recherche]',
+    'displayFormat' => '[LSformat]',
+    'onlyAccessible' => [booléen],
+  ),
+
+),
+...
+
+
    +
  • +

    generate_value_format

    +

    LSformat de la valeur utilisée pour la +génération automatique de celle-ci à partir des informations saisies dans le formulaire. Les +valeurs clefs du format sont les noms des attributs de l'objet. Seuls les attributs affichés au +moins en lecture seule dans le formulaire peuvent être utilisés dans le format. Une seule valeur +par attribut sera utilisée pour la génération : celle du premier champ (dans l'ordre d'apparition +dans le formulaire).

    +
    +

    Important

    +

    Seuls les éléments du formulaire de type HTML input, select ou textarea peuvent être +utilisés.

    +
    +
    • +
+
    +
  • +

    autoGenerateOnCreate

    +

    Activation de la génération automatique lorsque celui-ci est vide au moment du chargement du +formulaire (par défaut : False).

    +
    • +
+
    +
  • +

    autoGenerateOnModify

    +

    Activation de la génération automatique lors de chaque modification de la valeur des champs du +formulaire lié (par défaut : False).

    +
    • +
+
    +
  • +

    withoutAccent

    +

    Activation de la suppression des accents dans la chaîne de caractères générée automatiquement +(par défaut : False).

    +
    • +
+
    +
  • +

    withoutAccent

    +

    Activation du remplacement des accents dans la chaîne de caractères générée automatiquement. La +valeur de remplacement est celle du paramètre (par défaut : False).

    +
    • +
+
    +
  • +

    upperCase

    +

    Activation de la mise en majuscule de la valeur générée automatiquement (par défaut : False).

    +
    • +
+
    +
  • +

    lowerCase

    +

    Activation de la mise en minuscule de la valeur générée automatiquement (par défaut : False).

    +
    • +
+
    +
  • +

    autocomplete

    +

    Paramètrage de l'autocomplétion des valeurs saisies : on paramètre ici la recherche des valeurs +possibles de l'attribut dans l'annuaire qui peut se faire :

    +
      +
    • Sur la base d'un type d'LSobject donné : + l'autocomplétion se fera alors comme n'importe quelle recherche d'un type d'objet donné.
      • +
    +
      +
    • Sur la base d'une recherche brute dans l'annuaire : l'autocomplétion se fera alors au travers + une recherche brute dans l'annuaire sur n'importe quels objets ayant un des attributs spécifiés + dans le paramètre value_attributes correspondant.
      • +
    +

    Les paramètres associés à ces deux cas de figure sont décrits ci-dessous :

    +
      +
    • +

      object_type

      +

      Le type d'LSobject recherché.

      +
      • +
    +
      +
    • +

      value_attributes

      +

      Le(s) nom de l'attribut stockant les valeurs possibles recherchées. Il peut s'agir d'une chaîne +de caractères ou d'un tableau s'il y a plusieurs attributs.

      +
      • +
    +
      +
    • +

      pattern_filter

      +

      Le LSformat du filtre de recherche à partir +du mot clé recherché. Ce paramètre est facultatif et utile que dans le cas d'une recherche sans +type d'LSobject précis. S'il est défini, ce +LSformat sera composé à l'aide du mot clé +recherché. À défaut, le filtre de recherche sera composé à l'aide des différents +value_attributes configurés.

      +
      • +
    +
      +
    • +

      filter

      +

      Un filtre de recherche facultatif venant en plus de celui calculé automatiquement à partir du +mot clé de recherche.

      +
      • +
    +
      +
    • +

      basedn

      +

      Le basedn de la recherche. Paramètre facultatif.

      +
      • +
    +
      +
    • +

      scope

      +

      Le scope de la recherche. Paramètre facultatif, par défaut : sub.

      +
      • +
    +
      +
    • +

      display_name_format

      +

      Le LSformat d'affichage des objets trouvés. +Ce paramètre est facultatif et par défaut, il s'agira du format d'affichage propre au type +d'LSobject (si défini) et à défaut, la valeur +possible trouvée sera affichée. Si est configuré, ce +LSformat sera composé à l'aide des valeurs +brutes des attributs des objets correspondants avec en plus la valeur possible trouvée dans le +mot clé value.

      +
      • +
    +
      +
    • +

      only_accessible

      +

      Booléen falcultatif définissant si seul les +LSobjects auxquels l'utilisateur connecté à accès +doivent être considérés comme sélectionnables (Faux par défaut). Ce paramètre n'est appliqué que +dans le cas d'une recherche pour un type d'LSobject +donné.

      +
      • +
    +
    • +

LSattr_html_textarea

+

Ce type est utilisé pour la gestion des attributs dont la valeur est une chaine de caractères trop +longue pour être saisie dans un champs HTML imput de type text et est plus adapté à un champ +HTML textarea.

LSattr_html_url

+

Ce type est utilisé pour la gestion des attributs dont la valeur est une URL. Il propose directement +dans l'interface, la possibilité d'accèder au site ou encore de l'ajouter dans ses favoris +(lorsque le navigateur le supporte).

+
+

Important

+

Ce type d'attribut HTML est dérivé du type text. Il +profite donc de toutes les fonctionnalités d'un champ de ce type (autogénération, ...).

+

LSattr_html_valueWithUnit

+

Ce type est utilisé pour la gestion des attributs dont la valeur est un entier auxquel un facteur +peut s'appliquer (par exemple : Kilo, Méga, ...).

+
'html_options' => array(
+    'units' => array (
+      '[facteur1]' => '[label unit1]',
+      '[facteur2]' => '[label unit2]',
+      [...]
+    ),
+    'translate_labels' => [booléen],
+    'nb_decimals' => [number of decimals],
+    'dec_point' => '[decimals point]',
+    'thousands_sep' => '[thousands separator]',
+    'store_integer' => [booléen],
+    'round_down' => [booléen],
+  )
+),
+...
+
+
    +
  • +

    units

    +

    Tableau associatif dont la clé est un entier correspondant au facteur et la valeur est le label de +l'unité. (Par exemple : 1 => Octet, 1024 => Kilo-octet, ...).

    +
    • +
+
    +
  • +

    translate_labels

    +

    Booléen permettant d'activer/désactiver la traduction des labels (Par défaut : True).

    +
    • +
+
    +
  • +

    nb_decimals

    +

    Le nombre de décimals à afficher en cas de nombre non-entier (Par défaut : 2).

    +
    • +
+
    +
  • +

    dec_point

    +

    Le caractère à utiliser comme séparateur de décimal (Par défaut, une virgule).

    +
    • +
+
    +
  • +

    thousands_sep

    +

    Le caractère à utiliser comme séparateur de milliers (Par défaut, un espace).

    +
    • +
+
    +
  • +

    store_integer

    +

    Booléen permettant d'activer/désactiver le stockage de valeurs entières (Par défaut : True).

    +
    • +
+
    +
  • +

    round_down

    +

    Booléen permettant d'arrondir à l'entier inférieur (et non à l'entier supérieur par défaut) en cas +de stockage de valeurs entières.

    +
    • +

LSattr_html_wysiwyg

+

Ce type est utilisé pour la gestion des attributs dont la valeur est du code HTML et dont l'édition +doit être fait à l'aide d'un éditeur WYSIWYG. La librairie TinyMCE +est utilisée pour cela.

+
'html_options' => array(
+  'extra_options' => array (
+    [Options à passer à TinyMCE]
+  ),
+),
+...
+
+
    +
  • +

    extra_options

    +

    Ce paramètre permet de passer des options à TinyMCE pour personnaliser +son comportement. Par exemple, il est possible d'utiliser le paramètre valid_styles pour définir +quels styles CSS sont autorisés. Pour plus d'informations, consultez la documentation de +TinyMCE .

    +
    • +

LSattr_html_xmpp

+

Ce type est utilisé pour la gestion des attributs dont la valeur est une adresse XMPP. Il propose +directement dans l'interface, la possibilité de lancer une fenêtre de dialogue avec l'interlocuteur +de son client XMPP préféré.

+
+

Note

+

Cette fonctionnalité n'est supporté uniquement par les navigateurs web supportant les URI de +type xmpp://.

+
+
+

Important

+

Ce type d'attribut HTML est dérivé du type text. Il +profite donc de toutes les fonctionnalités d'un champ de ce type (autogénération, ...).

+

Ended: Types d'attribut HTML (LSattr_html)

Règles de vérification syntaxique (LSformRule)

Configuration des règles de vérification syntaxique

+

Cette section décrit la manière de configuer des règles de vérification syntaxique sur les données +des attributs. Ces règles seront utilisées pour vérifier que les valeurs saisies par un utilisateur +dans un formulaire sont correctes.

+
'check_data' => array (
+  '[regle1]' => array(
+    'msg' => "[Message d'erreur]",
+    'params' => array(
+      // Paramètres de la règle
+    )
+  ),
+  ...
+),
+...
+
+

Le paramètre check_data est un tableau associatif dont les clés sont les noms des règles de +vérification syntaxique actives et les valeurs associées sont des tableaux associatifs contenant les +paramètres des règles.

+
    +
  • +

    msg

    +

    Le message d'erreur à afficher lors que la règle n'est pas respectée (optionnel).

    +
    • +
+
    +
  • +

    params

    +

    Tableau associatif contenant les paramètres de la règle. Les paramètres possibles sont propres à +chaque type de règle. Les clès sont les noms des paramètres et les valeurs associés, les valeurs +des paramètres.

    +
    • +

alphanumeric

+

Cette règle vérifie que la valeur est une chaîne de caractères composée uniquement de lettres +non-accuentées, en minuscule ou en majuscule et/ou de chiffres.

+
    +
  • +

    withAccents

    +

    Si le paramètre est à true, les lettres accentuées seront acceptées.

    +
    • +

callable

+

Cette règle vérifie que la valeur saisie est correcte en utilisant une fonction personnalisée. Cette +fonction devra prendre en paramètres la valeur à valider, le tableau des paramètres de la règle +ainsi qu'un pointeur sur l'objet LSformElement. Sur la base de ses informations, elle devra +valider la valeur et retourner True si la valeur est valide et False sinon.

+
    +
  • +

    callable

    +

    Le nom de la fonction (ou tout autre callable au sens PHP) de validation.

    +
    • +

date

+

Cette règle vérifie que la valeur saisie est bien une date et qu'elle respecte un format précis.

+ +
    +
  • +

    special_values

    +

    Tableau listant les valeurs spéciales que peut prendre l'attribut. Dans ce tableau, seules les +valeurs sont utilisées et les clés n'ont pas d'importance. Ces valeurs spéciales n'auront pas +forcément besoin de respecter le format attendu.

    +
    • +

differentPassword

+

Cette règle vérifie que la valeur saisie ne correspond pas à un des mots de passe stockés dans +d'autres attributs du même objet.

+
+

Important

+

Les autres attributs doivent utiliser le type d'attribut LDAP +LSattr_ldap_password.

+
+
    +
  • +

    otherPasswordAttributes

    +

    La liste des autres attributs dont les mots de passe doivent être différent.

    +
    • +

email

+

Cette règle vérifie que la valeur saisie est bien une adresse e-mail. Il est possible de vérifier si +elle appartient bien à un domaine en particulier ou encore de vérifier si le domaine existe et qu'il +possède un serveur de mail(MX).

+
    +
  • +

    domain

    +

    Nom de domaine obligatoire. Ce paramètre peut être une simple chaine correspondant au domaine ou +un tableau listant plusieurs domaines possibles.

    +
    • +
+
    +
  • +

    checkDomain

    +

    Booléen définissant si le domaine de l'adresse mail doit être validée.

    +
    • +

filesize

+

Cette règle vérifie que la valeur est un fichier dont la taille en octets respecte les limites +passées en paramètre.

+
    +
  • +

    minSize

    +

    Taille minimum.

    +
    • +
+
    +
  • +

    maxSize

    +

    Taille maximum.

    +
    • +

gpg_pub_key

+

Cette règle vérifie que la valeur est une clé publique GPG. Pour cela, la clé est importée dans un +keyring GnuPG.

imagefile

+

Cette règle vérifie que la valeur est bien un fichier et que le type mime de celui-ci est bien une +image. Cette règle utilise la règle mimetype en spécifiant si l'utilisateur ne le fait pas que le +type mime doit respecter la regex suivante : /image\/.*/

+
+

Important

+

Cette règle est une simple interface à la règle mimetype, il est donc possible de passer +d'autres paramètres propres à ce type.

+

imagesize

+

Cette règle vérifie que la valeur est une image dont la taille en pixels respecte les limites +passées en paramètre.

+
    +
  • +

    minWidth

    +

    Largeur minimum.

    +
    • +
+
    +
  • +

    maxWitdh

    +

    Largeur maximum.

    +
    • +
+
    +
  • +

    minHeight

    +

    Hauteur minimum.

    +
    • +
+
    +
  • +

    maxHeight

    +

    Hauteur maximum.

    +
    • +

inarray

+

Cette règle vérifie que la valeur saisie fait partie d'une liste de valeurs autorisées +(ou interdites).

+
    +
  • +

    possible_values

    +

    Tableau listant les valeurs autorisées.

    +
    • +
+
    +
  • +

    reverse

    +

    Booléen permettant d'inverser la logique de validation : si reverse est vrai, la valeur testée +sera acceptée si elle ne fait pas partie des valeurs possibles (Paramètre facultatif, par défaut : +False).

    +
    • +

integer

+

Cette règle vérifie que la valeur saisie est un entier. Les paramètres permettent de spécifier +éventuellement si la valeur doit être positive ou négative et également de borner les valeurs +valides.

+
    +
  • +

    positive

    +

    Booléen définissant si la valeur doit être positive.

    +
    • +
+
    +
  • +

    negative

    +

    Booléen définissant si la valeur doit être negative.

    +
    • +
+
    +
  • +

    min

    +

    Valeur minimale (supérieur ou égale).

    +
    • +
+
    +
  • +

    max

    +

    Valeur maximale (inférieur ou égale).

    +
    • +

ldapSearchURI

+

Cette règle vérifie que la valeur est une URI de recherche LDAP valide, c'est à dire, par exemple, +ldaps://ldap.example.com:636/o=example?attr1,attr2?one?(gidNumber=100)

+

Cette vérification commence par découper la valeur à l'aide du sépérateur ? et elle s'assure +ensuite :

+
    +
  • Que la première partie est bien une URI LDAP valide. Si l'hôte LDAP est spécifié, elle s'assure + qu'il soit une adresse IP ou un nom de domaine valide. Si le port LDAP est spécifié, elle s'assure + également qu'il soit correct et que l'hôte est également bien spécifié.
    • +
+
    +
  • Si la base de recherche est spécifiée, elle s'assure qu'elle soit compatible avec la racine de + l'annuaire connecté.
    • +
+
    +
  • Si un ou plusieurs attributs sont spécifiés, elle les vérifie un à un afin de vérifier qu'il + s'agit de nom d'attribut valide.
    • +
+
    +
  • Que le scope de recherche soit bien spécifié et valide.
    • +
+
    +
  • Si le filtre de recherche est spécifié, elle vérifie qu'il soit valide.
    • +
+

Paramêtres de configuration :

+
    +
  • +

    check_resolving_ldap_host

    +

    Si l'hôte du serveur LDAP est spécifié et qu'il s'agit d'un nom de domaine valide, un tentative de +résolution DNS sera également faite (optionnel, par défaut : True).

    +
    • +
+
    +
  • +

    host_required

    +

    Booléen détermintant si une erreur est relevée en cas d'absence de l'hôte LDAP. (optionnel, +par défaut : False)

    +
    • +
+
    +
  • +

    basedn_required

    +

    Booléen détermintant si une erreur est relevée en cas d'absence de base de recherche. (optionnel, +par défaut : False)

    +
    • +
+
    +
  • +

    scope_required

    +

    Booléen détermintant si une erreur est relevée en cas d'absence de portée de recherche. +(optionnel, par défaut : True)

    +
    • +
+
    +
  • +

    attr_required

    +

    Booléen détermintant si une erreur est relevée en cas d'absence d'attribut recherché. (optionnel, +par défaut : False)

    +
    • +
+
    +
  • +

    max_attrs_count

    +

    Nombre maximum d'attribut recherchés. (optionnel, par défaut : pas de limite)

    +
    • +
+
    +
  • +

    filter_required

    +

    Booléen détermintant si une erreur est relevée en cas d'absence de filtre de recherche. +(optionnel, par défaut : False)

    +
    • +

lettersonly

+

Cette règle vérifie que la valeur est une chaîne de caractères composée uniquement de lettres +non-accuentées, en minuscule ou en majuscule.

maxlength

+

Cette règle vérifie que la valeur saisie est une chaine de caractères dont la longueur est inférieur +ou égale à la valeur passées en paramètre.

+
    +
  • +

    limit

    +

    Limite supérieur (ou égale) de la longueur de la chaîne de caratères.

    +
    • +

mimetype

+

Cette règle vérifie que la valeur est bien un fichier et que le type mime de celui-ci est correct. +Il est possible de vérifier si le type mime fait partie d'une liste ou encore s'il valide une +expression régulière.

+
    +
  • +

    mimeType

    +

    Type mime obligatoire. Ce paramètre peut être une simple chaine correspondant au type mime ou un +tableau listant plusieurs possibilités.

    +
    • +
+
    +
  • +

    mimeTypeRegEx

    +

    Expression régulière que doit respecter le type mime.

    +
    • +

minlength

+

Cette règle vérifie que la valeur saisie est une chaine de caractères dont la longueur est supérieur +ou égale à la valeur passée en paramètre.

+
    +
  • +

    limit

    +

    Limite inférieure (ou égale) de la longueur de la chaîne de caratères.

    +
    • +

nonzero

+

Cette régle vérifie que la valeur est une valeur numérique non nulle.

nopunctuation

+

Cette régle vérifie que la valeur est une chaîne de caractères ne contenant pas de signe de +ponctuation. Les caractères suivants sont actuellement exclus : +( ) . \ / \ * \ ^ \ ? # ! @ $ % + = , " ' > < ~ [ ] { }

numberOfValues

+

Cette règle vérifie que le nombre de valeurs de l'attribut est comprise entre les limites passées en +paramètre.

+
    +
  • +

    min

    +

    Nombre minimum de valeurs (paramètre optionnel).

    +
    • +
+
    +
  • +

    max

    +

    Nombre maximum de valeurs (paramètre optionnel).

    +
    • +

numeric

+

Cette régle vérifie que la valeur est une valeur numérique.

password

+

Cette règle vérifie que la valeur est un mot de passe respectant la politique de sécurité définie +par les paramètres de la règle.

+
    +
  • +

    minlength

    +

    Longueur minimale du mot de passe.

    +
    • +
+
    +
  • +

    maxlength

    +

    Longueur maximale du mot de passe.

    +
    • +
+
    +
  • +

    prohibitedValues

    +

    Tableau de valeurs interdites.

    +
    • +
+
    +
  • +

    regex

    +

    Expression(s) régulière(s) que doit respecter le mot de passe. Ce paramètre peut être une +expression régulière au format PCRE ou un tableau d'expressions +régulières.

    +
    • +
+
    +
  • +

    minValidRegex

    +

    Le nombre minimum d'expression régulière qui doivent être validées pour que le mot de passe soit +considéré comme correct. Ce paramètre est optionnel, par défaut, toutes les expressions régulières +doivent être validées.

    +
    • +

rangelength

+

Cette règle vérifie que la valeur saisie est une chaine de caractères dont la longueur est comprise +entre deux valeurs passées en paramètre.

+
    +
  • +

    limits

    +

    Tableau contenant deux valeurs, la première étant la limite inférieure ou égale et la seconde la +limite supérieure ou égale.

    +
    • +

regex

+

Cette règle vérifie que la valeur saisie respecte bien l'expression régulière passée en paramètre.

+
    +
  • +

    regex

    +

    L'expression régulière devant être respectée. Cette expression régulière doit être au format +PCRE.

    +
    • +

required

+

Cette régle vérifie que la valeur n'est pas une chaîne de caractères de longueur nulle.

ssh_pub_key

+

Cette règle vérifie que la valeur est une clé publique SSH.

+

Cette vérification utilise tout d'abord une expression régulière pour valider la forme syntaxique de +la clé publique (ssh-[type] [clé au format base64] [commentaire]) puis tente de décoder la partie +en base64 de la clé pour vérifier qu'il s'agit bien d'une chaine de caractères.

telephonenumber

+

Cette régle vérifie que la valeur est un numéro de téléphone français. Celui-ci doit respecter +l'expression regulière suivante : /^(01|02|03|04|05|06|08|09)[0-9]{8}$/

zxcvbn

+

Cette règle vérifie la sécurité d'un mot de passe en utilisant la librairie +ZxcvbnPhp. Cette librairie s'appuie sur un ensemble de +vérifications permettant de déterminer à quel point le mot de passe choisi est commun, prévisible +et plus globalement, estime en combien de temps il pourra être cassé par une personne malveillante. +Sur la base de l'analyse du mot de passe saisi, des conseils seront donnés à l'utilisateur pour le +guider dans le choix d'un mot de passe sûre.

+
+

Warning

+

La librairie ZxcvbnPhp n'est compatible qu'avec PHP 7 et supérieur.

+
+
    +
  • +

    minScore

    +

    Le score minimal pour que le mot de passe soit accepté. Il doit s'agir d'un entier cimpris entre 0 +(le plus faible) et 4 (le plus sécurisé). Paramètre facultatif valant 4 par défaut.

    +
    • +
+
    +
  • +

    userDataAttrs

    +

    Liste d'attributs de l'objet dont les valeurs seront passées à la librairie Zxcvbn qui les +considérera comme associés à l'utilisateur. Ainsi, par exemple, si l'utilisateur utilise son nom +de famille ou encore son prénom dans son mot de passe, la librairie pourra lui indiqué que cela ne +le protège que peut des attaques ciblées. Paramètre facultatif, mais il est fortement conseillé de +renseigner un maximum d'attributs contenant des informations personnelles relatives à l'utilisteur.

    +
    • +
+
    +
  • +

    showWarning

    +

    Booléen définissant si les messages d'alertes retournés par la librairie Zxcvbn doivent être +affichés à l'utilisateur. Paramètre facultatif et vrai par défaut.

    +
    • +
+
    +
  • +

    showSuggestions

    +

    Booléen définissant si les messages de suggestions retournés par la librairie Zxcvbn doivent +être affichés à l'utilisateur. Paramètre facultatif et vrai par défaut.

    +
    • +
+
    +
  • +

    zxcvbn_autoload_path

    +

    Le chemin vers le fichier de chargement automatique des classes de la librairie ZxcvbnPhp. Ce +paramètre est facultatif et vaut par défaut Zxcvbn/autoload.php, ce qui est adapté si vous +utiliser le paquet Debian php-zxcvbn disponible sur le dépôt Debian du projet LdapSaisie.

    +
    • +

Ended: Règles de vérification syntaxique (LSformRule)

Configuration des règles de vérification d'intégrité

+

Cette section décrit la manière de configurer des règles de vérification d'intégrité sur les données +des attributs. Il est possible de valider la valeur de l'attribut par l'intermédiraire de la +vérification de résultat d'une recherche paramètrable dans l'annuaire ou encore d'appeler une +fonction de votre choix pour effectuer la vérification voulue.

+

Validation par l'analyse du résultat d'une recherche dans l'annuaire

+

Une telle règle permet de vérifier si les valeurs des attributs n'entrent pas en conflit avec +d'autres objets de l'annuaire. Ce test peut également permetre de vérifier si les valeurs devant +faire référence à d'autres objets de l'annuaire sont correctes.

+
'validation' => array (
+  ...
+  array(
+    'msg' => "[LSformat du message d'erreur]",
+    'filter' => '[LSformat du filtre de la recherche]',
+    'object_type' => '[Type d'LSobject recherché]',
+    'basedn' => '[BaseDn de la recherche]',
+    'scope' => '[Scope de la recherche]',
+    'result' => '[Résultat positif de la recherche]',
+    'except_current_object' => '[Exclure l'objet courant]'
+  ),
+  ...
+),
+...
+
+
    +
  • +

    msg

    +

    LSformat du message d'erreur à afficher lorsque la +validation échoue. Ce format est construit avec les valeurs du +LSobject.

    +
    • +
+
    +
  • +

    filter

    +

    LSformat du filtre de la recherche. Ce format peut +être construit avec toutes les valeurs du LSobject (attributs, DN, ...) et également avec la +valeur à valider en utilisant pour mot clé %{val}.

    +
    • +
+
    +
  • +

    object_type

    +

    Le nom du type d'LSobject recherché. Si un type est spécifié, le filtre de la recherche sera une +combinaison de celui du paramètre filter et du filtre composé à partir des objectClass du type +d'LSobject. Paramètre facultatif.

    +
    • +
+
    +
  • +

    basedn

    +

    Le basedn de la recherche (Paramètre facultatif, par défaut : racine de l'annuaire).

    +
    • +
+
    +
  • +

    scope

    +

    Le scope de la recherche (Paramètre facultatif, par défaut : sub).

    +
    • +
+
    +
  • +

    result

    +

    Le résultat de la recherche : si result vaut zéro, la recherche ne devra retourner aucun objet +pour que la validation soit réussie. Sinon, la recherche devra retourner au moins un objet.

    +
    • +
+
    +
  • +

    except_current_object

    +

    Booléen définissant si l'objet courrant doit être exclu du résultat de la recherche. Ce paramètre +n'est évalué quand cas de création (formulaire create).

    +
    • +
+

Validation par l'exécution d'une fonction

+

Il est possible d'effectuer la validation de l'attribut par l'exécution d'une fonction de votre +choix. Il lui sera passé en paramètre une référence à l'objet LSldapObject courant. Si la fonction +ne retourne pas true, la validation échouera.

+
'validation' => array (
+  ..
+  array(
+    'msg' => "[LSformat du message d'erreur]",
+    'function' => '[Nom de la fonction de validation]'
+  ),
+  ...
+),
+...
+
+
    +
  • +

    msg

    +

    LSformat du message d'erreur à afficher lorsque la +validation échoue. Ce format est construit avec les valeurs du +LSobject.

    +
    • +
+
    +
  • +

    function

    +

    Le nom de la fonction à exécuter. Si cette fonction n'existe pas, un message d'erreur sera affiché +et la validation échouera.

    +
    • +

Déclencheurs

+

Cette section décrit la manière de paramétrer des déclencheurs afin que LdapSaisie exécute durant +ses processus, et à des moments bien précis des traitements d'un +LSattributes, des fonctions que vous pourrez développer vous +même. De plus, le résultat de l'exécution de vos fonctions pourra influer sur le déroulement des +processus.

+

Actuellement, les évènements suivant sont gérés :

+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
NomDescriptionBloquant
before_createAvant la création du LSobject, lorsque l'attribut a au moins une valeur.Oui
after_createAprès la création du LSobject, lorsque l'attribut a au moins une valeur.Non
before_modifyAvant la modification de la valeur de l'attribut.Oui
after_modifyAprès la modification de la valeur de l'attribut.Non
before_deleteAvant la suppression du LSobject contenant l'attribut.Oui
after_deleteAprès la suppression du LSobject contenant l'attribut.Non
+
+

Note

+

Si un événement est dit bloquant, lors de l'exécution des actions liées, si une des fonctions +retourne false, le processus s'arrêtera.

+
+

Configuration

+

La configuration des déclencheurs se fait dans la définition des +LSattributes. Par exemple, pour définir les fonctions à +exécuter après la modification de la valeur de l'attribut mail du type de +LSobject LSpeople, c'est à dire lors de leur évenement +after_modify, il faut définir la variable suivante :

+
$GLOBALS['LSobjects']['LSpeople']['attrs']['mail']['after_modify']
+
+

Cette variable peut contenir soit une chaine de caractères correspondant au nom de la fonction à +exécuter, soit un tableau de chaînes de caractères correspondant aux noms des fonctions à exécuter.

+

Écriture d'une fonction

+

Une fonction exécuté par un déclencheur d'un LSattribute se déclare de la manière suivante :

+
/*
+ * Ma fonction à exécuter lors de l'évènement [event]
+ *
+ * Paramètre :
+ *     - $object : Le LSobject contenant le LSattribute sur lequel l'évenement
+ *                 survient
+ *
+ * Valeurs retournées :
+ *     - True : Tout s'est bien passé
+ *     - False : Une erreur est survenue ou la fonction souhaite bloquer le
+ *               processus lors d'un évènement bloquant.
+ */
+function maFonction ($object) {
+
+  // Actions
+
+}
+
+

Cette fonction doit prendre pour seul paramètre, le LSobject contenant le LSattribute sur lequel +l'évenement survient et doit retourner soit True si tout s'est bien passé, soit False en cas de +problème. Dans le cas d'un événement bloquant, si la fonction retourne False, le processus est +arrêté.

Ended: Attributs

Création automatique du conteneur des LSobjets dans un subDn

+

Cette section décrit la manière de configurer la création automatique des conteneurs des LSobjets. +Si le basedn correspondant à la branche de stockage des LSobjects +n'existe pas, LdapSaisie tentera de le créer à partir de la configuration de la variable +$GLOBALS['LSobjects']['[nom du type d'LSobject]']['container_auto_create'].

+
$GLOBALS['LSobjects']['[nom du type d'LSobject]']['container_auto_create'] = array (
+  'objectclass' => array(
+      'objectclass1',
+      'objectclass2',
+      ...
+    ),
+    'attrs' => array(
+      'attr1' => 'val1',
+      'attr2' => array(
+        'val2',
+        'val3',
+        ...
+      ),
+      ...
+    )
+);
+
+
    +
  • +

    objectclass

    +

    La liste des objectclass de l'objet conteneur.

    +
    • +
+
    +
  • +

    attrs

    +

    Un tableau associatif dont les clés sont les noms des attributs de l'objet conteneur à définir et +dont les valeurs associées sont la/les valeur(s) de ces attributs.

    +
    • +

Déclencheurs

+

Cette section décrit la manière de paramétrer des déclencheurs afin que LdapSaisie exécute durant +ses processus, et à des moments bien précis des traitements d'un +LSobject, des fonctions que vous pourrez développer vous même. De +plus, le résultat de l'exécution de vos fonctions pourra influer sur le déroulement des processus.

+

Actuellement, les évenements suivant sont gérés :

+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
NomDescriptionBloquant
before_createAvant la création du LSobject.Oui
after_createAprès la création du LSobject.Non
before_modifyAvant la modification du LSobjectOui
after_modifyAprès la modification du LSobjectNon
before_renameAvant de renommer le LSobjectOui
after_renameAprès avoir renommé le LSobjectNon
before_deleteAvant la suppression du LSobjectOui
after_deleteAprès la suppression du LSobjectNon
+
+

Note

+

Si un événement est dit bloquant, lors de l'exécution des actions liées, si une des fonctions +retourne false, le processus s'arrêtera.

+
+

Configuration

+

La configuration des déclencheurs se fait dans la définition des types +d'LSobjects. Par exemple, pour définir les fonctions à exécuter +après la modification des LSobjects de type LSpeople, c'est à dire lors de leur évènement +after_modify, il faut définir la variable suivante :

+
$GLOBALS['LSobjects']['[nom du type d'LSobject]']['after_modify']
+
+

Cette variable peut contenir soit une chaine de caractères correspondant au nom de la fonction à +exécuter, soit un tableau de chaînes de caractères correspondant aux noms des fonctions à exécuter.

+

Écriture d'une fonction

+

Une fonction exécuté par un déclencheur d'un LSobject se déclare de la manière suivante :

+
/*
+ * Ma fonction à exécuter lors de l'evenement [event]
+ *
+ * Paramètre :
+ *     - $object : Le LSobject sur lequel l'évènement survient
+ *
+ * Valeurs retournées :
+ *     - True : Tout s'est bien passé
+ *     - False : Une erreur est survenue ou la fonction souhaite bloquer le
+ *               processus lors d'un évènement bloquant.
+ */
+function maFonction ($object) {
+
+  // Actions
+
+}
+
+

Cette fonction doit prendre pour seul paramètre, le LSobject sur lequel l'évènement survient et doit +retourner soit True si tout s'est bien passé, soit False en cas de problème. Dans le cas d'un +événement bloquant, si la fonction retourne False, le processus est arrêté.

Actions personnalisées (customActions)

+

Cette section décrit la manière de configurer les actions personnalisées exécutables sur les +LSobjects appelées customActions.

+
$GLOBALS['LSobjects']['[nom du type d'LSobject]']['customActions'] = array (
+  'action1' => array(
+    'label' => '[label l'action]',
+    'hideLabel' => '[booléen]',
+    'helpInfo' => '[label d'aide]',
+    'icon' => '[nom de l'icône de l'action]',
+    'function' => '[fonction à exécuter]',
+    'question_format' => '[LSformat de la question de confirmation]',
+    'onSuccessMsgFormat' => '[LSformat du message à afficher en cas de succès de l'action]',
+    'disableOnSuccessMsg' => '[booléen]',
+    'noConfirmation' => '[booléen]',
+    'redirectToObjectList' => '[booléen]',
+    'noRedirect' => '[booléen]',
+    'accessMethods' => array(
+      'web',
+      'api',
+    ),
+    'rights' => array(
+      'LSprofile1',
+      'LSprofile2',
+      ...
+    )
+  )
+);
+
+
    +
  • +

    label

    +

    Le label de l'action.

    +
    • +
+
    +
  • +

    hideLabel

    +

    Cache le label dans le bouton de l'action.

    +
    • +
+
    +
  • +

    helpInfo

    +

    Le label du message d'aide qui sera affiché au survole du bouton de l'action.

    +
    • +
+
    +
  • +

    icon

    +

    Nom de l'îcone à afficher dans le bouton de l'action. Ce nom correspond au nom du fichier de +l'image (sans l'extention) qui devra se trouver dans le dossier +src/images/[nom du theme d'images]/ ou dans le dossier src/local/images.

    +
    • +
+
    +
  • +

    function

    +

    Le nom de la fonction à exécuter qui implémente l'action personnalisée Cette fonction prendra en +seule paramètre le LSobject sur lequel l'action devra être +exécutée et retournera True en cas de succès ou False en cas d'échec d'exécution de la fonction.

    +
    • +
+
    +
  • +

    question_format

    +

    Le LSformat de la question de confirmation +d'exécution de l'action. Ce LSformat sera composé à +l'aide du nom de l'objet.

    +
    • +
+
    +
  • +

    onSuccessMsgFormat

    +

    Le LSformat du message à afficher en cas de succès +d'exécution de l'action. Ce LSformat sera composé à +l'aide du nom de l'objet.

    +
    • +
+
    +
  • +

    disableOnSuccessMsg

    +

    Booléen permetant de désactiver le message afficher en cas de succès d'exécution de l'action.

    +
    • +
+
    +
  • +

    noConfirmation

    +

    Booléen permetant de désactiver la confirmation de l'exécution de l'action.

    +
    • +
+
    +
  • +

    redirectToObjectList

    +

    Booléen permetant de rediriger l'utilisateur vers la liste des objets plutôt que sur la fiche de +l'objet après l'execution de l'action.

    +
    • +
+
    +
  • +

    noRedirect

    +

    Booléen permetant de désactiver la redirection de l'utilisateur après l'execution de l'action. +Cela permet à la fonction de définir son propre fichier de template de retour et donc d'afficher +une page personnalisable.

    +
    • +
+
    +
  • +

    rights

    +

    Tableau contenant la liste des noms des +LSprofiles ayant le droit d'exécuter cette +action.

    +
    • +
+
    +
  • +

    accessMethods

    +

    Tableau permetant de restreindre les moyens d'accès possibles à cette action. Par défaut, tous les +moyens d'accès possibles sont autorisés. Valeurs possibles : web pour les accès via l'interface +web et api pour les accès via l'API.

    +
    • +
+

Écriture d'une fonction implémentant une customAction

+

Une fonction implémentant une customAction se déclare de la manière suivante :

+
/*
+ * Ma fonction implémentant ma customAction
+ *
+ * Paramètre :
+ *     - $object : Le LSobject sur lequel mon action doit être exécutée
+ *
+ * Valeurs retournées :
+ *     - True : Tout s'est bien passé
+ *     - False : Une erreur est survenue
+ *     - Cas particulier pour une exécution via l'API : un tableau des données
+ *       à retourner. Exemple :
+ *       ["success" => true, "extra_info1" => "...", "extra_info2" => "..."]
+ */
+function maFonction ($object) {
+
+  // Actions
+
+}
+
+

Cette fonction doit prendre pour seul paramètre, le LSobject sur +lequel l'action personnalisée doit être exécutée et doit retourner soit True si tout s'est bien +passé, soit False en cas de problème.

+

Une customAction pourra également être appelé via l'API. Dans ce cas, il est possible de +retourner un tableau associatif et non un simple booléen. Le résultat retourné sera alors +fusionné avec les données retournées par la requête. Ce tableau devra contenir à minima la clé +success qui indiquera via un booléen si l'exécution est un succès ou non. Il est possible de +détecter si la méthode est appelée via l'API en appelant la méthode +LSsession :: get('api_mode'). Vous pouvez prendre exemple sur le code de la méthode +showTechInfo() fournie par le LSaddon showTechInfo.

+
+

Note

+

Ces fonctions sont le plus couramment définies au sein d' +LSaddon.

+

Les relations entre les objets de l'annuire (LSrelation)

+

Cette section décrit la manière de configurer les relations entre les +LSobjects appelées LSrelation.

+

Dans le cadre d'une liaison dîte simple, c'est à dire une liaison au travers la valeur d'un +attribut qui fera directement référence à un autre objet (DN ou la première valeur d'un attribut +de référence), pourra être configurée simplement en spécifiant l'attribut de liaison et le type de +valeur qu'il contient. Dans le cas d'une liaison plus complexe, il sera possible de développer vous +même des méthodes de mise en relation.

+
$GLOBALS['LSobjects']['[nom du type d'LSobject]']['LSrelation'] = array (
+  'relation1' => array(
+    'label' => '[label de la relation]',
+    'emptyText' => "[texte affiché si aucune relation avec d'autres objets
+                     n'existe pour l'objet courant]",
+    'LSobject' => '[le type d'LSobjet en relation]',
+    'display_name_format' => '[LSformat du nom d'affichage des LSobjet en relation]',
+    'canEdit_attribute' => '[nom d'attribut]',
+
+    // Liaison simple
+    'linkAttribute' => '[attribut de liaison]',
+    'linkAttributeValue' => '[valeur de l'attribut de liaison]',
+    'linkAttributeOtherValues' => array('[autres valeurs possible de l'attribut de liaison]', [...]),
+
+    // Liaison complexe
+    'list_function' => '[méthode1]',
+    'getkeyvalue_function' => '[methode2]',
+    'update_function' => '[methode3]',
+    'remove_function' => '[methode4]',
+    'rename_function' => '[methode5]',
+    'canEdit_function' => '[methode6]',
+
+    'rights' => array(
+      'LSprofile1' => 'r',
+      'LSprofile2' => 'w',
+      ...
+    )
+  )
+);
+
+
    +
  • +

    label

    +

    Le label de la relation.

    +
    • +
+
    +
  • +

    emptyText

    +

    Le texte à afficher pour décrire le fait que l'objet courant n'a aucune relation d'établie avec +d'autres LSobjects. Exemple (au sujet d'un utilisateur) : +N'appartient à aucun groupe.

    +
    • +
+
    +
  • +

    LSobject

    +

    Le type d'LSobject en relation avec le type courant. +(Facultatif en cas de liaison complexe)

    +
    • +
+
    +
  • +

    display_name_format

    +

    LSformat du nom d'affichage des objets en relation.

    +
    • +
+
    +
  • +

    canEdit_attribute

    +

    Le nom de l'attibut du type d'LSobject en relation devant être +éditable par l'utilisateur pour que celui-ci puisse modifier la relation. Dans le cadre d'une +relation simple, celui-ci peut, si nécessaire, être différent du paramètre linkAttribute.

    +
    • +
+
    +
  • +

    linkAttribute

    +

    Dans le cadre d'une relation simple, il s'agit de l'attribut de liaison du type +d'LSobject en relation avec le type courant, c'est à dire +l'attribut dans lequel on retrouve une valeur en relation avec l'objet courant. +(Facultatif en cas de liaison complexe)

    +
    • +
+
    +
  • +

    linkAttributeValue

    +

    Dans le cadre d'une relation simple, il s'agit du type de valeur prisent par l'attribut de liaison +du type d'LSobject en relation avec le type courant. Il peut +s'agir du mot clé dn si l'attribut de liaison contient le DN de l'objet courant ou bien le nom +d'un attribut du type d'objet courant dont la première valeur sera stockée par l'attribut de +liaison. (Facultatif en cas de liaison complexe)

    +
    • +
+
    +
  • +

    linkAttributeOtherValues

    +

    Dans le cadre d'une relation simple, il s'agit d'autres types de valeur possiblement prisent par +l'attribut en plus de celui défini par le paramètre linkAttributeValue. Ce paramètre ne sert +qu'a détecter des liaisons établies à l'aide de valeurs autres que celle relative au paramètre +linkAttributeValue : en cas de nouvelle liaison, c'est la valeur associée à ce dernier qui sera +utilisée pour établir la liaison. (Facultatif en cas de liaison complexe)

    +
    • +
+
    +
  • +

    list_function

    +

    La méthode de la classe du type d'LSobject en relation, +permettant de lister les objets de ce type en relation avec l'objet courant. +(Facultatif en cas de liaison simple)

    +
    • +
+
    +
  • +

    getkeyvalue_function

    +

    La méthode de la classe du type d'LSobject en relation, +permettant d'obtenir la valeur clé à stocker pour établir la relation entre l'objet courant et +d'autres objets du type concerné. (Facultatif en cas de liaison simple)

    +
    • +
+
    +
  • +

    update_function

    +

    La méthode de la classe du type d'LSobject en relation, +permettant de mettre à jour les relations existantes entre l'objet courant et les objets du type +concerné. Cette liste d'objets en relation est établie par l'utilisateur à travers l'interface. +(Facultatif en cas de liaison simple)

    +
    • +
+
    +
  • +

    remove_function

    +

    La méthode de la classe du type d'LSobject en relation +permettant de supprimer une relation existante entre l'objet courant et un objet du type concerné. +(Facultatif en cas de liaison simple)

    +
    • +
+
    +
  • +

    rename_function

    +

    La méthode de la classe du type d'LSobject en relation +permettant d'effectuer les actions nécessaires lorsque l'objet courant est renommé dans le but +de maintenir les valeurs clés permettant d'établir les relations entre l'objet courant et les +objets en relation avec lui. (Facultatif en cas de liaison simple)

    +
    • +
+
    +
  • +

    canEdit_function

    +

    La méthode de la classe du type d'LSobject en relation +permettant de vérifier que l'utilisateur à le droit de modifier la relation avec un objet +en particulier. (Facultatif en cas de liaison simple)

    +
    • +
+
    +
  • +

    rights

    +

    Tableau associatif dont les clés sont les noms des +LSprofiles ayant des droits sur cette +relation et dont les valeurs associées sont les droits correspondants. La valeur des droits d'un +LSprofile peut être r pour le droit de +lecture ou w pour le droit de lecture-écriture.Par défaut, un +LSprofile n'a aucun droit.

    +
    • +

Les formulaires (LSform)

+

Cette section décrit la manière de paramétrer les formulaires d'LdapSaisie pour un type +LSobject donné. Pour chaque type +d'LSobject, il faut configurer plusieurs formulaires +correspondant aux vues gérées par LdapSaisie (création, modification, ...). Les formulaires se +configurent par plusieurs biais :

+
    +
  • Via la configuration des attributs : La configuration des attributs détermine la présence ou non + des attributs dans les formulaires. Elle permet également de définir si on souhaite bloquer leur + présence en lecture seulement.
    • +
+
    +
  • Via les droits de l'utilisateur connecté sur les attributs de l'objet à éditer : en fonction des + droits de l'utilisateur sur un attribut, celui-ci apparaîtra en lecture-écriture ou en lecture + uniquement voir pas du tout.
    • +
+
    +
  • +

    Via la configuration au niveau de chaque type d'LSobject : il + y est possible de définir le comportement globale du formulaire comme la validation via Ajax ou + encore la disposition logique des attributs dans le formulaire.

    +
    $GLOBALS['LSobjects']['[nom du type d'LSobject]']['LSform'] = array (
+  'ajaxSubmit' => [booléen],
+  'layout' => array (
+    // Configuration de la disposition logique des attributs
+  ),
+  'dataEntryForm' => array (
+    // Configuration des masques de saisie
+  )
+
+);
+
    +
      +
    • +

      ajaxSubmit

      +

      Booléen définissant si le formulaire sera envoyé via une requête Ajax plutôt qu'à travers un +rafraîchissement de la page. Par défaut : True.

      +
      • +
    +
      +
    • +

      layout

      +

      Tableau contenant la configuration de l'affichage du formulaire : il est possible de définir la +disposition des attributs dans le formulaire en les regroupant dans des onglets et en les +faisant apparaître dans un ordre logique. +Voir la section concernée.

      +
      • +
    +
      +
    • +

      dataEntryForm

      +

      Tableau contenant la configuration des masques de saisie : il est possible de définir des +masques de saisie pour faire en sorte que lors de la création d'un objet, seul un certain nombre +d'élements soit demandé à l'utilisateur. +Voir la section concernée.

      +
      • +
    +
    • +
+

Configuration de l'affichage

+

La configuration des layout se situe dans la configuration des +LSobjects, dans la variable layout +($GLOBALS['LSobjects']['[nom du type d'LSobject]']['LSform']['layout']). Cette variable est un +tableau associatif dont la clé est l'identifiant de l'onglet et dont la valeur associée est la +configuration de l'onglet.

+
$GLOBALS['LSobjects']['[nom du type d'LSobject]']['LSform']['layout'] = array (
+  'onglet1' => array(
+    'label' => '[label de l'onglet]',
+    'img' => 1, // Valeur possible 1 ou 0
+    'args' => array (
+      'arg1',
+      'arg2',
+      ...
+    )
+  ),
+  ...
+);
+
+
    +
  • +

    label

    +

    Le label de l'onglet.

    +
    • +
+
    +
  • +

    img

    +

    Affiche ou non l'image d'un éventuel attribut de type HTML +LSattr_html_image.

    +
    • +
+
    +
  • +

    args

    +

    Tableau associatif contenant une liste ordonnée des attributs qui apparaîtront dans l'onglet.

    +
    • +
+
+

Important

+

Lorsqu'un layout est défini, celui-ci est "suivi à la lettre" pour l'affichage du +LSform. Ainsi, si un attribut est défini dans la configuration de l'objet comme +présent dans le LSform courant, mais que celui-ci n'est pas présent dans le layout, +il ne sera pas du tout affiché.

+
+

Configuration des masques de saisie

+

La configuration des masques de saisie (dataEntryForm) se situe dans la configuration des +LSobjects, dans la variable dataEntryForm +($GLOBALS['LSobjects']['[nom du type d'LSobject]']['LSform']['dataEntryForm']). Cette variable est +un tableau associatif dont la clé est l'identifiant du masque de saisie et dont la valeur associée +est sa configuration.

+
$GLOBALS['LSobjects']['[nom du type d'LSobject]']['LSform']['dataEntryForm'] = array (
+  'masque1' => array(
+    'label' => '[label du masque de saisie]',
+    'disabledLayout' => [booleen],
+    'displayedElements' => array (
+      'attr1',
+      'attr2',
+      ...
+    ),
+    'defaultValues' => array (
+      'attr3' => [value],
+      'attr4' => [value],
+      ...
+    ),
+    'requiredAllAttributes' => [booleen],
+    'requiredAttributes' => array (
+      'attr1',
+      'attr2',
+      ...
+    ),
+    'forceGeneration' => array (
+      'attr1',
+      'attr2',
+      ...
+    ),
+  ),
+  ...
+);
+
+
    +
  • +

    label

    +

    Le label du masque de saisie.

    +
    • +
+
    +
  • +

    disabledLayout

    +

    Active ou non les layouts pour ce masque de saisie.

    +
    • +
+
    +
  • +

    displayedElements

    +

    Tableau contenant la liste des attributs qui devront être saisie dans le masque de saisie.

    +
    • +
+
    +
  • +

    defaultValues

    +

    Tableau associatif contenant la liste des valeurs par défaut des attributs. Les valeurs multiples +sont possibles en utilisant des tableaux.

    +
    +

    Important

    +

    Les valeurs seront vue comme des valeurs retournées par le formulaire et non comme des valeurs +des attribus LDAP eux-même. Ainsi et par exemple, un attribut traité comme un booléen dans un +formulaire pourra prendre comme valeur par défaut yes ou no.

    +
    +
    • +
+
    +
  • +

    requiredAttributes

    +

    Tableau contenant la liste des attributs obligatoires du masque de saisie. Cette liste d'attributs +obligatoires viendra en complément de la configuration des attributs. Il est ainsi possible de +rendre des attributs obligatoires durant la saisie d'un masque tout en les laissant facultatif le +reste du temps.

    +
    • +
+
    +
  • +

    requiredAllAttributes

    +

    Si ce parametre vaut True, tout les attributs du masque de saisie seront tous obligatoires de la +même manière qu'avec le paramètre requiredAttributes.

    +
    • +
+
    +
  • +

    forceGeneration

    +

    Tableau contenant la liste des attributs dont la génération sera forcée lors de la validation du +formation.

    +
    • +

Recherche des objets dans l'annuaire (LSsearch)

+

Cette section décrit la manière de paramétrer les recherches dans l'annuaire pour un type +d'LSobject donné.

+

La configuration des LSsearch se situe dans la configuration des +LSobjects, dans la variable LSsearch +($GLOBALS['LSobjects']['[nom du type d'LSobject]']['LSsearch']).

+
$GLOBALS['LSobjects']['[nom du type d'LSobject]']['LSsearch'] = array (
+  'attrs' => array(
+    'attr1',
+    'attr2',
+    ...
+    'attr3' => array(
+      'searchLSformat' => '[LSformat]',
+      'approxLSformat' => '[LSformat]',
+    ),
+    ...
+  ),
+  'params' => array(
+    // Paramètres de la recherche
+    'pattern' => '[string]',
+    'sizelimit' => [integer],
+    'recursive' => [boolean],
+    'approx' => [boolean],
+    'withoutCache' => [boolean],
+    'onlyAccessible' => [boolean],
+    // Paramètres de tri
+    'sortBy' => [displayName|subDn],
+    'sortDirection' => [ASC|DESC],
+    'sortlimit' => [integer],
+    // Paramètre d'affichage
+    'displayFormat' => [LSformat],
+    'nbObjectsByPage' => [integer],
+    'nbObjectsByPageChoices' => array([integer], [integer], ...),
+    'validPatternRegex' => '[regex]'
+  ),
+  'predefinedFilters' => array(
+    'filter1' => 'label filter1',
+    'filter2' => 'label filter2'
+  ),
+  'extraDisplayedColumns' => array(
+    'col1' => array(
+      'label' => 'label column 1',
+      'LSformat' => '[LSformat]'
+    ),
+    'col2' => array(
+      'label' => 'label column 2',
+      'generateFunction' => '[fonction de génération]',
+      'additionalAttrs' => array('[attr1]', '[attr2]', ...),
+      'escape' => [booléen],
+    ),
+    'col3' => array(
+      'label' => 'label column 3',
+      'LSformat' => '[LSformat]',
+      'alternativeLSformats' => array (
+        '[LSformat 1]',
+        '[LSformat 2]'
+      ),
+      'formaterLSformat' => '[LSformat]',
+      'formaterFunction' => '[fonction de formatage]',
+      'cssStyle' => '[CSS style]',
+      'visibleTo' => array (
+        '[LSprofile 1]',
+        '[LSprofile 2]'
+      )
+    ),
+  ),
+  'customActions' =>  array (
+    // Configuration des customActions pour les recherches de ce type d'objet
+  ),
+  'showSelectionBoxes' => [boolean],
+);
+
+
    +
  • +

    attrs

    +

    Tableau listant les attributs pouvant être utilisés dans les filtres de recherche LDAP employés +par LdapSaisie. Lorsqu'un motif de recherche est passé par l'utilisateur, LdapSaisie composera un +filtre LDAP à partir de cette liste.

    +

    Lors d'une recherche non-approximative, le filtre de recherche sera composé (par défaut) de la +manière suivante :

    +
    (|(attr1=*motif*)(attr2=*motif*)...)
+
    +

    Lors d'une recherche approximative, le filtre de recherche sera composé (par défaut) de la manière +suivante :

    +
    (|(attr1=~motif)(attr2~=motif)...)
+
    +

    Il est également possible de paramétrer la manière dont sera composé le filtre de recherche +attribut par attribut à l'aide des paramètres searchLSformat et approxLSformat.

    +
    +

    Important

    +

    Ces filtres, une fois composés, sont insérés dans un autre, filtrant en plus sur les +ObjectClass du type d'LSobject de la manière suivante :

    +
    (& (&(objectclass=oc1)(objectclass=oc2)) (filtre) )
+
    +
    +
      +
    • +

      searchLSformat

      +

      Ce paramètre est un LSformat permettant de définir, +attribut par attribut, comment le filtre de recherche LDAP est composé à partir d'un motif de +recherche et en cas de recherche non-approximative.

      +

      Ce LSformat est composé à l'aide des éléments +name, le nom de l'attribut et pattern, le motif de recherche.

      +
      (%{name}=%{pattern})
+
      +
      +

      Important

      +

      Le filtre déduit doit obligatoirement commencer par ( et se terminer par ).

      +
      +
      • +
    +
      +
    • +

      approxLSformat

      +

      Ce paramètre est un LSformat permettant de définir, +attribut par attribut, comment le filtre de recherche LDAP est composé à partir d'un motif de +recherche et en cas de recherche approximative.

      +

      Ce LSformat est composé à l'aide des éléments +name, le nom de l'attribut et pattern, le motif de recherche.

      +
      (%{name}=~%{pattern})
+
      +
      +

      Important

      +

      Le filtre déduit doit obligatoirement commencer par ( et se terminer par ).

      +
      +
      • +
    +
    • +
+
    +
  • +

    params

    +

    Tableau des paramètres par défaut d'une recherche. Ce tableau contient les paramètres qui seront +utilisés pour initialisé une recherche. Ces paramètres pourront être redéfini par l'utilisateur +ou par l'application en fonction du contexte dans lequel cette recherche est effectuée.

    +
      +
    • +

      pattern

      +

      Mot clé de la recherche.

      +
      • +
    +
      +
    • +

      sizelimit

      +

      Entier determinant le nombre maximum d'objet pouvant être retournés dans une recherche.

      +
      • +
    +
      +
    • +

      recursive

      +

      Booléen déterminant si la recherche récursive est activée.

      +
      • +
    +
      +
    • +

      approx

      +

      Booléen déterminant si la recherche approximative est activée.

      +
      • +
    +
      +
    • +

      withoutCache

      +

      Booléen déterminant si le cache de recherche doit être utilisé.

      +
      • +
    +
      +
    • +

      onlyAccessible

      +

      Booléen déterminant si seul les objets accessibles à l'utilisateur connecté doivent être +retournés par la recherche.

      +
      • +
    +
      +
    • +

      sortBy

      +

      Mot clé déterminant sur quel valeur/colonne le résultat de recherche sera trié.

      +

      Valeurs possibles : displayName, subDn ou NULL.

      +
      • +
    +
      +
    • +

      sortDirection

      +

      Mot clé déterminant le sens du trie du résultat de la recherche.

      +

      Valeurs possibles : ASC, DESC ou NULL.

      +
      • +
    +
      +
    • +

      sortlimit

      +

      Entier determinant le nombre maximum d'objet pouvant être triés dans le résultat d'une +recherche.

      +
      • +
    +
      +
    • +

      displayFormat

      +

      LSformat d'affichage du nom de l'objet dans le +résultat de la recherche.

      +
      • +
    +
      +
    • +

      nbObjectsByPage

      +

      Entier déterminant le nombre d'objet maximum affichés dans une page de résultat de la recherche.

      +
      • +
    +
      +
    • +

      nbObjectsByPageChoices

      +

      Tableau des choix proposés à l'utilisateur pour le nombre d'objets maximum affichés dans une +page de résultat de la recherche.

      +
      • +
    +
      +
    • +

      validPatternRegex

      +

      Expression régulière de validation des mots clés de recherche pour ce type +d'LSobject.

      +

      (Par défaut : /^[\w\-_\\\'\"^[]\(\){}\=\+\£\%\$\€\.\:\;\,\?\/\@]+$/iu)

      +
      • +
    +
    • +
+
    +
  • +

    predefinedFilters

    +

    Tableau associatif contenant des filtres prédéfinis pour la recherche. Les clés sont les filtres +au format LDAP et les valeurs sont les labels associés.

    +
    • +
+
    +
  • +

    extraDisplayedColumns

    +

    Tableau associatif contenant des colonnes supplémentaires à afficher dans les résultats de +recherche. Les clés sont les identifiants des colonnes supplémentaires et les valeurs sont leur +configuration définie à partir des paramètres suivant :

    +
      +
    • +

      label

      +

      Le label de la colonne.

      +
      • +
    +
      +
    • +

      LSformat

      +

      Le LSformat d'affichage de la colonne. Ce format +est composé à partir des attributs des objets LDAP dans leur format brut.

      +
      • +
    +
      +
    • +

      alternativeLSformats

      +

      Tableau des LSformats alternatifs à utiliser si le +résultat du format principal est vide. Les formats définis dans cette liste sont essayés les uns +après les autres et le premier LSformat retournant +une valeur non-vide est utilisé.

      +
      • +
    +
      +
    • +

      formaterLSformat

      +

      LSformat optionnel permettant de mettre en forme le +résultat obtenu des LSformats précédents. Ce +LSformat ne sera utilisé que si le résultat obtenu +précédement n'est pas vide. Il est ainsi possible d'utiliser les paramètres LSformat et +alternativeLSformats afin de récupérer la valeur à afficher, puis de la mettre en forme grâce +à ce LSformat. Ce format est composé à partir des +attributs des objets LDAP dans leur format brut et de la valeur retournés précedement accessible +via la variable val.

      +
      • +
    +
      +
    • +

      formaterFunction

      +

      Le nom d'une fonction optionnelle à exécuter pour mettre en forme le résultat obtenu des +LSformats précédents. Cette fonction ne sera +appelée que si le résultat obtenu précédement n'est pas vide. La fonction prendra en paramètre +la valeur à mettre en forme et retournera la valeur mise en forme.

      +
      • +
    +
      +
    • +

      generateFunction

      +

      Le nom d'une fonction qui sera utilisée pour générer la valeur d'affichage de cette colonne. La +fonction prendra en paramètre une référence de l'objet LSsearchEntry et retournera la valeur +de la colonne.

      +
      • +
    +
      +
    • +

      additionalAttrs

      +

      Un tableau de nom d'attributs à inclure dans le resultat de la recherche LDAP. Ce tableau permet +notamment d'inclure les attributs nécessaires au bon fonctionnement de la fonction +generateFunction.

      +
      • +
    +
      +
    • +

      escape

      +

      Ce paramètre booléen permet de définir si, lors de l'affichage, le contenu de la colonne doit +être transformé pour protéger les caractères éligibles en entités HTML. Par défaut, ce paramètre +est True.

      +
      +

      Warning

      +

      Cette fonctionnalité existe pour des raisons de sécurité et notamment en protection des +failles XSS. Si vous désactivez cette fonctionnalité, il est important de gérer la +problématique de sécurité par ailleurs.

      +
      +
      • +
    +
      +
    • +

      cssStyle

      +

      Ce paramètre permet de définir un style CSS personnalisé pour la colonne. S'il est défini, le +contenu de ce paramètre sera ajouté en tant qu'attribut style des balises th et td de la +colone.

      +
      • +
    +
      +
    • +

      visibleTo

      +

      Ce paramètre permet de restreindre la visibilité de cette colonne aux seuls +LSprofiles spécifiés. S'il est omis, la +colonne sera visible pour tous.

      +
      • +
    +
    • +
+ +
    +
  • +

    showSelectionBoxes

    +

    Booléen permettant de définir si les cases à cocher de sélections des objets doivent être +affichées. Lorsqu'elles sont affichées, l'utilisateur pourra sélectionner un ou plusieurs objets +dans la liste avant de déclencher une customAction. Dans ce cas, les DNs de ces +objets seront passés à la page d'exécution de la customAction via le paramètre +selected.

    +
    • +
+

Les actions personnalisées (customActions)

+

Cette section décrit la manière de configurer les actions personnalisées exécutables sur les +recherches d'LSobjects appelées customActions.

+
$GLOBALS['LSobjects']['[nom du type d'LSobject]']['LSsearch']['customActions'] = array (
+  'action1' => array(
+    'label' => '[label l'action]',
+    'hideLabel' => '[booléen]',
+    'icon' => '[nom de l'icône de l'action]',
+    'function' => '[fonction à exécuter]',
+    'question_format' => '[LSformat de la question de confirmation]',
+    'onSuccessMsgFormat' => '[LSformat du message à afficher en cas de succès de l'action]',
+    'disableOnSuccessMsg' => '[booléen]',
+    'noConfirmation' => '[booléen]',
+    'redirectToObjectList' => '[booléen]',
+    'rights' => array(
+      'LSprofile1',
+      'LSprofile2',
+      ...
+    )
+  )
+);
+
+
    +
  • +

    label

    +

    Le label de l'action.

    +
    • +
+
    +
  • +

    hideLabel

    +

    Cache le label dans le bouton de l'action.

    +
    • +
+
    +
  • +

    icon

    +

    Nom de l'îcone à afficher dans le bouton de l'action. Ce nom correspond au nom du fichier de +l'image (sans l'extention) qui devra se trouver dans le dossier +/src/images/[nom du theme d'images]/ ou dans le dossier src/local/images.

    +
    • +
+
    +
  • +

    function

    +

    Le nom de la fonction à exécuter qui implémente l'action personnalisée Cette fonction prendra en +seule paramètre l'objet LSsearch. sur lequel l'action devra être exécutée et +retournera True en cas de succès ou False en cas d'échec d'exécution de la fonction.

    +
    • +
+
    +
  • +

    question_format

    +

    Le LSformat de la question de confirmation +d'exécution de l'action. Ce LSformat sera composé à +l'aide du label de l'action.

    +
    • +
+
    +
  • +

    onSuccessMsgFormat

    +

    Le LSformat du message à afficher en cas de succès +d'exécution de l'action. Ce LSformat sera composé à +l'aide du label de l'action.

    +
    • +
+
    +
  • +

    disableOnSuccessMsg

    +

    Booléen permetant de désactiver le message afficher en cas de succès d'exécution de l'action.

    +
    • +
+
    +
  • +

    noConfirmation

    +

    Booléen permetant de désactiver la confirmation de l'exécution de l'action.

    +
    • +
+
    +
  • +

    redirectToObjectList

    +

    Booléen permetant de rediriger ou non l'utilisateur vers la liste des objets (Vrai par défaut). +Si l'utilisateur n'est redirigé, le template par défaut (ou celui défini durant l'éxécution de la +fonction) sera affiché.

    +
    • +
+
    +
  • +

    rights

    +

    Tableau contenant la liste des noms des LSprofiles +ayant le droit d'exécuter cette action.

    +
    • +
+

Écriture d'une fonction implémentant une customAction

+

Une fonction implémentant une customAction se déclare de la manière suivante :

+
/*
+ * Ma fonction implémentant ma customAction
+ *
+ * Paramètre :
+ *     - $search : L'objet LSsearch de la recherche sur lequel mon action doit être exécutée
+ *
+ * Valeurs retournées :
+ *     - True : Tout s'est bien passé
+ *     - False : Une erreur est survenue
+ */
+function maFonction ($search) {
+
+  // Actions
+
+}
+
+

Cette fonction doit prendre pour seul paramètre, l'objet LSsearch. sur lequel l'action +personnalisée doit être exécutée et doit retourner soit True si tout s'est bien passé, soit +False en cas de problème.

+
+

Important

+

La recherche passée en paramètre n'a pas encore été exécutée. En conséquence, si vous avez +besoin d'accéder au résultat de la recherche, il est nécessaire d'exécuter au préalable : +$search -> run();. Cela permet en outre, de modifier les paramètres de la recherche avant de +l'exécuter. Cela peut par exemple être utile, si vous avez besoin d'accèder aux valeurs +d'attributs particuliers, d'ajouter des attributs au résultat de la recherche :

+
$search -> setParam('attributes',array('attr1','attr2'));
+
+
+
+

Note

+

Ces fonctions sont le plus couramment définies au sein +d'LSaddon.

+

Les formats d'import/export (ioFormat)

+

Cette section décrit la manière de paramétrer les formats d'import/export pour un type d' +LSobject donné.

+

La configuration des ioFormats se situe dans la configuration des +LSobjects, dans la variable ioFormat +($GLOBALS['LSobjects']['[nom du type d'LSobject]']['ioFormat']). Cette variable est un tableau +associatif dont la clé est l'identifiant du format et dont la valeur associée est la configuration +du format.

+
+

Important

+

Le moteur d'importation simule la validation d'un formulaire de création du type +d'LSobject (ou de modification en cas d'activation du mode +mise à jour uniquement, voir ci-dessous). En conséquence :

+
    +
  • seul les attributs présent dans le formulaire de création peuvent être importés.
    • +
+
    +
  • tous les attributs obligatoires présents dans le formulaire de création doivent être fournis + par le fichier source ou générer à partir des autres attributs.
    • +
+
    +
  • Les valeurs des attributs issus de l'importation seront vue comme des valeurs retournées par + le formulaire et non comme des valeurs des attribus LDAP eux-même. Ainsi et par exemple, un + attribut traité comme un booléen dans un formulaire pourra prendre comme valeur par + défaut yes ou no.
    • +
+
+
$GLOBALS['LSobjects']['[nom du type d'LSobject]']['ioFormat'] = array (
+  '[ioFormat ID]' => array (
+    'label' => '[Label du type de fichier]',
+    'driver' => '[Pilote d'ioFormat utilisé]',
+    'driver_options' => array([Options du pilote d'ioFormat utilisé]),
+    'update_only' => '[Booléen]',
+    'fields => array (
+      '[champ 1]' => '[attribut 1]',
+      '[champ 2]' => '[attribut 2]',
+      [...]
+    ),
+    'generated_fields' => array (
+      '[attribute 3]' => '[LSformat]',
+      '[attribute 4]' => array('[LSformat1]', '[LSformat2]', ...)
+      '[attribute 5]' => function($attrs, $row) {
+        return array([...]);
+      },
+      [...]
+    ),
+    'before_import' => array('function1', 'function2'),
+    'after_import' => 'function3',
+  ),
+  [...]
+);
+
+
    +
  • +

    label

    +

    Le label du format

    +
    • +
+
    +
  • +

    driver

    +

    Le pilote a utilisé pour ce format. Le pilote permet de gérér la lecture et l'écriture dans un +type de fichier d'import/export. Pour plus d'information sur les pilotes disponibles, +Voir la section concernée.

    +
    • +
+
    +
  • +

    driver_options

    +

    Tableau associatif des options du pilote utilisé pour ce format. Pour plus d'informations, +consulter la documentation du pilote utilisé.

    +
    • +
+
    +
  • +

    update_only

    +

    Booléen permettant d'activer le mode mise à jour uniquement pour ce format. Dans ce mode, les +données de l'objet LDAP correspondant seront chargées depuis l'annuaire avant toutes validations +des données fournies dans le fichier d'import, et ce, dans un formulaire de modifications et non +pas un formulaire de création autrement. Pour que cela soit possible, il est indispensable que le +DN de l'objet puisse être déduit depuis les données fournies dans le fichier d'import. Pour cela, +vous pouvez le fournir via un champ du fichier d'import associé à la clé dn ou à défaut il sera +généré à partir du RDN dont la valeur devra être fournie dans le fichier d'import. Vous pouvez +également le générer via le paramètre generated_fields (voir ci-dessous).

    +
    • +
+
    +
  • +

    fields

    +

    Tableau associatif permettant d'associer un champ du fichier source (la clé) avec attribut de +l'objet LDAP (la valeur). Il est également possible d'associé un champ avec la valeur dn pour +fournir le DN de l'objet en mode mise à jour uniquement (voir ci-dessus).

    +
    • +
+
    +
  • +

    generated_fields

    +

    Tableau associatif permettant de définir soit des +LSformats, soit un callable (au sens PHP) pour +générer les valeurs d'attributs automatiquement. Ce tableau contient en clé, le nom de l'attribut +à générer (ou dn pour la génération du DN de l'objet en mode mise à jour uniquement), et en +valeur associée, un ou plusieurs LSformat ou un +callable à utiliser pour générer ses valeurs. +En cas de LSformat, ils seront composés à l'aide des +valeurs des autres attributs de l'objet. En cas d'un callable, il sera appeler avec en paramètre +le tableau des valeurs des autres attributs ($attrs), le tableau des données issues du fichier +source ($row) et devra retourner le tableau des valeurs générées de l'attribut ou false en cas +d'erreur.

    +
    • +
+
    +
  • +

    before_import

    +

    Chaîne de caractères (ou tableau de chaîne de caractères) correspondant au nom d'une ou plusieurs +fonctions qui seront exécutées avant chaque import. Voir la section concernée

    +
    • +
+
    +
  • +

    after_import

    +

    Chaîne de caractères (ou tableau de chaîne de caractères) correspondant au nom d'une ou plusieurs +fonctions qui seront exécutées après chaque import. Voir la section concernée

    +
    • +
+

Pilote d'ioFormat

+

Cette section décrit la manière de configurer les pilotes d'ioFormat utilisés lors des +imports/exports d'LSobjects.

+

Pilote de fichiers CSV

+

Ce pilote permet de gérer l'import/export de LSobject à partir +d'un fichier CSV. Depuis la version 4 d'LdapSaisie, ce pilote utilise les fonctions standards +fgetcsv() et fputcsv fournis par PHP. Avant cela, la classe PEAR +File_CSV_DataSource était utilisée. Par défaut, +les paramètres de lecture et d'écriture des fichiers sont : la virgule sert de délimiteur, le +caractère " peut être utilisé pour encadrer les valeurs des champs et la longueur maximale d'une +ligne est infini. Ces paramètres peuvent être modifiés en configurant les options du pilote.

+
$GLOBALS['LSobjects']['[nom du type d'LSobject]']['ioFormat']['[ID ioFormat]']['driver_options'] = array (
+  'delimiter' => '[délimiteur]',
+  'enclosure' => '[caractère d'encadrement de texte]',
+  'length' => [longueur maximale d'une ligne],
+  'escape' => '[caractère d'échappement]',
+  'multiple_value_delimiter' => '[délimiteur]',
+);
+
+
    +
  • +

    delimiter

    +

    Le caractère utilisé pour délimiter les champs (Par défaut, une virgule).

    +
    • +
+
    +
  • +

    length

    +

    La longueur maximale d'une ligne du fichier. Si zéro est spécifié, la longueur d'une ligne ne sera +pas limité, mais la lecture du fichier sera ralentie. (Par défaut : 0)

    +
    • +
+
    +
  • +

    enclosure

    +

    Le caractère utilisé pour encadrer les valeurs des champs (Par défaut : ").

    +
    • +
+
    +
  • +

    escape

    +

    Le caractère d'échappement utilisé si un des champs d'une ligne de fichier contient le caractère +utilisé pour encadrer les valeurs. (Par défaut : \).

    +
    +

    Note

    +

    Selon la RFC4180, l'echappement du caractère utilisé pour encadrer les valeurs des champs doit +se faire en le doublant. Le caractère défini ici est une alternative à ce comportement par +défaut. Pour désactiver ce caractère d'échappement alternatif, il est possible depuis de la +version 7.4.0 de PHP de mettre ici une chaine vide.

    +
    +
    • +
+
    +
  • +

    multiple_value_delimiter

    +

    Le caractère utilisé pour délimiter au sein d'un champs, les valeurs valeurs multiples d'un +attribut (Par défaut : |).

    +
    • +
+

Déclencheurs

+

Cette section décrit la manière de paramétrer des déclencheurs afin que LdapSaisie exécute durant +ses processus, et à des moments bien précis des traitements d'un ioFormat, des +fonctions que vous pourrez développer vous même. De plus, le résultat de l'exécution de vos +fonctions pourra influer sur le déroulement des processus.

+

Actuellement, les évenements suivant sont gérés :

+ + + + + + + + + + + + + + + + + + + + +
NomDescriptionBloquant
before_importAvant l'import.Oui
after_importAprès l'import'.Non
+
+

Note

+

Si un événement est dit bloquant, lors de l'exécution des actions liées, si une des fonctions +retourne false, le processus s'arrêtera.

+
+

Configuration

+

La configuration des déclencheurs se fait dans la définition des types d'ioFormat. Par +exemple, pour définir les fonctions à exécuter après l'import des LSobjects de type LSpeople avec +son LSioFormat mycsv, c'est à dire lors de leur évènement after_import, il faut définir la +variable suivante :

+
$GLOBALS['LSobjects']['LSpeople']['ioFormat']['mycsv']['after_import']
+
+

Cette variable peut contenir soit une chaine de caractères correspondant au nom de la fonction à +exécuter, soit un tableau de chaînes de caractères correspondant aux noms des fonctions à exécuter. +Il est également possible de mettre ici directement des +fonctions anonymes.

+

Ecriture d'une fonction

+

Une fonction exécutée par un déclencheur d'un ioFormat se déclare de la manière suivante :

+
/*
+ * Ma fonction à exécuter lors de l'evenement [event]
+ *
+ * Paramètres :
+ *     - $ioFormat : Le LSioFormat sur lequel l'évènement survient
+ *     - $data : Les données de contexte de l'évènement
+ *
+ * Valeurs retournées :
+ *     - True : Tout s'est bien passé
+ *     - False : Une erreur est survenue ou la fonction souhaite bloquer le
+ *               processus lors d'un évènement bloquant.
+ */
+function maFonction (&$ioFormat, &$data) {
+
+  // Actions
+
+}
+
+

Cette fonction doit accepter deux paramètres, le LSioFormat sur lequel l'évènement survient et un +tableau des données contextuelles de l'évènement. Elle doit par ailleurs retourner True si tout +s'est bien passé ou False en cas de problème. Dans le cas d'un événement bloquant, si la fonction +retourne False, le processus est arrêté.

+

Les données contextuelles de l'évènement, passées en paramètre, pourront dépendre du contexte et de +l'évènement déclencheur, mais pour les moments, il s'agit toujours d'un tableau telque décrit +ci-dessous :

+
array(
+  'input_file' => "[/path/of/import.file]",
+  'updateIfExists' => [boolean],
+  'justTry' => [boolean],
+  'objectsData' => array(
+    [Données des objets chargés depuis le fichier d'import]
+  ),
+  'return' => array(
+    'success' => [boolean],
+    'LSobject' => "[nom du type d'LSobject]",
+    'ioFormat' => "[nom du type d'ioFormat]",
+    'updateIfExists' => [boolean],
+    'justTry' => [boolean],
+    'imported' => array([objets importés]),
+    'updated' => array([objets mis à jour]),
+    'errors' => array(
+      array(
+        'data' => [données de l'objet importé ayant déclenché l'erreur],
+        'errors' => array (
+          'globals' => array("Erreur 1", [...]),
+          'attrs' => array(
+            'attr1' => array("Erreur 1", [...]),
+            [...]
+          ),
+        ),
+      ),
+      [...]
+    ),
+  ),
+)
+
+
+

Note

+

Les clés objectsData et return sont des références. En cas de modification, cela influencera +respectivement sur les données utilisées pour l'import et sur le résultat de l'import tel +qu'affiché dans l'interface.

+

Ended: Objets de l'annuaire

Configuration des addons (LSaddons)

Configuration des LSaddons

+

Cette partie décrit la manière de configurer les différents LSaddons actuellement supportés par +LdapSaisie. Ces addons peuvent avoir un fichier de configuration et il sera alors stocké dans le +dossier conf/LSaddons/ et potera le nom config.LSaddons.[addon name].php.

LSaddon_accesslog

+

Cet LSaddon fournit la fonction showObjectAccessLogs() +pouvant être utilisée comme customActions et +permettant d'afficher les logs d'accès produits par +l'overlay OpenLDAP accesslog +sur un objet de l'annuaire.

+

La constante LS_ACCESSLOG_BASEDN du fichier de configuration de l'addon +(conf/LSaddons/config.LSaddons.accesslog.php) permet d'indiquer le base DN de la base stockant les +logs :

+
// Accesslog base DN
+define('LS_ACCESSLOG_BASEDN', 'cn=ldapsaisie-accesslog');
+
+
+

Warning

+

LdapSaisie se connectera à la base stockant les logs d'accès de l'annuaire avec les mêmes +paramètres de connexion que pour la base principale (excepté le base DN). Pensez à ajuster les +ACLs de la base stockant les logs d'accès pour autoriser l'utilisateur d'LdapSaisie à se +connecter et lire les informations qu'elle contient.

+

Exemple d'ACL à mettre en place : +

to *
+      by dn.exact=uid=ldapsaisie,ou=sysaccounts,o=ls read
+      by * break
+

+
+

Ci-dessous, vous trouverez un exemple de configuration de la fonction showObjectAccessLogs() comme +customActions :

+

Exemple d'utilisation :

+
$GLOBALS['LSobjects']['LSpeople'] = array (
+  [...]
+  'customActions' => array (
+    'showObjectAccessLogs' => array (
+      'function' => 'showObjectAccessLogs',
+      'label' => 'Show access logs',
+      'hideLabel' => true,
+      'noConfirmation' => true,
+      'disableOnSuccessMsg' => true,
+      'icon' => 'clock',
+      'rights' => array (
+        'admin'
+      ),
+    ),
+  ),
+  [...]
+);
+

LSaddon_asterisk

+

Cet LSaddon est utilisé pour gérer les fonctionnalités +spécifiques au serveur de téléphonie Asterisk. Cet LSaddon +donne accès à une fonction permettant l'encodage d'un mot de passe au format spécifique attendu par +Asterisk. Ce format est un hash MD5 d'une chaine de caractère composée du nom d'utilisateur, d'une +chaine fixe spécifiée dans la configuration d'Asterisk et du mot de passe en clair.

LSaddon_exportSearchResultAsCSV

+

Cet LSaddon fournie une fonction du même nom pouvant être +utilisée comme customActions et permettant de télécharger +le résultat d'une recherche au format CSV. L'export généré reprend exactement le contenu des +colonnes du tableau du résultat de la recherche. Le DN de l'objet LDAP correspondant est également +fournis dans une colonne.

+

Des paramètres de configuration sont disponibles dans le fichier de configuration +config.LSaddons.exportSearchResultAsCSV.php. Ils permettent notamment de contrôller le format du +fichier CSV généré.

+
// CSV file delimiter
+define('LS_EXPORTSEARCHRESULTASCSV_DELIMITER',',');
+
+// CSV file enclosure
+define('LS_EXPORTSEARCHRESULTASCSV_ENCLOSURE','"');
+
+// CSV file escape character (available since PHP 5.5.4)
+define('LS_EXPORTSEARCHRESULTASCSV_ESCAPE_CHAR','\\');
+
+

Ci-dessous, vous trouverez un exemple de configuration de la fonction exportSearchResultAsCSV() +comme customActions :

+
$GLOBALS['LSobjects']['LSpeople']['LSsearch'] = array (
+        [...]
+        'customActions' => array (
+                'exportSearchResultAsCSV' => array (
+                        'label' => 'Export result as CSV',
+                        'icon' => 'export_csv',
+                        'function' => 'exportSearchResultAsCSV',
+                        'noConfirmation' => true,
+                        'disableOnSuccessMsg' => true,
+                        'rights' => array (
+                                'admin'
+                        )
+                ),
+        ),
+        [...]
+);
+
+
+

Note

+

Le label et l'icône fournis dans cet exemple sont traduits et délivrés avec LdapSaisie.

+

LSaddon_impersonate

+

Cet LSaddon fournie une fonction du même nom pouvant être +utilisée comme customActions et permettant de se +reconnecter en tant qu'un autre utilisateur de l'annuaire.

+

Ci-dessous, vous trouverez un exemple de configuration de la fonction impersonate() comme +customActions :

+

Exemple d'utilisation :

+
$GLOBALS['LSobjects']['LSpeople'] = array (
+  [...]
+  'customActions' => array (
+    'impersonate' => array (
+      'function' => 'impersonate',
+      'label' => 'Reconnect as this user',
+      'hideLabel' => True,
+      'noConfirmation' => true,
+      'disableOnSuccessMsg' => true,
+      'icon' => 'user_go',
+      'rights' => array (
+        'admin'
+      ),
+    ),
+  ),
+  [...]
+);
+

LSaddon_LSaccessRightsMatrixView

+

Cet LSaddon offre une interface de visualisation des droits +d'accès des différents LSprofiles configurés. +Pour chaque type d'objet, la matrice des droits d'accès par attribut et par profil est affiché sous +la forme d'un tableau.

+

Le fichier de configuration permet de définir au travers la variable +$GLOBALS['LSaccessRightsMatrixView_allowed_LSprofiles'] la liste des +LSprofiles autorisés à accéder à cette interface.

LSaddon_mail

+

Cet LSaddon est utilisé pour gérer l'envoi de courriels. Il +utilise pour cela les librairies PEAR Mail et Mail_Mime qui doivent être +installés.

+

Cet LSaddon offre aussi la possibilité d'envoyer des +courriels dont le contenu est construit à partir de modèles. Ces modèles sont enregistrés dans des +fichiers textes stockés (voir $GLOBALS['MAIL_TEMPLATES_DIRECTORIES']). Pour chaque modèle, vous +devez fournir trois fichiers portant le même nom mais avec des extensions différentes :

+
    +
  • template.subject : le sujet du courriel. Note : seule la première ligne du fichier est utilisé + (et passée dans la fonction trim())
    • +
  • template.html : le contenu HTML du courriel
    • +
  • template.txt: le contenu texte du courriel
    • +
+

Ces trois fichiers sont utilisés en tant que modèle Smarty et seront +construit en utilisant les variables fournies dans le contexte d'envoi des courriels. À noter que le +moteur Smarty utilisé pour la génération du contenu de ces courriels n'est pas le même que celui +utilisé par LdapSaisie pour l'affichage des pages.

+

Par ailleurs, cet LSaddon fourni une vue de gestion des +modèles de courriels existants (voir $GLOBALS['MAIL_TEMPLATES_EDITOR_VIEW_ACCESS'] pour la +configuration des accès).

+
+

Warning

+

Cette vue n'est pas conçues pour être mise entre toutes les mains. La sécurisation de modèles de +courriels étant très complexe, il est fortement recommandé de n'ouvrir l'accès à cette vue +qu'aux utilisateurs avertis et de confiances.

+
+

Cet LSaddon doit être configuré en éditant son +fichier de configuration config.LSaddons.mail.php.

+
 ***********************************************
+ * Configuration du support de l'envoi de mail *
+ ***********************************************
+ */
+
+// Pear :: Mail
+define('PEAR_MAIL','/usr/share/php/Mail.php');
+
+// Pear :: Mail_mime
+define('PEAR_MAIL_MIME','/usr/share/php/Mail/mime.php');
+
+/*
+ * Méthode d'envoie :
+ *  - mail : envoie avec la méthode PHP mail()
+ *  - sendmail : envoie la commande sendmail du système
+ *  - smtp : envoie en utilisant un serveur SMTP
+ */
+define('MAIL_SEND_METHOD','smtp');
+
+/*
+ * Paramètres d'envoie :
+ *   Ces paramètres dépende de la méthode utilisé. Repporté vous à la documentation
+ *   de PEAR :: Mail pour plus d'information.
+ *   Lien : http://pear.php.net/manual/en/package.mail.mail.factory.php
+ * Infos :
+ *  List of parameter for the backends
+ *  mail
+ *    o If safe mode is disabled, $params will be passed as the fifth
+ *      argument to the PHP mail() function. If $params is an array,
+ *      its elements will be joined as a space-delimited string.
+ *  sendmail
+ *    o $params["sendmail_path"] - The location of the sendmail program
+ *      on the filesystem. Default is /usr/bin/sendmail.
+ *    o $params["sendmail_args"] - Additional parameters to pass to the
+ *      sendmail. Default is -i.
+ *  smtp
+ *    o $params["host"] - The server to connect. Default is localhost.
+ *    o $params["port"] - The port to connect. Default is 25.
+ *    o $params["auth"] - Whether or not to use SMTP authentication.
+ *      Default is FALSE.
+ *    o $params["username"] - The username to use for SMTP authentication.
+ *    o $params["password"] - The password to use for SMTP authentication.
+ *    o $params["localhost"] - The value to give when sending EHLO or HELO.
+ *      Default is localhost
+ *    o $params["timeout"] - The SMTP connection timeout.
+ *      Default is NULL (no timeout).
+ *    o $params["verp"] - Whether to use VERP or not. Default is FALSE.
+ *    o $params["debug"] - Whether to enable SMTP debug mode or not.
+ *      Default is FALSE.
+ *    o $params["persist"] - Indicates whether or not the SMTP connection
+ *      should persist over multiple calls to the send() method.
+ */
+$GLOBALS['MAIL_SEND_PARAMS'] = NULL;
+
+/*
+ * Headers :
+ */
+$GLOBALS['MAIL_HEARDERS = array();
+
+// Catch all sent emails
+$GLOBALS['MAIL_CATCH_ALL'] = array();
+
+/**
+ * Email templates
+ *
+ * This addon offer ability to send email by using templates. Email templates are stored in
+ * full-text files in configured directories (see $GLOBALS['MAIL_TEMPLATES_DIRECTORIES']). For each
+ * template, you have to provide three files with the same name but with different extensions:
+ * - template.subject: the email subject. Note: only the first line is used (and stripped)
+ * - template.html: the HTML content of the email
+ * - template.txt: the text content of the email
+ * All these files will be used as Smarty templates and will be computed using variables provided
+ * in the sending context. Note that the Smarty object used to compute the template is not the same
+ * as the one used by LdapSaisie to display pages.
+ *
+ * Futhermore, this addon offer a view to list and edit existing template (see
+ * $GLOBALS['MAIL_TEMPLATES_EDITOR_VIEW_ACCESS'] to configured access).
+ */
+
+// List of directory paths where as stored mail templates
+// Notes:
+// - provided path could be absolute or relative. Relative path are relative to the root base
+//   sources LdapSaisie directory (commonly /usr/share/ldapsaisie or the src directory if you
+//   installed it from sources). On Debian installation, you can specify 'local/email_templates' to
+//   refer to /etc/ldapsaisie/local/email_templates directory/
+// - Multiple directories could be specified, sorted so that the first ones take priority over
+//   the last one.
+// - To allow users to edit them using the editor view, these directories must be
+//   writable by PHP process (commonly runed as www-data).
+$GLOBALS['MAIL_TEMPLATES_DIRECTORIES'] = array('local/email_templates');
+
+// List of granted LSprofiles to access mail templates editor view
+// WARNING: Sanitizing mail templates is hell... EXPOSE THIS VIEW ONLY TO TRUSTED USERS!
+$GLOBALS['MAIL_TEMPLATES_EDITOR_VIEW_ACCESS'] = array('admin');
+
+

Cet LSaddon offre avant tout la possibilité d'envoyer des +courriels en utilisant la fonction PHP sendMail() :

+
bool sendMail(
+  <string> $to,
+  <string> $subject,
+  <string> $msg,
+  <array(string)> $headers,
+  <array> $attachments,
+  <string> $eol,
+  <string> $encoding,
+  <boolean> $html
+);
+
+

Pour l'envoi de courriels en utilisant un modèle, il faut utiliser la fonction PHP +sendMailFromTemplate() :

+
bool sendMailFromTemplate(
+  <string> $tplname,
+  <string> $to,
+  <array> $variables,
+  <array(string)> $headers,
+  <array> $attachments
+);
+

LSaddon_maildir

+

Cet LSaddon est utilisé pour gérer la manipulation distante +de maildir.

+

FIXME

LSaddon_mailquota

+

Cet LSaddon fournie une fonction mailquota_get_usage +pouvant être utilisée pour récupérer l'utilisation du quota d'une boîte mail IMAP. Pour cela, +LdapSaisie se connecte au serveur IMAP en utilisant un compte maître.

+

Cet LSaddon fournie une également une fonction +mailquota_show_usage pouvant être utilisée comme +customActions et permettant d'afficher l'utilisation +du quota de la boîte mail correspondante via une message dynamique (LSinfo).

+

Des paramètres de configuration sont disponibles dans le fichier de configuration +config.LSaddons.mailquota.php.

+
// IMAP Mailbox connection string LSformat (composed with LSldapObject attributes)
+// See : https://php.net/imap_open (parameter $mailbox)
+define('MAILQUOTA_IMAP_MAILBOX','{localhost}');
+
+// IMAP Master user
+define('MAILQUOTA_IMAP_MASTER_USER', 'ldapsaisie');
+
+// IMAP Master user's password
+define('MAILQUOTA_IMAP_MASTER_USER_PWD', 'secret');
+
+// IMAP Master user LSformat composed with :
+//  * masteruser = master username (MAILQUOTA_IMAP_MASTER_USER)
+//  * LSldapObject attributes
+define('MAILQUOTA_IMAP_MASTER_USER_FORMAT', '%{mail}*%{masteruser}');
+
+// IMAP quota root mailbox
+define('MAILQUOTA_IMAP_QUOTA_ROOT_MAILBOX', 'INBOX');
+
+

Ci-dessous, vous trouverez un exemple de configuration de la fonction mailquota_show_usage() +comme customActions :

+
$GLOBALS['LSobjects']['LSpeople'] = array (
+        [...]
+        'customActions' => array (
+                'showmailquotausage' => array (
+                        'function' => 'mailquota_show_usage',
+                        'label' => 'Show mail quota usage',
+                        'noConfirmation' => true,
+                        'disableOnSuccessMsg' => true,
+                        'icon' => 'mail',
+                        'rights' => array (
+                                'admin'
+                        )
+                ),
+                [...]
+        ),
+        [...]
+);
+

LSaddon_phpldapadmin

+

Cet LSaddon est utilisé pour permettre un lien facile entre +le logiciel PhpLdapAdmin et LdapSaisie. Il sera possible +ainsi à partir d'un objet dans LdapSaisie de voir ce même objet dans +PhpLdapAdmin.

+

Il est necessaire de configurer l'URL de votre installation de +PhpLdapAdmin dans le fichier de configuration +config.LSaddons.phpldapadmin.php.

+

Structure du fichier :

+
// PhpLdapAdmin View Object URL format
+define('LS_PHPLDAPADMIN_VIEW_OBJECT_URL_FORMAT','//'.$_SERVER['SERVER_NAME'].'/phpldapadmin/cmd.php?cmd=template_engine&server_id=0&dn=%{dn}');
+
+

Cet LSaddon offre la possibilité d'utilisé la fonction PHP +redirectToPhpLdapAdmin() comme customActions.

+

Exemple d'utilisation :

+
$GLOBALS['LSobjects']['LSpeople'] = array (
+        [...]
+        'customActions' => array (
+                'redirectPhpLdapAdmin' => array (
+                        'function' => 'redirectToPhpLdapAdmin',
+                        'label' => 'See in PhpLdapAdmin',
+                        'hideLabel' => True,
+                        'noConfirmation' => true,
+                        'disableOnSuccessMsg' => true,
+                        'icon' => 'phpldapadmin',
+                        'rights' => array (
+                                'admin'
+                        )
+                ),
+        ),
+        [...]
+);
+

LSaddon_ppolicy

+

Cet LSaddon fourni :

+
    +
  • +

    une fonction ppolicy_extraDisplayColumn_password_expiration pouvant être utilisée pour la + génération d'une extraDisplayedColumn affichant l'état d'expiration du mot de passe des objets + d'une recherche.

    +

    Exemple d'utilisation :

    +
    $GLOBALS['LSobjects']['LSpeople']['LSsearch'] = array (
+  [...]
+  'extraDisplayedColumns' => array (
+    [...]
+    'password_expiration' => array (
+      'label' => 'Password expiration',
+      'generateFunction' => 'ppolicy_extraDisplayColumn_password_expiration',
+      'additionalAttrs' => array('pwdChangedTime', 'pwdPolicySubentry'),
+      'escape' => false,
+      'cssStyle' => 'width: 14em; text-align: center;'
+    ),
+    [...]
+  ),
+  [...]
+);
+
    +
    • +
+
    +
  • +

    une fonction ppolicy_export_search_info pouvant être utilisée comme + actions personnalisées sur les recherches d'LSobjects + pour exporter au format CSV les informations des politiques de mots de passe des objets retournés + par la recherche.

    +

    Exemple d'utilisation :

    +
    $GLOBALS['LSobjects']['LSpeople']['LSsearch'] = array (
+  [...]
+  'customActions' => array (
+    'exportPpolicyInfo' => array (
+      'label' => 'Export password policy info',
+      'icon' => 'export_csv',
+      'function' => 'ppolicy_export_search_info',
+      'noConfirmation' => true,
+      'disableOnSuccessMsg' => true,
+      'rights' => array (
+        'admin',
+      ),
+    ),
+  ),
+  [...]
+);
+
    +
    • +
+
    +
  • la méthode d'API exportPpolicyInfo permettant d'exporter les informations des politiques de mots + de passe de tous les objets d'un type donné. Cette méthode est accessible via l'URL au format + suivant : /api/1.0/exportPpolicyInfo/[object type]
    • +
+
    +
  • +

    la commande CLI export_ppolicy_info permettant d'exporter les informations des politiques de + mots de passe de tous les objets d'un type donné.

    +

    Utilisation :

    +
    ldapsaisie export_ppolicy_info [object type] [-o|--output filepath] [-j|--json [-p|--pretty]]
+
    +
    • +
+

Des paramètres de configuration sont disponibles dans le fichier de configuration +config.LSaddons.ppolicy.php.

+
// Default password policy object DN (set to null if no default policy is configured)
+define('LS_PPOLICY_DEFAULT_DN', null);
+
+// Ppolicy password warning expiration threshold (in seconds)
+define('LS_PPOLICY_WARNING_EXPIRATION_THRESHOLD', 7 * 86400);
+
+// Ppolicy password critical expiration threshold (in seconds)
+define('LS_PPOLICY_CRITICAL_EXPIRATION_THRESHOLD', 2 * 86400);
+
+// CSV file delimiter
+define('LS_PPOLICY_CSV_DELIMITER',';');
+
+// CSV file enclosure
+define('LS_PPOLICY_CSV_ENCLOSURE','"');
+
+// CSV file escape character (available since PHP 5.5.4)
+define('LS_PPOLICY_CSV_ESCAPE_CHAR','\\');
+
+// List of LSprofiles who are granted to use the exportPpolicyInfo API method
+$GLOBALS['LS_PPOLICY_API_GRANTED_PROFILES'] = array('admin');
+
+// List of extra attributes to include in Ppolicy info export
+$GLOBALS['LS_PPOLICY_INFO_EXPORT_EXTRA_ATTRS'] = array();
+
+
    +
  • +

    LS_PPOLICY_DEFAULT_DN

    +

    Constante définissant le DN de la politique par défaut. Si aucune politique par défaut n'est +définie, ce paramètre doit valoir null.

    +
    • +
+
    +
  • +

    LS_PPOLICY_WARNING_EXPIRATION_THRESHOLD

    +

    Constante définissant le seuil d'alerte pour l'expiration des mots de passe (en seconde). Par +défaut : 7 jours.

    +
    • +
+
    +
  • +

    LS_PPOLICY_CRITICAL_EXPIRATION_THRESHOLD

    +

    Constante définissant le seuil critique pour l'expiration des mots de passe (en seconde). Par +défaut : 2 jours.

    +
    • +
+
    +
  • +

    LS_PPOLICY_CSV_DELIMITER

    +

    Constante définissant le caractère utilisé lors de la génération de l'export CSV comme séparateur +de champ. Par défaut : un point-virgule.

    +
    • +
+
    +
  • +

    LS_PPOLICY_CSV_ENCLOSURE

    +

    Constante définissant le caractère utilisé lors de la génération de l'export CSV pour +l'encadrement des champs. Par défaut : un guillemet double.

    +
    • +
+
    +
  • +

    LS_PPOLICY_CSV_ESCAPE_CHAR

    +

    Constante définissant le caractère utilisé lors de la génération de l'export CSV pour +l'échappement des champs. Par défaut : une barre oblique inverse.

    +
    • +
+
    +
  • +

    $GLOBALS['LS_PPOLICY_API_GRANTED_PROFILES']

    +

    Tableau global listant les LSprofiles +autorisés à utiliser la méthode d'API exportPpolicyInfo.

    +
    • +
+
    +
  • +

    $GLOBALS['LS_PPOLICY_INFO_EXPORT_EXTRA_ATTRS']

    +

    Tableau global listant les attributs supplémentaires à inclure lors de l'export des informations +de politique de mots de passe.

    +
    • +

LSaddon_showSupportInfo

+

Cet LSaddon fourni une page affichant les informations utiles +pour l'équipe assurant le support de l'application. Cette page est accessible à l'adresse +addon/showSupportInfo/showMySupportInfo. Elle compile (et permet de télécharger) l'ensemble des +informations utiles à l'appréciation du contexte d'accès à l'application par l'utilisateur.

+

Cette page est accessible par tous les utilisateurs connectés à l'application. Cependant, par +défaut, il n'y a aucun lien d'accès à celle-ci. Il est possible d'ajouter un lien d'accès dans le +menu et modifiant la valeur de la constante SHOW_SUPPORT_INFO_IN_MENU à True.

+

Une fonction showMySupportInfo() est également fournie et peut-être utilisée comme +customActions. Elle redirigera alors l'utilisateur +vers cette page. Ci-dessous, vous trouverez un exemple de configuration de la fonction +showMySupportInfo() comme customActions :

+
$GLOBALS['LSobjects']['LSpeople'] = array (
+  [...]
+  'customActions' => array (
+    'showMySupportInfo' => array (
+      'function' => 'showMySupportInfo',
+      'label' => 'Show my support information',
+      'hideLabel' => True,
+      'noConfirmation' => true,
+      'disableOnSuccessMsg' => true,
+      'icon' => 'terminal',
+      'rights' => array (
+        'self'
+      ),
+    ),
+  ),
+  [...]
+);
+
+
+

Note

+

Le label et l'icône fournis dans cet exemple sont traduits et délivrés avec LdapSaisie.

+

LSaddon_showTechInfo

+

Cet LSaddon fournie une fonction du même nom pouvant être +utilisée comme customActions et permettant d'afficher +les informations techniques d'un objet de l'annuaire.

+

Ci-dessous, vous trouverez un exemple de configuration de la fonction showTechInfo() comme +customActions :

+
$GLOBALS['LSobjects']['LSpeople'] = array (
+  [...]
+  'customActions' => array (
+    'showTechInfo' => array (
+      'function' => 'showTechInfo',
+      'label' => 'Show technical information',
+      'hideLabel' => True,
+      'noConfirmation' => true,
+      'disableOnSuccessMsg' => true,
+      'icon' => 'tech_info',
+      'rights' => array (
+        'admin'
+      ),
+    ),
+  ),
+  [...]
+);
+
+
+

Note

+

Le label et l'icône fournis dans cet exemple sont traduits et délivrés avec LdapSaisie.

+

Ended: Configuration des addons (LSaddons)

Configuration des méthodes d'authentification (LSauthMethod)

Configuration des méthodes d'authentification (LSauthMethod)

+

Cette partie décrit la manière de configurer les méthodes d'authentification d'LdapSaisie appelée +LSauthMethod). Ces librairies peuvent avoir un fichier de configuration et il sera alors stocké dans +le dossier conf/LSauth/.

LSauthMethod_anonymous

+

Cette LSauthMethod est utilisée pour gérer +l'authentification automatique des utilisateurs arrivant (équivalent à un mode anonyme). Cette +librairie doit être configurée en éditant le fichier de configuration +conf/LSauth/config.LSauthMethod_anonymous.php et notament en définissant la constante +LSAUTHMETHOD_ANONYMOUS_USER contenant le login d'un utilisateur dont les droits d'accès seront +endossés par tout les personnes utilisant LdapSaisie.

LSauthMethod_CAS

+

Cette LSauthMethod est utilisée pour gérer +l'authentification via un service SSO CAS. Cette librairie doit être configurée en éditant le +fichier de configuration conf/LSauth/config.LSauthMethod_CAS.php.

+

Structure du fichier :

+
/*
+ *****************************************************
+ * Configuration of the CAS authentification support *
+ *****************************************************
+ */
+
+// phpCAS Path (http://www.ja-sig.org/wiki/display/CASC/phpCAS)
+define('PHP_CAS_PATH','/usr/share/php/CAS.php');
+
+// phpCAS Debug File
+// define('PHP_CAS_DEBUG_FILE','/tmp/phpCAS.log');
+
+// Disable logout
+define('LSAUTH_CAS_DISABLE_LOGOUT',false);
+
+// CAS Server version (used constant name know by phpCAS : CAS_VERSION_1_0 or CAS_VERSION_2_0)
+define('LSAUTH_CAS_VERSION','CAS_VERSION_2_0');
+
+// CAS Server hostname
+define('LSAUTH_CAS_SERVER_HOSTNAME','cas.univ.fr');
+
+// CAS Server port
+define('LSAUTH_CAS_SERVER_PORT',443);
+
+// CAS Server URI (empty by default)
+// define('LSAUTH_CAS_SERVER_URI','cas/');
+
+// No SSL validation for the CAS server
+define('LSAUTH_CAS_SERVER_NO_SSL_VALIDATION',false);
+
+// CAS server SSL CA Certificate path
+//define('LSAUTH_CAS_SERVER_SSL_CACERT','');
+
+
    +
  • +

    PHP_CAS_PATH

    +

    Le chemin d'accès du fichier CAS.php de la librairie +phpCAS. Le chemin d'exemple correspond au chemin +résultant d'une installation via PEAR sur une Debian (Lenny).

    +
    • +
+
    +
  • +

    PHP_CAS_DEBUG_FILE

    +

    Chemin du fichier de log de la librairie phpCAS. +Commenter la ligne pour désactiver les logs.

    +
    • +
+
    +
  • +

    LSAUTH_CAS_DISABLE_LOGOUT

    +

    Booléen définissant si l'utilisateur peut se déconnecter du serveur CAS depuis l'interface.

    +
    +

    Note

    +

    Remarque : l'appel de l'URL de déconnexion via une requête GET supprimera la session PHP et +donc la session LdapSaisie sans déconnecter pour autant l'utilisateur au niveau du serveur +CAS. Cela peut donc permettre de gérer la déconnexion automatique au niveau d'LdapSaisie suite +à une déconnexion au niveau du CAS à traver le concepte de Global Logout.

    +
    +
    • +
+
    +
  • +

    LSAUTH_CAS_VERSION

    +

    Nom de la constant phpCAS permettant de définir +la version CAS du serveur. Actuellement, la librairie +phpCAS ne reconnait que la constante +CAS_VERSION_1_0 pour la version 1 de CAS ou la constante CAS_VERSION_2_0 pour la version 2 de +CAS.

    +
    +

    Note

    +

    Remarque : Des tests on montrés que l'utilisation d'une compatibilité CAS version 2 peut +également fonctionner sur un version 3 du serveur CAS.

    +
    +
    • +
+
    +
  • +

    LSAUTH_CAS_SERVER_HOSTNAME

    +

    Le nom d'hôte du serveur CAS.

    +
    • +
+
    +
  • +

    LSAUTH_CAS_SERVER_PORT

    +

    Le port d'écoute du serveur CAS.

    +
    • +
+
    +
  • +

    LSAUTH_CAS_SERVER_URI

    +

    Le dossier HTTP dans lequel se trouve le service CAS. Exemple : Pour un service CAS accessible via +l'URL https://cas.univ.fr/cas/, la constante devra valoir cas/.

    +
    • +
+
    +
  • +

    LSAUTH_CAS_SERVER_NO_SSL_VALIDATION

    +

    Booléen permettant de désactiver la validation du certificat SSL du serveur CAS lors des requêtes +de validation des tickets CAS.

    +
    • +
+
    +
  • +

    LSAUTH_CAS_SERVER_SSL_CACERT

    +

    Chemin d'accès du fichier contenant le certificat SSL de la CA du serveur CAS au format PEM. +Commenter la ligne pour désactiver ce paramètre.

    +
    • +

LSauthMethod_HTTP

+

Cette LSauthMethod est utilisée pour gérer +l'authentification via les variables d'environnements définies suite à une authentification, +potentiellement déléguée au serveur web.

+

Cette méthode récupère dans l'environment d'exécution PHP, le nom d'utilisateur et le mot de passe +de l'utilisateur connecté. À partir du nom d'utilisateur, une recherche dans l'annuaire sera +effectuée pour trouver l'utilisateur correspondant. L'authentification sera réussie uniquement si un +et un seul utilisateur est retourné par la recherche et si une authentification auprès de l'annuaire +LDAP réussie à l'aide du DN de l'objet LDAP trouvé et du mot de passe fourni.

+
+

Note

+

En cas d'authentification déléguée au serveur web, il est possible de désactiver la vérification +du mot de passe via le paramètre LSAUTHMETHOD_HTTP_TRUST_WITHOUT_PASSWORD_CHALLENGE +(voir ci-dessous).

+
+

Les variables d'environnements utilisées pour authentifier l'utilisateur connecté dépendent de la +méthode configurée via la constante LSAUTHMETHOD_HTTP_METHOD (voir ci-dessous). Si ces variables +ne sont pas disponibles, une erreur HTTP 403 sera générée pour réclamer une authentification à +l'utilisateur.

+
+

Note

+

Cette LSauthMethod supporte le mode API et il s'agit +de la méthode utilisée par défaut dans ce mode.

+
+

Cette librairie peut être configurée en éditant le fichier de configuration +conf/LSauth/config.LSauthMethod_HTTP.php.

+

Structure du fichier :

+
/*
+ *****************************************************
+ * Configuration of the HTTP authentification support *
+ *****************************************************
+ */
+
+// Don't check HTTP server's login/password by LDAP authentication challenge
+//define('LSAUTHMETHOD_HTTP_TRUST_WITHOUT_PASSWORD_CHALLENGE',true);
+
+// Authentication realm (API mode only)
+//define('LSAUTHMETHOD_HTTP_API_REALM', ___('LdapSaisie API - Authentication required'));
+
+
    +
  • +

    LSAUTHMETHOD_HTTP_TRUST_WITHOUT_PASSWORD_CHALLENGE

    +

    Permet de désactiver le test d'authentification auprès de l'annuaire LDAP. Pour cela, cette +constante doit être définie et valoir True.

    +
    • +
+
    +
  • +

    LSAUTHMETHOD_HTTP_METHOD

    +

    Permet de définir la méthode utilisée par le serveur web pour passer à PHP +l'identifiant de l'utilisateur connecté et son mot de passe.

    +

    Cette constance peut pendre les valeurs suivantes :

    +
      +
    • +

      PHP_PASS

      +

      Dans cette méthode, le serveur web défini les variables d'environnement PHP_AUTH_USER et +PHP_AUTH_PW. Cette méthode est la méthode par défaut et convient en cas d'utilisation de +mod_php.

      +
      • +
    +
      +
    • +

      REMOTE_USER

      +

      Dans cette méthode, le serveur web défini la variable d'environnement REMOTE_USER. Cette +variable ne contient que l'identifiant de l'utilisateur connecté. Cette méthode ne peut donc +être utilisée que conjointement avec l'activation du paramètre +LSAUTHMETHOD_HTTP_TRUST_WITHOUT_PASSWORD_CHALLENGE.

      +
      • +
    +
      +
    • +

      AUTHORIZATION

      +

      Dans cette méthode, le serveur web passe le contenu de l'entête HTTP Authorization dans la +variable d'environnement HTTP_AUTHORIZATION. Cette méthode convient en cas d'utilisation de +PHP en mode CGI ou encore via PHP-FPM.

      +

      Pour utiliser cette méthode, il faudra adapter la configuration du serveur web. Par exemple, +pour Apache HTTPd, vous pouvez utiliser le module rewrite et la règle de réécriture suivante :

      +
      RewriteRule .* - [E=HTTP_AUTHORIZATION:%{HTTP:Authorization}]
+
      +
      • +
    +
    • +
+
    +
  • +

    LSAUTHMETHOD_HTTP_LOGOUT_REMOTE_URL

    +

    URL de déconnexion externe, utile par exemple dans le contexte d'une connexion via un service SSO. +L'utilisateur sera automatiquement redirigé vers cette URL après sa déconnexion effective au +niveau d'LdapSaisie.

    +
    +

    Note

    +

    Si cette URL de déconnexion n'est pas défini, le bouton de déconnexion sera masqué.

    +
    +
    • +
+
    +
  • +

    LSAUTHMETHOD_HTTP_REALM

    +

    Domaine d'authentification (reaml) utilisé pour réclamer l'authentification de l'utilisateur +(facultatif).

    +
    +

    Note

    +

    Pour que le message soit traduit, utilisez la fonction ___() (voir exemple).

    +
    +
    • +

Ended: Configuration des méthodes d'authentification (LSauthMethod)

Ended: Configuration

API

+

Depuis la version 4.0, LdapSaisie offre une API visant à permettre de faire les mêmes choses que ce +qu'il est possible d'accomplir via l'interface web. L'idée n'est bien entendue pas de se substituer +systématiquement à la possibilité de se connecter directement à l'annuaire, mais plutôt d'offrir une +API web pour l'intégration d'outil préférant ce mode d'interaction, ou encore, pour exposer des +méthodes accès aux données de l'annuaire tout en profitant des logiques métiers +implémentées/configurées dans LdapSaisie : validation syntaxique et d'unicité, règle de génération +et d'interdépendances des attributs, déclencheurs, ...

+
+

Note

+

Cette API est actuellement dans une phase de test et n'offre pas encore toutes les +fonctionnalités proposées dans l'interface web. Elle est vouée à évoluer pour intégrer petit à +petit un maximum de fonctionnalités. Des contributions à ce sujet seront plus qu'appréciée !

+
+

Authentification

+

L'authentification à l'API utilise le même composant LSauth que lors d'une authentification à +l'interface web, cependant, ce composant s'adapte pour prendre en compte de mode de connexion. Par +défaut, la méthode d'authentification utilisée sera +LSauthMethod_HTTP et permettra de se +connecter en spécifiant le nom d'utilisateur et le mot de l'utilisateur cherchant à se connecter via +une authentification basique HTTP.

+
+

Warning

+

Il est à noter que tous les types d'utilisateur ne peuvent pas forcément utiliser l'API : le +paramètre api_access doit être explicitement positionné à True dans +la configuration du serveur LDAP.

+
+

Une fois connecté, l'utilisateur endossera les droits associés à ses +LSprofiles, tout comme un utilisateur +connecté à l'interface web.

+

Méthodes exposées

+

Les URLs des méthodes de l'API ont été construites par mimétisme sur celle de l'interface web et +sous la racine web api/. Par ailleurs, un numéro de version d'API a été insérée dans chacune +d'elles afin d'anticiper toutes évolutions futures majeures nécéssitants de conserver une +rétrocompatibilité avec les anciennes versions de l'API.

+

Toutes les méthodes retournent des informations au format JSON et accepte le paramètre pretty +permettant d'obtenir un retour plus facilement lisible. Les chaines de caractères échangées doivent +par ailleurs être encodées en UTF-8. On trouvera par ailleurs dans le retour JSON :

+
    +
  • +

    success

    +

    Booléen précisant si l'action demandée a correctement été exécutée.

    +
    • +
+
    +
  • +

    messages

    +

    Ce tableau pourra être présent et lister les messages d'informations générées par l'action +demandée. Il s'agira des mêmes messages que ceux affichés dans l'interface web lorsque les +actions équivalentes y sont faites.

    +
    • +
+
    +
  • errors + Ce tableau pourra être présent et lister les messages d'erreurs générées par l'action demandée.
    • +
+
+

Note

+

Les messages d'informations et d'erreurs générées par l'application sont traduites dans la +langue courante qui peut être spécifiée via le paramètre lang accepté par toutes les méthodes +(exemple : fr_FR ou en_US).

+
+

Lorsqu'une méthode cible un type d'objets, voir un objet en particulier, ces informations seront +transmises dans l'URL appelée. Si le type d'objet ou l'objet demandé est introuvable, une erreur +HTTP 404 sera générée.

+
+

Important

+

Sauf précision contraire, toutes les méthodes exposées sont accessibles uniquement via les +méthodes HTTP GET ou POST. L'accès via une autre méthode retournera une erreur 404.

+
+
    +
  • +

    /api/1.0/object/[object type]

    +

    Cette méthode permet de rechercher/lister les informations d'un type d'objets de l'annuaire en +particulier. Le type de l'objet est précisé dans l'URL et doit être encodé en conséquence. Par +mimétisme du comportement de l'interface web, la recherche est paginée et accepte des paramètres +similaires en plus de paramètre plus appropriés à un fonctionnement programmatique :

    +
      +
    • +

      filter

      +

      Permet de spécifier un filtre de recherche LDAP personnalisé. Celui-ci sera combiné avec les +paramètres propres au type d'objets recherchés et aux autres paramètres spécifiés (pattern +par exemple).

      +
      +

      Warning

      +

      Du fait d'une limitation de la classe Net_LDAP2_Filter utilisée pour analyser le +filtre passé en paramètre, seuls les filtres simples du type (attribut=valeur) sont +acceptés ici. Pour les mêmes raisons, il est important que le filtre spécifié soit +toujours entourné de paranthèses.

      +
      +
      • +
    +
      +
    • +

      predefinedFilter

      +

      Permet de spécifier un des filtres de recherche LDAP prédéfinis dans la configuration du +type d'objet.

      +
      • +
    +
      +
    • +

      pattern

      +

      Permet de spécifier un mot clé de recherche, comme proposé dans l'interface web.

      +
      • +
    +
      +
    • +

      approx

      +

      Booléen permettant d'activer/désactiver la recherche approximative sur le mot clé. Les +valeurs acceptées sont 1 ou 0.

      +
      • +
    +
      +
    • +

      basedn

      +

      Permet de spécifier une base de recherche personnalisé pour la recherche.

      +
      • +
    +
      +
    • +

      subDn

      +

      Dans le cas d'un serveur LDAP configuré avec des +sous-niveaux de connexion, permet de +spécifier le sous-niveau pour la recherche.

      +
      • +
    +
      +
    • +

      scope

      +

      Permet de spécifier l'étendue de la recherche dans l'annuaire. Valeurs acceptées: sub, +one et base.

      +
      • +
    +
      +
    • +

      recursive

      +

      Booléen permettant d'activer/désactiver la recherche recursive, c'est à dire une recherche à +la racine de l'annuaire (ou du +sous-niveau de connexion) avec une +étendue de recherche maximale. Les valeurs acceptées sont 1 ou 0.

      +
      • +
    +
      +
    • +

      displayFormat

      +

      Permet de spécifier un LSformat personnalisé +pour le nom des objets dans le résultat de recherche.

      +
      • +
    +
      +
    • +

      extraDisplayedColumns

      +

      Booléen permettant d'activer le retour des colonnes personnalisées dans le résultat de +recherche. Les valeurs acceptées sont 1 ou 0.

      +
      • +
    +
      +
    • +

      attributes

      +

      Liste des attributs supplémentaires que devra retourner la recherche.

      +
      • +
    +
      +
    • +

      attributesDetails

      +

      Permet d'obtenir les détails sur les valeurs des attributs (au lieu des valeurs au format +attendu en cas de création/modification de l'objet). Seul la présence de ce paramètre suffit +à activer ce comportement, sa valeur n'a pas d'importance.

      +
      • +
    +
      +
    • +

      sortBy

      +

      Permet de préciser sur quelle information le résultat de recherche doit être trié. Valeurs +acceptées : displayName, subDn ou un des noms des colonnes personnalisées.

      +
      • +
    +
      +
    • +

      sortDirection

      +

      Permet de préciser l'ordre de tri du résultat de recherche. Valeurs acceptées : ASC (A-Z) +ou DESC (Z-A).

      +
      • +
    +
      +
    • +

      page

      +

      Permet de préciser la page du résultat de recherche.

      +
      • +
    +
      +
    • +

      nbObjectsByPage

      +

      Permet de préciser le nombre maximum d'objets retournés par page du résultat de recherche.

      +
      • +
    +
      +
    • +

      all

      +

      Permet de réclamer le résultat complet de la recherche (désactivation de la pagination). +Seul la présence de ce paramètre suffit à activer ce comportement, sa valeur n'a pas +d'importance.

      +
      • +
    +
      +
    • +

      as_list

      +

      Permet de réclamer un résultat de recherche dans lequel, la clé objects sera une liste et +non un dictionnaire. Dans ce cas, le DN de l'objet est fourni dans la clé dn des détails +des objets. Seul la présence de ce paramètre suffit à activer ce comportement, sa valeur n'a pas +d'importance.

      +
      • +
    +
      +
    • +

      withoutCache

      +

      Booléen permettant de désactiver l'utilisation du cache. Les valeurs acceptées sont 1 ou +0.

      +
      • +
    +
      +
    • +

      keepParamsBetweenSearches

      +

      Booléen permettant d'activer/désactiver le stockage en session des paramètres de recherche +(optionnel, par défaut : False). Les valeurs acceptées sont 1 ou 0.

      +
      • +
    +

    Exemple :

    +
    # curl -u username:secret 'https://ldapsaisie/api/1.0/object/LSpeople?extraDisplayedColumns=1&pretty'
+{
+    "success": true,
+    "objects": {
+        "uid=hmartin,ou=people,o=ls": {
+            "name": "Henri MARTIN",
+            "Mail": "henri.martin@ls.com"
+        },
+        "uid=s.ldapsaisie,ou=people,o=ls": {
+            "name": "Secretariat LdapSaisie",
+            "Mail": "secretariat@ldapsaisie.biz"
+        },
+        "uid=ls,ou=people,o=ls": {
+            "name": "LdapSaisie",
+            "Mail": "ldap.saisie@ls.com"
+        },
+        "uid=erwpa,ou=people,o=ls": {
+            "name": "Erwan PAGE",
+            "Mail": "erwan.page@ldapsaisie.biz"
+        },
+        "uid=user2,ou=people,ou=company1,ou=companies,o=ls": {
+            "name": "prenom2 nom2",
+            "Mail": "user2@ls.com"
+        }
+    },
+    "total": 14,
+    "params": {
+        "keepParamsBetweenSearches": false,
+        "filter": null,
+        "pattern": null,
+        "predefinedFilter": false,
+        "basedn": null,
+        "scope": null,
+        "sizelimit": 0,
+        "attronly": false,
+        "approx": false,
+        "recursive": true,
+        "attributes": [],
+        "onlyAccessible": true,
+        "sortDirection": null,
+        "sortBy": null,
+        "sortlimit": 0,
+        "displayFormat": "%{cn}",
+        "nbObjectsByPage": 25,
+        "withoutCache": false,
+        "extraDisplayedColumns": true
+    },
+    "page": 1,
+    "nbPages": 3
+}
+
    +
    • +
+
    +
  • +

    /api/1.0/object/[object type]/[dn]

    +

    Cette méthode permet de récupérer les informations d'un objet de l'annuaire au format JSON. Le +type de l'objet et son DN sont précisés dans l'URL et doivent être encodés en conséquence. Par +défaut, les valeurs des attributs retournées sont au format tel qu'attendu en cas de +création/modification de l'objet. Il est cependant possible d'ajouter le paramètre details +afin d'obtenir des informations complémentaires sur les valeurs des attributs.

    +

    Exemple :

    +
    # curl -u username:secret 'https://ldapsaisie/api/1.0/object/LSpeople/uid=hmartin,ou=people,o=ls?pretty'
+{
+    "success": true,
+    "dn": "uid=hmartin,ou=people,o=ls",
+    "type": "LSpeople",
+    "name": "Henri MARTIN",
+    "details": false,
+    "attributes": {
+        "uid": "hmartin",
+        "givenName": "Henri",
+        "sn": "MARTIN",
+        "cn": "Henri MARTIN",
+        "mail": "henri.martin@ls.com",
+        "personalTitle": "M.",
+        "description": [],
+        "jpegPhoto": null,
+        "lsGodfatherDn": [
+            "uid=eeggs,ou=people,o=ls"
+        ],
+        "uidNumber": "101022",
+        "gidNumber": "102001",
+        "loginShell": "no",
+        "homeDirectory": "\/home\/com",
+        "gecos": null,
+        "shadowExpire": null,
+        "shadowMax": null,
+        "shadowInactive": null,
+        "shadowLastChange": null,
+        "sambaSID": "S-1-5-21-2421470416-3566881284-3047381809-203044",
+        "sambaPrimaryGroupSID": "S-1-5-21-2421470416-3566881284-3047381809-205003",
+        "sambaAcctFlags": [
+            "U"
+        ],
+        "sambaHomeDrive": null,
+        "sambaHomePath": null,
+        "sambaProfilePath": null,
+        "sambaLogonScript": null,
+        "sambaLogonTime": null,
+        "sambaLogoffTime": null,
+        "sambaKickoffTime": null,
+        "sambaPwdLastSet": null,
+        "sambaPwdMustChange": null,
+        "sambaPwdCanChange": null
+    },
+    "relations": {
+        "groups": {
+            "cn=direction,ou=groups,o=ls": "direction",
+            "cn=secretariat,ou=groups,o=ls": "secretariat"
+        },
+        "godfather": []
+    }
+}
+
    +
    • +
+
    +
  • +

    /api/1.0/object/[object type]/create

    +

    Cette méthode permet de créer un objet dans l'annuaire. Le type de l'objet qui sera créé est +précisé dans l'URL et doit être encodé en conséquence. Les informations de l'objet doivent est +transmises au format x-www-form-urlencoded. Elles peuvent également être au format +multipart/form-data, en particulier si votre requête contient une image. Par mimétisme avec +l'interface web, seuls les attributs prévus dans le formulaire de création du type d'objet +peuvent être passées ici. De la même manière, les attributs non-spécifiés ici, pouront être +auto-générés en accord avec leur configuration et la requête sera acceptée uniquement si tous +les attributs obligatoires y sont spécifiés ou s'ils peuvent être auto-générés.

    +

    Le format et la syntaxe des valeurs des attributs dépends de leur type HTML. Ainsi, par exemple, +un attribut de type HTML boolean acceptera comme valeurs possibles yes ou no. Pour plus +de détails sur le type de valeur acceptée par un type d'attribut HTML en particulier, consultez +sa documentation. Vous pouvez également analyser le code de la méthode getPostData() de la +classe PHP correspondante.

    +

    Si l'application détecte un souci avec les informations transmises pour les attributs, un +tableau fields_errors sera présent dans la réponse JSON et contiendra pour chacun des +attributs problématique, un tableau des messages d'erreurs générées par l'application.

    +

    Si le type d'objet en prévoit, vous pouvez également utiliser un +masque de saisie via le +paramètre dataEntryForm.

    +

    Exemple :

    +
    # curl -u username:secret 'https://ldapsaisie/api/1.0/object/LSpeople/create?pretty' -d "uid=foo.bar&personalTitle=M.&givenName=foo&sn=bar&cn=Foo Bar&mail=foo.bar@example.com&userPassword=Y0urS3cr3t&lsGodfatherDn[]=uid=admin,ou=people,o=ls&gidNumber=70000"
+{
+    "success": true,
+    "type": "LSpeople",
+    "dn": "uid=foo.bar,ou=people,o=ls",
+    "name": "Foo Bar",
+    "messages": [
+        "Le mail de notification a \u00e9t\u00e9 envoy\u00e9.",
+        "L'objet a \u00e9t\u00e9 ajout\u00e9."
+    ]
+}
+
    +
    • +
+
    +
  • +

    /api/1.0/object/[object type]/[dn]/modify

    +

    Cette méthode permet de modifier un objet dans l'annuaire. Le type de l'objet et son DN sont +précisés dans l'URL et doivent être encodés en conséquence. Les informations de l'objet à +modifier doivent être transmises au même format que pour la méthode create (voir ci-dessus). +Comme pour cette dernière, seuls les attributs prévus dans le formulaire de modification du type +d'objet peuvent être passées ici et la réponse JSON pourra contenir un tableau fields_errors +contenant les erreurs générées par l'application au sujet des valeurs transmises pour les +attributs.

    +

    Exemple :

    +
    # curl -u username:secret 'https://ldapsaisie/api/1.0/object/LSpeople/uid=foo.bar,ou=people,o=ls/modify?pretty' -d "givenName=foo&sn=bar&cn=Foo Bar"
+{
+    "dn": "uid=foo.bar,ou=people,o=ls",
+    "type": "LSpeople",
+    "name": "Foo Bar",
+    "success": true,
+    "messages": [
+        "L'objet a bien \u00e9t\u00e9 modifi\u00e9."
+    ]
+}
+
    +
    • +
+
    +
  • +

    /api/1.0/object/[object type]/[dn]/remove

    +

    Cette méthode permet de supprimer un objet dans l'annuaire. Le type de l'objet et son DN sont +précisés dans l'URL et doivent être encodés en conséquence.

    +

    Exemple :

    +
    # curl -u username:secret 'https://ldapsaisie/api/1.0/object/LSpeople/uid=foo.bar,ou=people,o=ls/remove?pretty'
+{
+    "dn": "uid=foo.bar,ou=people,o=ls",
+    "type": "LSpeople",
+    "name": "Foo Bar",
+    "success": true,
+    "messages": [
+        "Foo Bar a bien \u00e9t\u00e9 supprim\u00e9."
+    ]
+}
+
    +
    • +
+
    +
  • +

    /api/1.0/object/[object type]/[dn]/customAction/[customAction]

    +

    Cette méthode permet d'exécuter une action personnalisée sur +un objet dans l'annuaire. Le nom de l'action ainsi que le type de l'objet et son DN sont précisés +dans l'URL et doivent être encodés en conséquence.

    +

    Exemple :

    +
    # curl -u username:secret 'https://ldapsaisie/api/1.0/object/LSpeople/uid=foo.bar,ou=people,o=ls/customAction/action?pretty'
+{
+    "dn": "uid=foo.bar,ou=people,o=ls",
+    "type": "LSpeople",
+    "name": "Foo Bar",
+    "success": true,
+    "messages": [
+        "L'action personnalis\u00e9e action a \u00e9t\u00e9 correctement ex\u00e9cut\u00e9e sur Foo Bar.",
+    ]
+}
+
    +
    +

    Note

    +

    Par défaut, une action personnalisée ne retourne qu'un booléen permettant de savoir si +l'action a correctement été exécutée ou non. En outre, dans un contexte d'appel via l'API, il +est possible de retourner des informations via un tableau associatif dont le contenu sera +fusionné avec les données retournées par la requête. Pour plus d'informations à ce sujet, +consultez la documentation sur l'écriture d'une fonction implémentant une customAction.

    +
    +
    • +
+
    +
  • +

    /api/1.0/object/[object type]/import

    +

    Cette méthode permet d'importer des objets d'un type en particulier à partir de données d'import +formatées selon un ioFormat configuré pour ce type +d'objets. Le type de l'objet est précisé dans l'URL et doit être encodé en conséquence. Par +mimétisme du comportement de l'interface web, cette méthode accepte des paramètres similaires et +s'attend à récupérer les données d'import dans le corps de la requête.

    +
      +
    • +

      ioFormat

      +

      Le nom de l'ioFormatdes données d'import.

      +
      • +
    +
      +
    • +

      updateIfExists

      +

      Booléen permettant d'activer/désactiver la mise à jour des données des objets s'ils existent +déjà. Si ce mode est inactif et qu'un objet des données d'import existe déjà, une erreur +sera remontée. Les valeurs acceptées sont 1 ou 0.

      +
      • +
    +
      +
    • +

      justTry

      +

      Booléen permettant d'activer/désactiver le mode de vérification des données d'import +uniquement. Si ce mode est actif, les données d'import seront analysées pour vérifier +qu'elles sont correctes, mais l'import en lui-même ne sera pas effectué. Les valeurs +acceptées sont 1 ou 0.

      +
      +

      Note

      +

      Le retour de cette méthode en mode justTry est identique à une exécution en mode +normal. Ce mode permet donc d'anticiper le résultat d'un import à partir d'un jeu de +données sources.

      +
      +
      +

      Warning

      +

      En mode justTry, seul la vérification syntaxique des données est fiable, car les +informations doublonnées au sein des données d'import ne pourront être détectées.

      +
      +
      • +
    +

    En cas d'erreurs détectées dans les informations des objets des données d'import, le tableau +errors du retour de la méthode contiendra une entrée pour chaque objet en erreur sous le +format d'un dictionnaire dont la clé data reprendra les informations de l'objet telle que +chargé (ou générée) depuis les données sources, ainsi qu'un dictionnaire sous la clé errors +qui contiendra les erreurs globales concernant l'objet sous la clé globals et les erreurs +propres à ses attributs dans un dictionnaire sous la clé attrs.

    +
    +

    Note

    +

    Les erreurs d'importation sur un objet sont non-bloquantes : l'importation des autres objets +ne sera pas interrompue.

    +
    +

    Exemple :

    +
    # curl -u username:secret --data-binary @/path/to/input.file 'https://ldapsaisie/api/1.0/object/LSpeople/import?ioFormat=mycsv&pretty'
+{
+    "success": false,
+    "LSobject": "LSpeople",
+    "ioFormat": "mycsv",
+    "updateIfExists": false,
+    "justTry": false,
+    "imported": {
+        "uid=rturin,ou=people,o=ls": "M. Roger TURIN"
+    },
+    "updated": [],
+    "errors": [
+        {
+            "data": {
+                "uid": [
+                    "lmartin"
+                ],
+                "personalTitle": [
+                    "Mme"
+                ],
+                "givenName": [
+                    "Ludivine"
+                ],
+                "sn": [
+                    "MARTIN"
+                ],
+                "mail": [
+                    "lmartin@gmail.com"
+                ],
+                "userPassword": [
+                    "123Yh%uT"
+                ],
+                "gidNumber": [
+                    "102009"
+                ],
+                "loginShell": [
+                    "no"
+                ],
+                "cn": [
+                    "Mme Ludivine MARTIN"
+                ]
+            },
+            "errors": {
+                "globals": [
+                    "Un objet existe d\u00e9j\u00e0 dans l'annuaire LDAP avec le DN uid=lmartin,ou=people,o=ls."
+                ],
+                "attrs": []
+            }
+        }
+    ],
+    "messages": [
+        "Le mail de notification a \u00e9t\u00e9 envoy\u00e9."
+    ]
+}
+
    +
    • +
+
    +
  • +

    /api/1.0/object/[object type]/export

    +

    Cette méthode permet d'exporter les objets d'un type en particulier dans un +ioFormat configuré pour ce type d'objets. Le type de +l'objet est précisé dans l'URL et doit être encodé en conséquence.

    +
      +
    • +

      ioFormat

      +

      Le nom de l'ioFormat .

      +
      • +
    +

    En tant normal, le retour de cette méthode sera directement le fichier d'export demandé. +Cependant, si une erreur survient, les paramètres d'export seront repris dans le retour JSON +de la méthode qui contiendra également les erreurs survenues.

    +

    Exemple :

    +
    # curl -u username:secret --data-binary @/path/to/input.file 'https://ldapsaisie/api/1.0/object/LSpeople/export?ioFormat=mycsv&pretty'
+login;civility;firstname;name;mail;password;gid;shell
+hmartin;M.;Henri;MARTIN;henri.martin@ls.com;********;102001;no
+s.ldapsaisie;M.;Secretariat;LdapSaisie;secretariat@ldapsaisie.biz;********;70000;no
+ls;M.;Ldap;Saisie;ldap.saisie@ls.com;********;102001;no
+erwpa;M.;Erwan;PAGEARD;erwan.page@ldapsaisie.biz;********;102009;no
+[...]
+
    +
    • +
+
    +
  • +

    /api/1.0/object/[object type]/[dn]/relation/[relation]

    +

    Cette méthode permet de gérer les objets en relation avec un objet en particulier de l'annuaire. +Le type de l'objet, son DN et le nom de la relation sont précisés dans l'URL et doivent être +encodés en conséquence. Cette méthode accepte les paramètres add et remove permettant de +lister le ou les DN d'objet(s) à respectivement ajouter ou supprimer parmis les objets +actuellement en relation avec l'objet spécifié. Si aucun DN n'est spécifié comme devant être +ajouté ou supprimé, la méthode retournera simplement les DN des objets en relation. En cas de +modification demandée, la méthode retournera la nouvelle liste des DNs des objets en relation, +quel que soit le résultat de l'opération de mise à jour.

    +

    Exemple :

    +
    # curl -u username:secret 'https://ldapsaisie/api/1.0/object/LSpeople/uid=foo.bar,ou=people,o=ls/relation/groups?pretty&add[]=cn=ls,ou=groups,o=ls&add[]=cn=invite,ou=groups,o=ls'
+{
+    "dn": "uid=foo.bar,ou=people,o=ls",
+    "type": "LSpeople",
+    "name": "Foo Bar",
+    "relation": "groups",
+    "success": true,
+    "relatedObjects": [
+        "cn=ls,ou=groups,o=ls",
+        "cn=invite,ou=groups,o=ls"
+    ],
+    "messages": [
+        "Objects in relation updated."
+    ]
+}
+
    +
    • +
+
    +
  • +

    /api/1.0/search

    +

    Cette méthode permet d'effectuer une recherche sur plusieurs types d'objets de l'annuaire à la +fois. Par mimétisme du comportement de l'interface web, la recherche est paginée et accepte des +paramètres similaires en plus de paramètre plus appropriés à un fonctionnement programmatique.

    +

    Les paramètres acceptés par cette méthode sont sensiblement les mêmes que ceux acceptés par la +méthode de recherche d'un type d'objet de l'annuaire en particulier et ils ne seront donc pas +tous redocumentés ici :

    +
      +
    • filter
      • +
    +
      +
    • predefinedFilter
      • +
    +
      +
    • pattern
      • +
    +
      +
    • approx
      • +
    +
      +
    • basedn
      • +
    +
      +
    • subDn
      • +
    +
      +
    • scope
      • +
    +
      +
    • recursive
      • +
    +
      +
    • displayFormat
      • +
    +
      +
    • extraDisplayedColumns
      • +
    +
      +
    • attributes
      • +
    +
      +
    • attributesDetails
      • +
    +
      +
    • page
      • +
    +
      +
    • all
      • +
    +
      +
    • as_list
      • +
    +
      +
    • withoutCache
      • +
    +
      +
    • keepParamsBetweenSearches
      • +
    +
      +
    • +

      nbObjectsByPage

      +

      Permet de préciser le nombre maximum d'objets retournés par type d'objet ET par page du résultat +de recherche.

      +
      • +
    +
      +
    • +

      types

      +

      Permet de limiter les types d'objets à inclure dans le résultat de recherche. Par défaut, tous +les types d'objets auxquels l'utilisateur à accès et dont la recherche globale n'est pas +désactivée seront inclus.

      +
      • +
    +
      +
    • +

      splited_result

      +

      Permet de faire en sorte que les objets inclus dans le résultat de recherche soient séparés par +type dans des sous-clés de objects. Par défaut, tous les objets sont retournés dans la clé +objects et une sous-clé type est ajouté à chacun d'eux pour les distinguer. Seul la présence +de ce paramètre suffit à activer ce comportement, sa valeur n'a pas d'importance.

      +
      • +
    +
    • +
+
+

Important

+

Pour chaque type d'objets inclus dans la recherche, un filtre et/ou un mot clé de recherche +doit être spécifié. Cette méthode n'a pas vocation à permettre de lister tous les objets de +l'annuaire.

+
+

Exemple :

+
# curl -u username:secret 'https://ldapsaisie/api/1.0/search?pattern=LdapSaisie&pretty'
+{
+    "success": true,
+    "objects": {
+        "uid=s.ldapsaisie,ou=people,o=ls": {
+            "name": "Secretariat LdapSaisie",
+            "type": "LSpeople",
+            "Mail": "secretariat@ldapsaisie.biz"
+        },
+        "uid=ls,ou=people,o=ls": {
+            "name": "LdapSaisie",
+            "type": "LSpeople",
+            "Mail": "ldap.saisie@ls.com"
+        },
+        "uid=erwpa,ou=people,o=ls": {
+            "name": "Erwan PAGE",
+            "type": "LSpeople",
+            "Mail": "erwan.page@ldapsaisie.biz"
+        },
+        "uid=invite,ou=people,o=ls": {
+            "name": "Utilisateur de passage",
+            "type": "LSpeople",
+            "Mail": "invite@ldapsaisie.biz"
+        },
+        "uid=demo,ou=people,o=ls": {
+            "name": "Demonstration LdapSaisie",
+            "type": "LSpeople",
+            "Mail": "demo@ls.com"
+        },
+        "uid=admin,ou=people,o=ls": {
+            "name": "Administration LdapSaisie",
+            "type": "LSpeople",
+            "Mail": "admin@ls.com"
+        },
+        "uid=admin3,ou=people,o=ls": {
+            "name": "ZAdministration LdapSaisie",
+            "type": "LSpeople",
+            "Mail": "admin@ls.com"
+        },
+        "uid=ldapsaisie,ou=sysaccounts,o=ls": {
+            "name": "ldapsaisie",
+            "type": "LSsysaccount"
+        }
+    },
+    "total": null,
+    "params": {
+        "keepParamsBetweenSearches": false,
+        "LSpeople": {
+            "filter": null,
+            "pattern": "LdapSaisie",
+            "predefinedFilter": false,
+            "basedn": null,
+            "scope": null,
+            "sizelimit": 0,
+            "attronly": false,
+            "approx": false,
+            "recursive": true,
+            "attributes": [],
+            "onlyAccessible": true,
+            "sortDirection": null,
+            "sortBy": null,
+            "sortlimit": 0,
+            "displayFormat": "%{cn}",
+            "nbObjectsByPage": 25,
+            "withoutCache": false,
+            "extraDisplayedColumns": true
+        },
+        "LSsysaccount": {
+            "filter": null,
+            "pattern": "LdapSaisie",
+            "predefinedFilter": false,
+            "basedn": null,
+            "scope": null,
+            "sizelimit": 0,
+            "attronly": false,
+            "approx": false,
+            "recursive": false,
+            "attributes": [],
+            "onlyAccessible": true,
+            "sortDirection": null,
+            "sortBy": null,
+            "sortlimit": 0,
+            "displayFormat": "%{uid}",
+            "nbObjectsByPage": 30,
+            "withoutCache": false,
+            "extraDisplayedColumns": true
+        }
+    },
+    "page": 1,
+    "nbPages": 1
+}
+

Contribution

Contribution

+

Comme tout projet libre qui se respecte, les contributions à LdapSaisie sont les bienvenues. Ce +chapitre explique les possibilités de contribution.

Les addons (LSaddon)

Les addons (LSaddon)

+

Les LSaddons sont utilisés pour implémenter dans LdapSaisie +des fonctionnalités spécifiques tel que :

+
    +
  • le support d'une famille d'attributs spécifiques (POSIX, Samba, SUPANN…) par le biais de méthodes + de génération de la valeur de ces attributs par exemple (paramètre generate_function) ;
    • +
+
    +
  • des tâches communes et génériques (envoi de mails, connexion FTP/SSH…) ;
    • +
+
    +
  • l'implémentation de déclencheurs spécifiques à votre environnement : + création automatique du dossier client sur le serveur de fichiers de l'entreprise, création de la + boite mail de l'utilisateur… ;
    • +
+ +
    +
  • l'implémentation d'action personnalisée sur les objets (synchronisation, + archivage…) ou sur les résultats de recherches + (export, rapport personnalisé…) ;
    • +
+

Structure d'écriture

+

L'écriture d'un LSaddon doit respecter une structure +suffisamment souple afin de ne pas être un frein à vos contributions, tout en permettant d'assurer +la bonne intégration de votre contribution au projet. Le code que vous écrirez sera réparti dans +deux fichiers :

+
    +
  • +

    conf/LSaddons/config.LSaddons.[addon name].php

    +

    Ce fichier contiendra la configuration de votre LSaddon. +On y retrouvera la déclaration de constances et/ou variables de configuration permettant d'adapter +votre LSaddon à une installation et à un environnement.

    +
    • +
+
    +
  • +

    includes/addons/LSaddons.[addon name].php

    +

    Ce fichier contiendra le code à proprement dit de votre LSaddon.

    +

    Structure du fichier includes/addons/LSaddons.[addon name].php :

    +
    <?php
+
+/*
+ * Error messages
+ */
+
+// Support error messages
+LSerror :: defineError('MYADDON_SUPPORT_01',
+  ___("MYADDON Support :  Unable to load %{dep}.")
+);
+
+LSerror :: defineError('MYADDON_SUPPORT_02',
+  ___("MYADDON Support : The constant %{const} is not defined.")
+);
+
+// Other orror messages
+LSerror :: defineError('MYADDON_01',
+  ___("An error : %{msg}.")
+);
+
+LSerror :: defineError('MYADDON_02',
+  ___("An other error about %{about} : %{msg}")
+);
+
+LSerror :: defineError('MYADDON_03',
+  ___("Unknown error.")
+);
+
+/**
+ * Verify support of my addon by LdapSaisie
+ *
+ * @author My Name <my.email@example.com>
+ *
+ * @return boolean true if my addon is totaly supported, false in other cases
+ **/
+function LSaddon_myaddon_support() {
+
+  $retval=true;
+
+  // Check/load dependencies
+  if ( !class_exists('mylib') ) {
+    if ( !LSsession::includeFile(LS_LIB_DIR . 'class.mylib.php') ) {
+      LSerror :: addErrorCode('MYADDON_SUPPORT_01', 'mylib');
+      $retval=false;
+    }
+  }
+
+
+  $MUST_DEFINE_CONST= array(
+    'LS_MYADDON_CONF_O1',
+    'LS_MYADDON_CONF_O2',
+    ...
+  );
+
+  foreach($MUST_DEFINE_CONST as $const) {
+    if ( (!defined($const)) || (constant($const) == "")) {
+      LSerror :: addErrorCode('MYADDON_SUPPORT_02',$const);
+      $retval=false;
+    }
+  }
+
+  if ($retval) {
+      // Register LSaddon view using LSsession :: registerLSaddonView()
+
+      if (php_sapi_name() == 'cli') {
+          // Register LSaddon CLI command using LScli :: add_command()
+      }
+  }
+
+  return $retval;
+}
+
+/**
+ * My first function
+ *
+ * Description of this wonderfull function
+ *
+ * @author My Name <my.email@example.com>
+ *
+ * @return [type(s) of returned values (pipe separator)] Description of the return of this function
+ **/
+function myaddon_first_function($arg1, $arg2) {
+  // Do some stuff
+  if (something) {
+    LSerror :: addErrorCode(
+      'MYADDON_01',
+      'something went wrong'    // Error LSformat unique argument
+    );
+    return false;
+  }
+
+  if (something else) {
+    LSerror :: addErrorCode(
+      'MYADDON_02',
+      array(                    // Error LSformat arguments
+        'about' => 'second step',
+        'msg' => 'something went wrong'
+      )
+    );
+    return false;
+  }
+
+  if (still something else) {
+    LSerror :: addErrorCode('MYADDON_03'); // Error without argument
+    return false;
+  }
+  return true;
+}
+
+[...]
+
+// Defined custom CLI commands functions only on CLI context
+if (php_sapi_name() != 'cli')
+    return true;  // Always return true to avoid some warning in log
+
+// Defined functions handling custom CLI commands and optionnaly
+// their arguments autocompleter functions.
+
    +
    • +
+

Par convention, la structure de ce fichier est toujours à peu près la même:

+
    +
  • On déclare tout d'abord les messages d'erreurs qui seront potentiellement émis par notre + LSaddon en commençant par les messages d'erreurs liés au + support de cet LSaddon. On utilise pour cela la méthode + LSerror :: defineError() qui attends en premier argument, l'identifiant du message + d'erreur et en tant que second argument, le + LSformat du message d'erreur. Par convention, + les identifiants des messages d'erreurs seront en majuscule et préfixés du nom du + LSaddon.
    • +
+
    +
  • +

    On déclare ensuite une fonction LSaddon_[myaddon]_support qui sera exécutée lors du chargement + de l'addon et qui permettra de s'assurer du support de celui-ci. Cette fonction devra retourner + True si c'est le cas ou False dans le cas contraire.

    +

    Cette fonction s'assura notamment :

    + +
    • +
+
    +
  • On déclare ensuite les fonctions, classes et éléments fournis et manipulés par l'addon.
    • +
  • +

    Si notre addon offre des commandes CLI personnalisées, les + fonctions les implémentant ne seront définies, dans un souci de performance, que dans un contexte + ou elles seraient potentiellement appelables, c'est à dire dans un contexte d'exécution CLI. + Pour cela, nous utilisons communément la fonction php_sapi_name pour déterminer le contexte + d'exécution et si celui-ci vaut cli, nous stoppons l'exécution du reste du code du fichier via + un return true.

    +
    +

    Note

    +

    Il est important dans ce contexte de ne jamais retourner autre chose que True pour éviter +tout message d'erreur inutile dans les logs.

    +
    +
    • +
+
    +
  • On déclare, pour finir, les fonctions implémentant les + commandes CLI personnalisées et leur éventuelle fonction + gérant l'autocomplétion des arguments qu'elles acceptent.
    • +

Les vues personnalisées

+

Les LSaddons peuvent fournir des vues personnalisées qui +seront accessibles à tout ou parties des utilisateurs de l'application. Ce filtrage d'accès sera +fait en utilisant les LSprofiles de +l'utilisateur connecté sur la +racine courante de l'annuaire LDAP.

+

Pour mettre en place une telle vue personnalisée, il est nécessaire de :

+
    +
  • Déclarer cette vue dans la fonction LSaddon_[addon]_support de l'addon à l'aide de la méthode + LSsession :: registerLSaddonView() ;
    • +
+
    +
  • Déclarer la fonction implémentant cette vue. Cette fonction n'acceptera aucun paramètre et ne + retournera rien. Elle devra en outre s'occuper de définir son fichier template et charger les + dépendances de ce dernier (fichiers CSS & JS, variables...).
    • +
+

Pour implémenter une telle vue personnalisée, vous pouvez vous inspirer de l'exemple fourni +ci-dessous ou encore des vues fournies par les autres +LSaddons (par exemple, l'addon +exportSearchResultAsCSV).

+

Structure du fichier includes/addons/LSaddons.[addon name].php :

+
<?php
+function LSaddon_myaddon_support() {
+
+  $retval=true;
+
+  // Some check
+
+  if ($retval) {
+      $retval = LSsession :: registerLSaddonView(
+          'myaddon',          // addon name
+          'myaddon_view',     // addon view ID
+          __('MyAddon view'), // addon view label
+          'myaddon_view',     // callable (ex: function name) that implement addon view
+          array('user'),      // array listing allowed LSprofiles
+          true                // Show/hide this addon view in user menu
+      );
+  }
+
+  return $retval;
+}
+
+[...]
+
+/**
+ * My addon view handler function
+ *
+ * Description of this view
+ *
+ * @author My Name <my.email@example.com>
+ *
+ * @return void
+ **/
+function myaddon_view() {
+    // Do some stuff and set some template variables
+    $list = array ([...]);
+    LStemplate :: assign('list', $list);
+
+    // Load some CSS & JS files need on this view
+    LStemplate :: addCssFile('LSaddon_myadon.css');
+    LStemplate :: addJSscript('LSaddon_myadon.js');
+
+    // Set template file of the view
+    LSsession :: setTemplate('LSaddon_myadon_view.tpl');
+}
+

Les commandes CLI personnalisées

+

Les LSaddons peuvent fournir des commandes CLI +personnalisées qui seront accessibles via la commande ldapsaisie fournie avec l'application. Cela +peut, par exemple, vous permettre de rendre accessible en ligne de commandes une procédure +implémentée dans le code d'LdapSaisie et vous permettre de mettre en place une tâche planifiée +exécutant cette procédure régulièrement.

+

Pour mettre en place une telle commande CLI personnalisée, il est nécessaire de :

+
    +
  • Déclarer cette vue dans la fonction LSaddon_[addon]_support de l'addon à l'aide de la méthode + LScli :: add_command() ;
    • +
+
    +
  • Déclarer la fonction implémentant cette commande CLI personnalisée. Cette fonction acceptera, + en tant qu'unique paramètre, un tableau des arguments reçus lors de l'exécution de la commande et + retournera True ou False en cas de succès/d'erreur d'exécution de la commande. Cette valeur de + retour influencera le code retourné par la commande : 0 en cas de succès, 1 en cas d'erreur.
    • +
+
    +
  • +

    Bien que cela ne soit pas obligatoire, il sera également possible de déclarer une fonction + permettant l'autocomplétion des arguments acceptés par la commande.

    +

    Cette méthode recevra en paramètre :

    +
      +
    • +

      $command_args

      +

      Un tableau des arguments déjà reçus par la commande.

      +
      • +
    +
      +
    • +

      $comp_word_num

      +

      Un entier indiquant le rang de l'argument que l'autocomplétion tente de compléter. Il peut +s'agir du rang d'un paramètre déjà fourni et présent dans le tableau $command_args ou bien +d'un rang supérieur aux nombres d'arguments déjà fournis à la commande et dans ce cas il s'agira +d'autocompléter tous potentiels autre argument que pourrait accepter cette commande.

      +
      • +
    +
      +
    • +

      $comp_word

      +

      Une chaîne de caractères correspondant à ce qu'a déjà saisi l'utilisateur de l'argument que l'on +tente d'autocompléter. Cette chaîne de caractères peut être vide ou non, en fonction de s'il +s'agit d'un nouvel argument à autocompléter ou non.

      +
      • +
    +
      +
    • +

      $opts

      +

      Un tableau des potentiels arguments globaux acceptés par LScli dans le contexte actuel (par +exemple, -d ou --debug pour l'activation du mode debug). La réponse de cette fonction devra +inclure ces potentiels arguments si le contexte d'autocomplétion si prête (nouvel argument par +exemple).

      +
      • +
    +

    Pour finir, cette fonction devra retourner un tableau des potentielles valeurs que pourrait +prendre l'argument autocomplété. Si une unique proposition est faite à l'utilisateur, celle-ci +sera automatiquement proposée à l'utilisateur et à défaut, la liste des valeurs possibles lui +seront affichées.

    +
    +

    Note

    +

    Pour vous aider dans l'écrire d'une telle méthode d'autocomplétion, des méthodes statiques +sont fournies par la classe LScli pour les autocomplétions les plus courantes :

    +
      +
    • LScli :: autocomplete_class_name()
      • +
    +

    Autocomplétion du nom d'une classe PHP.

    +
      +
    • LScli :: autocomplete_addon_name()
      • +
    +

    Autocomplétion du nom d'un LSaddon.

    +
      +
    • LScli :: autocomplete_int()
      • +
    +

    Autocomplétion d'un nombre entier.

    +
      +
    • LScli :: autocomplete_LSobject_types()
      • +
    +

    Autocomplétion du nom d'un type d'LSobject.

    +
      +
    • LScli :: autocomplete_LSobject_dn()
      • +
    +

    Autocomplétion du DN d'un type précis d'LSobject de + l'annuaire.

    +

    Par ailleurs, la méthode LScli :: autocomplete_opts() vous facilitera la construction de la +liste des valeurs d'autocomplétion de l'argument courant en fonction de ce qui a déjà été +saisi par l'utilisateur (paramètre $comp_word). Cette méthode s'occupera en l'occurrence de +filtrer parmi toutes les valeurs contextuelles possibles, celles qui correspondent au préfixe +fourni par l'utilisateur.

    +
    +
    • +
+

Pour implémenter une telle commande CLI personnalisée, vous pouvez vous inspirer de l'exemple +fourni ci-dessous ou encore des commandes CLI fournies par les autres +LSaddons ou classes PHP de l'application.

+

Structure du fichier includes/addons/LSaddons.[addon name].php :

+
<?php
+function LSaddon_myaddon_support() {
+
+  $retval=true;
+
+  // Some check
+
+  if ($retval) {
+    if (php_sapi_name() == 'cli') {
+        LScli :: add_command(
+          'my_custom_cli_cmd',                    // The CLI command name (required)
+          'cli_my_custom_cli_cmd',                // The CLI command handler (must be callable, required)
+          'My custom CLI command',                // A short description of what this command does (required)
+          '[arg1] [arg2] [...]',                  // A short list of commands available arguments show in usage message
+                                                  // (optional, default: false)
+          'This command permit to ...',           // A long description of what this command does (optional, default:
+                                                  // false)
+          true,                                   // Permit to define if this command need connection to LDAP server
+                                                  // (optional, default: true)
+          'cli_my_custom_cli_cmd_autocompleter',  // Callable of the CLI command arguments autocompleter (optional,
+                                                  // default: null)
+          true                                    // Allow override if a command already exists with the same name
+                                                  // (optional, default: null)
+        );
+    }
+  }
+
+  return $retval;
+}
+
+[...]
+
+// Defined CLI commands functions only on CLI context
+if (php_sapi_name() != 'cli')
+    return true;  // Always return true to avoid some warning in log
+
+/**
+ * My addon CLI command my_custom_cli_cmd handler function
+ *
+ * Description of this CLI command.
+ *
+ * @param array $command_args Command arguments
+ *   - Positional arguments :
+ *     - LSobject
+ *     - dn
+ *   - Optional arguments :
+ *     - -f|--force : Force mode
+ *
+ * @author My Name <my.email@example.com>
+ *
+ * @return boolean True on success, false otherwise
+ **/
+function cli_my_custom_cli_cmd($command_args) {
+    $objType = null;
+    $dn = null;
+    $force_mode = false;
+    foreach ($command_args as $arg) {
+      if ($arg == '-f' || $arg == '--force')
+        $force_mode = true;
+      elseif (is_null($objType)) {
+        $objType = $arg;
+      }
+      elseif (is_null($dn)) {
+        $dn = $arg;
+      }
+      else
+        LScli :: usage("Invalid $arg parameter.");
+    }
+
+    if (is_null($objType) || is_null($dn))
+      LScli :: usage('You must provide LSobject type and DN.');
+
+    if (!LSsession :: loadLSobject($objType))
+      return false;
+
+    $obj = new $objType();
+    if (!$obj->loadData($dn)) {
+      self :: log_fatal("Fail to load object $dn data from LDAP");
+      return false;
+    }
+
+    // Do some stuff on loaded object
+    [...]
+
+    return true;
+}
+
+/**
+ * Args autocompleter for CLI my_custom_cli_cmd command
+ *
+ * @param array<string> $command_args List of already typed words of the command
+ * @param int $comp_word_num The command word number to autocomplete
+ * @param string $comp_word The command word to autocomplete
+ * @param array<string> $opts List of global available options
+ *
+ * @return array<string> List of available options for the word to autocomplete
+ **/
+public static function cli_my_custom_cli_cmd_autocompleter($command_args, $comp_word_num, $comp_word, $opts) {
+  $opts = array_merge($opts, array ('-f', '--force'));
+
+  // Handle positional args
+  $objType = null;
+  $objType_arg_num = null;
+  $dn = null;
+  $dn_arg_num = null;
+  for ($i=0; $i < count($command_args); $i++) {
+    if (!in_array($command_args[$i], $opts)) {
+      // If object type not defined
+      if (is_null($objType)) {
+        // Defined it
+        $objType = $command_args[$i];
+        LScli :: unquote_word($objType);
+        $objType_arg_num = $i;
+
+        // Check object type exists
+        $objTypes = LScli :: autocomplete_LSobject_types($objType);
+
+        // Load it if exist and not trying to complete it
+        if (in_array($objType, $objTypes) && $i != $comp_word_num) {
+          LSsession :: loadLSobject($objType, false);
+        }
+      }
+      elseif (is_null($dn)) {
+        $dn = $command_args[$i];
+        LScli :: unquote_word($dn);
+        $dn_arg_num = $i;
+      }
+    }
+  }
+
+  // If objType not already choiced (or currently autocomplete), add LSobject types to available options
+  if (!$objType || $objType_arg_num == $comp_word_num)
+    $opts = array_merge($opts, LScli :: autocomplete_LSobject_types($comp_word));
+
+  // If dn not alreay choiced (or currently autocomplete), try autocomplete it
+  elseif (!$dn || $dn_arg_num == $comp_word_num)
+    $opts = array_merge($opts, LScli :: autocomplete_LSobject_dn($objType, $comp_word));
+
+  return LScli :: autocomplete_opts($opts, $comp_word);
+}
+

Ended: Les addons (LSaddon)

Les éléments des formulaires (LSformElement)

+

Les LSformElements sont les types de champs de formulaire supportés par +l'application.

+

Pour chaque type implémenté, on devra trouver :

+
    +
  • Une classe PHP dérivée de la classe LSattr_html et devant s'appeler + LSattr_html_[nom du type d'attribut HTML]. Dans celle-ci, il devra être défini à minima la + variable de classe LSformElement_type permettant de référencer le type + d'LSformElement à utiliser ;
    • +
+
    +
  • +

    Une classe PHP dérivée de la classe LSformElement et devant s'appeler + LSformElement_[nom du type d'LSformElement]. Cette classe implémentera tout ce qui concerne + l'affichage du champ dans le formulaire et le traitement d'une valeur retournée par ce dernier. + Cela concerne notamment les méthodes suivantes :

    +
      +
    • +

      getDisplay()

      +

      Retourne les informations d'affichage du champ dans un formulaire sous la forme d'un tableau +(implémentation obligatoire, pas de méthode par défaut). Il sera possible de s'appuyer sur la +méthode getLabelInfos() permettant de générer et récupérer tout ce qui concerne le label du +champ du formulaire. Il faudra cependant à minima fournir également la clé html dans le +tableau retourné qui devra contenir le bout de code HTML correspondant au champ du formulaire. +Communément, ce code HTML est généré en appelant la méthode fetchTemplate().

      +
      • +
    +
      +
    • +

      fetchTemplate()

      +

      Retourne le code HTML du champ dans le formulaire. L'implémentation de cette méthode est +facultative et par défaut, cette méthode utilisera la variable de classe $template pour +connaître le fichier de template à utiliser. Ce fichier de template permettra la génération de +la liste de tous les champs associés à chacune des valeurs de l'attribut. Individuellement, le +champ d'une des valeurs de l'attribut est généré à l'aide du fichier de template référencé dans +la variable de class $fieldTemplate.

      +
      +

      Note

      +

      La variable de classe $fieldTemplate est également utilisée par la méthode +LSformElement :: getEmptyField() qui sert à générer le code HTML d'un champ du formulaire +pour une nouvelle valeur de l'attribut. Cette méthode est notamment utilisée lorsque l'on +clique sur le bouton permettant d'ajouter une valeur à un champ du formulaire.

      +
      +
      • +
    +
      +
    • +

      getPostData()

      +

      Récupère dans les données postées par le formulaire, celle concernant ce champ. Cette méthode +devra potentiellement traiter l'ensemble des valeurs de l'attribut envoyées par le formulaire +et les définir dans le tableau passé en référence en tant que premier argument, les valeurs de +l'attribut. L'implémentation de cette méthode est facultative et par défaut, un tableau de +valeurs portant le nom de l'attribut LDAP correspondant sera récupérée comme valeur de +l'attribut.

      +
      +

      Note

      +

      Pour plus d'informations sur le rôle et fonctionnement de cette méthode, référer à la +méthode par défaut, définie dans la classe PHP parente LSformElement.

      +
      +
      • +
    +
      +
    • +

      setValueFromPostData()

      +

      Définit les valeurs de l'attribut à partir des données reçues du formulaire (et récupérées par +la méthode getPostData). L'implémentation de cette méthode est facultative et par défaut, +aucune transformation ne sera faites à cette étape sur les données récupérées depuis le +formulaire. Implémenter cette méthode pourra cependant se révéler utile en cas de champs de +formulaire complexe (attribut composite par exemple).

      +
      • +
    +
      +
    • +

      autocomplete_attr_values()

      +

      Génère de la liste des valeurs possibles de l'attribut dans un contexte CLI.

      +
      +

      Note

      +

      Pour plus d'informations sur le rôle et fonctionnement de cette méthode, référer aux +commentaires de la méthode par défaut, définie dans la classe PHP parente LSformElement. +Vous pouvez également vous inspirer des exemples d'implémentations fournies avec les autres +type d'LSformElement.

      +
      +
      • +
    +
    • +
+
    +
  • Un (ou plusieurs) fichier template pour la génération du code HTML du champ du formulaire. + Communément, le fichier LSformElement.tpl est utilisé pour générer la structure de la liste des + champs correspondant aux différentes valeurs de l'attribut. Ce template utilise une variable + $fieldTemplate pour définir quel fichier template devra être utilisé pour générer le code HTML + de chaque champ associés à une valeur. C'est ce second fichier de template qui est en général à + fournir à minima avec votre LSformElement.
    • +
+
+

Note

+

Il peut être utile d'étendre un type d'LSformElement existant pour faciliter +l'implémentation d'un nouveau type. Pour cela, vous devez utiliser l'héritage de classe PHP en +faisant dériver vos nouvelles classes des classes du LSformElement dont vous +vous inspirer, plutôt que les classes génériques. Vous pouvez prendre exemple sur le type +d'LSformElement pre qui s'inspire du type textarea, ou encore du type +url dérivé du type text.

+

Les règles de validation syntaxiques (LSformRule)

+

Les LSformRules sont les règles syntaxiques applicables aux champs des formulaires. +Ces règles serviront à s'assurer que les valeurs des champs récupérées des formulaires sont +syntaxiquement correctes. Elles seront configurables via le paramètre check_data des attributs des +LSobjects.

+

Pour chaque type implémenté, on trouvera une classe PHP dérivée de la classe LSformRule et devant +s'appeler LSattr_rule_[nom du type]. Dans celle-ci, il devra être défini la méthode statique +validate() qui implémentera le contrôle syntaxique. Cette méthode prendra en paramètres :

+
    +
  • +

    $value

    +

    La valeur à tester.

    +
    • +
+
    +
  • +

    $options

    +

    Un tableau des options définies dans la configuration pour ce contrôle syntaxique.

    +
    • +
+
    +
  • +

    $formElement

    +

    Une référence au champ du formulaire (objet LSformElement).

    +
    • +
+

Cette méthode devra retourner True ou False si la valeur testée est respectivement valide ou +invalide. Elle pourra également déclencher une exception LSformRuleException qui lui permettra de +donner des messages d'erreurs elle-même sur le(s) problème(s) detecté(s) durant l'analyse de la +valeur passée. Le constructeur de ce type d'exception prend en tant que premier paramètre un tableau +de messages d'erreurs (ou un simple message d'erreur) qui seront retournés à l'utilisateur.

+
+

Note

+

Par défaut, les valeurs de l'attribut sont testées une à une via la méthode validate(). +Cependant, il est possible d'implémenter une méthode de validation pour toutes les valeurs de +l'attribut en une seule fois en affectant la valeur false à la constante de classe +validate_one_by_one. Dans ce cas, l'ensemble des valeurs de l'attribut seront passées via le +paramètre $value à la méthode validate() (sous la forme d'un tableau). Cela pourra par +exemple être utile pour implémenter une validation de la cohérence des valeurs les unes vis à +vis des autres (unicité, nombre maximum de valeurs, …).

+

Ended: Contribution

+
+
+ +
+
+ +
+
+
+
+ + + + \ No newline at end of file diff --git a/doc/dist/4.2.0-1-30-g6646ca9/LdapSaisie.pdf b/doc/dist/4.2.0-1-30-g6646ca9/LdapSaisie.pdf new file mode 100644 index 0000000000000000000000000000000000000000..932d509f025e5c867218b84f73068330e99c907d GIT binary patch literal 1652828 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