docs: add documentation for rule DOK.21

mmjohansson · mmjohansson · commit 69b3548d0776 · 2025-11-05T13:59:32.000+01:00
Signed-off-by: Mats Johansson &lt;extern.mats.johansson@digg.se&gt;
diff --git a/GUIDELINES.md b/GUIDELINES.md
@@ -41,6 +41,7 @@ Detta dokument specificerar reglerna som verktyget tillämpar.
    - [ID: DOK.17](#id-dok17)
    - [ID: DOK.19](#id-dok19)
    - [ID: DOK.20](#id-dok20)
+   - [ID: DOK.21](#id-dok21)
 2. [Område: Datum- och tidsformat](#område-datum--och-tidsformat)
    - [ID: DOT.01](#id-dot01)
    - [ID: DOT.04](#id-dot04)
@@ -93,7 +94,7 @@ Detta dokument specificerar reglerna som verktyget tillämpar.
 
 ## Område: Dokumentation
 
-**Täckningsgrad: 46%**
+**Täckningsgrad: 50%**
 
 ### ID: DOK.01
 
@@ -405,6 +406,33 @@ I exemplet ovan, så exemplifieras regeln med GET samt en POST operation, där r
 
 ---
 
+### ID: DOK.21
+
+**Krav:** Krav på autentisering SKALL anges i specifikationen.
+
+**Typ:** SKALL
+
+**JSON Path Plus-uttryck:**
+
+```
+$
+```
+
+**Förklaring:**
+Regeln förutsätter att det finns minst en förekomst av objektet `security`, antingen på rot- eller operationsnivå.
+
+**Exempel:**
+
+![Exempelbild som visar var security-objektet kan existera i en OpenAPI description](images/dok21-1.png)
+
+_Security-objektet kan existera på antingen rot- eller operationsnivå, eller båda._
+
+![Exempelbild som visar att security-objektet också kan användas när API:et saknar säkerhet](images/dok21-2.png)
+
+_Om säkerhet saknas så bör det signaleras genom att tilldela security-objektet en tom array._
+
+---
+
 ## Område: Datum- och tidsformat
 
 **Täckningsgrad: 50%**
diff --git a/REUSE.toml b/REUSE.toml
@@ -30,6 +30,7 @@ path = [
     "images/dok17.png",
     "images/dok19.png",
     "images/dok20.png",
+    "images/dok21.png",
     "images/dok3.png",
     "images/dok6-1.png",
     "images/dok6-2.png",
diff --git a/images/dok21-1.png b/images/dok21-1.png
diff --git a/images/dok21-2.png b/images/dok21-2.png
diff --git a/src/rulesets/DokRules.ts b/src/rulesets/DokRules.ts
@@ -439,7 +439,7 @@ export class Dok21 extends BaseRuleset {
     id: 'DOK.21',
   };
   given = '$';
-  message = 'Krav på autentisering SKALL anges i specifikationen ';
+  message = 'Krav på autentisering SKALL anges i specifikationen.';
   then = [
     {
       function: (targetVal: OpenAPIObject, _opts: string, paths: string[]) => {
diff --git a/tests/unit/dok.test.ts b/tests/unit/dok.test.ts
@@ -527,7 +527,7 @@ testRule('Dok21', [
     },
     errors: [
       {
-        message: 'Krav på autentisering SKALL anges i specifikationen',
+        message: 'Krav på autentisering SKALL anges i specifikationen.',
         severity: DiagnosticSeverity.Error,
       },
     ],

Original file line number	Diff line number	Diff line change
`@@ -439,7 +439,7 @@ export class Dok21 extends BaseRuleset {`
`439`	`439`	`id: 'DOK.21',`
`440`	`440`	`};`
`441`	`441`	`given = '$';`
`442`		`- message = 'Krav på autentisering SKALL anges i specifikationen ';`
	`442`	`+ message = 'Krav på autentisering SKALL anges i specifikationen.';`
`443`	`443`	`then = [`
`444`	`444`	`{`
`445`	`445`	`function: (targetVal: OpenAPIObject, _opts: string, paths: string[]) => {`
Original file line number	Diff line number	Diff line change
`@@ -527,7 +527,7 @@ testRule('Dok21', [`
`527`	`527`	`},`
`528`	`528`	`errors: [`
`529`	`529`	`{`
`530`		`- message: 'Krav på autentisering SKALL anges i specifikationen',`
	`530`	`+ message: 'Krav på autentisering SKALL anges i specifikationen.',`
`531`	`531`	`severity: DiagnosticSeverity.Error,`
`532`	`532`	`},`
`533`	`533`	`],`