Moodle PHP Documentation 4.4
Moodle 4.4.1 (Build: 20240610) (db07c09afc5)
|
Public Member Functions | |
check_combination (array $combination) | |
Grace Factor implementation. | |
create_event_after_factor_setup (object $user) | |
Creates an event when user successfully setup a factor. | |
delete_factor_for_user (stdClass $user) | |
Deletes all instances of factor for a user. | |
get_active_user_factors (stdClass $user) | |
Grace Factor implementation. | |
get_affecting_factors () | |
Get the factor list that is currently affecting gracemode. | |
get_all_affecting_factors () | |
Returns a list of factor objects that can affect gracemode giving points. | |
get_all_user_factors (stdClass $user) | |
Grace Factor implementation. | |
get_display_name () | |
Returns factor name from language string. | |
get_icon () | |
Get the icon associated with this factor. | |
get_info () | |
Returns factor help from language string. | |
get_label (int $factorid) | |
Function to retrieve the label for a factorid. | |
get_lastverified (int $factorid) | |
Gets lastverified timestamp. | |
get_login_desc () | |
Get the login description associated with this factor. | |
get_manage_info (int $factorid) | |
Returns factor help from language string when there is factor management available. | |
get_manage_string () | |
Gets the string for manage button on preferences page. | |
get_no_redirect_urls () | |
Grace factor implementation. | |
get_remaining_attempts () | |
Return the number of remaining attempts at this factor. | |
get_setup_string () | |
Gets the string for setup button on preferences page. | |
get_state ($redirectable=true) | |
Grace Factor implementation. | |
get_state () | |
Returns the state of the factor from session information. | |
get_summary_condition () | |
Returns condition for passing factor. | |
get_weight () | |
Returns configured factor weight. | |
global_definition (\MoodleQuickForm $mform) | |
Hook point for global auth form action hooks. | |
global_definition_after_data (\MoodleQuickForm $mform) | |
Hook point for global auth form action hooks. | |
global_submit (object $data) | |
Hook point for global auth form action hooks. | |
global_validation (array $data, array $files) | |
Hook point for global auth form action hooks. | |
has_input () | |
Grace Factor implementation. | |
has_replace () | |
Returns true if factor class has factor records that can be replaced. | |
has_revoke () | |
Returns true if factor class has factor records that might be revoked. | |
has_setup () | |
Returns true if factor needs to be setup by user and has setup_form. | |
increment_lock_counter () | |
Increments the lock counter for a factor. | |
is_enabled () | |
Returns true if factor is enabled, otherwise false. | |
is_lockable () | |
Returns true if a factor is able to be locked if it fails. | |
load_locked_state () | |
This loads the locked state from the DB Base class implementation. | |
login_form_definition (\MoodleQuickForm $mform) | |
Defines login form definition page for particular factor. | |
login_form_definition_after_data (\MoodleQuickForm $mform) | |
Defines login form definition page after form data has been set. | |
login_form_validation (array $data) | |
Implements login form validation for particular factor. | |
possible_states (stdClass $user) | |
Grace Factor implementation. | |
post_pass_state () | |
Grace Factor implementation. | |
process_cancel_action () | |
Process a cancel input from a user. | |
replace_user_factor (stdClass $data, int $id) | |
Replaces a given factor and adds it to user's active factors list. | |
revoke_user_factor (?int $factorid=null) | |
Marks factor record as revoked. | |
set_state (string $state) | |
Grace Factor implementation. | |
setup_factor_form_definition (\MoodleQuickForm $mform) | |
Defines setup_factor form definition page for particular factor. | |
setup_factor_form_definition_after_data (\MoodleQuickForm $mform) | |
Defines setup_factor form definition page after form data has been set. | |
setup_factor_form_is_cancelled (int $factorid) | |
Setups in given factor when the form is cancelled. | |
setup_factor_form_submit_button_string () | |
Setup submit button string in given factor. | |
setup_factor_form_validation (array $data) | |
Implements setup_factor form validation for particular factor. | |
setup_user_factor (stdClass $data) | |
Setups given factor and adds it to user's active factors list. | |
show_setup_buttons () | |
If has_setup returns true, decides if the setup buttons should be shown on the preferences page. | |
update_lastverified (?int $factorid=null) | |
When validation code is correct - update lastverified field for given factor. | |
Public Attributes | |
string | $name |
Factor name. | |
Protected Attributes | |
string | $icon = 'fa-lock' |
Factor icon. | |
tool_mfa local secret_manager | $secretmanager |
Secret manager. | |
factor_grace\factor::check_combination | ( | array | $combination | ) |
Grace Factor implementation.
Gracemode should not be a valid combination with another factor.
array | $combination | array of factors that make up the combination |
bool |
Reimplemented from tool_mfa\local\factor\object_factor_base.
|
inherited |
Creates an event when user successfully setup a factor.
object | $user |
void |
|
inherited |
Deletes all instances of factor for a user.
stdClass | $user | the user to delete for. |
void |
Implements tool_mfa\local\factor\object_factor.
factor_grace\factor::get_active_user_factors | ( | stdClass | $user | ) |
Grace Factor implementation.
Singleton instance, no additional filtering needed.
stdClass | $user | object to check against. |
array | the array of active factors. |
Reimplemented from tool_mfa\local\factor\object_factor_base.
factor_grace\factor::get_affecting_factors | ( | ) |
Get the factor list that is currently affecting gracemode.
Active and not ignored.
array |
factor_grace\factor::get_all_affecting_factors | ( | ) |
Returns a list of factor objects that can affect gracemode giving points.
Only factors that a user can setup or manually use can affect whether gracemode gives points. The intest is to provide a grace period for users to go in, setup factors, phone numbers, etc., so that they are able to authenticate correctly once the grace period ends.
array |
factor_grace\factor::get_all_user_factors | ( | stdClass | $user | ) |
Grace Factor implementation.
This factor is a singleton, return single instance.
stdClass | $user | the user to check against. |
array |
Reimplemented from tool_mfa\local\factor\object_factor_base.
|
inherited |
Returns factor name from language string.
Base class implementation.
string |
coding_exception |
Implements tool_mfa\local\factor\object_factor.
Reimplemented in tool_mfa\local\factor\fallback.
|
inherited |
Get the icon associated with this factor.
string | the icon name. |
|
inherited |
Returns factor help from language string.
Base class implementation.
string |
coding_exception |
Implements tool_mfa\local\factor\object_factor.
Reimplemented in tool_mfa\local\factor\fallback.
|
inherited |
Function to retrieve the label for a factorid.
int | $factorid |
string|dml_exception |
Implements tool_mfa\local\factor\object_factor.
|
inherited |
Gets lastverified timestamp.
int | $factorid |
int|bool | the lastverified timestamp, or false if not found. |
Implements tool_mfa\local\factor\object_factor.
|
inherited |
Get the login description associated with this factor.
Override for factors that have a user input.
string | The login option. |
Reimplemented in factor_email\factor, and factor_sms\factor.
|
inherited |
Returns factor help from language string when there is factor management available.
Base class implementation.
int | $factorid | The factor we want manage info for. |
string |
coding_exception |
|
inherited |
Gets the string for manage button on preferences page.
string |
Reimplemented in factor_sms\factor, factor_totp\factor, and factor_webauthn\factor.
factor_grace\factor::get_no_redirect_urls | ( | ) |
Grace factor implementation.
If grace period should redirect at end, make this a no-redirect url.
array |
Reimplemented from tool_mfa\local\factor\object_factor_base.
|
inherited |
Return the number of remaining attempts at this factor.
int | the number of attempts at this factor remaining. |
|
inherited |
Gets the string for setup button on preferences page.
string |
Implements tool_mfa\local\factor\object_factor.
Reimplemented in factor_sms\factor, factor_totp\factor, and factor_webauthn\factor.
factor_grace\factor::get_state | ( | $redirectable = true | ) |
Grace Factor implementation.
Checks the user login time against their first login after MFA activation.
bool | $redirectable | should this state call be allowed to redirect the user? |
string | state constant |
|
inherited |
Returns the state of the factor from session information.
Implementation for factors that require input. Should be overridden in child classes with no input.
mixed |
Implements tool_mfa\local\factor\object_factor.
Reimplemented in factor_admin\factor, factor_auth\factor, factor_capability\factor, factor_cohort\factor, factor_email\factor, factor_iprange\factor, factor_nosetup\factor, factor_role\factor, factor_token\factor, factor_totp\factor, factor_webauthn\factor, and tool_mfa\local\factor\fallback.
|
inherited |
Returns condition for passing factor.
Implementation for basic conditions. Override for complex conditions such as auth type.
string |
Implements tool_mfa\local\factor\object_factor.
Reimplemented in factor_auth\factor, factor_cohort\factor, and factor_role\factor.
|
inherited |
Returns configured factor weight.
Base class implementation.
int |
dml_exception |
Implements tool_mfa\local\factor\object_factor.
|
inherited |
Hook point for global auth form action hooks.
MoodleQuickForm | $mform | Form to inject global elements into. |
void |
Implements tool_mfa\local\factor\object_factor.
|
inherited |
Hook point for global auth form action hooks.
MoodleQuickForm | $mform | Form to inject global elements into. |
void |
Implements tool_mfa\local\factor\object_factor.
|
inherited |
Hook point for global auth form action hooks.
object | $data | Data from the form. |
void |
Implements tool_mfa\local\factor\object_factor.
|
inherited |
Hook point for global auth form action hooks.
array | $data | Data from the form. |
array | $files | Files form the form. |
array | of errors from validation. |
Implements tool_mfa\local\factor\object_factor.
factor_grace\factor::has_input | ( | ) |
Grace Factor implementation.
Factor has no input.
Returns true if a factor requires input from the user to verify.Override in child class if necessary
bool |
Reimplemented from tool_mfa\local\factor\object_factor_base.
|
inherited |
Returns true if factor class has factor records that can be replaced.
Override in child class if necessary.
bool |
Reimplemented in factor_totp\factor, and factor_webauthn\factor.
|
inherited |
Returns true if factor class has factor records that might be revoked.
It means that user can revoke factor record from their profile.
Override in child class if necessary.
bool |
Implements tool_mfa\local\factor\object_factor.
Reimplemented in factor_sms\factor, factor_totp\factor, and factor_webauthn\factor.
|
inherited |
Returns true if factor needs to be setup by user and has setup_form.
Override in child class if necessary.
bool |
Implements tool_mfa\local\factor\object_factor.
Reimplemented in factor_sms\factor, factor_totp\factor, and factor_webauthn\factor.
|
inherited |
Increments the lock counter for a factor.
void |
|
inherited |
Returns true if factor is enabled, otherwise false.
Base class implementation.
bool |
dml_exception |
Implements tool_mfa\local\factor\object_factor.
Reimplemented in factor_sms\factor.
|
inherited |
Returns true if a factor is able to be locked if it fails.
Generally only input factors are lockable. Override in child class if necessary
bool |
|
inherited |
|
inherited |
Defines login form definition page for particular factor.
Dummy implementation. Should be overridden in child class.
MoodleQuickForm | $mform |
MoodleQuickForm\$mform |
Implements tool_mfa\local\factor\object_factor.
Reimplemented in factor_email\factor, factor_sms\factor, factor_totp\factor, and factor_webauthn\factor.
|
inherited |
Defines login form definition page after form data has been set.
Dummy implementation. Should be overridden in child class.
MoodleQuickForm | $mform |
MoodleQuickForm\$mform |
Implements tool_mfa\local\factor\object_factor.
Reimplemented in factor_email\factor, and factor_sms\factor.
|
inherited |
Implements login form validation for particular factor.
Returns an array of errors, where array key = field id and array value = error text.
Dummy implementation. Should be overridden in child class.
array | $data |
array |
Implements tool_mfa\local\factor\object_factor.
Reimplemented in factor_email\factor, factor_sms\factor, factor_totp\factor, and factor_webauthn\factor.
factor_grace\factor::possible_states | ( | stdClass | $user | ) |
Grace Factor implementation.
Gracemode can change outcome just by waiting, or based on other factors.
stdClass | $user |
array |
Reimplemented from tool_mfa\local\factor\object_factor_base.
factor_grace\factor::post_pass_state | ( | ) |
Grace Factor implementation.
Add a notification on the next page.
Function for factor actions in the pass state.Override in child class if necessary.
void |
Reimplemented from tool_mfa\local\factor\object_factor_base.
|
inherited |
Process a cancel input from a user.
void |
Implements tool_mfa\local\factor\object_factor.
|
inherited |
Replaces a given factor and adds it to user's active factors list.
Returns the new factor if it has been successfully replaced.
Dummy implementation. Should be overridden in child class.
stdClass | $data | The new factor data. |
int | $id | The id of the factor to replace. |
stdClass|null | the record if created, or null. |
Reimplemented in factor_totp\factor, and factor_webauthn\factor.
|
inherited |
Marks factor record as revoked.
If factorid is not provided, revoke all instances of factor.
int | null | $factorid |
bool |
coding_exception | |
dml_exception |
Implements tool_mfa\local\factor\object_factor.
factor_grace\factor::set_state | ( | string | $state | ) |
Grace Factor implementation.
State cannot be set. Return true.
string | $state | the state constant to set |
bool |
Reimplemented from tool_mfa\local\factor\object_factor_base.
|
inherited |
Defines setup_factor form definition page for particular factor.
Dummy implementation. Should be overridden in child class.
MoodleQuickForm | $mform |
MoodleQuickForm\$mform |
Implements tool_mfa\local\factor\object_factor.
Reimplemented in factor_sms\factor, factor_totp\factor, and factor_webauthn\factor.
|
inherited |
Defines setup_factor form definition page after form data has been set.
Dummy implementation. Should be overridden in child class.
MoodleQuickForm | $mform |
MoodleQuickForm\$mform |
Implements tool_mfa\local\factor\object_factor.
Reimplemented in factor_sms\factor, and factor_totp\factor.
|
inherited |
Setups in given factor when the form is cancelled.
Dummy implementation. Should be overridden in child class.
int | $factorid |
void |
Implements tool_mfa\local\factor\object_factor.
Reimplemented in factor_sms\factor.
|
inherited |
Setup submit button string in given factor.
Dummy implementation. Should be overridden in child class.
string|null |
Implements tool_mfa\local\factor\object_factor.
Reimplemented in factor_sms\factor.
|
inherited |
Implements setup_factor form validation for particular factor.
Returns an array of errors, where array key = field id and array value = error text.
Dummy implementation. Should be overridden in child class.
array | $data |
array |
Implements tool_mfa\local\factor\object_factor.
Reimplemented in factor_sms\factor, and factor_totp\factor.
|
inherited |
Setups given factor and adds it to user's active factors list.
Returns true if factor has been successfully added, otherwise false.
Dummy implementation. Should be overridden in child class.
stdClass | $data |
stdClass|null | the record if created, or null. |
Implements tool_mfa\local\factor\object_factor.
Reimplemented in factor_sms\factor, and factor_totp\factor.
|
inherited |
If has_setup returns true, decides if the setup buttons should be shown on the preferences page.
bool |
Implements tool_mfa\local\factor\object_factor.
Reimplemented in factor_sms\factor, factor_totp\factor, and factor_webauthn\factor.
|
inherited |
When validation code is correct - update lastverified field for given factor.
If factor id is not provided, update all factor entries for user.
int | null | $factorid |
bool|dml_exception |
dml_exception |
Implements tool_mfa\local\factor\object_factor.