This documentation is for Dovecot v2.x, see wiki1 for v1.x documentation.
Differences between revisions 14 and 15
Revision 14 as of 2008-01-01 14:41:40
Size: 1679
Editor: odnb-4d0aa5f5
Comment:
Revision 15 as of 2009-03-15 22:35:25
Size: 1695
Editor: localhost
Comment: converted to 1.6 markup
Deletions are marked like this. Additions are marked like this.
Line 3: Line 3:
After a user has been successfully authenticated, Dovecot looks up the user's userdb information. The userdb lookup is also done by [:LDA:deliver] to find out how to deliver mails for the user. After a user has been successfully authenticated, Dovecot looks up the user's userdb information. The userdb lookup is also done by [[LDA|deliver]] to find out how to deliver mails for the user.
Line 7: Line 7:
 * '''uid''': User's [:UserIds#mailusers:UID] (UNIX user ID)
 * '''gid''': User's [:UserIds#gids:GID] (UNIX group ID)
 * '''home''': [:VirtualUsers#homedirs:Home directory]. Although not required, it's highly recommended even for virtual users (see the link).
 * '''mail''': [:MailLocation:Mail location] (if needed to override the default {{{mail_location}}} setting)
 * Optional [:UserDatabase/ExtraFields:extra fields] which are passed to the IMAP/POP3 process in environment variables.
 * '''uid''': User's [[UserIds#mailusers|UID]] (UNIX user ID)
 * '''gid''': User's [[UserIds#gids|GID]] (UNIX group ID)
 * '''home''': [[VirtualUsers#homedirs|Home directory]]. Although not required, it's highly recommended even for virtual users (see the link).
 * '''mail''': [[MailLocation|Mail location]] (if needed to override the default {{{mail_location}}} setting)
 * Optional [[UserDatabase/ExtraFields|extra fields]] which are passed to the IMAP/POP3 process in environment variables.
Line 13: Line 13:
The user and [:PasswordDatabase:password databases] may be the same or they may be different depending on your needs. You can also have [:Authentication/MultipleDatabases:multiple databases]. The user and [[PasswordDatabase|password databases]] may be the same or they may be different depending on your needs. You can also have [[Authentication/MultipleDatabases|multiple databases]].
Line 17: Line 17:
 * [:AuthDatabase/Passwd:Passwd]: System users (NSS, `/etc/passwd`, or similiar)
 * [:AuthDatabase/PasswdFile:Passwd-file]: `/etc/passwd`-like file in specified location
 * [:UserDatabase/NSS:NSS]: Name Service Switch (v1.1+)
 * [:AuthDatabase/LDAP:LDAP]: Lightweight Directory Access Protocol
 * [:AuthDatabase/SQL:SQL]: SQL database (PostgreSQL, MySQL, SQLite)
 * [:UserDatabase/Static:Static]: Userdb information generated from a given template
 * [:AuthDatabase/VPopMail:VPopMail]: External software used to handle virtual domains
 * [:UserDatabase/Prefetch:Prefetch]: This assumes that the passdb already returned also all the required user database information
 * [[AuthDatabase/Passwd|Passwd]]: System users (NSS, `/etc/passwd`, or similiar)
 * [[AuthDatabase/PasswdFile|Passwd-file]]: `/etc/passwd`-like file in specified location
 * [[UserDatabase/NSS|NSS]]: Name Service Switch (v1.1+)
 * [[AuthDatabase/LDAP|LDAP]]: Lightweight Directory Access Protocol
 * [[AuthDatabase/SQL|SQL]]: SQL database (PostgreSQL, MySQL, SQLite)
 * [[UserDatabase/Static|Static]]: Userdb information generated from a given template
 * [[AuthDatabase/VPopMail|VPopMail]]: External software used to handle virtual domains
 * [[UserDatabase/Prefetch|Prefetch]]: This assumes that the passdb already returned also all the required user database information

User Databases

After a user has been successfully authenticated, Dovecot looks up the user's userdb information. The userdb lookup is also done by deliver to find out how to deliver mails for the user.

The user database lookup returns these fields:

  • uid: User's UID (UNIX user ID)

  • gid: User's GID (UNIX group ID)

  • home: Home directory. Although not required, it's highly recommended even for virtual users (see the link).

  • mail: Mail location (if needed to override the default mail_location setting)

  • Optional extra fields which are passed to the IMAP/POP3 process in environment variables.

The user and password databases may be the same or they may be different depending on your needs. You can also have multiple databases.

Currently supported user databases are:

  • Passwd: System users (NSS, /etc/passwd, or similiar)

  • Passwd-file: /etc/passwd-like file in specified location

  • NSS: Name Service Switch (v1.1+)

  • LDAP: Lightweight Directory Access Protocol

  • SQL: SQL database (PostgreSQL, MySQL, SQLite)

  • Static: Userdb information generated from a given template

  • VPopMail: External software used to handle virtual domains

  • Prefetch: This assumes that the passdb already returned also all the required user database information

None: UserDatabase (last edited 2019-09-11 13:58:52 by MichaelSlusarz)