Aktualisiere Versionsnummer auf 3.2.4 in README.md, package.json, package-lock.json und package-solution.json. Füge Validierungen für sichere Formular-Elemente in CustomBrandingSettingsProvider hinzu und erweitere Tests entsprechend.

README.md

@@ -6,7 +6,7 @@ PortalSettings V3 ist ein providerbasiertes SPFx-WebPart für SharePoint Server
 
 | Eigenschaft | Wert |
 |---|---|
-| Version | 3.2.2 |
+| Version | 3.2.4 |
 | SharePoint Framework | 1.4.1 |
 | Build-Node | 8.17.0 |
 | npm | 6.x |
@@ -23,6 +23,12 @@ Die Oberfläche wird vollständig vom WebPart erzeugt und verwendet kein `innerH
 - Auswahl des Navigationstermsets aus dem Default Site Collection Term Store
 - Mega-Menu- oder Flyout-Modus
 - Cache-Dauer und Cache-Version
+
+### Custom Branding
+
+- sichere Header- und Footer-Elemente sowie Stylesheets
+- deklarative GET-Suchformulare über die erlaubten Elementtypen `form` und `input`
+- Prüfung von Formular-Action, Eingabetyp und Submit-Button vor dem Speichern
 - Debug-Modus
 - schemaerhaltendes Speichern unbekannter Properties
 
@@ -165,7 +171,7 @@ sharepoint/solution/portal-settings.sppkg
 
 ## Installation
 
-1. `portal-settings.sppkg` im App Catalog durch Version `3.2.2.0` ersetzen.
+1. `portal-settings.sppkg` im App Catalog durch Version `3.2.4.0` ersetzen.
 2. Die App im Root Web der gewünschten Site Collection installieren oder aktualisieren.
 3. Die Seite mit dem PnP-PowerShell-Skript erzeugen beziehungsweise reparieren:
 

ToDo.md

@@ -2,7 +2,7 @@
 
 Stand: 21.07.2026  
 Branch: `dev-3.0`  
-Zielversion: 3.2.2
+Zielversion: 3.2.4
 
 ## Architektur
 

config/package-solution.json

@@ -3,7 +3,7 @@
   "solution": {
     "name": "portal-settings-client-side-solution",
     "id": "1c98e32d-bb7b-43b7-9625-074d6e4ea286",
-    "version": "3.2.2.0",
+    "version": "3.2.4.0",
     "includeClientSideAssets": true,
     "skipFeatureDeployment": false
   },

package-lock.json

@@ -1,6 +1,6 @@
 {
   "name": "portal-settings",
-  "version": "3.2.2",
+  "version": "3.2.4",
   "lockfileVersion": 1,
   "requires": true,
   "dependencies": {

package.json

@@ -1,6 +1,6 @@
 {
   "name": "portal-settings",
-  "version": "3.2.2",
+  "version": "3.2.4",
   "private": true,
   "main": "lib/index.js",
   "engines": {

src/providers/CustomBrandingSettingsProvider.ts

@@ -31,7 +31,7 @@ export const CustomBrandingSettingsProvider: ISettingsProvider<ICustomBrandingSe
       title: 'Custom Branding Application Customizer',
       description: 'MSFT-Custom-Solution:CustomBranding',
       location: 'ClientSideExtension.ApplicationCustomizer',
-      sequence: 100
+      sequence: 90
     }
   },
   sections: [
@@ -140,7 +140,7 @@ export const CustomBrandingSettingsProvider: ISettingsProvider<ICustomBrandingSe
   }
 };
 
-const AllowedTags: string[] = ['div', 'span', 'p', 'a', 'button', 'img', 'h1', 'h2', 'h3', 'strong', 'em', 'nav', 'section'];
+const AllowedTags: string[] = ['div', 'span', 'p', 'a', 'button', 'form', 'input', 'img', 'h1', 'h2', 'h3', 'strong', 'em', 'nav', 'section'];
 function validateElements(elements: any[], path: string, depth: number, state: { count: number }, errors: string[]): void { // tslint:disable-line:no-any
   if (depth > 8) { errors.push(path + ' überschreitet die maximale Tiefe von 8.'); return; }
   if (!Array.isArray(elements)) { errors.push(path + ' muss ein Array sein.'); return; }
@@ -154,6 +154,21 @@ function validateElements(elements: any[], path: string, depth: number, state: {
     if (tag === 'img' && (!element.attributes || typeof element.attributes.alt !== 'string')) {
       errors.push(path + '[' + i + '] ist ein Bild ohne alt-Attribut.');
     }
+    if (tag === 'form') {
+      const action: string = String(element.attributes && element.attributes.action || '').trim();
+      if (!action || !isSafeFormAction(action)) { errors.push(path + '[' + i + '] besitzt keine sichere Formular-Action.'); }
+      if (element.attributes && element.attributes.method && String(element.attributes.method).toLowerCase() !== 'get') {
+        errors.push(path + '[' + i + '] darf nur die Formularmethode GET verwenden.');
+      }
+    }
+    if (tag === 'input' && element.attributes && element.attributes.type &&
+      String(element.attributes.type).toLowerCase() !== 'search') {
+      errors.push(path + '[' + i + '] darf nur den Eingabetyp search verwenden.');
+    }
+    if (tag === 'button' && element.attributes && element.attributes.type &&
+      ['button', 'submit'].indexOf(String(element.attributes.type).toLowerCase()) < 0) {
+      errors.push(path + '[' + i + '] verwendet einen nicht erlaubten Button-Typ.');
+    }
     if (element.attributes && typeof element.attributes === 'object') {
       Object.keys(element.attributes).forEach((name: string): void => {
         const lower: string = name.toLowerCase(); const attributeValue: string = String(element.attributes[name] || '');
@@ -170,3 +185,9 @@ function validateElements(elements: any[], path: string, depth: number, state: {
     if (element.children) { validateElements(element.children, path + '[' + i + '].children', depth + 1, state, errors); }
   }
 }
+
+function isSafeFormAction(value: string): boolean {
+  if (/^~sitecollection(?:\/|$)/i.test(value) || /^\/(?!\/)/.test(value)) { return true; }
+  const protocol: RegExpMatchArray = value.match(/^([a-z][a-z0-9+.-]*):/i);
+  return !!protocol && (protocol[1].toLowerCase() === 'http' || protocol[1].toLowerCase() === 'https');
+}

src/services/PortalSettingsDataService.ts

@@ -54,7 +54,7 @@ export class PortalSettingsDataService {
     const merged: any = mergePreservingUnknown(item.originalConfig, item.provider.normalize(item.config));
     if (item.provider.storage.kind === 'siteUserCustomAction') {
       const persist: Promise<IUserCustomActionInfo> = item.context.action
-        ? this.saveUserCustomAction(item.context.action, merged).then((): IUserCustomActionInfo => item.context.action)
+        ? this.saveUserCustomAction(item.context.action, merged, item.provider).then((): IUserCustomActionInfo => item.context.action)
         : this.createUserCustomAction(item.provider, merged);
       return persist.then((action: IUserCustomActionInfo): void => {
         item.context.action = action;
@@ -252,12 +252,13 @@ export class PortalSettingsDataService {
       .then((payload: any): any => payload.d || payload);
   }
 
-  private saveUserCustomAction(action: IUserCustomActionInfo, config: any): Promise<void> {
+  private saveUserCustomAction(action: IUserCustomActionInfo, config: any, provider: ISettingsProvider<any>): Promise<void> {
     const url: string = this.siteUrl + "/_api/site/UserCustomActions(guid'" + action.id + "')";
     const body: any = {
       '__metadata': { 'type': action.entityType || 'SP.UserCustomAction' },
       'ClientSideComponentProperties': JSON.stringify(config)
     };
+    if (provider.storage.action) { body.Sequence = provider.storage.action.sequence; }
     return this.context.spHttpClient.post(url, SPHttpClient.configurations.v1, {
       headers: this.writeHeaders('MERGE'), body: JSON.stringify(body)
     }).then((response: SPHttpClientResponse): Promise<void> => this.ensureOk(response, 'Konfiguration konnte nicht gespeichert werden.'));

tests/ProviderRegistry.test.ts

@@ -25,6 +25,7 @@ const mega: ISettingsProvider<any> = getSettingsProvider('megamenu'); // tslint:
 assert(!!mega.storage.action, 'MegaMenu-Aktivierungsdefinition fehlt.');
 assert(mega.storage.action.name === 'MegaMenu', 'MegaMenu Action-Name ist nicht stabil.');
 assert(mega.storage.action.location === 'ClientSideExtension.ApplicationCustomizer', 'MegaMenu Action-Location ist ungültig.');
+assert(mega.storage.action.sequence === 100, 'MegaMenu Action-Sequenz ist nicht stabil.');
 const normalizedMega: any = mega.normalize({ cacheMinutes: 5000, cacheVersion: '', unknownFuture: 'keep', menuMode: 'other' }); // tslint:disable-line:no-any
 assert(normalizedMega.cacheMinutes === 1440, 'MegaMenu Cache-Maximum greift nicht.');
 assert(normalizedMega.cacheVersion === '1', 'MegaMenu Cache-Fallback fehlt.');
@@ -52,6 +53,7 @@ const branding: ISettingsProvider<any> = getSettingsProvider('custombranding');
 assert(!!branding.storage.action, 'CustomBranding-Aktivierungsdefinition fehlt.');
 assert(branding.storage.action.name === 'CustomBranding', 'CustomBranding Action-Name ist nicht stabil.');
 assert(branding.storage.action.location === 'ClientSideExtension.ApplicationCustomizer', 'CustomBranding Action-Location ist ungültig.');
+assert(branding.storage.action.sequence === 90, 'CustomBranding muss vor MegaMenu geladen werden.');
 const defaultBranding: any = branding.createDefault(); // tslint:disable-line:no-any
 assert(defaultBranding.placeholderbottom.elements.length === 0,
   'PortalSettings darf keinen Runtime-Standard-Footer in die Konfiguration schreiben.');
@@ -62,6 +64,14 @@ assert(normalizedBranding.elements === undefined, 'Legacy-Root-Elemente werden n
 const unsafeBranding: any = branding.createDefault(); // tslint:disable-line:no-any
 unsafeBranding.placeholdertop.elements = [{ type: 'script', content: 'alert(1)' }, { type: 'a', attributes: { onclick: 'alert(1)', href: 'javascript:alert(1)' } }];
 assert(branding.validate(unsafeBranding).length >= 3, 'Unsichere Branding-Elemente werden nicht erkannt.');
+const searchBranding: any = branding.createDefault(); // tslint:disable-line:no-any
+searchBranding.placeholdertop.elements = [{
+  type: 'form', attributes: { action: '~sitecollection/_layouts/15/search.aspx/siteall', method: 'get' },
+  children: [{ type: 'input', attributes: { type: 'search', name: 'q' } }]
+}];
+assert(branding.validate(searchBranding).length === 0, 'Sichere deklarative Suchformulare werden nicht akzeptiert.');
+searchBranding.placeholdertop.elements[0].attributes.action = 'javascript:alert(1)';
+assert(branding.validate(searchBranding).length > 0, 'Unsichere Formular-Actions werden nicht erkannt.');
 
 const expiry: ISettingsProvider<any> = getSettingsProvider('expiryindicator'); // tslint:disable-line:no-any
 const normalizedExpiry: any = expiry.normalize({ baseField: 'Invalid field', future: true }); // tslint:disable-line:no-any

tests/validate-static-assets.js

@@ -22,8 +22,8 @@ var sourceFiles = [
 ].map(read).join('\n');
 var dataService = read('src/services/PortalSettingsDataService.ts');
 
-assert(packageJson.version === '3.2.2', 'Package-Version ist nicht 3.2.2.');
-assert(solution.version === '3.2.2.0', 'Solution-Version ist nicht 3.2.2.0.');
+assert(packageJson.version === '3.2.4', 'Package-Version ist nicht 3.2.4.');
+assert(solution.version === '3.2.4.0', 'Solution-Version ist nicht 3.2.4.0.');
 assert(!solution.features, 'Das inkompatible Seiten-Provisioning-Feature darf nicht paketiert werden.');
 assert(!!config.bundles['portal-settings-web-part'], 'WebPart-Bundle fehlt.');
 assert(copyAssets.deployCdnPath === 'temp/deploy', 'Ship-Assets werden nicht nach temp/deploy geschrieben.');
@@ -34,6 +34,8 @@ assert(sourceFiles.indexOf('innerHTML') < 0, 'UI darf innerHTML nicht verwenden.
 assert(dataService.indexOf('/_api/site/rootweb/UserCustomActions') >= 0 &&
   dataService.indexOf('siteActions.concat(values[1])') >= 0,
   'Root-Web-Actions werden nicht für die Provider-Erkennung berücksichtigt.');
+assert(dataService.indexOf('body.Sequence = provider.storage.action.sequence') >= 0,
+  'Bestehende Actions werden nicht auf die Provider-Sequence aktualisiert.');
 ['themePrimary', 'neutralPrimary', 'neutralLight', 'white'].forEach(function (slot) {
   assert(styles.indexOf('[theme: ' + slot + ', default:') >= 0, 'Themeslot fehlt: ' + slot);
 });