agentleFS
TeddyAlbinaTeddyAlbina/skills/preparing-compliance-documentation/SKILL.md

preparing-compliance-documentation

Skill2 starsChanged 28 days agoMITView on GitHub

Guides preparation of compliance documentation for CockroachDB Cloud deployments, covering SOC 2, PCI DSS, ISO 27001, HIPAA, and GDPR certifications. Use when responding to compliance questionnaires, preparing for audits, locating certification documents, or assessing cluster configuration for compliance readiness.

2 other projects use a version of this.

Adopted by

Most recently taken up by

The file

We split this skill into the rules it gives an agent

5 rules. About 0 are common, 5 are distinctive, and 0 are very specific to this project.

  • ≈0

    Common · estimate

    Many files like this have a rule of this kind.

  • ≈5

    Distinctive · estimate

    This author's own choices. Worth a look.

  • 0

    Very specific

    Tied to their project's names, files or tools. Probably skip.

  • Common
  • Distinctive
  • Very specific
  1. Distinctive:

    Use this checklist to evaluate whether a cluster meets common compliance requirements:

    line 84
  2. Distinctive:

    When responding to customer or auditor questionnaires, reference these standard answers:

    line 143
  3. Distinctive:

    Run the auditing-cloud-cluster-security skill to identify gaps

    line 170
  4. Distinctive:

    Document your CockroachDB Cloud configuration with screenshots or Terraform state

    line 173
  5. Distinctive:

    This skill is read-only: No cluster configuration is modified.

    line 191

≈ “Common” is an estimate: at least 1 in 5 of the 350,495 skill files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.

Keep what fits and drop the rest. Your version, ready for your agents.
Files
SKILL.md

Preparing Compliance Documentation

Guides the preparation of compliance documentation for CockroachDB Cloud deployments by identifying available certifications, mapping security features to compliance controls, and providing a configuration checklist for compliance readiness. Covers SOC 2 Type II, PCI DSS, ISO 27001, HIPAA, and GDPR.

When to Use This Skill

  • Responding to customer security questionnaires about CockroachDB Cloud
  • Preparing for SOC 2, PCI DSS, or HIPAA compliance audits
  • Locating CockroachDB Cloud certification documents (SOC 2 reports, PCI AOC, ISO certificates)
  • Assessing whether a cluster's configuration meets a specific compliance framework
  • Understanding which compliance features are available on each CockroachDB Cloud plan

Prerequisites

  • CockroachDB Cloud account — Any plan
  • Cloud Console access — For downloading compliance documents
  • Understanding of your compliance requirements — Which frameworks apply to your organization

Steps

1. Identify Available Certifications

CockroachDB Cloud maintains the following certifications and attestations:

CertificationTypeScopeWhere to Find
SOC 2 Type IIAttestation reportCloud infrastructure and operationsTrust Center or request via support
PCI DSSCertificate of Compliance (AOC)Payment data processingTrust Center or request via support
ISO 27001CertificationInformation security managementTrust Center or request via support
HIPAABAA eligibilityProtected health informationContact sales for BAA execution
GDPRComplianceEU personal data protectionDPA available on request

CockroachDB Cloud Trust Center: The Trust Center is the primary location for downloading compliance documents. Access it via the Cloud Console or request documents through a support ticket.

2. Map Compliance Controls to CockroachDB Features

See compliance matrix reference for a detailed mapping of compliance controls to CockroachDB features.

SOC 2 — Key Controls

Control AreaCockroachDB FeatureConfiguration Required
Access ControlRBAC, SSO, SCIMConfigure roles, enable SSO
EncryptionTLS (always on), CMEKEnable CMEK on Advanced plan
Audit LoggingSQL audit logging, log exportEnable audit logging + log export
Network SecurityIP allowlists, private endpointsConfigure network restrictions
AvailabilityMulti-region, managed backupsBuilt-in on all plans
Change ManagementCluster versioning, TerraformUse IaC for cluster management

PCI DSS — Key Requirements

RequirementCockroachDB FeatureNotes
Req 1: Network SecurityIP allowlists, private endpointsRestrict access to cardholder data environment
Req 3: Protect Stored DataEncryption at rest (default), CMEKCMEK provides key control
Req 4: Encrypt TransmissionTLS (always on)Enforced by default
Req 7: Restrict AccessRBAC, least privilegeUse hardening-user-privileges skill
Req 8: Identify UsersSQL users, SSO, MFAEnable SSO with MFA at IdP
Req 10: Track AccessAudit logging, log exportEnable and export audit logs

HIPAA — Key Safeguards

SafeguardCockroachDB FeatureNotes
Access ControlRBAC, SSOImplement least privilege
Audit ControlsAudit logging, log exportExport to SIEM
IntegrityChecksums, replicationBuilt-in data integrity
Transmission SecurityTLS (always on)Enforced by default
EncryptionEncryption at rest, CMEKCMEK for key control

