------- 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: [email protected]
        ReportedBy: [email protected]
                CC: [email protected]


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

-- 
## List details at https://lists.exim.org/mailman/listinfo/exim-dev Exim 
details at http://www.exim.org/ ##

Reply via email to