TRA Release History

The TRA Release History contains the historical changes published to the TRA, in reverse chronological order. Note: Older releases may contain content or links that have been modified or deleted.

Version Section Chapter Revised Topic Revision Description
2024R3 Infrastructure Services Software as a Service

SaaS Introduction

SaaS Business Rules

Updated Software as a Service per SaaS Governance policy changes
2024R3 Data Management File Transfer

File Transfer Introduction

File Transfer Business Drivers

Updated Enterprise File Transfer (EFT) information
2024R3 Application Development Business Rules

BR-SA-10: Applications in CMS Data Centers May Not Use Some Native Email Protocols

Updated SMTP Email Relay information
2024R3 Foundation N/A

CMS Strategic Guidance and Preferred Solutions

Changed Nomenclature to “CMS Hybrid Cloud”
Removed references to CMS batCAVE, discontinued after September 2024
2024R2.1 Foundation N/A TRB Engagement Guidance Updated 10/25/2023 whitepaper and related content
2024R2.1 References N/A TRA Business Rule Index and throughout Added text of deprecated and withdrawn TRA Business Rules (BR) and Recommended Practices (RP)
2024R2.0 Data Data Management

Introduction to Data Management

Enterprise Data Mesh

File Transfer

Reorganized TRA sections related to data management resources
2024R2.0 Data Data Storage Data Storage Services Reorganized TRA sections related to data storage
2024R2.0 Data Data Usage Business Intelligence Reorganized TRA sections related to consuming data, including Business Intelligence and Analytics
2024R2.0 Foundation CMS Strategic Guidance and Preferred Solutions CMS Strategic Guidance and Preferred Solutions Updated enterprise services, including collaboration services
2024R2.0 Application Development N/A Principles New content and recommended practice for Threat Modeling
2024R2.0 References TRA Glossary TRA Glossary Reorganize data-related terms
2024R2.0 Application Development N/A Application Development Introduction Consolidate the application development topics Concepts and Terminology, Principles
2024R1.1 References N/A TRA Business Rule Index Added an index of TRA Business Rules (BR) and Recommended Practices (RP)
2024R1.0 Foundation N/A

Guiding Principles

CMS Strategic Guidance & Preferred Solutions

Introduced new content summarizing CMS recommendations or enterprise solutions.
2024R1.0 Data Management N/A

Introduction to Data Management

Enterprise Data Sharing & Governance

New content describes major CMS data services and data sources.

New guidance emphasizes how CMS data must be kept within CMS authorization boundaries.

2024R1.0 Application Development Business Intelligence Business Intelligence Environment Updated Business Intelligence (BI) and Data Analytics resources, incorporating information from the Data Analytics & BI Tools Research Spotlight published May 12, 2023 as well as the EADG BI Tools pages. Some major CMS repositories feature close integration with BI and Analytics tools.
2024R1.0

Application Development

Infrastructure Services

Multiple Multiple Added callouts in relevant topics with CMS strategic guidance and recommendations or enterprise solutions. Future updates will add detailed guidance in other TRA topics.
2024R1.0 Application Development N/A

Blockchain Technology

Fast Data

Removed Fast Data and Blockchain from the TRA (the 4/26/21 Research Spotlight remains).
2023R2.0 Application Development Business Rules and Recommended Practices BR-SA-10: Applications in CMS Data Centers May Not Use Some Native Email Protocols

Updated Business Rule to reflect new CMS email architecture based on move from HHS to CMS tenant.

2023R2.0 Infrastructure Services Mobile Device Management Mobile Device Management Significant updates have been made across this chapter to align with current HHS mobile device policy In addition, the several sections within this chapter have been consolidated into a single web page for easier viewing and navigation.
2023R2.0 Foundation Zero Trust Zero Trust A new section introduces the CISA Zero Trust Maturity Model and shows how CMS TRA Business Rules and Recommended Practices align with it.
2023R2.0 Application Development Business Rules and Recommended Practices

BR-SA-1: Use CMS Shared Services

