How polymind-inc/acmebot works
Acmebot automates DNS-01 ACME certificate issuance and renewal, storing managed certificates in Azure Key Vault and exposing HTTP, dashboard, and CLI operations. The main workflow starts with a dashboard or CLI request, passes through the HTTP API and durable issuance orchestration, provisions DNS challenges through configured providers, completes ACME protocol steps, and persists the certificate. Separate paths support certificate inventory and ARI-aware renewal scheduling, DNS zone discovery, account management, and operation webhooks. Several links are documented capabilities or inferred from the component layout because the relevant handlers and orchestration activities were not excerpted.
Main entry points: CertificateIssuanceOrchestrator.cs Issuance orchestrator · CertificateRenewalSchedulerOrchestrator.cs Renewal scheduler · AcmeOrderActivities.cs ACME order activities · Http HTTP API
Components 23
Operator interfaces
- Management dashboard
src/Acmebot.App/ClientApp/src/App.vue - CLI commands
src/Acmebot.Cli/CliApplication.cs - CLI API client
src/Acmebot.Cli/AcmebotApiClient.cs - HTTP API
src/Acmebot.App/Functions/Http
Certificate workflows
- Certificate operations
src/Acmebot.App/Services/CertificateOperationService.cs - Issuance orchestrator
src/Acmebot.App/Functions/Orchestration/CertificateIssuanceOrchestrator.cs - ACME order activities
src/Acmebot.App/Functions/Orchestration/AcmeOrderActivities.cs - DNS challenge activities
src/Acmebot.App/Functions/Orchestration/DnsChallengeActivities.cs
ACME protocol
- ACME client
src/Acmebot.Acme/AcmeClient.cs - Account client factory
src/Acmebot.App/Acme/AcmeClientFactory.cs - ACME account state
src/Acmebot.App/Acme/BlobAcmeStateStore.cs
Azure and DNS integrations
- DNS providers
src/Acmebot.App/Providers/IDnsProvider.cs - Azure Key Vault
- Certificate query
src/Acmebot.App/Services/CertificateQueryService.cs - DNS zone query
src/Acmebot.App/Services/DnsZoneQueryService.cs
Renewal and monitoring
- Renewal scheduler
src/Acmebot.App/Functions/Orchestration/CertificateRenewalSchedulerOrchestrator.cs - Renewal evaluation
src/Acmebot.App/Services/CertificateRenewalScheduleEvaluator.cs - Renewal timer
src/Acmebot.App/Functions/Timer/RenewCertificates.cs - Webhook activity
src/Acmebot.App/Functions/Orchestration/WebhookActivities.cs - Webhook delivery
src/Acmebot.App/Notifications/WebhookInvoker.cs
Other components
- Operator
- Webhook endpoint
- ACME authority
Connections 24
- Operator → Management dashboard: uses
README.md - Operator → CLI commands: runs
README.md - Management dashboard → HTTP API: requests
- CLI commands → CLI API client: calls
src/Acmebot.Cli/CliApplication.cs - CLI API client → HTTP API: sends requests
src/Acmebot.Cli/AcmebotApiClient.cs - HTTP API → Certificate operations: delegates
- Certificate operations → Issuance orchestrator: starts
- Issuance orchestrator → ACME order activities: dispatches
- Issuance orchestrator → DNS challenge activities: dispatches
- ACME order activities → ACME client: uses
- Account client factory → ACME client: creates
src/Acmebot.App/Acme/AcmeClientFactory.cs - Account client factory → ACME account state: loads and saves
src/Acmebot.App/Acme/AcmeClientFactory.cs - ACME client → ACME authority: ACME requests
src/Acmebot.Acme/AcmeClient.cs - DNS challenge activities → DNS providers: updates challenge DNS
- ACME order activities → Azure Key Vault: stores certificate
README.md - Certificate query → Azure Key Vault: reads certificates
src/Acmebot.App/Services/CertificateQueryService.cs - DNS zone query → DNS providers: lists zones
src/Acmebot.App/Services/DnsZoneQueryService.cs - Renewal timer → Renewal scheduler: triggers
- Renewal scheduler → Renewal evaluation: evaluates timing
- Renewal scheduler → Certificate query: gets targets
- Renewal scheduler → Issuance orchestrator: starts renewals
- Issuance orchestrator → Webhook activity: reports outcome
- Webhook activity → Webhook delivery: invokes
src/Acmebot.App/Functions/Orchestration/WebhookActivities.cs - Webhook delivery → Webhook endpoint: sends notification
src/Acmebot.App/Notifications/WebhookInvoker.cs