Skip to content

mod_vcard

Module Description

This module provides support for vCards, as specified in XEP-0054: vcard-temp and XEP-0055: Jabber Search.

Options

modules.mod_vcard.iqdisc.type

  • Syntax: string, one of "one_queue", "no_queue", "queues", "parallel"
  • Default: "parallel"

Strategy to handle incoming stanzas. For details, please refer to IQ processing policies.

modules.mod_vcard.host

  • Syntax: string
  • Default: "vjud.@HOST@"
  • Example: host = "vjud.@HOST@"

Domain of the vCard User Directory, used for searching. @HOST@ is replaced with the domain(s) supported by the cluster.

modules.mod_vcard.search

  • Syntax: boolean
  • Default: true
  • Example: search = false

Enables/disables the domain set in the previous option. false makes searching for users impossible.

modules.mod_vcard.backend

  • Syntax: string, one of "ldap", "rdbms", "mnesia"
  • Default: "mnesia"
  • Example: backend = "rdbms"

vCard storage backend.

Warning

LDAP backend is read-only.

modules.mod_vcard.matches

  • Syntax: non-negative integer or the string "infinity"
  • Default: 30
  • Example: matches = 10

Maximum search results to be returned to the user.

LDAP-specific options

The following options are the same as for the LDAP authentication module:

modules.mod_vcard.ldap.pool_tag

modules.mod_vcard.ldap.base

modules.mod_vcard.ldap.uids

modules.mod_vcard.ldap.filter

modules.mod_vcard.ldap.deref

modules.mod_vcard.ldap.vcard_map

  • Syntax: Array of TOML tables with the following keys: "vcard_field", "ldap_pattern", "ldap_field" and string values.
  • Default: see description
  • Example: vcard_map = [{vcard_field = "FN", ldap_pattern = "%s", ldap_field = "displayName"}]

Mappings between VCard and LDAP fields. For the default settings, please see [MongooseIM root]/src/mod_vcard_ldap.erl.

modules.mod_vcard.ldap.search_fields

  • Syntax: Array of TOML tables with the following keys: "search_field", "ldap_field" and string values.
  • Default: see description
  • Example: search_fields = [{search_field = "User", ldap_field = "%u"}]

Mappings between the human-readable search fields and LDAP fields. For the default settings, please see [MongooseIM root]/src/mod_vcard_ldap.erl.

modules.mod_vcard.ldap.search_reported

  • Syntax: Array of TOML tables with the following keys: "search_field", "vcard_field" and string values.
  • Default: see description
  • Example: search_reported = [{search_field = "Full Name", vcard_field = "FN"}]

Mappings between the human-readable search fields and VCard fields. For the default settings, please see [MongooseIM root]/src/mod_vcard_ldap.erl.

modules.mod_vcard.ldap.search_operator

  • Syntax: string, one of "or", "and"
  • Default: "and"
  • Example: search_operator = "or"

A default operator used for search query items.

modules.mod_vcard.ldap.binary_search_fields

  • Syntax: array of strings
  • Default: []
  • Example: binary_search_fields = ["User", "Full Name"]

An array of search fields, which values should be Base64-encoded by MongooseIM before sending to LDAP.

Example Configuration

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
[modules.mod_vcard]
  matches = 1
  search = true
  host = "directory.example.com"

  [[modules.mod_vcard.ldap.vcard_map]]
    vcard_field = "FAMILY"
    ldap_pattern = "%s"
    ldap_field = "sn"

  [[modules.mod_vcard.ldap.vcard_map]]
    vcard_field = "FN"
    ldap_pattern = "%s"
    ldap_field = "displayName"

  [[modules.mod_vcard.ldap.search_fields]]
    search_field = "User"
    ldap_field = "%u"

  [[modules.mod_vcard.ldap.search_fields]]
    search_field = "Full Name"
    ldap_field = "displayName"

  [[modules.mod_vcard.ldap.search_reported]]
    search_field = "Full Name"
    vcard_field = "FN"

  [[modules.mod_vcard.ldap.search_reported]]
    search_field = "Given Name"
    vcard_field = "FIRST"

Metrics

If you'd like to learn more about metrics in MongooseIM, please visit MongooseIM metrics page.

Backend action Description (when it gets incremented)
set_vcard A vCard is set in a DB.
get_vcard A specific vCard is retrieved from a DB.
search A vCard search is performed.