BR-SA-2: Integrate with the CMS Identity Management Services

BR-SQ-5: Manual Code and Design Reviews Are Mandatory

Updated business rules to reflect TRB role as advising rather than approving, and removed references to legacy gate review process step.
2023R2.0 Application Development Open Source Business Rules RP-OSS-2: Implement the Tools to Support the Community Around a CMS-Released OSS Project Minor update to language regarding tools to support roadmap publication.
2023R1.1 All Multiple Multiple

Legacy Volume, Chapter, and Section references changed to hyperlinks to content titles

Selected business rule references now link to the rules

2023R1 Foundation CMS TRA Business Rules BR-F-3: The CMS TRA Defines a Zoned Architecture Align zones with the Services Framework
2023R1 Foundation CMS TRA Business Rules BR-F-4: Within a Data Center, Communication Must Flow Only between Adjacent Zones or within a Single Zone Updated rule title to refer to 'processing environment' rather than data center to be cloud-inclusive. Updated text to clarify that zones refer to CMS TRA zones (vs. cloud availability zones).
2023R1 Foundation CMS TRA Business Rules BR-F-5: Any System That Processes CMS Data Must Be Covered by a CMS ATO Updated the business rule to remove reference to prior ATO guide and instead reference the current CMS ATO website.
2023R1 Foundation CMS TRA Business Rules RP-F-21: Limit Data in the Application and Presentation Zones Refer to Application Services and not just Application Zone to align with the Services Framework
2023R1 Foundation CMS Technical Review Board CMS Technical Review Board Updated to refer to TRB guidance rather than TRB approval, and TRB consult vs TRB review.
2023R1 Foundation CMS TRA Change Request Process TRA Architecture Change Process Updated the text and the diagram in this topic to align with current process and provide reference to the TRA websites.
2023R1 Foundation Services Framework

CMS Services Framework

CMS Services Framework Guidance

CMS Services Framework Services

Services Framework

Services Framework - Mediation Services

Services Framework Summary

CMS Multi-Zone Architecture

Significant updates across the entire Services Framework section. Includes new content and clarification of services framework concepts and relationship to multi-zone architecture.

Also includes re-organization of the content, so some prior topics are removed and content shifted into different topics

2023R1 All Multiple Multiple Across the entire TRA, changed from Security and Management 'band' to 'zone' to provide consistency across data center and cloud environments
2023R1 Infrastructure Services File Transfer BR-EFT-11: CMS Data Files May Only Be Transferred to the Data Zone Updated to reflect Services Framework and cloud deployments
2023R1 Infrastructure Services Data Storage Services BR-AWS-2: The S3 Storage Must Be Attached / Accessible from Not More Than One Zone Update Zonal attachment guidance based on Services Framework
2023R1 Infrastructure Services Data Storage Services BR-AWS-3: Do Not Allow Cross-Zone Access to S3 Include reference to required security challenges
2023R1 Infrastructure Services Cloud IaaS and PaaS Infrastructure BR-CI-9: Applicability of Multi-Zone Architecture Updated rationale to reflect TRB consult vs approval
2023R1 Infrastructure Services Software as a Service

Software as a Service Introduction

BR-SAAS-6: Perform Configuration Management

