Skip to content

armgit / floci

Public Imported from GitHub
0

Light, fluffy, and always free - The AWS Local Emulator alternative

feat(ssm): add DescribePatchBaselines and GetDefaultPatchBaseline (#1404)

Hector Venturabe9e61d78899
diff --git a/docs/services/ssm.md b/docs/services/ssm.md
index 925e184190..60fee87e16 100644
--- a/docs/services/ssm.md
+++ b/docs/services/ssm.md
@@ -21,6 +21,8 @@
| `AddTagsToResource` | Tag a parameter |
| `ListTagsForResource` | List tags on a parameter |
| `RemoveTagsFromResource` | Remove tags from a parameter |
+| `DescribePatchBaselines` | List AWS-owned predefined patch baselines (filter by `OWNER`, `OPERATING_SYSTEM`, `NAME_PREFIX`) |
+| `GetDefaultPatchBaseline` | Get the default patch baseline id for an operating system |
### Run Command
diff --git a/src/main/java/io/github/hectorvent/floci/services/ssm/SsmJsonHandler.java b/src/main/java/io/github/hectorvent/floci/services/ssm/SsmJsonHandler.java
index 577b228c15..6a0522d0ef 100644
--- a/src/main/java/io/github/hectorvent/floci/services/ssm/SsmJsonHandler.java
+++ b/src/main/java/io/github/hectorvent/floci/services/ssm/SsmJsonHandler.java
@@ -6,6 +6,7 @@ import io.github.hectorvent.floci.services.ssm.model.CommandInvocation;
import io.github.hectorvent.floci.services.ssm.model.InstanceInformation;
import io.github.hectorvent.floci.services.ssm.model.Parameter;
import io.github.hectorvent.floci.services.ssm.model.ParameterHistory;
+import io.github.hectorvent.floci.services.ssm.model.PatchBaselineIdentity;
import com.fasterxml.jackson.annotation.JsonProperty;
import com.fasterxml.jackson.databind.JsonNode;
import com.fasterxml.jackson.databind.ObjectMapper;
@@ -57,6 +58,9 @@ public class SsmJsonHandler {
case "ListCommandInvocations" -> handleListCommandInvocations(request, region);
case "CancelCommand" -> handleCancelCommand(request, region);
case "DescribeInstanceInformation" -> handleDescribeInstanceInformation(request, region);
+ // Patch Manager (read-only: AWS-owned predefined baselines)
+ case "DescribePatchBaselines" -> handleDescribePatchBaselines(request, region);
+ case "GetDefaultPatchBaseline" -> handleGetDefaultPatchBaseline(request, region);
// Agent registration (internal, not in public SDK)
case "UpdateInstanceInformation" -> handleUpdateInstanceInformation(request, region);
default -> Response.status(400)
@@ -200,6 +204,47 @@ public class SsmJsonHandler {
return Response.ok(response).build();
}
+ private Response handleDescribePatchBaselines(JsonNode request, String region) {
+ Map<String, List<String>> filters = new HashMap<>();
+ JsonNode filtersNode = request.path("Filters");
+ if (filtersNode.isArray()) {
+ for (JsonNode f : filtersNode) {
+ String key = f.path("Key").asText("");
+ List<String> values = new ArrayList<>();
+ f.path("Values").forEach(v -> values.add(v.asText()));
+ if (!key.isEmpty()) {
+ filters.put(key, values);
+ }
+ }
+ }
+
+ List<PatchBaselineIdentity> baselines = ssmService.describePatchBaselines(filters);
+
+ ObjectNode response = objectMapper.createObjectNode();
+ ArrayNode identities = objectMapper.createArrayNode();
+ for (PatchBaselineIdentity b : baselines) {
+ ObjectNode node = objectMapper.createObjectNode();
+ node.put("BaselineId", b.baselineId());
+ node.put("BaselineName", b.baselineName());
+ node.put("OperatingSystem", b.operatingSystem());
+ node.put("BaselineDescription", b.baselineDescription());
+ node.put("DefaultBaseline", b.defaultBaseline());
+ identities.add(node);
+ }
+ response.set("BaselineIdentities", identities);
+ return Response.ok(response).build();
+ }
+
+ private Response handleGetDefaultPatchBaseline(JsonNode request, String region) {
+ String operatingSystem = request.has("OperatingSystem") ? request.path("OperatingSystem").asText() : null;
+ String baselineId = ssmService.getDefaultPatchBaseline(operatingSystem);
+
+ ObjectNode response = objectMapper.createObjectNode();
+ response.put("BaselineId", baselineId);
+ response.put("OperatingSystem", (operatingSystem == null || operatingSystem.isBlank()) ? "WINDOWS" : operatingSystem);
+ return Response.ok(response).build();
+ }
+
private Response handleLabelParameterVersion(JsonNode request, String region) {
String name = request.path("Name").asText();
long parameterVersion = request.path("ParameterVersion").asLong();
diff --git a/src/main/java/io/github/hectorvent/floci/services/ssm/SsmService.java b/src/main/java/io/github/hectorvent/floci/services/ssm/SsmService.java
index 3cd76b775e..791980737e 100644
--- a/src/main/java/io/github/hectorvent/floci/services/ssm/SsmService.java
+++ b/src/main/java/io/github/hectorvent/floci/services/ssm/SsmService.java
@@ -7,6 +7,7 @@ import io.github.hectorvent.floci.core.storage.StorageBackend;
import io.github.hectorvent.floci.core.storage.StorageFactory;
import io.github.hectorvent.floci.services.ssm.model.Parameter;
import io.github.hectorvent.floci.services.ssm.model.ParameterHistory;
+import io.github.hectorvent.floci.services.ssm.model.PatchBaselineIdentity;
import com.fasterxml.jackson.core.type.TypeReference;
import jakarta.enterprise.context.ApplicationScoped;
import jakarta.inject.Inject;
@@ -241,6 +242,82 @@ public class SsmService {
LOG.debugv("Removed tags from parameter: {0}", resourceId);
}
+ // ──────────────────────────── Patch Baselines ────────────────────────────
+ // AWS provides a fixed set of AWS-owned predefined patch baselines (one default per operating
+ // system). These are static reference data, not customer state, so they live in-memory only.
+
+ private static final List<PatchBaselineIdentity> PREDEFINED_BASELINES = buildPredefinedBaselines();
+
+ private static List<PatchBaselineIdentity> buildPredefinedBaselines() {
+ String[][] defs = {
+ {"WINDOWS", "AWS-DefaultPatchBaseline", "Windows"},
+ {"AMAZON_LINUX", "AWS-AmazonLinuxDefaultPatchBaseline", "Amazon Linux"},
+ {"AMAZON_LINUX_2", "AWS-AmazonLinux2DefaultPatchBaseline", "Amazon Linux 2"},
+ {"AMAZON_LINUX_2022", "AWS-AmazonLinux2022DefaultPatchBaseline", "Amazon Linux 2022"},
+ {"AMAZON_LINUX_2023", "AWS-AmazonLinux2023DefaultPatchBaseline", "Amazon Linux 2023"},
+ {"UBUNTU", "AWS-UbuntuDefaultPatchBaseline", "Ubuntu"},
+ {"REDHAT_ENTERPRISE_LINUX", "AWS-RedHatDefaultPatchBaseline", "Red Hat Enterprise Linux"},
+ {"SUSE", "AWS-SuseDefaultPatchBaseline", "SUSE Linux Enterprise Server"},
+ {"CENTOS", "AWS-CentOSDefaultPatchBaseline", "CentOS"},
+ {"ORACLE_LINUX", "AWS-OracleLinuxDefaultPatchBaseline", "Oracle Linux"},
+ {"DEBIAN", "AWS-DebianDefaultPatchBaseline", "Debian Server"},
+ {"MACOS", "AWS-MacOSDefaultPatchBaseline", "macOS"},
+ {"RASPBIAN", "AWS-RaspbianDefaultPatchBaseline", "Raspbian"},
+ {"ROCKY_LINUX", "AWS-RockyLinuxDefaultPatchBaseline", "Rocky Linux"},
+ {"ALMA_LINUX", "AWS-AlmaLinuxDefaultPatchBaseline", "AlmaLinux"},
+ };
+ List<PatchBaselineIdentity> baselines = new ArrayList<>();
+ for (String[] def : defs) {
+ String os = def[0];
+ String name = def[1];
+ String description = "Default Patch Baseline for " + def[2] + " Provided by AWS.";
+ baselines.add(new PatchBaselineIdentity(stableBaselineId(name), name, os, description, true));
+ }
+ return List.copyOf(baselines);
+ }
+
+ /** Deterministic AWS-style baseline id (pb-<17 hex>) derived from the baseline name. */
+ private static String stableBaselineId(String name) {
+ long h = 1125899906842597L;
+ for (int i = 0; i < name.length(); i++) {
+ h = 31 * h + name.charAt(i);
+ }
+ String hex = String.format("%016x", h & 0x0FFFFFFFFFFFFFFFL);
+ return "pb-0" + hex;
+ }
+
+ /**
+ * Return AWS-owned predefined patch baselines matching the given DescribePatchBaselines filters
+ * (supported keys: OWNER, OPERATING_SYSTEM, NAME_PREFIX). There are no customer-owned baselines.
+ */
+ public List<PatchBaselineIdentity> describePatchBaselines(Map<String, List<String>> filters) {
+ List<String> owners = filters.getOrDefault("OWNER", List.of());
+ // OWNER=Self matches only customer-owned baselines, of which there are none.
+ if (!owners.isEmpty() && !owners.contains("AWS") && !owners.contains("All")) {
+ return List.of();
+ }
+
+ List<String> operatingSystems = filters.getOrDefault("OPERATING_SYSTEM", List.of());
+ List<String> namePrefixes = filters.getOrDefault("NAME_PREFIX", List.of());
+
+ return PREDEFINED_BASELINES.stream()
+ .filter(b -> operatingSystems.isEmpty() || operatingSystems.contains(b.operatingSystem()))
+ .filter(b -> namePrefixes.isEmpty()
+ || namePrefixes.stream().anyMatch(prefix -> b.baselineName().startsWith(prefix)))
+ .toList();
+ }
+
+ /** Return the default patch baseline id for an operating system (defaults to WINDOWS). */
+ public String getDefaultPatchBaseline(String operatingSystem) {
+ String os = (operatingSystem == null || operatingSystem.isBlank()) ? "WINDOWS" : operatingSystem;
+ return PREDEFINED_BASELINES.stream()
+ .filter(b -> b.operatingSystem().equals(os))
+ .findFirst()
+ .map(PatchBaselineIdentity::baselineId)
+ .orElseThrow(() -> new AwsException("DoesNotExistException",
+ "No default patch baseline exists for operating system " + os, 400));
+ }
+
private static String regionKey(String region, String name) {
return region + "::" + name;
}
diff --git a/src/main/java/io/github/hectorvent/floci/services/ssm/model/PatchBaselineIdentity.java b/src/main/java/io/github/hectorvent/floci/services/ssm/model/PatchBaselineIdentity.java
new file mode 100644
index 0000000000..2114f387ae
--- /dev/null
+++ b/src/main/java/io/github/hectorvent/floci/services/ssm/model/PatchBaselineIdentity.java
@@ -0,0 +1,14 @@
+package io.github.hectorvent.floci.services.ssm.model;
+
+import io.quarkus.runtime.annotations.RegisterForReflection;
+
+/**
+ * Identity of an AWS-owned predefined patch baseline, as returned by DescribePatchBaselines.
+ */
+@RegisterForReflection
+public record PatchBaselineIdentity(String baselineId,
+ String baselineName,
+ String operatingSystem,
+ String baselineDescription,
+ boolean defaultBaseline) {
+}
diff --git a/src/test/java/io/github/hectorvent/floci/services/ssm/SsmIntegrationTest.java b/src/test/java/io/github/hectorvent/floci/services/ssm/SsmIntegrationTest.java
index 99740204f5..cedf7cc623 100644
--- a/src/test/java/io/github/hectorvent/floci/services/ssm/SsmIntegrationTest.java
+++ b/src/test/java/io/github/hectorvent/floci/services/ssm/SsmIntegrationTest.java
@@ -233,6 +233,89 @@ class SsmIntegrationTest {
.body("DeletedParameters.size()", equalTo(2));
}
+ // ── Issue #956: DescribePatchBaselines / GetDefaultPatchBaseline (AWS-owned predefined) ──
+
+ @Test
+ void describePatchBaselines_filteredByOwnerAndOperatingSystem() {
+ given()
+ .header("X-Amz-Target", "AmazonSSM.DescribePatchBaselines")
+ .contentType(SSM_CONTENT_TYPE)
+ .body("""
+ {
+ "Filters": [
+ {"Key": "OWNER", "Values": ["AWS"]},
+ {"Key": "OPERATING_SYSTEM", "Values": ["AMAZON_LINUX_2"]}
+ ]
+ }
+ """)
+ .when()
+ .post("/")
+ .then()
+ .statusCode(200)
+ .body("BaselineIdentities.size()", equalTo(1))
+ .body("BaselineIdentities[0].BaselineName", equalTo("AWS-AmazonLinux2DefaultPatchBaseline"))
+ .body("BaselineIdentities[0].OperatingSystem", equalTo("AMAZON_LINUX_2"))
+ .body("BaselineIdentities[0].DefaultBaseline", equalTo(true))
+ .body("BaselineIdentities[0].BaselineId", startsWith("pb-"));
+ }
+
+ @Test
+ void describePatchBaselines_byNamePrefixReturnsPredefined() {
+ given()
+ .header("X-Amz-Target", "AmazonSSM.DescribePatchBaselines")
+ .contentType(SSM_CONTENT_TYPE)
+ .body("""
+ {
+ "Filters": [
+ {"Key": "NAME_PREFIX", "Values": ["AWS-"]}
+ ]
+ }
+ """)
+ .when()
+ .post("/")
+ .then()
+ .statusCode(200)
+ .body("BaselineIdentities.size()", greaterThan(1))
+ .body("BaselineIdentities.BaselineName", everyItem(startsWith("AWS-")));
+ }
+
+ @Test
+ void describePatchBaselines_ownerSelfReturnsEmpty() {
+ given()
+ .header("X-Amz-Target", "AmazonSSM.DescribePatchBaselines")
+ .contentType(SSM_CONTENT_TYPE)
+ .body("""
+ {
+ "Filters": [
+ {"Key": "OWNER", "Values": ["Self"]}
+ ]
+ }
+ """)
+ .when()
+ .post("/")
+ .then()
+ .statusCode(200)
+ .body("BaselineIdentities.size()", equalTo(0));
+ }
+
+ @Test
+ void getDefaultPatchBaseline_windows() {
+ given()
+ .header("X-Amz-Target", "AmazonSSM.GetDefaultPatchBaseline")
+ .contentType(SSM_CONTENT_TYPE)
+ .body("""
+ {
+ "OperatingSystem": "WINDOWS"
+ }
+ """)
+ .when()
+ .post("/")
+ .then()
+ .statusCode(200)
+ .body("OperatingSystem", equalTo("WINDOWS"))
+ .body("BaselineId", startsWith("pb-"));
+ }
+
@Test
void unsupportedOperation() {
given()