auth/upgrade.txt

   1 This files describes API changes in /auth/* - plugins,
   2 information provided here is intended especially for developers.
   3
   4 === 4.4 ===
   5
   6 * A sesskey is no longer passed to the auth/test_settings.php page so it can no longer be required in test_settings().
   7
   8 === 4.2 ===
   9 * Support for configuration with the deprecated auth_config.php file has been removed.
  10 * The moodle-auth-passwordunmask YUI module has been removed. Any uses should be replaced with core_form/passwordunmask.
  11
  12 === 3.9 ===
  13
  14 * The following functions, previously used (exclusively) by upgrade steps are not available anymore because of the upgrade cleanup performed for this version. See MDL-65809 for more info:
  15     - upgrade_fix_config_auth_plugin_names()
  16     - upgrade_fix_config_auth_plugin_defaults()
  17
  18 === 3.7 ===
  19
  20 * get_password_change_info() method is added to the base class and returns an array containing the subject and body of the message
  21   to the user that contains instructions on how to change their password. Authentication plugins can override this method if needed.
  22
  23 === 3.6 ===
  24
  25 * Login forms generated from Moodle must include a login token to protect automated logins. See \core\session\manager::get_login_token().
  26
  27 === 3.5 ===
  28
  29 * The auth_db and auth_ldap plugins' implementations of update_user_record() have been removed and both now
  30   call the new implementation added in the base class.
  31 * Self registration plugins should use core_privacy\local\sitepolicy\manager instead of directly checking
  32   $CFG->sitepolicy , especially in custom signup forms.
  33
  34 === 3.3 ===
  35
  36 * Authentication plugins have been migrated to use the admin settings API.  Plugins should use a settings.php file to
  37   manage configurations rather than using the old config.html files. See how the helper function
  38   upgrade_fix_config_auth_plugin_names() can be used to convert the legacy settings to the new ones. Another helper
  39   function upgrade_fix_config_auth_plugin_defaults() can be used to populate the settings with default values so that
  40   they are not falsely reported as newly added ones.
  41 * The function 'print_auth_lock_options' has been replaced by 'display_auth_lock_options' which uses the admin settings API.
  42   See auth_manual as an exmple of how it can be used.  More information can be found in MDL-12689.
  43 * The list of supported identity providers (SSO IdP) returned by the 'loginpage_idp_list' method (used to render the
  44   login page and login block links) now supports a new key 'iconurl' which should be used instead of the legacy 'icon'.
  45
  46 === 3.2 ===
  47
  48 * New auth hook - pre_user_login_hook() - available, triggered right after the user object is created.
  49   This can be used to modify the user object before any authentication errors are raised.
  50 * The block_login now displays the loginpage_idp_list() links as well as main login page.
  51 * The authentication plugin auth_radius has been moved to https://github.com/moodlehq/moodle-auth_radius
  52 * New auth_email::user_signup_with_confirmation() method has a new optional parameter $confirmationurl to provide a different
  53   confirmation URL.
  54 * New signup_is_enabled() function available in lib/authlib.php to safely check if sign-up is enabled in the site.
  55
  56 === 3.0 ===
  57
  58 * login_signup_form::signup_captcha_enabled() now calls is_captcha_enabled() from the current auth plugin instead of from auth_email
  59
  60 === 2.9 ===
  61
  62 * Do not update user->firstaccess from any auth plugin, the complete_user_login() does it automatically.
  63
  64 * Add user_add_password_history() to user_signup() method.
  65
  66 * New auth hook - pre_loginpage_hook() - available, triggered before redirecting to the login page.
  67
  68 === 2.8 ===
  69
  70 * \core\session\manager::session_exists() now verifies the session is active
  71   instead of only checking the session data is present in low level session handler
  72
  73 * MNet is no longer sending logs between the client and parent sites. auth_plugin_mnet::refresh_log() is now deprecated. There is
  74   no alternative. Please don't use this function.
  75
  76 === 2.7 ===
  77
  78 * If you are returning a url in method change_password_url() from config, please make sure it is set before trying to use it.
  79
  80 === 2.6 ===
  81
  82 * can_be_manually_set() - This function was introduced in the base class and returns false by default. If overriden by
  83   an authentication plugin to return true, the authentication plugin will be able to be manually set for users. For example,
  84   when bulk uploading users you will be able to select it as the authentication method they use.
  85
  86 === 2.4 ===
  87
  88 required changes in code:
  89 * use role_get_name() or role_fix_names() if you need any role names, using role.name
  90   directly from database is not correct any more
  91
  92 optional - no changes needed:
  93 * add support for custom user signup form - see auth_plugin_base::signup_form() function
  94
  95 === 2.2 ===
  96
  97 required changes in code:
  98 * the correct sequence to set up global $USER is:
  99     $user = get_complete_user_data('username', $username); // or $user = authenticate_user_login()
 100     enrol_check_plugins($user);
 101     session_set_user($user);