Difference: TWikiUsersPasswordDotPm (1 vs. 6)

Revision 62011-08-21 - TWikiContributor

Line: 54 to 54
 
Changed:
<
<

ObjectMethod setPassword ($login,$newPassU,$oldPassU) -> $boolean

>
>

ObjectMethod setPassword ($login,$newPassU,$oldPassU,$mcp) -> $boolean

  If the $oldPassU matches matches the user's password, then it will replace it with $newPassU.
Line: 64 to 64
 If $oldPassU is 1, will force the change irrespective of the existing password, adding the user if necessary.
Added:
>
>
If $mcp is true, the "must change password" flag is set
 Otherwise returns 1 on success, undef on failure.
Line: 127 to 129
 
Added:
>
>

ObjectMethod getMustChangePassword ($cUID) -> $flag

Returns 1 if the $cUID must change the password, else 0. Returns undef if $cUID not found.

ObjectMethod getUserData ($cUID) -> $dataRef

Return a reference to an array of hashes with user data, used to manage users. Each item is a hash with:

  • {name} - name of field, such as "email"
  • {title} - title of field, such as "E-mail"
  • {value} - value of field, such as "jimmy@example.com"
  • {type} - type of field: text, password, checkbox, label
  • {size} - size of field, such as 40
  • {note} - comment note, if any

User management forms can be build dynamically from this data structure. Each password manager may return a different set of fields.

ObjectMethod setUserData ($cUID,$dataRef)

Set the user data of a user. Same array of hashes as getUserData is assumed, although only {name} and {value} are used.

Sub classes should return an empty string if save action is OK, or an error string starting with 'Error: '.

 

ObjectMethod canFetchUsers () -> boolean

returns true if the fetchUsers method is implemented and can return an iterator of users.

Revision 52008-08-03 - TWikiContributor

Line: 116 to 116
 
Changed:
<
<

ObjectMethod findLoginByEmail ($email) -> \@users

>
>

ObjectMethod findUserByEmail ($email) -> \@users

 Returns an array of login names that relate to a email address. Defaut behaviour is a nop, which will result in the user mapping manager being asked for its opinion. If subclass implementations return a value for

Revision 42008-01-22 - TWikiContributor

Line: 16 to 16
 
Changed:
<
<

ObjectMethod finish

>
>

ObjectMethod finish ()

Break circular references.
 
Changed:
<
<
Complete processing after the client's HTTP request has been responded to.
  1. breaking circular references to allow garbage collection in persistent environments
>
>

ObjectMethod readOnly () -> boolean

returns true if the password database is not currently modifyable also needs to call $this->{session}->enter_context('passwords_modifyable'); if you want to be able to use the existing TWikiUserMappingContrib ChangePassword topics

 
Line: 29 to 34
  Implements TWiki::Password
Changed:
<
<
Returns encrypted password if succeeds. Returns 0 if login is invalid.
>
>
Returns encrypted password if succeeds. Returns 0 if login is invalid.
 Returns undef otherwise.

Changed:
<
<

ObjectMethod checkPassword ($user,$passwordU) -> $boolean

>
>

ObjectMethod checkPassword ($login,$passwordU) -> $boolean

 
Changed:
<
<
Finds if the password is valid for the given login.
>
>
Finds if the password is valid for the given user.
  Returns 1 on success, undef on failure.

Changed:
<
<

ObjectMethod deleteUser ($user) -> $boolean

Delete users entry.

Returns 1 on success, undef on failure.

>
>

ObjectMethod removeUser ($login) -> $boolean

 
Added:
>
>
Delete the users entry.
 
Deleted:
<
<

ObjectMethod passwd ($user,$newPassU,$oldPassU) -> $boolean

 
Changed:
<
<
If the $oldPassU is undef, it will try to add the user, failing if they are already there.
>
>

ObjectMethod setPassword ($login,$newPassU,$oldPassU) -> $boolean

 
Changed:
<
<
If the $oldPassU matches matches the login's password, then it will
>
>
If the $oldPassU matches matches the user's password, then it will
 replace it with $newPassU.

If $oldPassU is not correct and not 1, will return 0.

Line: 67 to 68
 
Changed:
<
<

encrypt( $user, $passwordU, $fresh ) -> $passwordE

>
>

encrypt( $login, $passwordU, $fresh ) -> $passwordE

  Will return an encrypted password. Repeated calls
Changed:
<
<
to encrypt with the same user/passU will return the same passE.
>
>
to encrypt with the same login/passU will return the same passE.
  However if the passU is changed, and subsequently changed back
Changed:
<
<
to the old user/passU pair, then the old passE is no longer valid.
>
>
to the old login/passU pair, then the old passE is no longer valid.
  If $fresh is true, then a new password not based on any pre-existing salt will be used. Set this if you are generating a completely
