Light, fluffy, and always free - The AWS Local Emulator alternative
feat(iam): add GetAccountSummary support (#1986)
Olamide Kosilec21337c3b185
diff --git a/docs/services/iam.md b/docs/services/iam.mdindex ea45f5aa35..b5702863d9 100644--- a/docs/services/iam.md+++ b/docs/services/iam.md@@ -176,6 +176,12 @@ nothing here performs the TLS handshake they describe.|--------|-------------|| SimulatePrincipalPolicy | Evaluates requested actions and resources against the resolved principal's policies. |+### Account++| Action | Description |+|--------|-------------|+| GetAccountSummary | Returns entity counts (users, groups, roles, customer-managed policies, instance profiles) and IAM quota values. Resources Floci does not track (MFA devices, SAML/OIDC providers, server certificates) are reported as zero rather than omitted. |+## AWS Managed PoliciesFloci seeds a catalog of commonly-used AWS managed policies at startup. These are attachable immediately without any setup:diff --git a/src/main/java/io/github/hectorvent/floci/services/iam/IamQueryHandler.java b/src/main/java/io/github/hectorvent/floci/services/iam/IamQueryHandler.javaindex 68644a9b87..0ac496826f 100644--- a/src/main/java/io/github/hectorvent/floci/services/iam/IamQueryHandler.java+++ b/src/main/java/io/github/hectorvent/floci/services/iam/IamQueryHandler.java@@ -107,6 +107,7 @@ public class IamQueryHandler {case "DeletePolicy" -> handleDeletePolicy(params);case "ListPolicies" -> handleListPolicies(params);case "ListEntitiesForPolicy" -> handleListEntitiesForPolicy(params);+ case "GetAccountSummary" -> handleGetAccountSummary(params);case "CreatePolicyVersion" -> handleCreatePolicyVersion(params);case "GetPolicyVersion" -> handleGetPolicyVersion(params);case "DeletePolicyVersion" -> handleDeletePolicyVersion(params);@@ -616,6 +617,15 @@ public class IamQueryHandler {return Response.ok(AwsQueryResponse.envelope("ListEntitiesForPolicy", AwsNamespaces.IAM, xml.build())).build();}+ private Response handleGetAccountSummary(MultivaluedMap<String, String> params) {+ var xml = new XmlBuilder().start("SummaryMap");+ for (Map.Entry<String, Long> entry : iamService.getAccountSummary().entrySet()) {+ xml.start("entry").elem("key", entry.getKey()).elem("value", entry.getValue()).end("entry");+ }+ xml.end("SummaryMap");+ return Response.ok(AwsQueryResponse.envelope("GetAccountSummary", AwsNamespaces.IAM, xml.build())).build();+ }+private Response handleCreatePolicyVersion(MultivaluedMap<String, String> params) {String policyArn = getParam(params, "PolicyArn");String document = getParam(params, "PolicyDocument");diff --git a/src/main/java/io/github/hectorvent/floci/services/iam/IamService.java b/src/main/java/io/github/hectorvent/floci/services/iam/IamService.javaindex af0f3a3aa5..8ff3df2ac2 100644--- a/src/main/java/io/github/hectorvent/floci/services/iam/IamService.java+++ b/src/main/java/io/github/hectorvent/floci/services/iam/IamService.java@@ -743,6 +743,64 @@ public class IamService implements SessionAccountLookup {return result;}+ /**+ * Entity counts and quotas backing GetAccountSummary. Covers all 34 documented SummaryMap+ * keys; quota values are cross-checked against AWS's published IAM service quotas+ * (docs.aws.amazon.com/general/latest/gr/iam-service.html), though floci itself enforces+ * only the 5-versions-per-policy cap in {@link #createPolicyVersion}. Resources floci does+ * not track at all (MFA devices, SAML/OIDC providers, server certificates, account password -+ * all stub-empty elsewhere in this handler) are reported as zero rather than omitted, so+ * callers indexing into the full AWS field set don't hit a missing-key error.+ */+ public Map<String, Long> getAccountSummary() {+ long localPolicyCount = 0;+ long policyVersionsInUse = 0;+ for (IamPolicy policy : policies.scan(k -> true)) {+ if (policy.getArn().startsWith(AwsManagedPolicies.ARN_PREFIX)) {+ continue;+ }+ localPolicyCount++;+ policyVersionsInUse += policy.getVersions().size();+ }++ Map<String, Long> summary = new LinkedHashMap<>();+ summary.put("Users", (long) listUsers(null).size());+ summary.put("UsersQuota", 5000L);+ summary.put("Groups", (long) listGroups(null).size());+ summary.put("GroupsQuota", 300L);+ summary.put("GroupsPerUserQuota", 10L);+ summary.put("Roles", (long) listRoles(null).size());+ summary.put("RolesQuota", 1000L);+ summary.put("AssumeRolePolicySizeQuota", 2048L);+ summary.put("Policies", localPolicyCount);+ summary.put("PoliciesQuota", 1500L);+ summary.put("PolicySizeQuota", 6144L);+ summary.put("PolicyVersionsInUse", policyVersionsInUse);+ summary.put("PolicyVersionsInUseQuota", 10000L);+ summary.put("VersionsPerPolicyQuota", 5L);+ summary.put("InstanceProfiles", (long) listInstanceProfiles(null).size());+ summary.put("InstanceProfilesQuota", 1000L);+ summary.put("AttachedPoliciesPerUserQuota", 10L);+ summary.put("AttachedPoliciesPerGroupQuota", 10L);+ summary.put("AttachedPoliciesPerRoleQuota", 10L);+ summary.put("GroupPolicySizeQuota", 5120L);+ summary.put("UserPolicySizeQuota", 2048L);+ summary.put("RolePolicySizeQuota", 10240L);+ summary.put("AccessKeysPerUserQuota", 2L);+ summary.put("SigningCertificatesPerUserQuota", 2L);+ summary.put("ServerCertificates", 0L);+ summary.put("ServerCertificatesQuota", 20L);+ summary.put("Providers", 0L);+ summary.put("MFADevices", 0L);+ summary.put("MFADevicesInUse", 0L);+ summary.put("AccountMFAEnabled", 0L);+ summary.put("AccountAccessKeysPresent", 0L);+ summary.put("AccountSigningCertificatesPresent", 0L);+ summary.put("AccountPasswordPresent", 0L);+ summary.put("GlobalEndpointTokenVersion", 1L);+ return summary;+ }+public PolicyVersion createPolicyVersion(String policyArn, String document, boolean setAsDefault) {rejectIfAwsManaged(policyArn);IamPolicy policy = getPolicy(policyArn);diff --git a/src/test/java/io/github/hectorvent/floci/services/iam/IamGetAccountSummaryIntegrationTest.java b/src/test/java/io/github/hectorvent/floci/services/iam/IamGetAccountSummaryIntegrationTest.javanew file mode 100644index 0000000000..b6d4f19b71--- /dev/null+++ b/src/test/java/io/github/hectorvent/floci/services/iam/IamGetAccountSummaryIntegrationTest.java@@ -0,0 +1,119 @@+package io.github.hectorvent.floci.services.iam;++import io.quarkus.test.junit.QuarkusTest;+import org.junit.jupiter.api.Test;++import static io.restassured.RestAssured.given;+import static org.hamcrest.Matchers.equalTo;++/**+ * Verifies the IAM GetAccountSummary query action returns entity counts (which change as+ * resources are created) alongside static quota values. IAM state is shared across tests in+ * this suite, so counts are asserted via before/after deltas rather than absolute values.+ */+@QuarkusTest+class IamGetAccountSummaryIntegrationTest {++ private static final String IAM_AUTH =+ "AWS4-HMAC-SHA256 Credential=test/20260227/us-east-1/iam/aws4_request";++ private long summaryValue(String key) {+ return Long.parseLong(+ given()+ .formParam("Action", "GetAccountSummary")+ .header("Authorization", IAM_AUTH)+ .when()+ .post("/")+ .then()+ .statusCode(200)+ .contentType("application/xml")+ .extract()+ .path("GetAccountSummaryResponse.GetAccountSummaryResult.SummaryMap.entry"+ + ".find { it.key == '" + key + "' }.value"));+ }++ @Test+ void countsIncreaseAsEntitiesAreCreated() {+ String suffix = Long.toString(System.nanoTime(), 36);+ String userName = "gas-user-" + suffix;+ String policyName = "gas-policy-" + suffix;++ long usersBefore = summaryValue("Users");+ long policiesBefore = summaryValue("Policies");++ given()+ .formParam("Action", "CreateUser")+ .formParam("UserName", userName)+ .header("Authorization", IAM_AUTH)+ .when()+ .post("/")+ .then()+ .statusCode(200);++ given()+ .formParam("Action", "CreatePolicy")+ .formParam("PolicyName", policyName)+ .formParam("PolicyDocument",+ "{\"Version\":\"2012-10-17\",\"Statement\":[{\"Effect\":\"Allow\","+ + "\"Action\":\"s3:GetObject\",\"Resource\":\"*\"}]}")+ .header("Authorization", IAM_AUTH)+ .when()+ .post("/")+ .then()+ .statusCode(200);++ assertSummaryValue("Users", usersBefore + 1);+ assertSummaryValue("Policies", policiesBefore + 1);+ }++ private void assertSummaryValue(String key, long expected) {+ given()+ .formParam("Action", "GetAccountSummary")+ .header("Authorization", IAM_AUTH)+ .when()+ .post("/")+ .then()+ .statusCode(200)+ .body("GetAccountSummaryResponse.GetAccountSummaryResult.SummaryMap.entry"+ + ".find { it.key == '" + key + "' }.value", equalTo(String.valueOf(expected)));+ }++ @Test+ void reportsAllThirtyFourDocumentedFields() {+ // docs.aws.amazon.com/IAM/latest/APIReference/API_GetAccountSummary.html lists exactly+ // 34 valid SummaryMap keys - a caller indexing into any of them should never KeyError.+ given()+ .formParam("Action", "GetAccountSummary")+ .header("Authorization", IAM_AUTH)+ .when()+ .post("/")+ .then()+ .statusCode(200)+ .body("GetAccountSummaryResponse.GetAccountSummaryResult.SummaryMap.entry.size()",+ equalTo(34));+ }++ @Test+ void reportsStaticQuotaValues() {+ given()+ .formParam("Action", "GetAccountSummary")+ .header("Authorization", IAM_AUTH)+ .when()+ .post("/")+ .then()+ .statusCode(200)+ .contentType("application/xml")+ // VersionsPerPolicyQuota mirrors the 5-versions-per-policy cap enforced in+ // IamService#createPolicyVersion - not just a display value.+ .body("GetAccountSummaryResponse.GetAccountSummaryResult.SummaryMap.entry"+ + ".find { it.key == 'VersionsPerPolicyQuota' }.value", equalTo("5"))+ .body("GetAccountSummaryResponse.GetAccountSummaryResult.SummaryMap.entry"+ + ".find { it.key == 'UsersQuota' }.value", equalTo("5000"))+ .body("GetAccountSummaryResponse.GetAccountSummaryResult.SummaryMap.entry"+ + ".find { it.key == 'AssumeRolePolicySizeQuota' }.value", equalTo("2048"))+ .body("GetAccountSummaryResponse.GetAccountSummaryResult.SummaryMap.entry"+ + ".find { it.key == 'AccountPasswordPresent' }.value", equalTo("0"))+ .body("GetAccountSummaryResponse.GetAccountSummaryResult.SummaryMap.entry"+ + ".find { it.key == 'MFADevices' }.value", equalTo("0"));+ }+}