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 | Updated Software as a Service per SaaS Governance policy changes | |
2024R3 | Data Management | File Transfer | 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 | 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 | 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 | Introduced new content summarizing CMS recommendations or enterprise solutions. | |
2024R1.0 | Data Management | N/A |
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 Guidance CMS Services Framework Services Services Framework - Mediation Services Services Framework Summary |
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 | 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 |
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. |
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 |