Last modified by Agnease on 2026/06/08 18:44

From version 3.12
edited by Agnease
on 2026/06/08 18:44
Change comment: There is no comment for this version
To version 1.4
edited by Agnease
on 2026/05/26 07:47
Change comment: There is no comment for this version

Summary

Details

Page properties
Content
... ... @@ -28,14 +28,10 @@
28 28   <h4>In this guide</h4>
29 29   <ul>
30 30   <li><a href="#why-it-matters">Why it matters</a></li>
31 - <li><a href="#quick-self-check">Quick self-check</a></li>
32 32   <li><a href="#what-to-review">What to review</a></li>
33 - <li><a href="#common-findings">Common findings</a></li>
34 34   <li><a href="#security-checklist">Security checklist</a></li>
35 35   <li><a href="#review-output">What the review should produce</a></li>
36 - <li><a href="#readiness-checklist">What to prepare</a></li>
37 37   <li><a href="#when-to-review">When to run a review</a></li>
38 - <li><a href="#security-review-faq">FAQ</a></li>
39 39   </ul>
40 40   </aside>
41 41  
... ... @@ -48,11 +48,6 @@
48 48   </p>
49 49  
50 50   <p>
51 - An XWiki security review is a practical audit of the platform configuration, access model,
52 - authentication setup, installed extensions, custom code, infrastructure and recovery procedures.
53 - </p>
54 -
55 - <p>
56 56   Security risks are often hidden in less visible areas: outdated versions, inherited permissions,
57 57   forgotten administrator accounts, overly powerful rights, old extensions, undocumented scripts,
58 58   weak fallback access or backup assumptions that were never tested.
... ... @@ -60,20 +60,6 @@
60 60  
61 61   <div class="resource-note">
62 62   <p>
63 - <strong>In practice:</strong> an XWiki security review should evaluate the XWiki version,
64 - access rights, authentication setup, installed extensions, custom code, infrastructure,
65 - backups, restore expectations and the operational practices used to maintain the instance.
66 - </p>
67 - </div>
68 -
69 - <p>
70 - The value of the review is not only to find technical issues. It is to understand how the instance is actually
71 - used, where risk has accumulated over time, and what should be cleaned up before the next upgrade, migration,
72 - authentication change or business-critical rollout.
73 - </p>
74 -
75 - <div class="resource-note">
76 - <p>
77 77   <strong>The main point:</strong> an XWiki security review should not only check whether the application
78 78   is online. It should evaluate the platform, the access model and the operational practices around it.
79 79   </p>
... ... @@ -93,34 +93,10 @@
93 93   </p>
94 94  
95 95   <p>
96 - In real XWiki instances, security problems are rarely caused by a single visible mistake. They often come from
97 - years of small configuration decisions: one temporary group, one local right exception, one old extension, one
98 - undocumented script, one backup procedure that nobody has tested recently.
73 + A security review helps identify risks before they become incidents, upgrade blockers or maintenance
74 + surprises. It also gives administrators a clearer view of the current state of the instance.
99 99   </p>
100 100  
101 - <h2 id="quick-self-check">Quick self-check: does your XWiki need a security review?</h2>
102 -
103 - <p>
104 - Your XWiki instance may need a security review if one or more of these situations sound familiar.
105 - </p>
106 -
107 - <ul class="resource-checklist">
108 - <li>You are not sure who currently has admin, script or programming rights.</li>
109 - <li>The instance has not been upgraded regularly or the upgrade path is unclear.</li>
110 - <li>SSO, LDAP, OIDC or SAML was configured years ago and not reviewed recently.</li>
111 - <li>Custom scripts, templates, macros or extensions exist but are not clearly documented.</li>
112 - <li>Groups and page-level rights have grown organically over several years.</li>
113 - <li>Backups exist, but the restore process has not been tested or documented.</li>
114 - <li>A new team inherited the instance and has to guess how rights, extensions or customizations were configured.</li>
115 - </ul>
116 -
117 - <div class="resource-note">
118 - <p>
119 - <strong>Practical signal:</strong> if the instance works but nobody can clearly explain the access model,
120 - the customizations and the recovery process, the risk is not only technical. It is operational.
121 - </p>
122 - </div>
123 -
124 124   <h2 id="what-to-review">What should be reviewed</h2>
125 125  
126 126   <h3>1. Version and upgrade status</h3>
... ... @@ -135,11 +135,6 @@
135 135   A repeatable upgrade process is part of the security posture of a long-running XWiki instance.
136 136   </p>
137 137  
138 - <p>
139 - For more details on upgrade planning, see
140 - <a href="$xwiki.getURL('resources.why-upgrade-xwiki')">why regular XWiki upgrades matter</a>.
141 - </p>
142 -
143 143   <h3>2. Access rights and permission model</h3>
144 144   <p>
145 145   XWiki has a powerful access-rights system, but this flexibility needs a clear governance model. A review
... ... @@ -153,13 +153,6 @@
153 153   of small exceptions that nobody reviewed later.
154 154   </p>
155 155  
156 - <p>
157 - For a deeper look at this topic, see
158 - <a href="$xwiki.getURL('resources.xwiki-access-rights-governance')">why XWiki access rights need a clear governance model</a>.
159 - For a practical starting point, see
160 - <a href="$xwiki.getURL('resources.xwiki-access-rights-review')">how to start an XWiki access-rights review</a>.
161 - </p>
162 -
163 163   <h3>3. Authentication and identity management</h3>
164 164   <p>
165 165   Authentication should be reviewed beyond the simple question of whether users can log in. LDAP, Active
... ... @@ -184,11 +184,6 @@
184 184   discovered accidentally during an incident or a production upgrade.
185 185   </p>
186 186  
187 - <p>
188 - Customizations should also be reviewed from a maintenance perspective. See
189 - <a href="$xwiki.getURL('resources.xwiki-custom-development')">how to keep XWiki custom development maintainable across upgrades</a>.
190 - </p>
191 -
192 192   <h3>5. Configuration, infrastructure and operations</h3>
193 193   <p>
194 194   The review should also cover the environment around XWiki: HTTPS and reverse proxy configuration, database
... ... @@ -201,55 +201,9 @@
201 201   knows what is included, how long recovery would take or whether the restore process has ever been tested.
202 202   </p>
203 203  
204 - <div class="resource-inline-cta">
205 - <p>
206 - <strong>Need a clearer view of your XWiki security posture?</strong>
207 - A structured review can check versions, access rights, authentication,
208 - extensions, custom code, infrastructure, backups and operational practices.
209 - </p>
210 - <a class="btn btn-default" href="$xwiki.getURL('contact.WebHome')">Request a security review</a>
211 - </div>
140 + <h2 id="security-checklist">Practical XWiki security review checklist</h2>
212 212  
213 - <h2 id="common-findings">Common findings in real XWiki security reviews</h2>
214 -
215 - <p>
216 - In real XWiki instances, security risks are often not caused by one major mistake. They usually come from
217 - configuration decisions that were reasonable at the time but were never reviewed together later.
218 - </p>
219 -
220 220   <ul class="resource-checklist">
221 - <li>Old administrator accounts that are still active.</li>
222 - <li>Script or programming rights granted to users who no longer maintain the platform.</li>
223 - <li>Groups created for old projects that still grant access.</li>
224 - <li>Page-level rights added as exceptions and never documented.</li>
225 - <li>Custom Velocity or Groovy code that is business-critical but undocumented.</li>
226 - <li>Extensions installed years ago without a clear owner or upgrade validation process.</li>
227 - <li>SSO configured correctly for login, but not reviewed together with XWiki groups.</li>
228 - <li>Backup jobs scheduled automatically, but restore expectations never tested.</li>
229 - <li>Production changes performed without a staging or rollback habit.</li>
230 - </ul>
231 -
232 - <h2 id="what-this-is-not">What this review is not</h2>
233 -
234 - <p>
235 - A security review is not a one-click scan and it is not limited to checking the installed XWiki version.
236 - Automated checks can help, but they cannot fully explain why a group has access, whether a custom script is still
237 - needed, or whether a restore procedure would actually work during an incident.
238 - </p>
239 -
240 - <p>
241 - The review should combine technical checks with context: how the wiki is used, which areas are sensitive, which
242 - users administer it, what customizations matter and what the organization expects during an incident or upgrade.
243 - </p>
244 -
245 - <h2 id="security-checklist">XWiki security review checklist</h2>
246 -
247 - <p>
248 - A practical XWiki security review should cover both application-level and operational risks.
249 - The following checklist can be used as a starting point when reviewing a production instance.
250 - </p>
251 -
252 - <ul class="resource-checklist">
253 253   <li>Check the current XWiki version, target version and upgrade path.</li>
254 254   <li>Review installed extensions, outdated components and unsupported customizations.</li>
255 255   <li>Audit administrator, script and programming rights.</li>
... ... @@ -265,8 +265,8 @@
265 265   <h2 id="review-output">What the review should produce</h2>
266 266  
267 267   <p>
268 - A useful security review should not only produce a list of detected problems. It should produce a practical
269 - action plan. Each finding should explain the risk, the affected area, the recommended action and the priority.
158 + A useful security review should not only produce a list of problems. It should produce a practical action
159 + plan. Each finding should explain the risk, the affected area, the recommended action and the priority.
270 270   </p>
271 271  
272 272   <p>
... ... @@ -275,41 +275,6 @@
275 275   reviewing extensions or preparing the next upgrade.
276 276   </p>
277 277  
278 - <div class="resource-note">
279 - <p>
280 - <strong>A useful review should separate findings by priority:</strong> immediate risks,
281 - planned remediation, maintenance improvements and documentation gaps. This makes the result
282 - easier to act on instead of producing a generic list of observations.
283 - </p>
284 - </div>
285 -
286 - <h3>Example review finding</h3>
287 -
288 - <table class="table table-bordered table-striped">
289 - <thead>
290 - <tr>
291 - <th>Finding</th>
292 - <th>Risk</th>
293 - <th>Recommended action</th>
294 - <th>Priority</th>
295 - </tr>
296 - </thead>
297 - <tbody>
298 - <tr>
299 - <td>Several users have script rights but are no longer responsible for XWiki administration.</td>
300 - <td>Powerful rights remain active without clear ownership.</td>
301 - <td>Confirm the current need, remove obsolete assignments and document approved technical users.</td>
302 - <td>High</td>
303 - </tr>
304 - <tr>
305 - <td>Backups are scheduled, but the restore process has not been tested recently.</td>
306 - <td>Recovery expectations may be incorrect during an incident.</td>
307 - <td>Document backup coverage and perform a restore validation on a test environment.</td>
308 - <td>Medium</td>
309 - </tr>
310 - </tbody>
311 - </table>
312 -
313 313   <p>
314 314   The best outcome is a clearer, safer and more maintainable XWiki instance: one where administrators
315 315   understand the access model, critical features are documented and future upgrades can be planned with
... ... @@ -316,24 +316,6 @@
316 316   fewer surprises.
317 317   </p>
318 318  
319 - <h2 id="readiness-checklist">XWiki security review readiness checklist</h2>
320 -
321 - <p>
322 - Before starting a security review, prepare the following information. This makes the review faster and helps
323 - identify risks more clearly.
324 - </p>
325 -
326 - <ul class="resource-checklist">
327 - <li>Current XWiki version and target upgrade version, if an upgrade is planned.</li>
328 - <li>List of installed extensions and known custom applications.</li>
329 - <li>Authentication method: local users, LDAP, OIDC, SAML, SSO or MFA.</li>
330 - <li>Known restricted spaces, confidential areas or public-facing pages.</li>
331 - <li>List of technical administrators and users with powerful rights.</li>
332 - <li>Known custom scripts, templates, macros, UI extensions or Java components.</li>
333 - <li>Backup location, frequency and last restore test, if known.</li>
334 - <li>Staging or test environment availability.</li>
335 - </ul>
336 -
337 337   <h2 id="when-to-review">When should an XWiki security review be done?</h2>
338 338  
339 339   <p>
... ... @@ -347,89 +347,15 @@
347 347   permissions, extensions, customizations and recovery procedures were configured years earlier.
348 348   </p>
349 349  
350 - <div class="resource-note related-resources">
351 - <p><strong>Security review series:</strong></p>
352 - <ul>
353 - <li>
354 - <a href="$xwiki.getURL('resources.xwiki-security-review')">What an XWiki security review should actually include</a>
355 - </li>
356 - <li>
357 - <a href="$xwiki.getURL('resources.xwiki-access-rights-governance')">Why XWiki access rights need a clear governance model</a>
358 - </li>
359 - <li>
360 - <a href="$xwiki.getURL('resources.xwiki-access-rights-review')">How to start an XWiki access-rights review</a>
361 - </li>
362 - </ul>
187 + <div class="resource-note">
363 363   <p>
364 - Future topics will cover authentication and access control, script and programming rights,
365 - backup validation, extension review and operational practices.
189 + Related resources:
190 + <a href="$xwiki.getURL('resources.why-upgrade-xwiki')">why regular XWiki upgrades matter</a>
191 + and
192 + <a href="$xwiki.getURL('resources.xwiki-custom-development')">how to keep XWiki custom development maintainable across upgrades</a>.
366 366   </p>
367 367   </div>
368 368  
369 - <h2 id="security-review-faq">XWiki security review FAQ</h2>
370 -
371 - <details class="resource-faq-item" open>
372 - <summary>What should an XWiki security review include?</summary>
373 - <p>
374 - An XWiki security review should include the installed XWiki version, upgrade path,
375 - access rights, groups, authentication setup, installed extensions, custom code,
376 - infrastructure, backups, restore expectations and operational procedures.
377 - </p>
378 - </details>
379 -
380 - <details class="resource-faq-item">
381 - <summary>Is an updated XWiki instance automatically secure?</summary>
382 - <p>
383 - No. Updating XWiki is important, but security also depends on permissions,
384 - authentication, extensions, custom code, infrastructure configuration, backups
385 - and how the instance is maintained.
386 - </p>
387 - </details>
388 -
389 - <details class="resource-faq-item">
390 - <summary>Does SSO solve XWiki access control?</summary>
391 - <p>
392 - No. SSO helps authenticate users, but access control still depends on XWiki groups,
393 - inherited permissions, page-level rights and administrative privileges.
394 - </p>
395 - </details>
396 -
397 - <details class="resource-faq-item">
398 - <summary>Why should custom code be reviewed?</summary>
399 - <p>
400 - Custom scripts, templates, macros, UI extensions and Java components can affect
401 - permissions, workflows, rendering, integrations and upgrade behavior. They should
402 - be identified, documented and tested.
403 - </p>
404 - </details>
405 -
406 - <details class="resource-faq-item">
407 - <summary>When should an XWiki security review be done?</summary>
408 - <p>
409 - A review is useful before a major upgrade, after years of organic growth, after
410 - authentication changes, before exposing the wiki more broadly, or when the instance
411 - becomes business-critical.
412 - </p>
413 - </details>
414 -
415 - <div class="resource-note related-resources">
416 - <p><strong>Related resources:</strong></p>
417 - <ul>
418 - <li>
419 - <a href="$xwiki.getURL('resources.xwiki-access-rights-governance')">Why XWiki access rights need a clear governance model</a>
420 - </li>
421 - <li>
422 - <a href="$xwiki.getURL('resources.xwiki-access-rights-review')">How to start an XWiki access-rights review</a>
423 - </li>
424 - <li>
425 - <a href="$xwiki.getURL('resources.why-upgrade-xwiki')">Why regular XWiki upgrades matter</a>
426 - </li>
427 - <li>
428 - <a href="$xwiki.getURL('resources.xwiki-custom-development')">How to keep XWiki custom development maintainable across upgrades</a>
429 - </li>
430 - </ul>
431 - </div>
432 -
433 433   <div class="resource-cta">
434 434   <h3>Need an XWiki security review?</h3>
435 435   <p>
... ... @@ -446,54 +446,5 @@
446 446   </div>
447 447   </section>
448 448  
449 - <script type="application/ld+json">
450 - {
451 - "@context": "https://schema.org",
452 - "@type": "FAQPage",
453 - "mainEntity": [
454 - {
455 - "@type": "Question",
456 - "name": "What should an XWiki security review include?",
457 - "acceptedAnswer": {
458 - "@type": "Answer",
459 - "text": "An XWiki security review should include the installed XWiki version, upgrade path, access rights, groups, authentication setup, installed extensions, custom code, infrastructure, backups, restore expectations and operational procedures."
460 - }
461 - },
462 - {
463 - "@type": "Question",
464 - "name": "Is an updated XWiki instance automatically secure?",
465 - "acceptedAnswer": {
466 - "@type": "Answer",
467 - "text": "No. Updating XWiki is important, but security also depends on permissions, authentication, extensions, custom code, infrastructure configuration, backups and how the instance is maintained."
468 - }
469 - },
470 - {
471 - "@type": "Question",
472 - "name": "Does SSO solve XWiki access control?",
473 - "acceptedAnswer": {
474 - "@type": "Answer",
475 - "text": "No. SSO helps authenticate users, but access control still depends on XWiki groups, inherited permissions, page-level rights and administrative privileges."
476 - }
477 - },
478 - {
479 - "@type": "Question",
480 - "name": "Why should custom code be reviewed in XWiki?",
481 - "acceptedAnswer": {
482 - "@type": "Answer",
483 - "text": "Custom scripts, templates, macros, UI extensions and Java components can affect permissions, workflows, rendering, integrations and upgrade behavior. They should be identified, documented and tested."
484 - }
485 - },
486 - {
487 - "@type": "Question",
488 - "name": "When should an XWiki security review be done?",
489 - "acceptedAnswer": {
490 - "@type": "Answer",
491 - "text": "A review is useful before a major upgrade, after years of organic growth, after authentication changes, before exposing the wiki more broadly, or when the instance becomes business-critical."
492 - }
493 - }
494 - ]
495 - }
496 - </script>
497 -
498 498  {{/html}}
499 499  {{/velocity}}
xwiki-security-review.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.Admin
Size
... ... @@ -1,1 +1,0 @@
1 -1.3 MB
Content
Agnease.Code.SEODetailsClass[0]
metaTitle
... ... @@ -1,1 +1,1 @@
1 -What an XWiki Security Review Should Actually Include | Agnease
1 +XWiki Security Review Checklist: What to Check and Why