Skip to content

Services Overview

Floci-AZ provides emulation for several core Azure services.

Service Endpoint Implementation Status
Azure Resource Manager /subscriptions/... + /providers/... ✅ Subscriptions, resource groups, resource/provider listing; management-plane fallthrough for the Microsoft.* providers
Blob Storage /{account}/ ✅ Full CRUD; ADLS Gen2 DFS filesystem/path operations with Hadoop ABFS 3.3.4 compatibility; user delegation key/SAS
Queue Storage /{account}-queue/ ✅ Full CRUD
Azure SignalR Service /server/, /client/, *.service.signalr.net ✅ Default mode over WebSockets; ASP.NET Core hubs, JSON/MessagePack, groups, users, and broadcasts. Per-account isolation through {account}.service.signalr.net hostnames
Table Storage /{account}-table/ ✅ Full CRUD
Azure Functions /{account}-functions/ ✅ HTTP Triggers, Docker runtimes
App Configuration /{account}-appconfig/ ✅ Key-values, labels, feature flags, snapshots, revisions, locks, pagination, $select, tags filtering, Accept-Datetime, Sync-Token
Cosmos DB (SQL API) /{account}-cosmos/ ✅ Databases, containers, documents CRUD, SQL queries, partition keys
Cosmos DB multi-API (engine sidecars) ✅ MongoDB, PostgreSQL, Cassandra, Gremlin, Table, NoSQL (opt-in Docker engines)
Key Vault /{account}-keyvault/ ✅ Self-signed certificates with PFX/PEM secrets; secrets & keys CRUD, versioning, soft-delete, properties update, backup/restore, rotation, RSA/EC/oct crypto, /rng, Managed HSM
Event Hubs AMQP :5672 / Kafka :9093 ✅ AMQP 1.0 (Artemis), Kafka-compatible (Redpanda, opt-in)
Service Bus /{account}-servicebus/ + AMQP :5673 ✅ Queues, topics, subscriptions (dynamic); AMQP 1.0 via Artemis sidecar or mocked
Azure SQL Database ARM path + /{account}-sql/ ✅ Servers, databases, firewall rules; ARM-only by default, managed SQL Server opt-in
Azure Database for PostgreSQL ARM path (Microsoft.DBforPostgreSQL) + /{account}-postgres/ ✅ Flexible servers, databases, firewall rules, configurations; Docker-backed postgres containers or mocked
Azure Database for MySQL ARM path (Microsoft.DBforMySQL) + /{account}-mysql/ ✅ Flexible servers, databases, firewall rules, configurations; Docker-backed mysql containers or mocked
Azure Database for MariaDB ARM path (Microsoft.DBforMariaDB) + /{account}-mariadb/ ✅ Servers (single-server model), databases, firewall rules, configurations; Docker-backed mariadb containers or mocked
Azure Kubernetes Service ARM path (Microsoft.ContainerService) ✅ Clusters, agent pools, credentials; real k3s containers or mocked
Azure Container Apps ARM path (Microsoft.App) + FQDN ingress ✅ Managed environments, apps, revisions, ingress, secrets, min/max replicas; Docker-backed or mocked
API Management ARM path (Microsoft.ApiManagement) + /{account}-apim/ ✅ APIs, operations, products, subscriptions, named values, backends, OpenAPI import; gateway routing + policy subset
Virtual Network ARM path (Microsoft.Network) ✅ VNets, subnets, NICs, public IPs, NSGs, private DNS zones (+ virtual network links, record sets), private endpoints (+ private DNS zone groups), private link services; in-process ARM state for Terraform/OpenTofu and VM dependencies
Virtual Machines ARM path (Microsoft.Compute) ✅ VM lifecycle (create/start/stop/deallocate/restart/delete/list), instanceView; mocked by default, optional container-backed mode (mocked: false)
Azure Cache for Redis ARM path (Microsoft.Cache) ✅ Cache CRUD, listKeys/regenerateKey; real Redis containers (data plane) or mocked
Azure Container Registry ARM path (Microsoft.ContainerRegistry) ✅ Registry CRUD, admin credentials, checkNameAvailability; az acr login via the Entra token exchange on {name}.azurecr.io; one shared registry:2 (Docker Registry V2 push/pull) or mocked
Azure Container Instances ARM path (Microsoft.ContainerInstance) ✅ Container group lifecycle (create/update/delete/list), start/stop/restart, container logs, instanceView; real Docker containers (shared-netns pods) or mocked
Microsoft Entra ID /{tenant}/oauth2/... + /.well-known/openid-configuration ✅ OpenID Connect provider: RS256-signed tokens, JWKS, discovery; client-credentials, ROPC, and authorization-code+PKCE grants; scoped OIDC UserInfo; app registrations managed through Microsoft Graph
Microsoft Graph /v1.0/... ✅ Narrow slice: service principal discovery, group-membership management (getMemberGroups, members/$ref), app registrations with client secrets (applications, addPassword / removePassword); full Graph CRUD out of scope
Event Grid ARM path (Microsoft.EventGrid) + /{topic}-eventgrid/api/events ✅ Custom Topics, access keys, webhook event subscriptions with filters, publish (Event Grid + CloudEvents 1.0), async delivery with retry, subscription validation handshake
Azure Monitor / Log Analytics ARM path (Microsoft.OperationalInsights / Microsoft.Insights) + /dataCollectionRules/... + /v1/workspaces/... ✅ Workspaces, Data Collection Endpoints/Rules; Logs Ingestion API; Log Analytics query with a KQL subset (where/project/take/limit, timespan); subscription Activity Log (Administrative entries for every ARM write, delete and action, $filter / $select / paging)
Communication Services Email /emails:send + /emailMessages + ARM path (Microsoft.Communication) ✅ ACS Email send + status polling; in-memory inspection mailbox (Mailpit-style); ARM communication/email services + domains. No real delivery
Azure AI Search ARM path (Microsoft.Search) ✅ Search services, admin keys, query keys, checkNameAvailability; management plane only, the data plane is not served yet
Managed Identity ARM path (Microsoft.ManagedIdentity) + /metadata/identity/oauth2/token + /msi/token ✅ User-assigned identities + federated identity credentials, system-assigned identities/default, IMDS token endpoint (ManagedIdentityCredential via AZURE_POD_IDENTITY_AUTHORITY_HOST), App Service token endpoint (IDENTITY_ENDPOINT / IDENTITY_HEADER); tokens signed with the Entra key
ARM Template Deployments ARM path (Microsoft.Resources/deployments) ✅ Resource-group and subscription template deployments run asynchronously through the real handlers: parameters, variables, dependsOn and implicit reference() ordering, outputs read live, validate, exportTemplate, copy loops, nested deployments (Bicep modules), linked templates (templateLink, parametersLink, relativePath)
Azure Policy ARM path (Microsoft.Authorization/policy*) ✅ Policy definitions, set definitions, assignments and exemptions at management-group, subscription, resource-group and resource scope; assigned rules evaluated on writes (deny, append, audit); compliance states, summaries and on-demand scans through Microsoft.PolicyInsights; no built-in definitions
Azure RBAC ARM path (Microsoft.Authorization/role*) ✅ Built-in role definitions and role assignments at every scope, atScope() / principalId eq / assignedTo() list filters, Azure's conflict refusals; assignments are stored, not enforced; no custom roles
Azure Resource Graph ARM path (Microsoft.ResourceGraph/resources) ✅ KQL queries over resources, resourcecontainers and policyresources: where, extend, project, summarize, order by, distinct, union, join, the comparison and string operators, the conversion and string functions; objectArray / table formats, $top / $skip / $skipToken paging
Azure Management Groups ARM path (Microsoft.Management/managementGroups) ✅ Tenant root group, groups (create, get with $expand / $recurse, patch, delete, list, descendants), subscription membership, getEntities, checkNameAvailability

Unified Endpoint

All services are accessible through a single port (4577). The routing is handled by inspecting the request path and headers.

Docker-backed services

The following services spin up Docker containers on demand and require the Docker socket:

Service Docker image Data plane
Azure Functions User-provided image HTTP to container
Azure SQL Database mcr.microsoft.com/mssql/server:2025-latest Optional managed mode; TDS direct to container port
Cosmos DB engines Various (mongo, postgres, cassandra, …) Protocol direct to container port
Azure Kubernetes Service rancher/k3s:latest kubectl direct to k3s API server port
Azure Database for PostgreSQL postgres:17-alpine PostgreSQL wire protocol direct to container port
Azure Database for MySQL mysql:8.0 MySQL wire protocol direct to container port
Azure Database for MariaDB mariadb:10.11 MySQL wire protocol direct to container port
Azure Container Apps User-provided images HTTP ingress proxied through port 4577
Azure Container Instances User-provided images Shared-netns group, published ports on 7500-7599 (opt in with mocked: false)
Virtual Machines storageProfile.imageReference, falling back to ubuntu:22.04 One keep-alive Linux container per VM (opt in with mocked: false)

These services must have access to the Docker daemon (/var/run/docker.sock mount in Docker Compose).