{"id":249,"date":"2024-07-25T07:29:10","date_gmt":"2024-07-25T06:29:10","guid":{"rendered":"https:\/\/docs.brickfield.ie\/auth-bfmobile\/?page_id=249"},"modified":"2026-07-16T11:38:25","modified_gmt":"2026-07-16T10:38:25","slug":"site-administrator","status":"publish","type":"page","link":"https:\/\/docs.brickfield.ie\/auth-bfmobile\/site-administrator\/","title":{"rendered":"Site administrator"},"content":{"rendered":"\t\t<div data-elementor-type=\"wp-page\" data-elementor-id=\"249\" class=\"elementor elementor-249\" data-elementor-post-type=\"page\">\n\t\t\t\t<header class=\"elementor-element elementor-element-ac250df e-flex e-con-boxed e-con e-parent\" data-id=\"ac250df\" data-element_type=\"container\" data-e-type=\"container\">\n\t\t\t\t\t<div class=\"e-con-inner\">\n\t\t\t\t<div class=\"elementor-element elementor-element-755e23e elementor-widget elementor-widget-template\" data-id=\"755e23e\" data-element_type=\"widget\" data-e-type=\"widget\" data-widget_type=\"template.default\">\n\t\t\t\t<div class=\"elementor-widget-container\">\n\t\t\t\t\t\t\t<div class=\"elementor-template\">\n\t\t\t\t\t<div data-elementor-type=\"container\" data-elementor-id=\"565\" class=\"elementor elementor-565\" data-elementor-post-type=\"elementor_library\">\n\t\t\t\t<div class=\"elementor-element elementor-element-692c497 e-flex e-con-boxed e-con e-parent\" data-id=\"692c497\" data-element_type=\"container\" data-e-type=\"container\">\n\t\t\t\t\t<div class=\"e-con-inner\">\n\t\t\t\t<div class=\"elementor-element elementor-element-8de378a elementor-widget elementor-widget-image\" data-id=\"8de378a\" data-element_type=\"widget\" data-e-type=\"widget\" data-widget_type=\"image.default\">\n\t\t\t\t<div class=\"elementor-widget-container\">\n\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t<img fetchpriority=\"high\" decoding=\"async\" width=\"811\" height=\"186\" src=\"https:\/\/docs.brickfield.ie\/auth-bfmobile\/wp-content\/uploads\/sites\/67\/2025\/09\/brickfield-logo-2-2.png\" class=\"attachment-full size-full wp-image-708\" alt=\"Brickfield Education Labs Logo\" srcset=\"https:\/\/docs.brickfield.ie\/auth-bfmobile\/wp-content\/uploads\/sites\/67\/2025\/09\/brickfield-logo-2-2.png 811w, https:\/\/docs.brickfield.ie\/auth-bfmobile\/wp-content\/uploads\/sites\/67\/2025\/09\/brickfield-logo-2-2-300x69.png 300w, https:\/\/docs.brickfield.ie\/auth-bfmobile\/wp-content\/uploads\/sites\/67\/2025\/09\/brickfield-logo-2-2-768x176.png 768w\" sizes=\"(max-width: 811px) 100vw, 811px\" \/>\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t<\/div>\n\t\t\t\t<\/div>\n\t\t\t\t\t<\/div>\n\t\t\t\t<\/div>\n\t\t\t\t<\/div>\n\t\t\t\t<\/div>\n\t\t\t\t\t\t<\/div>\n\t\t\t\t<\/div>\n\t\t\t\t\t<\/div>\n\t\t\t\t<\/header>\n\t\t<nav class=\"elementor-element elementor-element-c63016d e-flex e-con-boxed e-con e-parent\" data-id=\"c63016d\" data-element_type=\"container\" data-e-type=\"container\">\n\t\t\t\t\t<div class=\"e-con-inner\">\n\t\t\t\t<div class=\"elementor-element elementor-element-aa71017 elementor-widget elementor-widget-text-editor\" data-id=\"aa71017\" data-element_type=\"widget\" data-e-type=\"widget\" data-widget_type=\"text-editor.default\">\n\t\t\t\t<div class=\"elementor-widget-container\">\n\t\t\t\t\t\t\t\t\t<p><a href=\"https:\/\/docs.brickfield.ie\/auth-bfmobile\">Home<\/a> &#8211; Site administrator<\/p>\t\t\t\t\t\t\t\t<\/div>\n\t\t\t\t<\/div>\n\t\t\t\t\t<\/div>\n\t\t\t\t<\/nav>\n\t\t<main class=\"elementor-element elementor-element-812b2ad e-flex e-con-boxed e-con e-parent\" data-id=\"812b2ad\" data-element_type=\"container\" data-e-type=\"container\">\n\t\t\t\t\t<div class=\"e-con-inner\">\n\t\t<div class=\"elementor-element elementor-element-07ab160 e-con-full e-flex e-con e-child\" data-id=\"07ab160\" data-element_type=\"container\" data-e-type=\"container\" data-settings=\"{&quot;background_background&quot;:&quot;classic&quot;}\">\n\t\t<div class=\"elementor-element elementor-element-0fe4df0 banner e-con-full e-flex e-con e-child\" data-id=\"0fe4df0\" data-element_type=\"container\" data-e-type=\"container\">\n\t\t\t\t<div class=\"elementor-element elementor-element-2618e62 elementor-widget elementor-widget-heading\" data-id=\"2618e62\" data-element_type=\"widget\" data-e-type=\"widget\" data-widget_type=\"heading.default\">\n\t\t\t\t<div class=\"elementor-widget-container\">\n\t\t\t\t\t<h1 class=\"elementor-heading-title elementor-size-default\">Brickfield Mobile: Site administrator<\/h1>\t\t\t\t<\/div>\n\t\t\t\t<\/div>\n\t\t\t\t<\/div>\n\t\t\t\t<\/div>\n\t\t<div class=\"elementor-element elementor-element-7e1a13e e-flex e-con-boxed e-con e-child\" data-id=\"7e1a13e\" data-element_type=\"container\" data-e-type=\"container\">\n\t\t\t\t\t<div class=\"e-con-inner\">\n\t\t<aside class=\"elementor-element elementor-element-405ff22 e-con-full e-flex e-con e-child\" data-id=\"405ff22\" data-element_type=\"container\" data-e-type=\"container\">\n\t\t\t\t<div class=\"elementor-element elementor-element-3a8aec7 elementor-toc--minimized-on-tablet elementor-widget elementor-widget-table-of-contents\" data-id=\"3a8aec7\" data-element_type=\"widget\" data-e-type=\"widget\" data-settings=\"{&quot;exclude_headings_by_selector&quot;:[],&quot;no_headings_message&quot;:&quot;No headings were found on this page.&quot;,&quot;headings_by_tags&quot;:[&quot;h2&quot;,&quot;h3&quot;,&quot;h4&quot;,&quot;h5&quot;,&quot;h6&quot;],&quot;marker_view&quot;:&quot;numbers&quot;,&quot;minimize_box&quot;:&quot;yes&quot;,&quot;minimized_on&quot;:&quot;tablet&quot;,&quot;hierarchical_view&quot;:&quot;yes&quot;,&quot;min_height&quot;:{&quot;unit&quot;:&quot;px&quot;,&quot;size&quot;:&quot;&quot;,&quot;sizes&quot;:[]},&quot;min_height_tablet&quot;:{&quot;unit&quot;:&quot;px&quot;,&quot;size&quot;:&quot;&quot;,&quot;sizes&quot;:[]},&quot;min_height_mobile&quot;:{&quot;unit&quot;:&quot;px&quot;,&quot;size&quot;:&quot;&quot;,&quot;sizes&quot;:[]}}\" data-widget_type=\"table-of-contents.default\">\n\t\t\t\t<div class=\"elementor-widget-container\">\n\t\t\t\t\t\t\t\t\t<div class=\"elementor-toc__header\">\n\t\t\t\t\t\t<h2 class=\"elementor-toc__header-title\">\n\t\t\t\tTable of Contents\t\t\t<\/h2>\n\t\t\t\t\t\t\t\t\t\t<div class=\"elementor-toc__toggle-button elementor-toc__toggle-button--expand\" role=\"button\" tabindex=\"0\" aria-controls=\"elementor-toc__3a8aec7\" aria-expanded=\"true\" aria-label=\"Open table of contents\"><svg aria-hidden=\"true\" class=\"e-font-icon-svg e-fas-chevron-down\" viewBox=\"0 0 448 512\" xmlns=\"http:\/\/www.w3.org\/2000\/svg\"><path d=\"M207.029 381.476L12.686 187.132c-9.373-9.373-9.373-24.569 0-33.941l22.667-22.667c9.357-9.357 24.522-9.375 33.901-.04L224 284.505l154.745-154.021c9.379-9.335 24.544-9.317 33.901.04l22.667 22.667c9.373 9.373 9.373 24.569 0 33.941L240.971 381.476c-9.373 9.372-24.569 9.372-33.942 0z\"><\/path><\/svg><\/div>\n\t\t\t\t<div class=\"elementor-toc__toggle-button elementor-toc__toggle-button--collapse\" role=\"button\" tabindex=\"0\" aria-controls=\"elementor-toc__3a8aec7\" aria-expanded=\"true\" aria-label=\"Close table of contents\"><svg aria-hidden=\"true\" class=\"e-font-icon-svg e-fas-chevron-up\" viewBox=\"0 0 448 512\" xmlns=\"http:\/\/www.w3.org\/2000\/svg\"><path d=\"M240.971 130.524l194.343 194.343c9.373 9.373 9.373 24.569 0 33.941l-22.667 22.667c-9.357 9.357-24.522 9.375-33.901.04L224 227.495 69.255 381.516c-9.379 9.335-24.544 9.317-33.901-.04l-22.667-22.667c-9.373-9.373-9.373-24.569 0-33.941L207.03 130.525c9.372-9.373 24.568-9.373 33.941-.001z\"><\/path><\/svg><\/div>\n\t\t\t\t\t<\/div>\n\t\t\t\t<div id=\"elementor-toc__3a8aec7\" class=\"elementor-toc__body\">\n\t\t\t<div class=\"elementor-toc__spinner-container\">\n\t\t\t\t<svg class=\"elementor-toc__spinner eicon-animation-spin e-font-icon-svg e-eicon-loading\" aria-hidden=\"true\" viewBox=\"0 0 1000 1000\" xmlns=\"http:\/\/www.w3.org\/2000\/svg\"><path d=\"M500 975V858C696 858 858 696 858 500S696 142 500 142 142 304 142 500H25C25 237 238 25 500 25S975 237 975 500 763 975 500 975Z\"><\/path><\/svg>\t\t\t<\/div>\n\t\t<\/div>\n\t\t\t\t\t\t<\/div>\n\t\t\t\t<\/div>\n\t\t\t\t<\/aside>\n\t\t<section class=\"elementor-element elementor-element-e1a181a e-con-full e-flex e-con e-child\" data-id=\"e1a181a\" data-element_type=\"container\" data-e-type=\"container\">\n\t\t\t\t<div class=\"elementor-element elementor-element-e6fc878 elementor-widget elementor-widget-heading\" data-id=\"e6fc878\" data-element_type=\"widget\" data-e-type=\"widget\" data-widget_type=\"heading.default\">\n\t\t\t\t<div class=\"elementor-widget-container\">\n\t\t\t\t\t<h2 class=\"elementor-heading-title elementor-size-default\">Introduction<\/h2>\t\t\t\t<\/div>\n\t\t\t\t<\/div>\n\t\t\t\t<div class=\"elementor-element elementor-element-efa91b7 elementor-widget elementor-widget-text-editor\" data-id=\"efa91b7\" data-element_type=\"widget\" data-e-type=\"widget\" data-widget_type=\"text-editor.default\">\n\t\t\t\t<div class=\"elementor-widget-container\">\n\t\t\t\t\t\t\t\t\t<p>This Mobile authentication plugin (auth_bfmobile) enables a Passwordless sign in for Moodle by mobile number plus a one time code. It is designed as an accessibility-first on-ramp for users who cannot use traditional credentials \u2014 for example older learners who do not use email, learners who do not remember their password, or learners whose accounts are administered for them by family members.<\/p>\t\t\t\t\t\t\t\t<\/div>\n\t\t\t\t<\/div>\n\t\t<div class=\"elementor-element elementor-element-ec53c01 e-con-full e-flex e-con e-child\" data-id=\"ec53c01\" data-element_type=\"container\" data-e-type=\"container\">\n\t\t\t\t<div class=\"elementor-element elementor-element-ba9c8f1 elementor-widget elementor-widget-image\" data-id=\"ba9c8f1\" data-element_type=\"widget\" data-e-type=\"widget\" data-widget_type=\"image.default\">\n\t\t\t\t<div class=\"elementor-widget-container\">\n\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t<img decoding=\"async\" width=\"1176\" height=\"996\" src=\"https:\/\/docs.brickfield.ie\/auth-bfmobile\/wp-content\/uploads\/sites\/67\/2026\/07\/auth_bfmobile.png\" class=\"attachment-full size-full wp-image-711\" alt=\"The Brickfield mobile login page displays a form where a user enters a mobile number, and clicks on the button &quot;Send code&quot;. On the next phase, the user enters the six digit verification code they received on their mobile, and clicks on the button &quot;Verify and sign in&quot;. A resend code link is also available.\" srcset=\"https:\/\/docs.brickfield.ie\/auth-bfmobile\/wp-content\/uploads\/sites\/67\/2026\/07\/auth_bfmobile.png 1176w, https:\/\/docs.brickfield.ie\/auth-bfmobile\/wp-content\/uploads\/sites\/67\/2026\/07\/auth_bfmobile-300x254.png 300w, https:\/\/docs.brickfield.ie\/auth-bfmobile\/wp-content\/uploads\/sites\/67\/2026\/07\/auth_bfmobile-1024x867.png 1024w, https:\/\/docs.brickfield.ie\/auth-bfmobile\/wp-content\/uploads\/sites\/67\/2026\/07\/auth_bfmobile-768x650.png 768w\" sizes=\"(max-width: 1176px) 100vw, 1176px\" \/>\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t<\/div>\n\t\t\t\t<\/div>\n\t\t\t\t<\/div>\n\t\t\t\t<div class=\"elementor-element elementor-element-b382ccd elementor-widget elementor-widget-heading\" data-id=\"b382ccd\" data-element_type=\"widget\" data-e-type=\"widget\" data-widget_type=\"heading.default\">\n\t\t\t\t<div class=\"elementor-widget-container\">\n\t\t\t\t\t<h2 class=\"elementor-heading-title elementor-size-default\">Administration<\/h2>\t\t\t\t<\/div>\n\t\t\t\t<\/div>\n\t\t\t\t<div class=\"elementor-element elementor-element-88c0b4d elementor-widget elementor-widget-text-editor\" data-id=\"88c0b4d\" data-element_type=\"widget\" data-e-type=\"widget\" data-widget_type=\"text-editor.default\">\n\t\t\t\t<div class=\"elementor-widget-container\">\n\t\t\t\t\t\t\t\t\t<p>This section is for the administration of the Brickfield Mobile Authentication plugin.<\/p>\t\t\t\t\t\t\t\t<\/div>\n\t\t\t\t<\/div>\n\t\t\t\t<div class=\"elementor-element elementor-element-4b6b20e elementor-widget elementor-widget-heading\" data-id=\"4b6b20e\" data-element_type=\"widget\" data-e-type=\"widget\" data-widget_type=\"heading.default\">\n\t\t\t\t<div class=\"elementor-widget-container\">\n\t\t\t\t\t<h3 class=\"elementor-heading-title elementor-size-default\">Version Support<\/h3>\t\t\t\t<\/div>\n\t\t\t\t<\/div>\n\t\t\t\t<div class=\"elementor-element elementor-element-2fb0d6a elementor-widget elementor-widget-text-editor\" data-id=\"2fb0d6a\" data-element_type=\"widget\" data-e-type=\"widget\" data-widget_type=\"text-editor.default\">\n\t\t\t\t<div class=\"elementor-widget-container\">\n\t\t\t\t\t\t\t\t\t<p>This plugin has been developed to work on Moodle releases 4.5, 5.0, 5.1, and 5.2.<\/p>\t\t\t\t\t\t\t\t<\/div>\n\t\t\t\t<\/div>\n\t\t\t\t<div class=\"elementor-element elementor-element-f62a1cd elementor-widget elementor-widget-heading\" data-id=\"f62a1cd\" data-element_type=\"widget\" data-e-type=\"widget\" data-widget_type=\"heading.default\">\n\t\t\t\t<div class=\"elementor-widget-container\">\n\t\t\t\t\t<h3 class=\"elementor-heading-title elementor-size-default\">Installation<\/h3>\t\t\t\t<\/div>\n\t\t\t\t<\/div>\n\t\t\t\t<div class=\"elementor-element elementor-element-1f5bf83 elementor-widget elementor-widget-text-editor\" data-id=\"1f5bf83\" data-element_type=\"widget\" data-e-type=\"widget\" data-widget_type=\"text-editor.default\">\n\t\t\t\t<div class=\"elementor-widget-container\">\n\t\t\t\t\t\t\t\t\t<p>To install the Brickfield mobile authentication plugin (auth-bfmobile):<\/p><ol><li>Unzip and copy the bfmobile folder into Moodle\u2019s auth\/ folder.<\/li><li>Go to Site administration &gt; Notifications to install the plugin.<\/li><li>Enable the plugin at Site administration \u2192 Plugins \u2192 Authentication \u2192 Manage authentication. Tick the enable column for Brickfield Mobile.<\/li><\/ol><p>\u00a0<\/p><p>Further installation instructions can be found on the <a href=\"https:\/\/docs.moodle.org\/400\/en\/Installing_plugins\">Installing plugins<\/a> Moodle documentation page.<\/p>\t\t\t\t\t\t\t\t<\/div>\n\t\t\t\t<\/div>\n\t\t\t\t<div class=\"elementor-element elementor-element-9945a43 elementor-widget elementor-widget-heading\" data-id=\"9945a43\" data-element_type=\"widget\" data-e-type=\"widget\" data-widget_type=\"heading.default\">\n\t\t\t\t<div class=\"elementor-widget-container\">\n\t\t\t\t\t<h3 class=\"elementor-heading-title elementor-size-default\">What it does<\/h3>\t\t\t\t<\/div>\n\t\t\t\t<\/div>\n\t\t\t\t<div class=\"elementor-element elementor-element-f3a643a elementor-widget elementor-widget-text-editor\" data-id=\"f3a643a\" data-element_type=\"widget\" data-e-type=\"widget\" data-widget_type=\"text-editor.default\">\n\t\t\t\t<div class=\"elementor-widget-container\">\n\t\t\t\t\t\t\t\t\t<p>Users go to a dedicated URL provided by their institution (typically distributed via leaflet, QR code, or course outreach). They enter their mobile number, receive a one time code by text message, type the code, and are logged in to Moodle. If the number is new, an account is created automatically.<\/p><p>\u00a0<\/p><p>The plugin does not appear on the standard Moodle login page. The institution&#8217;s existing login methods continue to work unchanged for everyone else.<\/p>\t\t\t\t\t\t\t\t<\/div>\n\t\t\t\t<\/div>\n\t\t\t\t<div class=\"elementor-element elementor-element-53910f5 elementor-widget elementor-widget-heading\" data-id=\"53910f5\" data-element_type=\"widget\" data-e-type=\"widget\" data-widget_type=\"heading.default\">\n\t\t\t\t<div class=\"elementor-widget-container\">\n\t\t\t\t\t<h3 class=\"elementor-heading-title elementor-size-default\">How it differs from a normal auth plugin<\/h3>\t\t\t\t<\/div>\n\t\t\t\t<\/div>\n\t\t\t\t<div class=\"elementor-element elementor-element-6e9734c elementor-widget elementor-widget-text-editor\" data-id=\"6e9734c\" data-element_type=\"widget\" data-e-type=\"widget\" data-widget_type=\"text-editor.default\">\n\t\t\t\t<div class=\"elementor-widget-container\">\n\t\t\t\t\t\t\t\t\t<p>The login page is the plugin&#8217;s own page at \/auth\/bfmobile\/login.php, not the standard \/login\/index.php.<\/p><p>\u00a0<\/p><p>Users authenticate via <strong>SMS code<\/strong>, not username and password. Users created by this plugin have no password and cannot set one.<\/p><p>\u00a0<\/p><p>The plugin can optionally auto-enrol users into a configured course immediately after sign in \u2014 useful for course-specific outreach campaigns.<\/p>\t\t\t\t\t\t\t\t<\/div>\n\t\t\t\t<\/div>\n\t\t\t\t<div class=\"elementor-element elementor-element-4f2e11d elementor-widget elementor-widget-heading\" data-id=\"4f2e11d\" data-element_type=\"widget\" data-e-type=\"widget\" data-widget_type=\"heading.default\">\n\t\t\t\t<div class=\"elementor-widget-container\">\n\t\t\t\t\t<h3 class=\"elementor-heading-title elementor-size-default\">Configuration<\/h3>\t\t\t\t<\/div>\n\t\t\t\t<\/div>\n\t\t\t\t<div class=\"elementor-element elementor-element-d36c2c7 elementor-widget elementor-widget-text-editor\" data-id=\"d36c2c7\" data-element_type=\"widget\" data-e-type=\"widget\" data-widget_type=\"text-editor.default\">\n\t\t\t\t<div class=\"elementor-widget-container\">\n\t\t\t\t\t\t\t\t\t<p>Go to\u00a0 Site administration \u2192 Plugins \u2192 Authentication \u2192 Brickfield Mobile.<\/p><h4>Twilio Verify<\/h4><p>Create a Verify Service in the Twilio Console under Verify \u2192 Services. Enable the SMS channel. Enter the Account SID, Auth Token, and Verify Service SID (starts with VA) into the plugin settings.<\/p><h4>Cloudflare Turnstile<\/h4><p>Create a Turnstile site in the Cloudflare dashboard for your Moodle&#8217;s hostname. Choose the Managed widget type. Enter the Site Key and Secret Key into the plugin settings.<\/p><h4>Identity<\/h4><p>The default region (e.g. IE) is used to interpret phone numbers typed without a country code. For sites with a single primary country, the international dialling code (e.g. +353) is shown as a non-editable prefix next to the phone field so learners only need to type their local number. Twenty-five regions are supported out of the box: IE, GB, US, CA, AU, NZ, DE, FR, ES, IT, NL, BE, LU, PT, SE, DK, FI, NO, PL, AT, CH, CZ, HU, GR, RO. Other regions fall back to a single-input layout.<\/p><p>The username and email templates control how synthetic accounts are named. The defaults (mobile_{digits} and {digits}@mobile.{sitehost}) are sensible for most sites.<\/p><h4>Throttling<\/h4><p>The defaults (5 codes per number per hour, 15 per IP per hour, 30-second cooldown between sends) are conservative. Twilio Verify has its own server-side limits as an authoritative backstop, so these can be relaxed during cohort onboarding if needed.<\/p><h4>Course allowlist and enrolment<\/h4><p>Enter a comma-separated list of course IDs. Only courses on this list can be auto-enrolled into through the plugin. The login page shows a dropdown of these courses for users to choose from. The role used for auto-enrolment defaults to Student.<\/p>\t\t\t\t\t\t\t\t<\/div>\n\t\t\t\t<\/div>\n\t\t\t\t<div class=\"elementor-element elementor-element-758d596 elementor-widget elementor-widget-heading\" data-id=\"758d596\" data-element_type=\"widget\" data-e-type=\"widget\" data-widget_type=\"heading.default\">\n\t\t\t\t<div class=\"elementor-widget-container\">\n\t\t\t\t\t<h3 class=\"elementor-heading-title elementor-size-default\">Distributing the login URL<\/h3>\t\t\t\t<\/div>\n\t\t\t\t<\/div>\n\t\t\t\t<div class=\"elementor-element elementor-element-aaaaa0e elementor-widget elementor-widget-text-editor\" data-id=\"aaaaa0e\" data-element_type=\"widget\" data-e-type=\"widget\" data-widget_type=\"text-editor.default\">\n\t\t\t\t<div class=\"elementor-widget-container\">\n\t\t\t\t\t\t\t\t\t<p>Direct users to:<\/p><p>https:\/\/yourmoodlesite\/auth\/bfmobile\/login.php<\/p><h4>URL parameter:<\/h4><p>?course=N \u2014 when N is an integer course ID on the allowlist, the plugin enters locked-in mode: the dropdown is hidden, the user signs in by phone, and they are auto-enrolled in course N and sent there.<\/p><p>\u00a0<\/p><p>Useful for per-leaflet or per-QR-code targeting where each piece of marketing points at a specific course.<\/p><p>\u00a0<\/p><p>When the URL parameter is absent (or N is not on the allowlist), the plugin falls back to dropdown mode (showing the full allowlist) or no-course mode (when the allowlist is empty), depending on configuration.<\/p><p>\u00a0<\/p><p>Examples:<\/p><ul><li>\/auth\/bfmobile\/login.php?course=42 \u2014 locked-in: leaflet for course 42; the user is enrolled and lands on the course.<\/li><li>\/auth\/bfmobile\/login.php \u2014 dropdown if the allowlist has entries, else no-course mode and a redirect to the configured default URL.<\/li><li>\/auth\/bfmobile\/login.php?course=999999 \u2014 silently ignored if 999999 is not on the allowlist; falls through to dropdown or no-course mode.<\/li><\/ul><p>\u00a0<\/p><p>Course IDs are not stable across environments. A backup\/restore can renumber courses. Validate distribution URLs against the current production database before each print run.<\/p>\t\t\t\t\t\t\t\t<\/div>\n\t\t\t\t<\/div>\n\t\t\t\t<div class=\"elementor-element elementor-element-7494940 elementor-widget elementor-widget-heading\" data-id=\"7494940\" data-element_type=\"widget\" data-e-type=\"widget\" data-widget_type=\"heading.default\">\n\t\t\t\t<div class=\"elementor-widget-container\">\n\t\t\t\t\t<h3 class=\"elementor-heading-title elementor-size-default\">What happens to users over time<\/h3>\t\t\t\t<\/div>\n\t\t\t\t<\/div>\n\t\t\t\t<div class=\"elementor-element elementor-element-a823fa4 elementor-widget elementor-widget-text-editor\" data-id=\"a823fa4\" data-element_type=\"widget\" data-e-type=\"widget\" data-widget_type=\"text-editor.default\">\n\t\t\t\t<div class=\"elementor-widget-container\">\n\t\t\t\t\t\t\t\t\t<p>Users start as synthetic accounts named &#8220;Phone User 4567&#8221; (with the last four digits). They can edit their profile to set a real first name, last name, email, and (if site policy allows) a password. Because the plugin matches on idnumber rather than email or username, those edits do not break their next sign in \u2014 they keep logging in via the phone number, and the other fields become useful for normal Moodle features (gradebook, messaging, certificates).<\/p><p>\u00a0<\/p><p>This means the plugin is an on-ramp, not a cage. Users who gain confidence over time can transition to using Moodle the normal way without losing their progress.<\/p>\t\t\t\t\t\t\t\t<\/div>\n\t\t\t\t<\/div>\n\t\t\t\t<div class=\"elementor-element elementor-element-baa9d99 elementor-widget elementor-widget-heading\" data-id=\"baa9d99\" data-element_type=\"widget\" data-e-type=\"widget\" data-widget_type=\"heading.default\">\n\t\t\t\t<div class=\"elementor-widget-container\">\n\t\t\t\t\t<h3 class=\"elementor-heading-title elementor-size-default\">What happens when someone loses their number<\/h3>\t\t\t\t<\/div>\n\t\t\t\t<\/div>\n\t\t\t\t<div class=\"elementor-element elementor-element-58d2219 elementor-widget elementor-widget-text-editor\" data-id=\"58d2219\" data-element_type=\"widget\" data-e-type=\"widget\" data-widget_type=\"text-editor.default\">\n\t\t\t\t<div class=\"elementor-widget-container\">\n\t\t\t\t\t\t\t\t\t<p>A site administrator updates the user&#8217;s idnumber field (e.g. blank it, or set it to their new number) using the standard Moodle user profile editor.<\/p><p>\u00a0<\/p><p>The user can then sign in with the new number. The plugin does not need a separate UI for this.<\/p>\t\t\t\t\t\t\t\t<\/div>\n\t\t\t\t<\/div>\n\t\t\t\t<div class=\"elementor-element elementor-element-ff5007c elementor-widget elementor-widget-heading\" data-id=\"ff5007c\" data-element_type=\"widget\" data-e-type=\"widget\" data-widget_type=\"heading.default\">\n\t\t\t\t<div class=\"elementor-widget-container\">\n\t\t\t\t\t<h3 class=\"elementor-heading-title elementor-size-default\">Requirements<\/h3>\t\t\t\t<\/div>\n\t\t\t\t<\/div>\n\t\t\t\t<div class=\"elementor-element elementor-element-8233ac4 elementor-widget elementor-widget-text-editor\" data-id=\"8233ac4\" data-element_type=\"widget\" data-e-type=\"widget\" data-widget_type=\"text-editor.default\">\n\t\t\t\t<div class=\"elementor-widget-container\">\n\t\t\t\t\t\t\t\t\t<ul><li>Moodle 4.5 LTS or later.<\/li><li>A Twilio account with a Verify Service configured for SMS.<\/li><li>A Cloudflare account (free) with a Turnstile site configured for the institution&#8217;s domain.<\/li><li>Manual enrolment plugin enabled (it is, by default).<\/li><\/ul>\t\t\t\t\t\t\t\t<\/div>\n\t\t\t\t<\/div>\n\t\t\t\t<div class=\"elementor-element elementor-element-0bae2df elementor-widget elementor-widget-heading\" data-id=\"0bae2df\" data-element_type=\"widget\" data-e-type=\"widget\" data-widget_type=\"heading.default\">\n\t\t\t\t<div class=\"elementor-widget-container\">\n\t\t\t\t\t<h3 class=\"elementor-heading-title elementor-size-default\">External services and third party resources<\/h3>\t\t\t\t<\/div>\n\t\t\t\t<\/div>\n\t\t\t\t<div class=\"elementor-element elementor-element-a9c22fa elementor-widget elementor-widget-text-editor\" data-id=\"a9c22fa\" data-element_type=\"widget\" data-e-type=\"widget\" data-widget_type=\"text-editor.default\">\n\t\t\t\t<div class=\"elementor-widget-container\">\n\t\t\t\t\t\t\t\t\t<p>This plugin requires the operator to hold accounts with, and accept the terms of, the following external services. Reviewers and procurement should be aware of all four. The fourth, the webhook receiver, is optional and is only contacted if the site administrator configures a webhook URL.<\/p><p>\u00a0<\/p><ul><li><strong>Twilio Verify<\/strong> \u2014 phone numbers are sent to Twilio over HTTPS. Twilio sends an SMS to the user containing a one time code, and on the verify call receives the code the user typed back. Operator pays Twilio per verification.<\/li><li><strong>Cloudflare Turnstile<\/strong> \u2014 the requesting browser&#8217;s IP address is sent to Cloudflare over HTTPS during the human verification check on the send-code step. Free at any volume.<\/li><li><strong>Cloudflare Turnstile JavaScript<\/strong> \u2014 the login page loads the Turnstile widget script from https:\/\/challenges.cloudflare.com\/turnstile\/v0\/api.js. This is loaded directly from Cloudflare and not bundled with the plugin; that is required for the widget to function as intended. There is no other client-side JavaScript loaded from any third party.<\/li><li><strong>Webhook receiver<\/strong> (optional) \u2014 if the site administrator configures a webhook URL in plugin settings, user and course identifiers are POSTed to that URL after a successful sign in and\/or enrolment. The URL must be HTTPS and cannot point at private, loopback or link-local addresses (an SSRF defence). Webhook delivery is asynchronous via Moodle&#8217;s task queue, with optional HMAC-SHA256 request signing for the receiver to verify authenticity.<\/li><\/ul><p>\u00a0<\/p><p>All credentials for the above services are configured by the site operator in plugin settings and are never transmitted anywhere except to the named services.<\/p>\t\t\t\t\t\t\t\t<\/div>\n\t\t\t\t<\/div>\n\t\t\t\t<div class=\"elementor-element elementor-element-00f5631 elementor-widget elementor-widget-heading\" data-id=\"00f5631\" data-element_type=\"widget\" data-e-type=\"widget\" data-widget_type=\"heading.default\">\n\t\t\t\t<div class=\"elementor-widget-container\">\n\t\t\t\t\t<h3 class=\"elementor-heading-title elementor-size-default\">Privacy and data flows<\/h3>\t\t\t\t<\/div>\n\t\t\t\t<\/div>\n\t\t\t\t<div class=\"elementor-element elementor-element-a04622b elementor-widget elementor-widget-text-editor\" data-id=\"a04622b\" data-element_type=\"widget\" data-e-type=\"widget\" data-widget_type=\"text-editor.default\">\n\t\t\t\t<div class=\"elementor-widget-container\">\n\t\t\t\t\t\t\t\t\t<p>The plugin stores the phone number in user.idnumber. It sends:<\/p><p>\u00a0<\/p><p>The phone number to Twilio so that Twilio can deliver and verify the one time code. The requesting browser&#8217;s IP address to Cloudflare so that Cloudflare Turnstile can verify the request is not automated.<\/p><p>\u00a0<\/p><p>If a webhook URL is configured by the site administrator, user identifiers (Moodle user ID, phone number, first name, last name) and course identifiers (course ID, shortname, fullname) to the configured webhook receiver after a successful sign in and\/or enrolment.<br \/>OTP send, verify, registration and enrolment events are recorded in Moodle&#8217;s standard log. The phone number is included in the event payload so support staff can correlate sign in attempts via the included report.<\/p><p>\u00a0<\/p><p>When a webhook is configured, the payload to be delivered is briefly stored in the Moodle ad-hoc task queue between event firing and cron delivery. The row is removed once delivery succeeds.<\/p><p>\u00a0<\/p><p>See the privacy provider for full metadata and Site administration \u2192 Users \u2192 Privacy and policies for export and delete behaviour.<\/p>\t\t\t\t\t\t\t\t<\/div>\n\t\t\t\t<\/div>\n\t\t\t\t<div class=\"elementor-element elementor-element-01cbbd3 elementor-widget elementor-widget-heading\" data-id=\"01cbbd3\" data-element_type=\"widget\" data-e-type=\"widget\" data-widget_type=\"heading.default\">\n\t\t\t\t<div class=\"elementor-widget-container\">\n\t\t\t\t\t<h3 class=\"elementor-heading-title elementor-size-default\">Copyright and support<\/h3>\t\t\t\t<\/div>\n\t\t\t\t<\/div>\n\t\t\t\t<div class=\"elementor-element elementor-element-bc74a70 elementor-widget elementor-widget-text-editor\" data-id=\"bc74a70\" data-element_type=\"widget\" data-e-type=\"widget\" data-widget_type=\"text-editor.default\">\n\t\t\t\t<div class=\"elementor-widget-container\">\n\t\t\t\t\t\t\t\t\t<p>This plugin is developed and maintained by Brickfield Education Labs. Brickfield Education Lab is able to provide support for this plugin.<\/p>\t\t\t\t\t\t\t\t<\/div>\n\t\t\t\t<\/div>\n\t\t\t\t<div class=\"elementor-element elementor-element-eedd319 elementor-widget elementor-widget-heading\" data-id=\"eedd319\" data-element_type=\"widget\" data-e-type=\"widget\" data-widget_type=\"heading.default\">\n\t\t\t\t<div class=\"elementor-widget-container\">\n\t\t\t\t\t<h3 class=\"elementor-heading-title elementor-size-default\">Licence<\/h3>\t\t\t\t<\/div>\n\t\t\t\t<\/div>\n\t\t\t\t<div class=\"elementor-element elementor-element-d8bb483 elementor-widget elementor-widget-text-editor\" data-id=\"d8bb483\" data-element_type=\"widget\" data-e-type=\"widget\" data-widget_type=\"text-editor.default\">\n\t\t\t\t<div class=\"elementor-widget-container\">\n\t\t\t\t\t\t\t\t\t<p>GPL v3 or later, in line with Moodle itself.<\/p>\t\t\t\t\t\t\t\t<\/div>\n\t\t\t\t<\/div>\n\t\t\t\t<\/section>\n\t\t\t\t\t<\/div>\n\t\t\t\t<\/div>\n\t\t\t\t\t<\/div>\n\t\t\t\t<\/main>\n\t\t\t\t<\/div>\n\t\t","protected":false},"excerpt":{"rendered":"<p>Home &#8211; Site administrator Brickfield Mobile: Site administrator Table of Contents Introduction This Mobile authentication plugin (auth_bfmobile) enables a Passwordless sign in for Moodle by mobile number plus a one time code. It is designed as an accessibility-first on-ramp for users who cannot use traditional credentials \u2014 for example older learners who do not use [&hellip;]<\/p>\n","protected":false},"author":3,"featured_media":0,"parent":0,"menu_order":0,"comment_status":"closed","ping_status":"closed","template":"elementor_canvas","meta":{"footnotes":""},"class_list":["post-249","page","type-page","status-publish","hentry"],"_links":{"self":[{"href":"https:\/\/docs.brickfield.ie\/auth-bfmobile\/wp-json\/wp\/v2\/pages\/249","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/docs.brickfield.ie\/auth-bfmobile\/wp-json\/wp\/v2\/pages"}],"about":[{"href":"https:\/\/docs.brickfield.ie\/auth-bfmobile\/wp-json\/wp\/v2\/types\/page"}],"author":[{"embeddable":true,"href":"https:\/\/docs.brickfield.ie\/auth-bfmobile\/wp-json\/wp\/v2\/users\/3"}],"replies":[{"embeddable":true,"href":"https:\/\/docs.brickfield.ie\/auth-bfmobile\/wp-json\/wp\/v2\/comments?post=249"}],"version-history":[{"count":157,"href":"https:\/\/docs.brickfield.ie\/auth-bfmobile\/wp-json\/wp\/v2\/pages\/249\/revisions"}],"predecessor-version":[{"id":735,"href":"https:\/\/docs.brickfield.ie\/auth-bfmobile\/wp-json\/wp\/v2\/pages\/249\/revisions\/735"}],"wp:attachment":[{"href":"https:\/\/docs.brickfield.ie\/auth-bfmobile\/wp-json\/wp\/v2\/media?parent=249"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}