The proprietary operation purpose request control may be included in a request to provide additional information about the reason for that request. It is purely informational (for example, for inclusion in access log messages generated for the operation), and does not otherwise affect the server’s processing for that operation. The control has an OID of 1.3.6.1.4.1.30221.2.5.19, and it takes a value. The following fields may be present in the value-json representation of the value, and at least one of the fields must be present:

The following sample shows the JSON encoding for the control:

{ 
    "oid":"1.3.6.1.4.1.30221.2.5.19",
    "control-name":"Operation Purpose Request Control",
    "criticality":false,
    "value-json": { 
        "application-name":"My LDAP-Enabled Application",
        "application-version":"1.2.3",
        "code-location":"authenticateUser",
        "request-purpose":"Validating the provided credentials"
    } 
}