User Self-Registration Functions¶

To enable the self-registration functions, see config_user_self_registration section of this manual. When self-registration is enabled, the banner menu functions shown to a user who has not logged in should contain two additional choices: ‘Forgot your password?’ and ‘Register’ as follows:

If ‘Register’ is chosen the user will be asked to fill out a form as follows:

../../_images/usr-self-registration-form.png

The fields in this form are self-explanatory except for the following:

Email: The user’s email address. This is mandatory and will be used as the username.

Profile: By default, self-registered users are given the ‘Registered User’ profile (see previous section). If any other profile is selected:

the user will still be given the ‘Registered User’ profile
an email will be sent to the Email address nominated in the Feedback section of the ‘System Administration’ menu, informing them of the request for a more privileged profile

What happens when a user self-registers?¶

When a user self-registration occurs, the user receives an email with the new account details that looks something like the following:

Dear User,

  Your registration at The Greenhouse GeoNetwork Site was successful.

  Your account is:
  username :    dubya.shrub@greenhouse.gov
  password :    0110O3
  usergroup:    GUEST
  usertype :    REGISTEREDUSER

  You've told us that you want to be "Editor", you will be contacted by our office soon.

  To log in and access your account, please click on the link below.
  http://greenhouse.gov/geonetwork

  Thanks for your registration.

        Yours sincerely,
        The team at The Greenhouse GeoNetwork Site

Notice that the user has requested an ‘Editor’ profile. As a result an email will be sent to the Email address nominated in the Feedback section of the ‘System Administration’ menu which looks something like the following:

Notice also that the user has been added to the built-in user group ‘GUEST’. This is a security restriction. An administrator/user-administrator can add the user to other groups if that is required later.

If you want to change the content of this email, you should modify INSTALL_DIR/web/geonetwork/xsl/registration-pwd-email.xsl.

Dear Admin,

        Newly registered user dubya.shrub@greenhouse.gov has requested "Editor" access for:

        Instance:     The Greenhouse GeoNetwork Site
        Url:          http://greenhouse.gov/geonetwork

        User registration details:

        Name:         Dubya
        Surname:      Shrub
        Email:        dubya.shrub@greenhouse.gov
        Organisation: The Greenhouse
        Type:         gov
        Address:      146 Main Avenue, Creationville
        State:        Clerical
        Post Code:    92373
        Country:      Mythical

Please action.

The Greenhouse GeoNetwork Site

If you want to change the content of this email, you should modify INSTALL_DIR/web/geonetwork/xsl/registration-prof-email.xsl.

The ‘Forgot your password?’ function¶

This function allows users who have forgotten their password to request a new one. For security reasons, only users that have the ‘Registered User’ profile can request a new password.

If a user takes this option they will receive an email inviting them to change their password as follows:

You have requested to change your Greenhouse GeoNetwork Site password.

You can change your password using the following link:

http://localhost:8080/geonetwork/srv/en/password.change.form?username=dubya.shrub@greenhouse.gov&changeKey=635d6c84ddda782a9b6ca9dda0f568b011bb7733

This link is valid for today only.

Greenhouse GeoNetwork Site

GeoNetwork has generated a changeKey from the forgotten password and the current date and emailed that to the user as part of a link to a change password form.

If you want to change the content of this email, you should modify INSTALL_DIR/web/geonetwork/xsl/password-forgotten-email.xsl.

When the user clicks on the link, a change password form is displayed in their browser and a new password can be entered. When that form is submitted to GeoNetwork, the changeKey is regenerated and checked with the changeKey supplied in the link, if they match then the password is changed to the new password supplied by the user.

The final step in this process is a verification email sent to the email address of the user confirming that a change of password has taken place:

Your Greenhouse GeoNetwork Site password has been changed.

If you did not change this password contact the Greenhouse GeoNetwork Site helpdesk

The Greenhouse GeoNetwork Site team

If you want to change the content of this email, you should modify INSTALL_DIR/web/geonetwork/xsl/password-changed-email.xsl.