[exim-dev] [Bug 1448] New: Dovecot authenticator documentati…

------- You are receiving this mail because: -------
You are on the CC list for the bug.

http://bugs.exim.org/show_bug.cgi?id=1448
           Summary: Dovecot authenticator documentation is incomplete
           Product: Exim
           Version: 4.82
          Platform: All
        OS/Version: All
            Status: NEW
          Severity: bug
          Priority: medium
         Component: Documentation
        AssignedTo: nigel@???
        ReportedBy: peter+exim@???
                CC: exim-dev@???

My goal: configuring Exim to use Dovecot as authenticator.
Following the documentation[1], I should set the following:

dovecot_plain:
driver = dovecot
public_name = PLAIN
server_socket = /var/run/dovecot/auth-client
server_set_id = $auth2

I have not tried this since I have no idea what this magic $auth2 means.
Looking in the source code, it seems wrong too. In src/auths/dovecot.c, I see:

    /*
     * Search for the "user=$USER" string in the args array
     * and return the proper value.
     */
    for (i=2; (i<nargs) && (auth_id_pre == NULL); i++)
    {
            if ( Ustrncmp(args[i], US"user=", 5) == 0 )
            {
                    auth_id_pre = args[i]+5;
                    expand_nstring[1] = auth_vars[0] =
                            string_copy(auth_id_pre); /* PH */
                    expand_nlength[1] = Ustrlen(auth_id_pre);
                    expand_nmax = 1;
            }
    }

This (auth_vars[0]) seems to set $auth1 to the username (which should be
documented!).

$auth2 seems to come from the SASL code where $auth1 means "AUTHID", $auth2
refers to "$AUTHZ" and $auth3 the password. This is however *not* applicable to
the dovecot documentation.

Please update the documentation, my quick analysis might be wrong so I would
like to have your feedback on it.

[1]:
http://www.exim.org/exim-html-current/doc/html/spec_html/ch-the_dovecot_authenticator.html


--
Configure bugmail: http://bugs.exim.org/userprefs.cgi?tab=email