Updated SaaS guidance based on the new CMS SaaS Governance program
2023R1 Application Development Application Development Context Application Development Context Updated services framework info and removed duplicative content and instead provided links to services framework and multi zone topic
2023R1 Application Development Application Development BR-SA-3: No Custom Application Code Is Permitted in the Presentation Zone Updated to reflect Services Framework
2023R1 Application Development Application Development BR-SA-4: Use TRB-Validated Approved Data Zone Mediation and Data Access Services to Access Data in the Data Zone Updated to reflect Services Framework
2023R1 Application Development Application Development BR-SA-9: Systems Must Define Metrics for IT Health Monitoring Updated title and guidance of infrastructure monitoring business rule to reflect both cloud and data center environments.
2023R1 Application Development Web Services and Web APIs BR-WS-9: Inter-Zone Web Services Must Transverse a Mediated Service Updated to reflect Services Framework
2023R1 Application Development Web Services and Web APIs BR-WS-12: Messages Must Pass through All Intermediate Zones Updated to reflect Services Framework
2023R1 Application Development Containers and Microservices BR-CA-1: The CMS Zonal Architecture Must Be Preserved Updated to reflect Services Framework
2023R1 Application Development Containers and Microservices BR-CA-3: The CMS TRA Zonal Hierarchy Will Be Enforced Updated to reflect Services Framework
2023R1 Application Development Web Services and Web APIs Service Deployment in the Multi-Zone Architecture Updated to reflect Services Framework
2023R1 Application Development Input Validation CMS TRA and CMS ARS Requirements Updated to reflect Services Framework
2022R1.1 Summary of Changes N/A Change Log of All Releases

Need a historical account of all changes made to the TRA:

Added the complete change log as its own section. It will be redacted for the external versions. It will not contain "in-flight" changes.

2022R1.1 List of TRA References N/A List of TRA References Across the entire section, updated references to current versions and provided updated active hyperlinks to references
2022R1.1

Services Framework

Glossary

N/A

Services Framework - Framework

Glossary

Updated fonts to align with overall TRA styles
2022R1 All Various Footnotes

Legacy footnotes embedded in text (hover) are showing obsolete or redundant information:

Removed (hover) footnote text where applicable. (ongoing)

2022R1 All Various Volume references Removed references to TRA "Volumes" and point to appropriate online section where applicable.
2022R1 All Various Security control name changes in ARS 5 (aligned to NIST SP 800-53 rev 5)

The titles/names of over 40 controls were changed in ARS 5:

Updated all TRA references to these controls to align with the new ARS 5 naming

2022R1 All Various New security controls added to CMS baselines as part of the ARS 5 update (aligned to NIST SP 800-53 rev 5)

21 new security controls were added to CMS baselines with ARS 5:

Added TRA references to the new controls as appropriate in various business rules throughout the TRA content

2022R1 All Various ARS 4 Privacy Catalog controls (AR, DI, DM control sets; NIST 800-53 rev 4 Appendix J) integrated into the main control families in ARS 5

Legacy privacy controls migrated into other ARS 5 controls:

References to legacy AR, DI, and DM controls have been updated across the TRA based on the NIST recommended mapping to new controls

2022R1 All Various Legacy CMS-specific controls (SC-CMS-1, SC-CMS-2)

In ARS 5, legacy CMS controls have been withdrawn and mapped into other standard controls:

References to the legacy CMS specific controls have been mapped to new controls based on guidance from the CMS ISPG policy team.

2022R1 Network Services, Infrastructure Services Business Rules

BR-ACID-6: Minimize Retention of PII in Identity Life-Cycle Management

BR-SAAS-4: Plan for Data Archival to Comply with Federal Records Management

Updated to reflect ARS changes:

Replaced withdrawn security control DM-2 with MP-6, SI-12, and SI-12(3)

2022R1 Foundation Various places throughout the TRA

Introduction (Foundation)

Disaster Recovery (Infrastructure Services)

TRA list of References (References)

ARS version change after update to ARS 5 :

Change to url security.cms.gov and https://security.cms.gov/policy-guidance/cms-acceptable-risk-safeguards-ars where applicable

2022R1 Foundation TRA Services Framework

CMS TRA Services Framework Architecture, Guidance, Services

CMS TRA Services Framework, Protecting Services, Framework Summary

New chapters developed to provide guidance on services framework architecture intended to modernize multi-zone architecture.
2022R1 Various Various places throughout the TRA

Various topic places through the TRA that contain related information about the TRA Services Framework.

They can be found here, here, here, here, and here.

