Changes for page XWiki Two-Factor Authentication
Last modified by Alex Cotiuga on 2026/07/13 06:59
From version 30.7
edited by Alex Cotiuga
on 2026/07/13 06:59
on 2026/07/13 06:59
Change comment:
There is no comment for this version
Summary
-
Page properties (3 modified, 0 added, 0 removed)
-
Attachments (0 modified, 0 added, 13 removed)
- 2fa-authenticator.png
- mfa-admin-configuration.png
- mfa-admin-full.png
- mfa-admin-overview.png
- mfa-admin-user-management.png
- mfa-login-verification-code.png
- mfa-login-verification-setup.png
- mfa-recovery-codes-generated.png
- mfa-recovery-codes-not-generated.png
- mfa-trusted-devices.png
- mfa-user-profile-full.png
- mfa-user-profile-overview.png
- mfa-user-setup-qr.png
Details
- Page properties
-
- Default language
-
... ... @@ -1,0 +1,1 @@ 1 +en - Hidden
-
... ... @@ -1,1 +1,1 @@ 1 - true1 +false - Content
-
... ... @@ -1,91 +1,77 @@ 1 1 {{velocity}} 2 2 #set ($discard = $xwiki.ssx.use('PublicWebSite.WebHome')) 3 +#set ($discard = $xwiki.ssx.use('products.WebHome')) 3 3 4 4 #set ($mainCapabilityItems = [{ 5 5 'title': 'Second verification step', 6 6 'icon': 'key', 7 - 'content': 'Add an additional verification s creen afterthenormal XWiki usernameand password login.'8 + 'content': 'After the normal username and password check, users complete an additional verification step before accessing XWiki.' 8 8 },{ 9 9 'title': 'Authenticator app codes', 10 10 'icon': 'mobile', 11 - 'content': ' Let users verify access with time-based TOTP codes generated by authenticator applications.'12 + 'content': 'Users can verify access with time-based TOTP codes generated by authenticator applications on mobile or desktop devices.' 12 12 },{ 13 - 'title': ' Recoveryandtrusteddevices',14 - 'icon': ' shield',15 - 'content': ' Providebackupaccesswithrecoverycodesandreducerepeatedpromptsontrustedbrowsers.'14 + 'title': 'Email verification codes', 15 + 'icon': 'envelope-o', 16 + 'content': 'Users can receive one-time verification codes by email when an authenticator app is not available or preferred.' 16 16 }]) 17 17 18 -#set ($adminExperienceItems = [{ 19 - 'title': 'Rollout policy', 20 - 'icon': 'cog', 21 - 'content': 'Make additional verification optional at first or required for all users from the XWiki Administration section.' 22 -},{ 23 - 'title': 'Configuration options', 24 - 'icon': 'sliders', 25 - 'content': 'Set the authenticator issuer name, recovery-code count and trusted-device duration.' 26 -},{ 27 - 'title': 'Administration overview', 28 - 'icon': 'table', 29 - 'content': 'Review adoption with summary indicators and a filterable Live Data table.' 30 -}]) 19 +#set ($useCaseItems = [ 20 + 'Protecting administrator accounts', 21 + 'Improving access security for internal knowledge bases', 22 + 'Securing private documentation platforms and intranets', 23 + 'Supporting remote-user access policies', 24 + 'Strengthening customer or partner portals', 25 + 'Preparing for security reviews or broader compliance initiatives' 26 +]) 31 31 32 -#set ($userExperienceItems = [{ 33 - 'title': 'Self-service setup', 34 - 'icon': 'qrcode', 35 - 'content': 'Users configure the second verification step from their profile by scanning a QR code or entering the setup key manually.' 36 -},{ 37 - 'title': 'Login verification', 38 - 'icon': 'sign-in', 39 - 'content': 'After the normal login, users enter the verification code generated by their authenticator app.' 40 -},{ 41 - 'title': 'Trusted browser option', 42 - 'icon': 'desktop', 43 - 'content': 'Users can trust the current browser for the configured duration after successful verification.' 44 -}]) 28 +#set ($adminCapabilityItems = [ 29 + 'Require MFA for all users', 30 + 'Define the issuer name displayed in authenticator applications', 31 + 'Configure trusted-device duration', 32 + 'Configure how many recovery codes are generated', 33 + 'Reset a user’s MFA setup when needed', 34 + 'Review MFA adoption from the administration overview' 35 +]) 45 45 46 -#set ($selfServiceItems = [{ 47 - 'title': 'Recovery codes', 48 - 'icon': 'life-ring', 49 - 'content': 'Recovery codes provide backup access when a user loses access to the authenticator application.' 50 -},{ 51 - 'title': 'Trusted devices', 52 - 'icon': 'desktop', 53 - 'content': 'Trusted devices can be reviewed and removed from the user profile.' 54 -},{ 55 - 'title': 'Profile management', 56 - 'icon': 'user', 57 - 'content': 'Users can review status, generate recovery codes, manage trusted devices and reset their setup.' 58 -}]) 37 +#set ($overviewItems = [ 38 + 'Number of users scanned', 39 + 'Users with MFA configured', 40 + 'Users without MFA configured', 41 + 'Users with trusted devices', 42 + 'Recovery-code status', 43 + 'Unused and total recovery-code count', 44 + 'Trusted-device count' 45 +]) 59 59 60 -#set ($adminSupportItems = [{ 61 - 'title': 'User status', 62 - 'icon': 'user', 63 - 'content': 'Administrators can open a user profile and check the verification status for that account.' 64 -},{ 65 - 'title': 'Setup reset', 66 - 'icon': 'refresh', 67 - 'content': 'Administrators can reset the setup when a user needs to restart the configuration process.' 68 -},{ 69 - 'title': 'Controlled recovery', 70 - 'icon': 'unlock-alt', 71 - 'content': 'Resetting the setup removes the authenticator configuration, recovery codes and trusted devices for that user.' 72 -}]) 47 +#set ($profileItems = [ 48 + 'Configure MFA', 49 + 'Review MFA status', 50 + 'Generate or regenerate recovery codes', 51 + 'Review trusted devices', 52 + 'Remove individual trusted devices', 53 + 'Remove all trusted devices', 54 + 'Reset MFA setup' 55 +]) 73 73 74 74 #set ($rolloutItems = [{ 75 - 'title': ' Startwitha pilot group',76 - 'content': ' Testtheextension withadministratorsorasmalluser group before enablingit widely.'58 + 'title': 'Install and configure the extension', 59 + 'content': 'Start by validating compatibility with the current XWiki version and authentication setup.' 77 77 },{ 78 - 'title': 'Define the rolloutpolicy',79 - 'content': 'Decide whether additionalverificationshould be optionalatfirst or required for all users.'61 + 'title': 'Define the MFA policy', 62 + 'content': 'Decide whether MFA should be optional, required for administrators, or required for all users.' 80 80 },{ 81 - 'title': 'Configure recovery options',82 - 'content': 'Choose the number ofrecovery codes and whether trusted devicesshould be allowed.'64 + 'title': 'Configure recovery and trusted devices', 65 + 'content': 'Choose whether users can rely on recovery codes and whether trusted browsers or devices are allowed.' 83 83 },{ 84 - 'title': ' Informusers',85 - 'content': ' Explainhowusersconfiguretheauthenticator app,saverecoverycodesandmanagetrusted devices.'67 + 'title': 'Test with a pilot group', 68 + 'content': 'Validate the setup and login flow with administrators or a small group before wider rollout.' 86 86 },{ 70 + 'title': 'Communicate the user process', 71 + 'content': 'Explain how users should configure MFA, store recovery codes and manage trusted devices.' 72 +},{ 87 87 'title': 'Monitor adoption', 88 - 'content': 'Use the administration overview to identify users who still need to configure protection.'74 + 'content': 'Use the administration overview to identify users who still need to configure MFA.' 89 89 }]) 90 90 91 91 {{html clean="false"}} ... ... @@ -94,25 +94,19 @@ 94 94 <div class="container hero-inner"> 95 95 <div class="hero-kicker"> 96 96 <i class="fa fa-lock" aria-hidden="true"></i> 97 - XWiki 2FA withMFArollout support83 + XWiki 2FA and MFA 98 98 </div> 99 99 100 100 <h1 id="product-title">XWiki Two-Factor Authentication</h1> 101 101 102 102 <p class="lead"> 103 - Protect XWiki logins with a uthenticatorappverification,recoverycodes,104 - trusteddevices and administration controlsfora safer rollout.89 + Protect XWiki logins with a second verification step using authenticator app codes, 90 + email verification codes, or both. 105 105 </p> 106 106 107 - <ul class="benefits"> 108 - <li><strong>Extension from €75/year</strong></li> 109 - <li><strong>Basic setup from €150</strong></li> 110 - <li>MFA rollout support available</li> 111 - </ul> 112 - 113 113 <div class="hero-actions"> 114 114 <a class="btn btn-primary" href="$xwiki.getURL('contact.WebHome')">Ask about this extension</a> 115 - <a class="btn btn-secondary" href="$xwiki.getURL('pr icing.WebHome')#common-packages">ViewMFAsetupprice</a>95 + <a class="btn btn-secondary" href="$xwiki.getURL('products.WebHome')">View all products</a> 116 116 </div> 117 117 </div> 118 118 </section> ... ... @@ -124,16 +124,21 @@ 124 124 <h2 id="overview-title">Two-factor authentication built into XWiki</h2> 125 125 126 126 <p> 127 - XWiki Two-Factor Authentication adds anadditional verificationstep to the standard128 - XWiki login flow.Users continue to sign in with their normal username and password,129 - thenconfirmaccess with a time-based code from anauthenticatorapplication.107 + XWiki Two-Factor Authentication adds MFA/2FA support to the standard XWiki login flow. 108 + Users continue to sign in with their normal username and password, then confirm access with 109 + an additional verification method. 130 130 </p> 131 131 132 132 <p> 133 - The applicationhas evolved beyond asimple login-codescreen.It supportsglobal134 - e nforcement,recoverycodes,trusted devices,userself-service,administrator135 - resetactionsand an overview for monitoring adoption.113 + The extension supports authenticator app codes, email-delivered verification codes, or a combined 114 + setup where both methods are required. It improves account protection without replacing the familiar 115 + XWiki authentication experience. 136 136 </p> 117 + 118 + <p> 119 + It is designed for organizations that use XWiki for internal knowledge bases, intranets, 120 + documentation platforms, customer portals, workflows or other business-critical applications. 121 + </p> 137 137 </article> 138 138 139 139 <aside class="product-info-card" aria-labelledby="quick-facts-title"> ... ... @@ -140,12 +140,12 @@ 140 140 <h3 id="quick-facts-title">Quick facts</h3> 141 141 <ul> 142 142 <li>Works with the standard XWiki login flow</li> 143 - <li>Supports TOTP authenticator applications</li> 144 - <li>Can require additional verification for all users</li> 145 - <li>Includes one-time recovery codes</li> 128 + <li>Supports authenticator app codes using TOTP</li> 129 + <li>Supports email-delivered one-time verification codes</li> 130 + <li>Can require app code and email code together</li> 131 + <li>Includes recovery codes for backup access</li> 146 146 <li>Can remember trusted browsers or devices</li> 147 - <li>Includes user self-service controls</li> 148 - <li>Includes an administration overview</li> 133 + <li>Includes administration and user setup controls</li> 149 149 </ul> 150 150 </aside> 151 151 </div> ... ... @@ -152,13 +152,13 @@ 152 152 </div> 153 153 </section> 154 154 155 -<section aria-labelledby=" capabilities-title">140 +<section aria-labelledby="features-title"> 156 156 <div class="container"> 157 - <h2 id=" capabilities-title">Main capabilities</h2>142 + <h2 id="features-title">Main capabilities</h2> 158 158 159 159 <p class="section-intro"> 160 - A focused set of authenticationprotectionfeatures for stronger XWiki accountsecurity161 - without replacingthe familiar login experience.145 + A focused set of MFA/2FA features for stronger XWiki account protection without changing 146 + the standard login experience. 162 162 </p> 163 163 164 164 <div class="product-feature-grid"> ... ... @@ -182,29 +182,32 @@ 182 182 <div class="container"> 183 183 <div class="product-layout"> 184 184 <article class="product-summary-card"> 185 - <h2 id="security-title">Useful for XWiki security and accessprotection</h2>170 + <h2 id="security-title">Useful for XWiki security and NIS 2 readiness</h2> 186 186 187 187 <p> 188 - Many organizations useXWikitostoreinternal documentation,procedures,operational189 - knowledge andbusiness-criticalinformation.Addingan additional authenticationfactorhelps190 - r educethe risk of accountcompromisewhena passwordis exposed orreused.173 + Many organizations need multi-factor authentication for enterprise software, including internal 174 + knowledge bases, intranets, documentation platforms and systems containing operational procedures 175 + or sensitive business information. 191 191 </p> 192 192 193 193 <p> 194 - The extension is especially useful for protecting administrator accounts, remote users, 195 - private knowledge bases and customer or partner portals. 179 + For organizations using XWiki, adding two-factor authentication directly to the standard login flow 180 + can help close a practical access-control gap. It can be useful for administrator accounts, 181 + remote users, private knowledge bases and broader security readiness initiatives such as NIS 2 preparation. 196 196 </p> 183 + 184 + <p> 185 + This extension is not a complete compliance solution on its own, but it provides an important 186 + technical control for protecting access to XWiki. 187 + </p> 197 197 </article> 198 198 199 199 <aside class="product-info-card" aria-labelledby="use-cases-title"> 200 200 <h3 id="use-cases-title">Typical use cases</h3> 201 201 <ul> 202 - <li>Administrator account protection</li> 203 - <li>Internal knowledge base security</li> 204 - <li>Private documentation platforms</li> 205 - <li>Remote user access protection</li> 206 - <li>Customer or partner portals</li> 207 - <li>Security review, MFA rollout and compliance readiness</li> 193 + #foreach ($item in $useCaseItems) 194 + <li>$item</li> 195 + #end 208 208 </ul> 209 209 </aside> 210 210 </div> ... ... @@ -211,268 +211,258 @@ 211 211 </div> 212 212 </section> 213 213 214 -<section aria-labelledby="admin- experience-title">202 +<section aria-labelledby="admin-title"> 215 215 <div class="container"> 216 - <h2 id="admin-experience-title">Administrator configuration and monitoring</h2> 204 + <div class="product-layout"> 205 + <article class="product-summary-card"> 206 + <h2 id="admin-title">Administrator configuration</h2> 217 217 218 - <p class="section-intro">219 - Administrators c an configure thepolicy,definerecoveryoptionsandmonitoradoption220 - from theXWikiAdministration section.221 - </p> 208 + <p> 209 + Administrators configure MFA from the XWiki Administration section. The configuration is intentionally 210 + simple, so the rollout can be adapted to the organization’s security policy and user base. 211 + </p> 222 222 223 - <div class="product-feature-grid"> 224 - #foreach ($entry in $adminExperienceItems) 225 - <article class="product-feature"> 226 - <div class="card-heading"> 227 - <div class="feature-icon"> 228 - <i class="fa fa-$entry.icon" aria-hidden="true"></i> 229 - </div> 230 - <h3>$entry.title</h3> 231 - </div> 213 + <p> 214 + MFA can be optional or required for all users. When MFA is required, users who have not configured it yet 215 + are guided through the setup flow from their profile or during login. 216 + </p> 232 232 233 - <p>$entry.content</p> 234 - </article> 235 - #end 218 + <p> 219 + If trusted devices should not be allowed, the trusted-device duration can be set to 0. 220 + If recovery codes should not be available, the recovery-code number can be set to 0. 221 + </p> 222 + </article> 223 + 224 + <aside class="product-info-card" aria-labelledby="admin-capabilities-title"> 225 + <h3 id="admin-capabilities-title">Administrators can</h3> 226 + <ul> 227 + #foreach ($item in $adminCapabilityItems) 228 + <li>$item</li> 229 + #end 230 + </ul> 231 + </aside> 236 236 </div> 233 + </div> 234 +</section> 237 237 238 238 {{/html}} 239 239 240 240 {{gallery}} 241 241 [[image:mfa-admin-configuration.png]] 242 -[[image:mfa-admin-overview.png]] 243 -[[image:mfa-admin-full.png]] 244 244 {{/gallery}} 245 245 246 246 {{html clean="false"}} 247 247 248 - <p class="product-gallery-caption"> 249 - Administration screens for configuring the policy and reviewing adoption across users. 250 - </p> 251 - </div> 252 -</section> 253 - 254 -<section class="product-section-muted" aria-labelledby="user-experience-title"> 244 +<section aria-labelledby="admin-overview-title"> 255 255 <div class="container"> 256 - <h2 id="user-experience-title">User setup and login verification</h2> 246 + <div class="product-layout"> 247 + <article class="product-summary-card"> 248 + <h2 id="admin-overview-title">MFA overview for administrators</h2> 257 257 258 - <p class="section-intro">259 - Userscanconfiguretheauthenticatorapp fromtheir profile orduring theenforcedsetupflow,260 - thenverifyfutureloginswitha generatedcode.261 - </p> 250 + <p> 251 + The Administration section includes an MFA overview page that helps administrators understand adoption 252 + and usage across the wiki. 253 + </p> 262 262 263 - <div class="product-feature-grid"> 264 - #foreach ($entry in $userExperienceItems) 265 - <article class="product-feature"> 266 - <div class="card-heading"> 267 - <div class="feature-icon"> 268 - <i class="fa fa-$entry.icon" aria-hidden="true"></i> 269 - </div> 270 - <h3>$entry.title</h3> 271 - </div> 255 + <p> 256 + The overview displays summary indicators and a Live Data table with MFA-related information. 257 + The table is filterable and sortable, making it suitable for installations with many users. 258 + </p> 259 + </article> 272 272 273 - <p>$entry.content</p> 274 - </article> 275 - #end 261 + <aside class="product-info-card" aria-labelledby="overview-data-title"> 262 + <h3 id="overview-data-title">The overview can show</h3> 263 + <ul> 264 + #foreach ($item in $overviewItems) 265 + <li>$item</li> 266 + #end 267 + </ul> 268 + </aside> 276 276 </div> 270 + </div> 271 +</section> 277 277 278 278 {{/html}} 279 279 280 280 {{gallery}} 281 -[[image:mfa-user-setup-qr.png]] 282 -[[image:mfa-login-verification-setup.png]] 283 -[[image:mfa-login-verification-code.png]] 276 +[[image:mfa-admin-overview.png]] 284 284 {{/gallery}} 285 285 286 286 {{html clean="false"}} 287 287 288 - <p class="product-gallery-caption"> 289 - User setup, enforced configuration and login verification screens. 290 - </p> 291 - </div> 292 -</section> 293 - 294 -<section aria-labelledby="self-service-title"> 281 +<section class="product-section-muted" aria-labelledby="user-setup-title"> 295 295 <div class="container"> 296 - <h2 id="self-service-title">Recovery codes and trusted devices</h2> 283 + <div class="product-layout"> 284 + <article class="product-summary-card"> 285 + <h2 id="user-setup-title">User setup experience</h2> 297 297 298 - <p class="section-intro"> 299 - Recovery codes and trusted devices help balance stronger access protection with a smoother user experience. 300 - </p> 287 + <p> 288 + Users can configure MFA from their profile page. During setup, the user scans a QR code with 289 + an authenticator application. 290 + </p> 301 301 302 - <div class="product-feature-grid"> 303 - #foreach ($entry in $selfServiceItems) 304 - <article class="product-feature"> 305 - <div class="card-heading"> 306 - <div class="feature-icon"> 307 - <i class="fa fa-$entry.icon" aria-hidden="true"></i> 308 - </div> 309 - <h3>$entry.title</h3> 310 - </div> 292 + <p> 293 + If scanning is not possible, the setup page also provides the account name and secret key that can be 294 + entered manually. After the generated verification code is entered successfully, MFA is activated for 295 + the user account. 296 + </p> 297 + </article> 311 311 312 - <p>$entry.content</p> 313 - </article> 314 - #end 299 + <aside class="product-info-card" aria-labelledby="login-flow-title"> 300 + <h3 id="login-flow-title">Login flow</h3> 301 + <ul> 302 + <li>User signs in with the normal XWiki credentials</li> 303 + <li>XWiki asks for the configured verification code</li> 304 + <li>The user enters the app code, email code, or both</li> 305 + <li>A recovery code can be used when enabled and available</li> 306 + <li>A trusted browser or device can be remembered when allowed</li> 307 + </ul> 308 + </aside> 315 315 </div> 310 + </div> 311 +</section> 316 316 317 317 {{/html}} 318 318 319 319 {{gallery}} 320 -[[image:mfa-user-profile-overview.png]] 321 -[[image:mfa-recovery-codes-not-generated.png]] 322 -[[image:mfa-recovery-codes-generated.png]] 323 -[[image:mfa-trusted-devices.png]] 324 -[[image:mfa-user-profile-full.png]] 316 +[[image:mfa-user-setup-qr.png]] 317 +[[image:mfa-login-verification.png]] 325 325 {{/gallery}} 326 326 327 327 {{html clean="false"}} 328 328 329 - <p class="product-gallery-caption"> 330 - User profile screens for recovery codes, trusted devices and self-service management. 331 - </p> 332 - </div> 333 -</section> 334 - 335 -<section class="product-section-muted" aria-labelledby="admin-support-title"> 322 +<section aria-labelledby="recovery-title"> 336 336 <div class="container"> 337 - <h2 id="admin-support-title">Administrator support and user recovery</h2> 324 + <div class="product-layout"> 325 + <article class="product-summary-card"> 326 + <h2 id="recovery-title">Recovery codes</h2> 338 338 339 - <p class="section-intro"> 340 - Administrators can help users recover from lost devices or restart setup when needed. 341 - </p> 328 + <p> 329 + Recovery codes provide a backup access method when a user loses access to the authenticator application 330 + or cannot complete the normal verification flow. 331 + </p> 342 342 343 - <div class="product-feature-grid"> 344 - #foreach ($entry in $adminSupportItems) 345 - <article class="product-feature"> 346 - <div class="card-heading"> 347 - <div class="feature-icon"> 348 - <i class="fa fa-$entry.icon" aria-hidden="true"></i> 349 - </div> 350 - <h3>$entry.title</h3> 351 - </div> 333 + <p> 334 + Recovery codes are generated for the user and displayed only once. Each code can be used one time. 335 + When new recovery codes are generated, previous recovery codes are invalidated. 336 + </p> 352 352 353 - <p>$entry.content</p> 354 - </article> 355 - #end 338 + <p> 339 + Users should save their recovery codes in a secure location immediately after generation. 340 + Administrators can configure how many recovery codes are generated, and setting the number to 0 disables them. 341 + </p> 342 + </article> 343 + 344 + <aside class="product-info-card" aria-labelledby="trusted-devices-title"> 345 + <h3 id="trusted-devices-title">Trusted devices</h3> 346 + <ul> 347 + <li>Reduce repeated MFA prompts on known browsers or devices</li> 348 + <li>Remain valid for the configured number of days</li> 349 + <li>Can be reviewed and removed from the user profile</li> 350 + <li>The current trusted browser is marked in the list</li> 351 + <li>Removed when a user’s MFA setup is reset</li> 352 + </ul> 353 + </aside> 356 356 </div> 355 + </div> 356 +</section> 357 357 358 358 {{/html}} 359 359 360 360 {{gallery}} 361 -[[image:mfa-admin-user-management.png]] 361 +[[image:mfa-recovery-codes.png]] 362 +[[image:mfa-trusted-devices.png]] 362 362 {{/gallery}} 363 363 364 364 {{html clean="false"}} 365 365 366 - <p class="product-gallery-caption"> 367 - Administrator view for checking and resetting a user setup. 368 - </p> 369 - </div> 370 -</section> 371 - 372 -<section aria-labelledby="faq-title"> 367 +<section class="product-section-muted" aria-labelledby="profile-title"> 373 373 <div class="container"> 374 - <h2 id="faq-title">Frequently asked questions</h2> 369 + <div class="product-layout"> 370 + <article class="product-summary-card"> 371 + <h2 id="profile-title">User and administrator management</h2> 375 375 376 - <p class="section-intro"> 377 - Common questions about how the extension works, how users configure it and how administrators can manage rollout and recovery. 378 - </p> 379 - 380 - <div class="resource-content"> 381 - <details class="resource-faq-item"> 382 - <summary>Does this extension replace the standard XWiki login?</summary> 383 383 <p> 384 - No.Usersstillsigninwiththeir normalXWikiusername andpassword. The extensionadds385 - an additionalverificationstepafterthestandardlogincheck.374 + The user profile contains a dedicated MFA section. Users can configure MFA, review their status, 375 + manage recovery codes and manage trusted devices from this area. 386 386 </p> 387 - </details> 388 388 389 - <details class="resource-faq-item"> 390 - <summary>Which verification method is used?</summary> 391 391 <p> 392 - Usersverifyaccesswith time-basedcodesgeneratedbyanauthenticator application.393 - Th esetuppageprovides aQRcodeandamanualsetupkey.379 + Administrators can also open a user profile and access the MFA section for that user. 380 + This is useful when a user loses access to their authenticator application or needs to restart the setup process. 394 394 </p> 395 - </details> 396 396 397 - <details class="resource-faq-item"> 398 - <summary>Can the second verification step be required for all users?</summary> 399 399 <p> 400 - Yes. Administrators can make theverificationstepoptionalorrequiredforallusers401 - fro mtheXWikiAdministrationsection.384 + Resetting MFA removes the authenticator app setup, invalidates recovery codes and removes trusted devices. 385 + If MFA is required globally, the user will be asked to configure MFA again at the next login. 402 402 </p> 403 - </ details>387 + </article> 404 404 405 - <details class="resource-faq-item"> 406 - <summary>What happens if a user loses access to the authenticator app?</summary> 407 - <p> 408 - Recovery codes can provide backup access when enabled. Administrators can also reset 409 - the user setup so the configuration process can be restarted. 410 - </p> 411 - </details> 389 + <aside class="product-info-card" aria-labelledby="profile-actions-title"> 390 + <h3 id="profile-actions-title">Profile actions</h3> 391 + <ul> 392 + #foreach ($item in $profileItems) 393 + <li>$item</li> 394 + #end 395 + </ul> 396 + </aside> 397 + </div> 398 + </div> 399 +</section> 412 412 413 - <details class="resource-faq-item"> 414 - <summary>Can trusted browsers or devices be disabled?</summary> 415 - <p> 416 - Yes. Administrators can configure how long trusted devices remain valid. Setting the 417 - trusted-device duration to 0 disables this option. 418 - </p> 419 - </details> 401 +{{/html}} 420 420 421 - <details class="resource-faq-item"> 422 - <summary>Is this only a basic 2FA login-code screen?</summary> 423 - <p> 424 - No. The main login mechanism is two-factor authentication, but the application also includes 425 - features needed for a safer organization-wide rollout: enforcement policy, recovery codes, 426 - trusted devices, user self-service, administrator monitoring and administrator reset actions. 427 - </p> 428 - </details> 403 +{{gallery}} 404 +[[image:mfa-user-profile-overview.png]] 405 +[[image:mfa-admin-user-management.png]] 406 +{{/gallery}} 429 429 430 - <details class="resource-faq-item"> 431 - <summary>Is this enough for compliance on its own?</summary> 432 - <p> 433 - No. This extension provides an important access-protection control, but it should be part 434 - of a broader security and compliance approach that includes permissions, upgrades, 435 - infrastructure, monitoring and operational procedures. 436 - </p> 437 - </details> 438 - </div> 408 +{{html clean="false"}} 409 + 410 +<section aria-labelledby="rollout-title"> 411 + <div class="container"> 412 + <h2 id="rollout-title">Rollout recommendations</h2> 413 + 414 + <p class="section-intro"> 415 + For a smooth rollout, start with a small administrator or pilot group before requiring MFA for everyone. 416 + A gradual rollout helps validate the configuration, prepare communication and reduce support issues. 417 + </p> 418 + 419 + <ol class="process-list"> 420 + #foreach ($entry in $rolloutItems) 421 + <li> 422 + <strong>$entry.title</strong> 423 + $entry.content 424 + </li> 425 + #end 426 + </ol> 439 439 </div> 440 440 </section> 441 441 442 -<section class="product-section-muted" aria-labelledby=" rollout-title">430 +<section class="product-section-muted" aria-labelledby="planning-title"> 443 443 <div class="container"> 444 444 <div class="product-layout"> 445 445 <article class="product-summary-card"> 446 - <h2 id=" rollout-title">Rolloutrecommendations</h2>434 + <h2 id="planning-title">Planning installation</h2> 447 447 448 448 <p> 449 - For a smooth rollout, start with a small administrator or pilot group before requiring 450 - the additional verification step for everyone. This helps validate the configuration, 451 - prepare user communication and reduce support issues. 437 + Before installing or rolling out MFA, it is useful to review the current XWiki version, 438 + authentication setup, user base and security expectations. 452 452 </p> 453 453 454 - <ol class="process-list"> 455 - #foreach ($entry in $rolloutItems) 456 - <li> 457 - <strong>$entry.title</strong> 458 - $entry.content 459 - </li> 460 - #end 461 - </ol> 441 + <p> 442 + This helps define whether MFA should be optional, required for selected users, or enforced globally. 443 + It also helps decide whether trusted devices and recovery codes should be enabled. 444 + </p> 462 462 </article> 463 463 464 - <aside class="product-info-card" aria-labelledby="planning-title"> 465 - <h3 id="planning-title">Useful information before installation</h3> 466 - 467 - <p class="product-card-note"> 468 - These details help evaluate compatibility, rollout scope and configuration options. 469 - </p> 470 - 447 + <aside class="product-info-card" aria-labelledby="planning-info-title"> 448 + <h3 id="planning-info-title">Useful information before installation</h3> 471 471 <ul> 472 472 <li>XWiki version</li> 473 473 <li>Single wiki or wiki farm with subwikis</li> 474 474 <li>Current authentication setup</li> 475 - <li>Optional or required rolloutpolicy</li>453 + <li>Optional or globally required MFA policy</li> 476 476 <li>Trusted-device policy</li> 477 477 <li>Recovery-code policy</li> 478 478 <li>Rollout communication needs</li> ... ... @@ -488,11 +488,12 @@ 488 488 <h2 id="cta-title">Interested in using this extension?</h2> 489 489 490 490 <p> 491 - Send a short message with your XWiki version, current authentication setup and rollout goal. 469 + Send a short message with your XWiki version, authentication setup and whether you need 470 + authenticator app codes, email verification codes, combined verification, recovery codes 471 + or trusted-device remembering. 492 492 </p> 493 493 494 494 <a class="btn btn-primary" href="$xwiki.getURL('contact.WebHome')">Contact Agnease</a> 495 - <a class="btn btn-secondary" href="$xwiki.getURL('pricing.WebHome')#common-packages">View MFA setup price</a> 496 496 </div> 497 497 </div> 498 498 </section>
- 2fa-authenticator.png
-
- Author
-
... ... @@ -1,1 +1,0 @@ 1 -XWiki.Admin - Size
-
... ... @@ -1,1 +1,0 @@ 1 -1.1 MB - Content
- mfa-admin-configuration.png
-
- Author
-
... ... @@ -1,1 +1,0 @@ 1 -XWiki.Admin - Size
-
... ... @@ -1,1 +1,0 @@ 1 -125.3 KB - Content
- mfa-admin-full.png
-
- Author
-
... ... @@ -1,1 +1,0 @@ 1 -XWiki.Admin - Size
-
... ... @@ -1,1 +1,0 @@ 1 -184.3 KB - Content
- mfa-admin-overview.png
-
- Author
-
... ... @@ -1,1 +1,0 @@ 1 -XWiki.Admin - Size
-
... ... @@ -1,1 +1,0 @@ 1 -64.7 KB - Content
- mfa-admin-user-management.png
-
- Author
-
... ... @@ -1,1 +1,0 @@ 1 -XWiki.Admin - Size
-
... ... @@ -1,1 +1,0 @@ 1 -90.8 KB - Content
- mfa-login-verification-code.png
-
- Author
-
... ... @@ -1,1 +1,0 @@ 1 -XWiki.Admin - Size
-
... ... @@ -1,1 +1,0 @@ 1 -23.6 KB - Content
- mfa-login-verification-setup.png
-
- Author
-
... ... @@ -1,1 +1,0 @@ 1 -XWiki.Admin - Size
-
... ... @@ -1,1 +1,0 @@ 1 -115.9 KB - Content
- mfa-recovery-codes-generated.png
-
- Author
-
... ... @@ -1,1 +1,0 @@ 1 -XWiki.Admin - Size
-
... ... @@ -1,1 +1,0 @@ 1 -38.5 KB - Content
- mfa-recovery-codes-not-generated.png
-
- Author
-
... ... @@ -1,1 +1,0 @@ 1 -XWiki.Admin - Size
-
... ... @@ -1,1 +1,0 @@ 1 -27.0 KB - Content
- mfa-trusted-devices.png
-
- Author
-
... ... @@ -1,1 +1,0 @@ 1 -XWiki.Admin - Size
-
... ... @@ -1,1 +1,0 @@ 1 -59.1 KB - Content
- mfa-user-profile-full.png
-
- Author
-
... ... @@ -1,1 +1,0 @@ 1 -XWiki.Admin - Size
-
... ... @@ -1,1 +1,0 @@ 1 -197.5 KB - Content
- mfa-user-profile-overview.png
-
- Author
-
... ... @@ -1,1 +1,0 @@ 1 -XWiki.Admin - Size
-
... ... @@ -1,1 +1,0 @@ 1 -193.4 KB - Content
- mfa-user-setup-qr.png
-
- Author
-
... ... @@ -1,1 +1,0 @@ 1 -XWiki.Admin - Size
-
... ... @@ -1,1 +1,0 @@ 1 -176.6 KB - Content