Line: 87 to 88
 
Changed:
<
<

ObjectMethod getEmails ($user) -> @emails

>
>

ObjectMethod isManagingEmails () -> $boolean

Determines if this manager can store and retrieve emails. The password manager is used in preference to the user mapping manager for storing emails, on the basis that emails need to be secure, and the password database is the most secure place. If a password manager does not manage emails, then TWiki will fall back to using the user mapping manager (which by default will store emails in user topics)

The default ('none') password manager does not manage emails.

ObjectMethod getEmails ($login) -> @emails

Fetch the email address(es) for the given login. Default behaviour is to return an empty list. Called by Users.pm. Only used if isManagingEmails -> true.

ObjectMethod setEmails ($login,@emails) -> $boolean

Set the email address(es) for the given login name. Returns true if the emails were set successfully. Default behaviour is a nop, which will result in the user mapping manager taking over. Called by Users.pm. Only used if isManagingEmails -> true.

ObjectMethod findLoginByEmail ($email) -> \@users

Returns an array of login names that relate to a email address. Defaut behaviour is a nop, which will result in the user mapping manager being asked for its opinion. If subclass implementations return a value for this, then the user mapping manager will not be asked. Only used if isManagingEmails -> true.

Called by Users.pm.

ObjectMethod canFetchUsers () -> boolean

 
Changed:
<
<
Fetch the email address(es) for the given username. Default behaviour is to look up the users' personal topic.
>
>
returns true if the fetchUsers method is implemented and can return an iterator of users. returns undef / nothing in this case, as we are unable to generate a list of users
 
Changed:
<
<

ObjectMethod setEmails ($user,@emails)

>
>

ObjectMethod fetchUsers () -> newTWiki::ListIterator(\@users)

 
Changed:
<
<
Set the email address(es) for the given username in the user topic.
>
>
returns a TWikiIterator of loginnames from the password source. If AllowLoginNames is false this is used to remove the need for a TWikiUsers topic.
 

Revision 22006-06-25 - TWikiContributor

Line: 16 to 16
 
Added:
>
>

ObjectMethod finish

Complete processing after the client's HTTP request has been responded to.
  1. breaking circular references to allow garbage collection in persistent environments

 

ObjectMethod fetchPass ($login) -> $passwordE

Implements TWiki::Password

Revision 12006-02-01 - TWikiContributor

Line: 1 to 1
Added:
>
>

Package TWiki::Users::Password

Base class of all password handlers. Default behaviour is no passwords, so anyone can be anyone they like.

The methods of this class should be overridded by subclasses that want to implement other password handling methods.

ClassMethod new ($session) -> $object

Constructs a new password handler of this type, referring to $session for any required TWiki services.

ObjectMethod fetchPass ($login) -> $passwordE

Implements TWiki::Password

Returns encrypted password if succeeds. Returns 0 if login is invalid. Returns undef otherwise.

ObjectMethod checkPassword ($user,$passwordU) -> $boolean

Finds if the password is valid for the given login.

Returns 1 on success, undef on failure.

ObjectMethod deleteUser ($user) -> $boolean

Delete users entry.

Returns 1 on success, undef on failure.

ObjectMethod passwd ($user,$newPassU,$oldPassU) -> $boolean

If the $oldPassU is undef, it will try to add the user, failing if they are already there.

If the $oldPassU matches matches the login's password, then it will replace it with $newPassU.

If $oldPassU is not correct and not 1, will return 0.

If $oldPassU is 1, will force the change irrespective of the existing password, adding the user if necessary.

Otherwise returns 1 on success, undef on failure.

encrypt( $user, $passwordU, $fresh ) -> $passwordE

Will return an encrypted password. Repeated calls to encrypt with the same user/passU will return the same passE.

However if the passU is changed, and subsequently changed back to the old user/passU pair, then the old passE is no longer valid.

If $fresh is true, then a new password not based on any pre-existing salt will be used. Set this if you are generating a completely new password.

ObjectMethod error () -> $string

Return any error raised by the last method call, or undef if the last method call succeeded.

ObjectMethod getEmails ($user) -> @emails

Fetch the email address(es) for the given username. Default behaviour is to look up the users' personal topic.

ObjectMethod setEmails ($user,@emails)

Set the email address(es) for the given username in the user topic.

 
This site is powered by the TWiki collaboration platform Powered by PerlCopyright © 1999-2024 by the contributing authors. All material on this collaboration platform is the property of the contributing authors.
Ideas, requests, problems regarding TWiki? Send feedback
Note: Please contribute updates to this topic on TWiki.org at TWiki:TWiki.TWikiUsersPasswordDotPm.