Integrate new services framework information into the existing TRA content.
2022R1 Foundation TRA Business Rules BR-F-22: The CMS TRA Defines a Services Framework Architecture Added new business rule for Services framework
2022R1 Network Services WAN Business Rules and Practices BR-WAN-O-2: Access to the Public Internet Will Be Via the HHS TIC Trusted Internet Connections (TIC) updated to new guidance for OMB-M-19-26
2022R1 All All HCD - General Website Layout

Added working breadcrumb links at the top of all pages.

Moved previous and next page icons to left bottom, out of the content and made them fixed. They no longer scroll with the content.

2022R1 Application Development Portal Integration Options URL Pass-through and Native Portlet Obsolete content: Added updates from portal team input.
2022R1 Data Management Data Lake Onboarding Data Lake Onboarding Obsolete content: Updated URLs
2022R1 Data Management Data Catalogs Data Catalogs Obsolete content: Updated URLs
2022R1 Data Management EUDC User Data Catalogs Obsolete content: Updated Chart
2022R1 Application Development Future Considerations Standard SOAP Headers Obsolete content: Removed content
2022R1 Application Development Principles Digital Service Delivery and Human Centered Design Obsolete content: Updated terminology from "User Centered Design" to "Human Centered Design" and removed broken link.
2022R1 Application Development Business Rules and Recommended Practices BR-DBM-3: Systems must meet CMS Data and Database Management Standards Obsolete content: CDA has been rebranded to Data Architecture (DA). Revised content to reflect new services
2022R1 All All All Added TRA version and date to header to display on all pages
2022R1 Infrastructure Services Network Virtualization Future Considerations Obsolete content: Removed future considerations for virtualization
2022R1 Application Development Fast Data Fast Data Obsolete content: Removed outdated content based of TRB feedback.
2022R1 Foundation Services Framework Services Framework Architecture

Some audience were unclear if the Services framework was mandatory:

Clarified language to state the CMS Services Framework is an option and that multi-tier is still valid (content since removed).

2021R2.2 Infrastructure Services DR Key Concepts and Definitions Disaster

Inclusive and sensitive terminology ("man-made"):

Updated language to "human-caused"

2021R2.2 Publishing Platform N/A N/A

Security update to API connector:

Applied new version of axios (v3.3) code.

2021R2.1 Change Log N/A N/A

Updated table and columns formatting

Navigation - provided additional links to changed material

2021R2.1 Reference Acronyms N/A Formatting - Added borders to table
2021R2.1 Reference Glossary N/A Formatting- Added borders to table
2021R2.1 All All Various

Transform from pdf to online - duplicate figure and table numbers no longer applicable in web version:

Removed table and figure numbers

2021R2.1 All All N/A

Transform from pdf to online:

Sequenced all url names to match order of content

2021R2.1 Foundation Guiding Principles Various

Transform from pdf to online:

Updated hard references of "Volumes" for online

2021R2.1 Foundation Guiding Principles N/A

Transform from pdf to online:

Changed section number reference to link

2021R2.1 Application Development Concepts and Terminology Various

Transform from pdf to online:

Updated hard references of "Volumes" for online

2021R2.1 Foundation CMS TRA Multi zone Architecture Various

Transform from pdf to online:

Updated hard references of "Volumes" for online

2021R2 Foundation Guiding Principles Common Platform Services Removed explicit product reference
2021R2 Foundation CMS TRA Multi-Zone Architecture Network Connectivity and Trust Boundaries

Change wording to indicate that these networks operate at a high level of trust (vs explicitly trusted)

Edited the text to remove the explicit trust reference, indicating that CMSNet and CMS data centers operate at an elevated trust level, but best practice would be to authenticate all network connections (aligns to future zero trust security model being pushed through the recent Executive Order on Cybersecurity).

2021R2 Foundation CMS TRA Business Rules BR-F-6: Mainframes Must Be Dedicated to CMS

Remove IBM reference, but can retain reference to logical partitions. Cite the requirement for an AAA (Authorization, Auditing, Authentication) tool. RACF can be generically referred to as an example of such.

After review with TRB, the IBM references can remain. Added AA references and removed specific naming of RACF.

