Frequently Asked Questions¶
General¶
What is CertifyClouds?¶
CertifyClouds is an Azure secret lifecycle platform that helps you:
- Discover all Key Vaults across your subscriptions
- Monitor secret expiration dates
- Automate secret rotation (3/month on STARTER; unlimited on PRO and ENTERPRISE)
- Sync secrets to other clouds (PRO tier)
- Track compliance with security policies
How is it deployed?¶
CertifyClouds runs as a Docker container in your Azure environment. You control where it runs and what data it accesses. Nothing is hosted on our servers except the licence validation endpoint.
What Azure permissions does it need?¶
- Reader on the subscriptions you want to scan, to list vaults and read their settings
- Key Vault Reader on the vaults. It lists secret, certificate and key properties but cannot read secret values or use keys. Vaults that use access policies need List on secrets, certificates and keys, plus Get on certificates.
- Additional permissions for Automation features (see Azure Permissions)
Security & Privacy¶
Can you see my secrets?¶
No. CertifyClouds runs in your own Azure tenant and secret values are never sent to us. The Scan reads metadata only (names, expiration dates, enabled status). Rotation and Sync handle secret values inside your deployment and send them only to destinations you configure, such as your Key Vaults or your AWS and GCP accounts.
What data leaves my network?¶
To CertifyClouds, only two things:
- Licence validation: Your licence key is validated against
license.certifyclouds.com. Unless you switch off Share operational counts with licensing (on by default) in Settings → Advanced → App behaviour, the hourly check also sends aggregate counts, feature states, a few timestamps and a hashed host ID. Counts are tied to your licence and organisation; names, resource identifiers and secret values are not sent. See the Privacy Policy for details. - Update checks: At startup, only the app version is sent; these checks cannot be switched off
Individual scan results, secret metadata and audit logs stay in your PostgreSQL database; scan-derived counts are sent unless you switch off sharing. Integrations you set up, such as alert email and webhooks, sync to AWS or GCP, and the MCP Connector, send data to the destinations you choose.
Is my data encrypted?¶
- In transit: All Azure API calls use TLS
- At rest: Your PostgreSQL database - configure encryption as needed
- Licence validation: Uses TLS to our servers
Can I run it without internet access?¶
Standard Starter and Pro deployments require outbound HTTPS access to license.certifyclouds.com for licence validation. Fully offline or air-gapped operation is not part of the standard Starter/Pro setup and should be discussed as an Enterprise requirement.
Licensing¶
What licence tiers are available?¶
| Tier | Features | Subscriptions |
|---|---|---|
| STARTER | Key Vault Scan + Compliance + Alerts + 3 manual rotations/month | Max 4 |
| PRO | All features including unlimited Rotation + Sync | Up to 20 |
| ENTERPRISE | Pro features plus corporate tenants, MCP Connector, MSA/DPA, signed support schedule, guided onboarding, and security review support | 21+ / agreed scope |
Evaluation: Request a 30-day PRO licence for evaluation.
How do I get a licence?¶
- Contact sales@certifyclouds.com
- Choose your tier
- Receive your licence key
- Add
CERTIFYCLOUDS_LICENSE_KEY=<your-key>to your environment
What happens when my licence expires?¶
After expiration:
- Access to the application is blocked
- Contact sales@certifyclouds.com to renew
What if the licence server is unreachable?¶
CertifyClouds keeps working from its last validated licence for the grace period (7 days by default). After that, access is blocked until it can reach the licence server again. See Offline Operation.
Can I change tiers?¶
Yes. Contact support@certifyclouds.com with your new requirements. We'll issue an updated licence key. Enter it in Settings > Licence; changing the environment key has no effect while the current key is valid.
Features¶
What is the Key Vault Scan?¶
The scan (Assets › Scan) reads your Azure Key Vaults:
- Discovers all Key Vaults across subscriptions
- Inventories all secrets, keys, and certificates
- Identifies expiration dates
- Tracks changes over time
What is Secret Rotation? (PRO + ENTERPRISE)¶
Rotation automates App Registration secret rotation:
- Detects secrets approaching expiration
- Generates new secrets in Microsoft Entra ID
- Updates linked Key Vault secrets
- Maintains audit trail
What is Multi-Cloud Sync? (PRO + ENTERPRISE)¶
Sync provides multi-cloud disaster recovery:
- Azure → AWS Secrets Manager
- Azure → AWS Certificate Manager
- Azure → GCP Secret Manager
- Azure → GCP Certificate Manager
- Scheduled or manual synchronisation
- Exclusion rules for sensitive secrets
What is Dependencies? (PRO + ENTERPRISE)¶
Dependencies maps credential usage across your Azure environment:
- Discovers Azure resources using Key Vault credentials
- Maps dependencies across 13 resource types:
- Compute: App Services, Function Apps, Container Apps, AKS Clusters (cluster settings only, not yet linked to individual secrets)
- DevOps: ADO Service Connections, ADO Variable Groups
- Integration: Logic Apps, API Management, Data Factory
- Messaging: Service Bus, Event Hubs
- Data: SQL Servers, Storage Accounts
- Analyses blast radius before rotation (shows all affected resources)
- Performs coordinated full-stack rotation; rollback depends on the resource type
What compliance evidence does CertifyClouds aggregate?¶
CertifyClouds maps findings to control families in:
- HIPAA Security Rule §164.312
- PCI-DSS v4.0.1
- SOC 2 Type II
- ISO 27001
- NIST 800-53 Rev. 5
- CIS Azure Foundations Benchmark
- Microsoft Cloud Security Benchmark
- Custom rules (PRO + ENTERPRISE)
CertifyClouds is not a certified compliance product - it identifies what violates each control and recommends customer-side remediation. See the Compliance Disclaimer for the full framing.
Can I export evidence?¶
Yes:
- JSON - programmatic access for ingestion into other systems
- PDF evidence bundle (PRO + ENTERPRISE) - auditor-grade: cover page with tenant, scope, actor, CC version, row count, CSV SHA-256; embedded CSV attachments for sampling; customer management assertion page the customer signs. The audit log also has its own PDF bundle path.
See Evidence Reports for detail.
Troubleshooting¶
Azure authentication fails¶
- Verify the user-assigned Managed Identity is attached to your Container App or Container Instance
- Check Reader role is assigned on subscriptions
- Ensure network access to Azure Resource Manager
- Check the deployment logs for authentication errors
Key Vault access fails¶
- Run the setup script:
./setup-certifyclouds-access.sh --principal-id <id> --apply - Check if Key Vault has firewall rules - add your IP/subnet
- Verify RBAC vs Access Policy configuration
Licence cannot be validated¶
- Check the key in Settings > Licence; a valid key entered there takes precedence over the environment key
- Verify network access to
license.certifyclouds.com - Check if licence has expired
- Contact support@certifyclouds.com
Scans are slow¶
- Check container resources (CPU/memory)
- Reduce concurrent workers if hitting rate limits
- Consider scanning fewer subscriptions
- Review Azure API throttling
How do I reset my admin password?¶
If locked out of your admin account:
- Select Forgot your password? on the sign-in page and use the recovery secret from Settings > Advanced > Recovery
- If you have another admin account, they can reset your password via Settings > Users
Tip
We recommend having at least two admin accounts to avoid lockout scenarios.
Support¶
How do I get support?¶
- Email: support@certifyclouds.com
Response times:
- STARTER: Email support, 4 UK business day target initial response
- PRO: Priority email support, 2 UK business day target initial response
- ENTERPRISE: Response targets and P1 escalation defined in the signed support agreement
How do I report a bug?¶
Email support@certifyclouds.com with:
- Your licence tier
- CertifyClouds version (
/api/system/version) - Steps to reproduce
- Relevant log output
- Expected vs actual behaviour
How do I request a feature?¶
Email feedback@certifyclouds.com. We prioritise based on customer demand and roadmap alignment.
Upgrades¶
What's new in 1.8.1?¶
1.8.1 is a maintenance release:
- Starter plan: evidence packages and changes to custom compliance rules are now limited to PRO and ENTERPRISE, as the pricing page describes. Starter still lists every rule and its result.
- Security updates: the image runs on newer Python and Node versions, and dependencies with published advisories were updated.
- PostgreSQL 18 for new installs: existing installs keep their current database server and need no change.
1.8.1 is non-breaking: pull the new image and restart. If you run CertifyClouds from the bundled docker-compose.production.yml, keep your existing compose file or move your data before switching, because the new file uses postgres:18-alpine with a new data volume.
What's new in 1.8.0?¶
- Enterprise Applications inventory (STARTER+): the normal rotation-discovery run now lists Entra service principals in Automation → Rotation → Enterprise Apps, with their SAML signing certificates, client secrets and owners. It is monitor-only; nothing there is rotated. Expiry alerts and compliance checks cover it too, so existing scores may shift.
- One Tenants page: corporate and external tenants moved out of Settings into a Tenants item in the left-hand navigation, with Corporate and External tabs.
- Read-only surfaces for non-admin users: users without the admin role see the same pages and data as admins, with the write controls replaced by a read-only notice.
- New look: a refreshed visual design across the app, notification emails, evidence PDFs and this docs site.
- Evidence PDF fixes: column names no longer break mid-word, and the report states its scope and the rule-set fingerprint it was generated from.
1.8.0 is non-breaking. Database changes apply on their own when the new version starts; no configuration or Azure consent change is required.
How do I upgrade CertifyClouds?¶
# Import new version to ACR
az acr import --name YOUR_ACR \
--source docker.io/certifyclouds/certifyclouds:1.8.1 \
--image certifyclouds:1.8.1
# Update container
az containerapp update \
--name ca-cc-uks-prd \
--resource-group rg-cc-uks-prd \
--image YOUR_ACR.azurecr.io/certifyclouds:1.8.1
Are upgrades automatic?¶
No. Upgrades are manual for control. We recommend:
- Testing upgrades in non-production first
- Reading release notes before upgrading
- Taking database backups before major upgrades
Still have questions?¶
Contact us at support@certifyclouds.com.