Configuration and Change Management¶
2025.2
CAP Index standardizes and automates configuration management through the use of automation scripts as well as documentation of all changes to production systems and networks. Automation tools such as CID, Azure CLI, PowerShell automatically configure all CAP Index systems according to established and tested policies, and are used as part of our Disaster Recovery plan and process.
Policy Statements¶
CAP Index policy requires that:
(a) All production changes, including but not limited to software deployment, feature toggle enablement, network infrastructure changes, and access control authorization updates, must be invoked through approved change management process.
(b) Each production change must maintain complete traceability to fully document the request, including requestor, date/time of change, actions taken and results.
(c) Each production change must be fully tested prior to implementation.
(d) Each production change must include a rollback plan to back out the change in the event of failure.
(e) Each production change must include proper approval.
- The approvers are determined based on the type of change.
- Approvers must be someone other than the author/executor of the change.
- Approvals may be automatically granted if certain criteria is met. The auto-approval criteria must be pre-approved by the Security Officer and fully documented and validated for each request.
Controls and Procedures¶
Configuration Management Processes¶
-
Configuration management is automated using industry-recognized tools like Chef, Salt and Terraform to enforce secure configuration standards.
-
All changes to production systems, network devices, and firewalls are reviewed and approved by Security team before they are implemented to assure they comply with business and security requirements.
-
All changes to production systems are tested before they are implemented in production.
-
Implementation of approved changes are only performed by authorized personnel.
-
Tooling is used to generate an up to date system inventory.
- All systems are categorized and labeled by their corresponding environment, such as dev, test, and prod.
- All systems are classified and labeled based on the data they store or process, according to CAP Index data classification model.
- The Security team maintains automation which monitors all changes to IT assets, generates inventory lists, using automatic IT assets discovery, and services provided by each cloud provider.
- IT assets database is used to generate the diagrams and asset lists required by the Risk Assessment phase of CAP Index’s Risk Management procedures
- CAP Index Change Management process ensures that all asset inventory created by automation is reconciled against real changes to production systems. This process includes periodic manual audits and approvals.
- During each change implementation, the change is reviewed and verified by the target asset owner as needed.
-
CAP Index uses the Security Technical Implementation Guides (STIGs) published by the Defense Information Systems Agency as a baseline for hardening systems.
- Windows-based systems use a baseline Active Directory group policy configuration in conjunction with the DISA STIGs.
- Linux-based systems use Red Hat Enterprise Linux STIG as a guideline for implementation.
- VM instances in Azure are provisioned using only hardened and approved Azure Machine Images.
- Docker containers are launched using only approved Docker images that have been through security testing.
-
All IT assets in CAP Index have time synchronized to a single authoritative source.
- On-premise systems are configured to point to an internal NTP server.
- The internal NTP server and all Azure instances are pointing to the same set of ntp.org servers.
-
All frontend functionality (e.g. user dashboards and portals) is separated from backend (e.g. database and app servers) systems by being deployed on separate servers or containers.
-
All software and systems are required to complete full-scale testing before being promoted to production.
-
All code changes are reviewed to assure software code quality, while in development, to proactively detect potential security issues using pull-requests and static code analysis tools. More details can be found in the Software Release / Code Promotion section.
Configuration Monitoring and Auditing¶
All infrastructure and system configurations, including all software-defined sources, are centrally aggregated to a configuration management database (CMDB) – Microsoft Intune.
Configuration auditing rules are created according to established baseline, approved configuration standards and control policies. Deviations, misconfigurations, or configuration drifts are detected by these rules and alerted to the security team.
Production Systems Provisioning¶
-
Before provisioning any systems, a request must be created and approved in Jira.
- Jira access requires authenticated users.
- Security grants access to the Jira project following the procedures covered in the Access Establishment and Modification section.
-
The security team must approve the provisioning request before any new system can be provisioned, unless a pre-approved automation process is followed.
-
Once provisioning has been approved, the implementer must configure the new system according to the standard baseline chosen for the system’s role.
-
If the system will be used to store sensitive information, the implementer must ensure the volume containing this sensitive data is encrypted.
-
Sensitive data in motion must always be encrypted.
-
A security analysis is conducted once the system has been provisioned. This can be achieved either via automated configuration/vulnerability scans or manual inspection by the security team. Verifications include, but is not limited to:
- Removal of default users used during provisioning.
- Network configuration for system.
- Data volume encryption settings.
- Intrusion detection and virus scanning software installed.
-
The new system is fully promoted into production upon successful verification against corresponding CAP Index standards and change request approvals.
User Endpoint Security Controls and Configuration¶
-
Employee laptops, including Windows, Mac, and Linux systems, are configured
- Automatically using a configuration management tool or equivalent scripts.
-
The following security controls are applied at the minimum:
- Disk encryption
- Unique user accounts and strong passwords
- Approved security agents
- Locking after 2 mins of inactivity
- Auto-update of security patches
-
The security configurations on all end-user systems are inspected by Security through either a manual periodic review or an automated compliance auditing tool.
Server Hardening Guidelines and Processes¶
-
Linux System Hardening: Linux systems have their baseline security configuration applied via automation tools. These tools cover:
- Ensuring that the machine is up-to-date with security patches and is configured to apply patches in accordance with our policies.
- Stopping and disabling any unnecessary OS services.
- Apply applicable DISA STIGs to OS and applications.
- Configuring 15-minute session inactivity timeouts for SSH sessions.
- Installing and configuring the virus scanner.
- Installing and configuring the NTP daemon, including ensuring that modifying system time cannot be performed by unprivileged users.
- Configuring disk volumes for providers that do not have native support for encrypted data volumes, including ensuring that encryption keys are protected from unauthorized access.
- Configuring authentication to the centralized Directory Services servers.
- Configuring audit logging as described in the Auditing Policy section.
-
Windows System Hardening: Windows systems have their baseline security configuration applied via the combination of Group Policy settings and/or automation scripts. These baseline settings cover:
- Joining the Windows Domain Controller and applying the Active Directory Group Policy configuration (for AD-managed systems only).
- Ensuring that the machine is up-to-date with security patches and is configured to apply patches in accordance with our policies.
- Apply applicable DISA STIGs to OS and applications.
- Stopping and disabling any unnecessary OS services.
- Configuring session inactivity timeouts.
- Installing and configuring security protection agents such as anti-virus scanner.
- Configuring transport encryption according to the requirements described in the Mobile Device Security and Disposable Media Management section.
- Configuring the system clock to point to approved NTP servers and ensuring that modifying system time cannot be performed by unprivileged users.
- Configuring audit logging as described in the Auditing Policy section.
-
Any additional configuration changes applied to hardened Windows systems must be clearly documented by the implementer and reviewed by the Security team.
Configuration and Provisioning of Management Systems¶
-
Provisioning management systems such as configuration management servers, remote access infrastructure, directory services, or monitoring systems follows the same procedure as provisioning a production system.
-
Critical infrastructure roles applied to new systems must be clearly documented by the implementer in the change request.
Configuration and Management of Network Controls¶
[PLACEHOLDER]
THIS NEEDS REVISED
All network devices and controls on a sensitive network are configured such that:
-
Encryption keys and passwords are changed anytime anyone with knowledge of the keys or passwords leaves the company or changes positions.
-
Traffic filtering (e.g. firewall rules) and inspection (e.g. Network IDS/IPS or Azure VPC flow logs) are enabled.
-
An up-to-date network diagram is maintained.
In Azure, network controls are implemented using Virtual Networks (VNets) and Security Groups. The configurations are managed as code and stored in approved repos. All changes to the configuration follow the defined code review, change management and production deployment approval process.
Patch Management Procedures¶
Local Systems
CAP Index uses automated tooling to ensure systems are up-to-date with the latest security patches.
-
On local Linux and Windows systems, the unattended-upgrades tool is used to apply security patches in phases.
- High Risk security patches are automatically applied as they are released
- Monthly system patching for regular applications are applied as needed.
- Snapshotting of a system will take place before an update is applied.
- Once the update is deemed stable the snapshot will be removed.
- In case of failure of the update the snapshot will be rolled back.
- If the staging systems function properly after the two-week testing period, the security team will promote that snapshot into the mirror used by all production systems. These patches will be applied to all production systems during the next nightly patch run.
- The patching process may be expedited by the Security team
- On Windows systems, the baseline Group Policy setting configures Windows Update to implement the patching policy.
Cloud Resources
CAP Index follows a “cattle-vs-pets” methodology to keep the resources in the cloud environments immutable and up-to-date with security patches.
*Azure Elastic Container Service (ECS) is used to dynamically manage container resources based on demand.
-
Engineering team builds security-approved AMI from the latest Azure optimized Machine Image (AMI) to include required security agent.
-
The security agents installed on the security-approved AMIs continuously scan for and report new vulnerabilities.
-
The custom AMIs are automatically rebuilt from the latest Azure AMIs weekly to include the latest security patches.
User Endpoints
CAP Index requires auto-update for security patches to be enabled for all user endpoints, including laptops and workstations.
- The auto-update configuration and update status on all end-user systems are inspected by Security through either manual periodic audits or automated compliance auditing agents installed on the endpoints.
Production Deploy / Code Promotion Processes¶
In order to promote changes into Production, a valid and approved Change Request (CR) is required. It can be created in the Change Management System/Portal which implements the CAP Index Change Management workflow, using the Production Change Management (PRODCM) Jira project to manage changes and approvals.
-
At least two approvals are required for each PRODCM ticket. By default, the approvers are
- Security Lead and
- Engineering Lead.
-
Additional approver(s) may be added depending on the impacted component(s). For example,
- the IT Manager is added as an approver for IT/network changes; and
- the DevOps Lead is added as an approver for changes to
CAP Index-staging
account in Azure.
-
Each PRODCM ticket requires the following information at a minimum:
- Summary of the change
- Component(s) impacted
- Justification
- Rollback plan
-
Additional details are required for a code deploy, including:
- Build job name
- Build ID and/or number
- Deploy action (e.g. plan, apply)
- Deploy branch (e.g. master)
- Target environment (e.g.
CAP Index-staging
,CAP Index-prod
,datacenter-hq
) - Links to pull requests and/or Jira issues
- Security scan status and results
Emergency Change¶
In the event of an emergency, the person or team on call is notified. This may include a combination or Development, IT, and Security.
If an emergency change must be made, such as patching of a zero-day security vulnerability or recovering from a system downtime, and that the standard change management process cannot be followed due to time constraint or personnel availability or other unforeseen issues, the change can be made by:
-
Notification: The Engineering Lead, Security Lead, and/or IT Lead must be notified by email, Slack, or phone call prior to the change . Depending on the nature of the emergency, the leads may choose to inform members of the executive team.
-
Access and Execution: Manually access of the production system or manual deploy of software, using one of the following access mechanisms as defined in Access Control policy and procedures:
- Support/Troubleshooting access
- Root account or root user access
- Local system access (for on-premise environment)
-
Post-emergency Documentation: A PRODCM ticket should be created within 24 hours following the emergency change. The ticket should contains all details related to the change, including:
- Reason for emergency change
- Method of emergency access used
- Steps and details of the change that was made
- Sign-off/approvals must be obtained per the type of change as defined by the standard CM process
-
Prevention and Improvement: The change must be fully reviewed by Security and Engineering together with the person/team responsible for the change. Any process improvement and/or preventative measures should be documented and an implementation plan should be developed.