2021R2 Infrastructure Services Software as a Service

CMS Performance Management Systems;

BR-KSM-1: KSM Auditing Must Be Enabled and Connected to CMS Logging Infrastructure

Added references that explains logging in detail. Addressed explicit references to specific products.
2021R2 Infrastructure Services Keys and Secrets Management Enterprise Monitoring & Management Matrix Addressed explicit references to specific products.
2021R2 Application Development Services Application Development

Data and Database Management;

BR-DBM-3: Systems Must Meet CMS Data and Database Management Standards

Updated chapter references
2021R2 Application Development Services Application Development

Packaging and Delivery;

BR-PD-2: Software Target Packaging Must Be in Either the Operating System or Language Platform Native Form

Addressed explicit references to specific products.
2021R2 Application Development Services Open Source Software

Business Rules and Recommended Practices (Open Source);

BR-OSS-12: CMS-Released OSS Code Must Include Automated Unit Tests, Build Scripts and Be Checked for Software Vulnerabilities

Addressed explicit references to specific products.
2021R2 Application Development Services Portal Strategy Current State of CMS Portals After review with TRB, removed outdated Portals diagram.
2021R2 Application Development Services Business Intelligence Data Warehouses Removed obsolete references within list of available CMS data stores
2021R2 Application Development Services Business Intelligence Business Intelligence Servers Addressed explicit references to specific products.
2021R2 Application Development Services Business Intelligence Hardware and Software Platforms Addressed explicit references to specific products.
2021R2 Application Development Services Business Intelligence Business Intelligence Servers Addressed explicit references to specific products.
2021R2 Application Development Services Business Intelligence Database Servers Addressed explicit references to specific products.
2021R2 Application Development Services Business Intelligence Integrate Operational Data Sources Addressed explicit references to specific products.
2021R2 Application Development Services Business Intelligence Data Integrity / Quality Addressed explicit references to specific products.
2021R2 Application Development Services Business Intelligence Metadata Integration Addressed explicit references to specific products.
2021R2 Application Development Services Web Services Technology Overview Monitoring Lambda Functions Addressed explicit references to specific products.
2021R2 Application Development Services Web Services Technology Overview BR-LD-2: Integrate with CMS Enterprise Security Addressed explicit references to specific products.
2021R2 Application Development Services Future Considerations Implications for CMS Development Addressed explicit references to specific products.
2021R2 Application Development Services Glossary Section Glossary: Enterprise User Administration (EUA) Addressed explicit references to specific products.
2021R2 Application Development Services Business Intelligence Web Servers Addressed explicit references to specific products.
2021R2 Application Development Services Containers and Microservices CMS Considerations and Recommendations for Using AWS Lambda Removed text indicating AWS Lambda as not yet FedRamp approved
2021R2 Data Management Enterprise Data Environment Overview 1.1.1 CMS Master Data Management Removed the actual MDM API names and reworded to describe functionality
2021R2 Data Management Enterprise Data Environment Overview 1.1 Data Lake Onboarding Genericized description of associated S3 buckets
2021R2 Data Management Enterprise Data Environment Overview 1.1 User Data Catalog Capabilities

Diagram depicts various specific tool names.

Added text to document to indicate a "sample" diagram.

2021R2 Data Management Enterprise Data Environment Overview 2.5 Data Lake Onboarding Added links to pages on EDL Confluence space for Contributor and Consumer onboarding instructions
2021R2 Data Management Enterprise Data Environment Overview 2.6 Data Catalogs EDL's user data catalog: changed references to user data catalog to EUDC
2021R2 Data Management Chapter 3 3.1 Authentication EDL access and authentication: Added description for how to access the EUDC
2021R2 Data Management List of Acronyms   Introduced DA to acronym list; removed CDA
2021R1.1 Application Development Common Engineering Support Services all Replaced section of missing content from conversion to web
2021R1.1 Application Development Common Engineering Support Services all Replaced missing content from conversion to web