The DevOps compliance challenge
DevOps and SRE teams manage more credentials than any other function in most organisations. Service accounts, database passwords, API keys, CI/CD tokens, Kubernetes secrets, cloud IAM credentials, container registry passwords — the list is long and often undocumented.
The compliance challenge is not generating strong credentials. Tools like HashiCorp Vault, AWS Secrets Manager, and Doppler handle secure storage and rotation. The challenge is proving that credentials meet specific compliance standards at the moment they were created.
When a SOC 2 auditor asks "show me evidence that your production database password was generated to CC6.1 requirements," the typical DevOps answer is: "we use Vault and rotate every quarter." That's a process claim, not evidence. The auditor needs to see that a specific credential met a specific standard at a documented point in time.
This is the gap that compliance certificates close — without adding meaningful operational overhead.
Credential types and compliance scope
Not every credential in your environment is in scope for every compliance framework. Understanding which credentials require compliance documentation helps prioritise where to invest:
Priority rule: if the credential provides access to systems that process or store data covered by a compliance framework, that credential is in scope and should have documented provenance.
Secrets management vs compliance proof
Secrets management and compliance proof are related but distinct problems. Understanding the distinction prevents teams from assuming that "we use Vault" answers audit questions about password compliance.
- Secrets management solves: secure storage (encryption at rest and in transit), access control (who can read which secrets), rotation automation (TTL-based renewal), audit logging (who accessed what, when), and secret injection (runtime delivery without plaintext exposure).
- Secrets management does NOT solve: proof that the secret was generated to a specific compliance standard, documentation of the entropy source used, demonstration that the secret met HIPAA or PCI-DSS requirements at the moment of creation, or a machine-verifiable record of generation parameters for auditors.
- Compliance certificates solve: exactly the gap above. They provide the generation-time evidence that secrets management platforms are architecturally unable to provide (because they don't control how secrets are created — only how they're stored).
The optimal workflow: generate credentials using PassGeni with a compliance preset (getting a certificate), store them in Vault or AWS Secrets Manager, and tag the secret with the PassGeni certificate URL. You get the operational benefits of secrets management plus the compliance evidence of a certificate.
Password provenance: what it is and why auditors care
Password provenance is proof of how a credential was created: what standard it was generated to, what entropy source was used, what character rules were applied, and when the generation occurred.
Auditors care about provenance because:
- Policy enforcement is not self-proving: Having a policy that says "all database passwords must be 20+ characters with full character set" doesn't prove any specific database password actually meets that requirement. Provenance closes this gap.
- Human credential creation is unverifiable: If an engineer manually created a service account password, there is no way to prove it was cryptographically random, met length requirements, or used an appropriate entropy source. Machine-generated credentials with provenance documents eliminate this ambiguity.
- Rotation events need documentation: When a credential is rotated (on schedule or due to compromise), auditors want to see that the replacement met compliance standards. A certificate generated at rotation time provides this.
- Litigation and incident response: After a breach, investigators ask whether credential weaknesses contributed. Machine-generated credentials with documented compliance properties are a strong defense against negligence claims.
A PassGeni compliance certificate is machine-readable provenance in a cryptographically signed format. The ES256 signature means the record cannot be altered retroactively — making it reliable evidence even under adversarial scrutiny.
Certificate workflow for DevOps teams
The standard workflow for generating and documenting compliant credentials:
- Select compliance preset: Identify the most demanding compliance standard applicable to the credential's target system. Use FIPS 140-3 for federal/DoD contexts; SOC 2 for general SaaS infrastructure; HIPAA for healthcare systems; PCI-DSS for payment systems.
- Generate via PassGeni: Use the web interface or API with the selected preset. PassGeni validates parameters server-side and issues a generation_session_id.
- Certify immediately: Use the generation_session_id (valid 60 seconds) to request the compliance certificate. You receive a cert_url.
- Store credential in secrets manager: HashiCorp Vault, AWS Secrets Manager, Doppler, 1Password Secrets Automation — whatever your team uses.
- Tag with certificate URL: Add the cert_url as metadata alongside the credential:
- Vault:
vault kv metadata put secret/db-prod passgeni-cert="https://passgeni.ai/cert/[id]" - AWS Secrets Manager: Add tag
PassGeniCert: https://passgeni.ai/cert/[id] - Doppler: Add URL to the secret's note field
- Kubernetes: Add annotation
passgeni.ai/cert-urlto the Secret resource
- Vault:
- Update system documentation: Add the cert URL to the runbook, system diagram, or infrastructure documentation for the target system.
For teams using the PassGeni API (Authority tier), steps 2–3 can be fully automated as part of Terraform, Ansible, or custom provisioning scripts. The cert_url becomes a Terraform output that flows into tagging and documentation automatically.
Rotation requirements by framework
Rotation schedules differ significantly across compliance frameworks. The trend in modern guidance is away from mandatory periodic rotation toward evidence-based rotation:
Every rotation event should generate a new PassGeni compliance certificate for the replacement credential. The old certificate provides historical audit trail; the new certificate covers the current credential. Together they demonstrate continuous compliance across rotation events — exactly what SOC 2 Type II and ISO 27001 auditors want to see.
IaC and pipeline integration
Integrating PassGeni certificate generation into infrastructure-as-code workflows ensures compliance documentation is generated automatically, not manually:
- Terraform: Use a
null_resourceorterraform-provider-httpto call the PassGeni API during apply. Store the cert_url as a Terraform output. Reference it in atagsblock on the associated resource (RDS instance, EKS cluster, etc.). - Pulumi: Call the PassGeni REST API from a Pulumi ComponentResource during stack deployment. Return the cert_url as a stack output.
- Ansible: Add a PassGeni API task to credential provisioning playbooks using
urimodule. Register the cert_url and write it to a host variable file. - GitHub Actions: Add a step to credential rotation workflows that calls PassGeni API and stores the cert_url as a step output. Archive it as a workflow artifact for audit retention.
- Kubernetes Operators: For teams managing credentials via Kubernetes operators (External Secrets, Sealed Secrets), add a PassGeni certificate annotation to generated Secret resources at creation time.
The PassGeni API requires an Authority tier API key. Each API call to POST /api/generate followed by POST /api/generate-certificate produces a cert_url in the response. API calls are logged in the team's audit trail.
Environment files and compliance risk
Environment files (.env, .env.production, .env.local) are an audit liability that DevOps teams should be aware of:
- Plaintext storage: .env files store credentials in plaintext. If committed to version control (a common mistake), they expose credentials permanently. If stored on developer workstations, they create uncontrolled access vectors.
- No provenance: .env files contain the credential value only — no documentation of how it was created, when, to what standard, or by whom. From a compliance standpoint, these credentials are undocumented.
- No access controls: .env files have filesystem-level access controls at best. Anyone with read access to the file can read all credentials in it, with no audit log.
- The compliant alternative: Generate credentials using PassGeni (capturing the cert_url), inject them at runtime via a secrets manager (Vault agent, AWS Parameter Store, Doppler sync). The application references the credential at runtime; it is never stored in a .env file; the cert_url provides compliance documentation.
If .env files are unavoidable in your environment, at minimum: ensure they are in .gitignore and never committed; generate their contents using PassGeni with the appropriate compliance preset; document the cert_url in the associated application's runbook.
Building an audit evidence package
When preparing for a SOC 2, HIPAA, or PCI-DSS audit as a DevOps/SRE team, the credential evidence package should include:
- Written infrastructure credential policy: A document covering minimum password length by credential type, approved generation tools, secrets manager requirements, rotation schedule, and off-boarding procedures. Use PassGeni's Policy Generator with your applicable standards.
- Credential inventory: A register of all in-scope credentials: system name, credential type, applicable compliance standard, rotation date, cert URL. This can be a simple CSV or CMDB table.
- Compliance certificates: For each in-scope credential: the cert URL demonstrating it was generated to the stated compliance standard. Auditors can independently verify each certificate.
- Secrets manager configuration: Export or screenshot showing encryption-at-rest configuration, access policies, and audit logging settings for your secrets management platform.
- Rotation logs: Evidence of credential rotation events with dates. PassGeni's dashboard (Assurance tier) shows certificate history as a rotation log.
- Access reviews: Documentation showing periodic review of which service accounts exist and who has access to retrieve credentials from the secrets manager.
This package addresses the credential control evidence requirements for SOC 2 CC6.1, HIPAA §164.312, PCI-DSS Requirement 8, and ISO 27001 Annex A.9.
DevOps compliance checklist
Use this checklist when onboarding a new system to compliance requirements or preparing for an audit:
- Identify all credentials associated with the target system or audit scope
- Classify each credential by applicable compliance framework
- Rotate any credential created without documented provenance — generate replacement via PassGeni with appropriate preset
- Collect certificate URL for each rotated or new credential
- Store credential in approved secrets manager (Vault, AWS SM, Doppler)
- Tag each secret with PassGeni cert URL in secrets manager metadata
- Add cert URLs to system runbook and infrastructure documentation
- Create or update credential inventory spreadsheet / CMDB entry
- Configure rotation schedule and calendar reminder (per applicable framework)
- Generate written credential policy using PassGeni Policy Generator
- Export secrets manager access policy configuration for audit evidence
- Test credential rotation workflow end-to-end (including cert URL capture)
- For CI/CD credentials: verify no credentials in version control (.env check, git history scan)
- For Authority tier teams: verify API-based certificate generation working in provisioning pipeline