HIPAA requirement: A Business Associate Agreement (BAA) must be executed with Cockroach Labs before storing PHI. Contact your account team to execute a BAA.

3. Assess Cluster Configuration for Compliance

Use this checklist to evaluate whether a cluster meets common compliance requirements:

Baseline (All Frameworks)

-- Check password policy
SHOW CLUSTER SETTING server.user_login.min_password_length;
-- Should be >= 12

-- Check admin user count
SELECT COUNT(*) AS admin_count FROM [SHOW GRANTS ON ROLE admin];
-- Should be minimized (1-3)

-- Check audit logging
SHOW CLUSTER SETTING sql.log.admin_audit.enabled;
SHOW CLUSTER SETTING sql.log.user_audit;
-- Should be enabled

-- Check PUBLIC role privileges
SELECT database_name, privilege_type
FROM [SHOW GRANTS FOR public]
WHERE privilege_type NOT IN ('USAGE')
  AND schema_name = 'public';
-- Should return no rows for application databases
# Check network security
ccloud cluster networking allowlist list <cluster-id> -o json
# Should NOT contain 0.0.0.0/0

# Check SSO configuration (Cloud Console)
# Verify in Cloud Console > Organization Settings > Authentication

# Check CMEK (Advanced plan)
ccloud cluster info <cluster-name> -o json
# Check for cmek_config

# Check log export (Advanced plan)
# Look for log_export_config in cluster info output

Advanced Compliance (SOC 2 + PCI DSS + HIPAA)

CheckCommand/LocationExpected State
SSO enabledCloud ConsoleEnabled and enforced
SCIM provisioningCloud ConsoleEnabled
CMEK enabledccloud cluster infoEnabled with valid key
Audit loggingSQL: SHOW CLUSTER SETTING sql.log.admin_audit.enabledtrue
Log exportccloud cluster infoConfigured and ENABLED
IP allowlistccloud cluster networking allowlist listNo 0.0.0.0/0
Private endpointsCloud Console: Networking > Private endpointConfigured (recommended)
Password policySQL: min_password_length>= 12
Admin countSQL: admin role grants<= 3
PUBLIC privilegesSQL: SHOW GRANTS FOR publicMinimal

4. Respond to Security Questionnaires

When responding to customer or auditor questionnaires, reference these standard answers:

Encryption at rest:

  • CockroachDB Cloud encrypts all data at rest using AES-256
  • CMEK is available on Advanced plan with Advanced Security Add-on for customer-controlled keys
  • Key management follows cloud provider best practices (AWS KMS, GCP Cloud KMS, Azure Key Vault)

Encryption in transit:

  • TLS 1.2+ is enforced on all connections — cannot be disabled
  • Client certificate authentication (mTLS) is supported

Data residency:

  • Clusters can be deployed in specific regions to meet data residency requirements
  • Multi-region clusters keep data within specified regions

Backup and recovery:

  • Managed backups are automatic on all plans
  • RPO and RTO depend on plan type and configuration
  • Backups are encrypted and stored in the same cloud provider

Incident response:

  • Cockroach Labs maintains a documented incident response plan
  • Details are available in the SOC 2 Type II report

5. Prepare for Compliance Audits

Before the audit:

  1. Run the auditing-cloud-cluster-security skill to identify gaps
  2. Remediate any FAIL findings using the linked remediation skills
  3. Download current compliance documents from the Trust Center
  4. Document your CockroachDB Cloud configuration with screenshots or Terraform state

During the audit:

  1. Provide the SOC 2 Type II report to demonstrate CockroachDB Cloud's controls
  2. Show your cluster configuration (security audit report) to demonstrate your controls
  3. Demonstrate audit log export and review capability
  4. Show RBAC configuration and access control policies

Compliance documents to have ready:

  • SOC 2 Type II report (from Trust Center)
  • PCI AOC (if processing payment data)
  • ISO 27001 certificate (if required)
  • BAA (if storing PHI — executed with Cockroach Labs)
  • DPA (if processing EU personal data)
  • Your security audit report (from auditing-cloud-cluster-security skill)

Safety Considerations

  • This skill is read-only. No cluster configuration is modified.
  • Compliance documents may be confidential. Handle SOC 2 reports and PCI AOCs according to your organization's information classification policy.
  • Compliance is shared responsibility. CockroachDB Cloud provides the platform controls; your organization is responsible for configuring and using them correctly.

References

Skill references:

  • Compliance control matrix

Related skills:

  • auditing-cloud-cluster-security — Automated security posture assessment
  • configuring-audit-logging — Enable audit logging for compliance
  • enabling-cmek-encryption — Enable customer-managed encryption keys
  • configuring-sso-and-scim — Enable SSO and automated provisioning
  • hardening-user-privileges — Implement least-privilege access
  • enforcing-password-policies — Configure password requirements
  • configuring-ip-allowlists — Network access control
  • configuring-private-connectivity — Private network endpoints
  • configuring-log-export — Export logs for compliance retention

Official CockroachDB Documentation:

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

Reviews can't be read right now.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.