class twisted.cred.portal.IRealm(Interface): (source)
Known implementations: twisted.conch.manhole_tap._StupidRealm, twisted.conch.unix.UnixSSHRealm, twisted.mail.maildir.MaildirDirdbmDomain, twisted.protocols.ftp.BaseFTPRealm, twisted.words.service.WordsRealm
The realm connects application-specific objects to the authentication system.
| Method | requestAvatar | Return avatar which provides one of the given interfaces. |
Return avatar which provides one of the given interfaces.
| Parameters | avatarId | a string that identifies an avatar, as returned by ICredentialsChecker.requestAvatarId (via a Deferred). Alternatively, it may be twisted.cred.checkers.ANONYMOUS. |
| mind | usually None. See the description of mind in Portal.login. | |
| interfaces | the interface(s) the returned avatar should implement, e.g. IMailAccount. See the description of Portal.login. | |
| Returns | a deferred which will fire a tuple of (interface, avatarAspect, logout), or the tuple itself. The interface will be one of the interfaces passed in the 'interfaces' argument. The 'avatarAspect' will implement that interface. The 'logout' object is a callable which will detach the mind from the avatar. | |