The proprietary join request control can be included in a search request to indicate that each search result entry may include a corresponding join result control with information from one or more other entries that are in some way related to (for example, “joined with”) that search result entry. The control has an OID of 1.3.6.1.4.1.30221.2.5.9, and it takes a value. The following fields may be present in the value-json representation of the value:

The main criteria used to identify entries that should be joined with each search result entry is specified using the join rule. The supported join rule types are:

The following sample shows the JSON encoding for the control:

{ 
    "oid":"1.3.6.1.4.1.30221.2.5.9",
    "control-name":"Join Request Control",
    "criticality":false,
    "value-json": { 
        "join-rule": { 
            "type":"dn",
            "attribute":"manager" 
        },
        "base-dn-type":"use-custom-base-dn",
        "base-dn-value":"ou=People,dc=example,dc=com",
        "scope":"wholeSubtree",
        "size-limit":10,
        "attributes": [ 
            "givenName",
            "sn",
            "cn",
            "mail"
        ],
        "require-match":false
    } 
}