Mail::...rConfig(3pm)

📦
version 2.05 · 6 versions
, in debian trixie, ubuntu questing

💖 Mail::MtPolicyd::Plugin::LdapUserConfig 💖

okay bestie, so this is a page from the User Contributed Perl Documentation, filed under the manual name Mail::...rConfig(3pm) (yes it's truncated, no that's not my fault, that's just how the header rolled). anyway. sit down, grab a strawberry 🍓, we're gonna talk about the mtpolicyd plugin that goes and fetches your per-user config out of LDAP.

✨ NAME ✨

Mail::MtPolicyd::Plugin::LdapUserConfig — it's an mtpolicyd plugin, and its whole job is retrieving per user configuration from LDAP. that's it, that's the girlboss job description. 💅

✨ VERSION ✨

version 2.05 — locked in, no cap.

✨ SYNOPSIS ✨

here's the vibe, literally just copy it:

ldap_host="localhost"
ldap_binddn="cn=readonly,dc=domain,dc=com"
ldap_password="secret"

<Plugin user_config>
  module="LdapUserConfig"
  basedn="ou=users,dc=domain,dc=com"
  filter="(mail=%s)"
  filter_field="sasl_username"
  config_fields="mailMessageLimit,mailSendExternal"
</Plugin>

look at her. main character energy. 🌟

✨ DESCRIPTION ✨

so this plugin could be used to retrieve session variables/user configuration from a LDAP server. that's the whole plot. you point it at LDAP, it pulls back your per-user config, everyone eats. 🍽️

✨ PARAMETERS ✨

🫶 heads up bestie: the LDAP connection must be configured in the global configuration section of mtpolicyd. see mtpolicyd. it does not live in the plugin block, okay? it lives globally. iykyk.
  • basedn — default: ''. this is the basedn to use for the search. that's where we're looking, girl. 🔍
  • filter — required. the filter to use for the search. and the pattern %s will be replaced with the content of filter_field. so %s is the little placeholder slot and filter_field is what gets poured into it. 🌸
  • filter_field — required. the content of this request field will be used to replace %s in the filter string. so like, whatever this field holds, that's what fills the hole. 🎀
  • config_fields — required. a comma separated list of LDAP attributes to retrieve and copy into the current mtpolicyd session. yes, comma separated. don't get cute with it. 🦋

✨ AUTHOR ✨

Markus Benning <ich@markusbenning.de> — the author, the icon, the legend. 👑

This software is Copyright (c) 2014 by Markus Benning <ich@markusbenning.de>.

This is free software, licensed under:

The GNU General Public License, Version 2, June 1991

periodt. GPLv2, we respect her. 💜

and that's the whole page, bestie! this one was rendered by perl v5.38.2 and dated 2024-05-26, so if you're reading it in some distant future era, just know she was fresh on that day. bye mwah 🎀✨💖

📦 where this page comes from