FRR-RSC-09: Publish Guidance
Last Updated: 2025-11-25
Version: 1.0.0
Overview
FedRAMP Rev5 requires CSPs to publish secure configuration guidance publicly to enable customers and auditors to understand and implement security controls. This guidance is available through multiple channels and formats for maximum accessibility.
Publication Channels
Web-Based Guidance Portal
Description:
Interactive HTML interface for browsing guidance
Url:
http://:8080/
Access Method:
Public HTTP/HTTPS (configure as needed)
Authentication:
None required (public access)
RESTful JSON API
Description:
Programmatic access to guidance data
Base Url:
http://:8080/api
Endpoints:
- all_guidance: {'path': '/api/guidance/all/json', 'method': 'GET', 'description': 'Complete guidance for all requirements', 'response': 'JSON object with all RSC requirements', 'example': 'curl http://
:8080/api/guidance/all/json\n'} - specific_requirement: {'path': '/api/guidance/
/json', 'method': 'GET', 'description': 'Guidance for specific requirement', 'parameters': 'requirement: rsc01_root_account_guidance, rsc02_root_security_settings, etc.', 'example': 'curl http:// :8080/api/guidance/rsc01_root_account_guidance/json\n'} - cloudformation_template: {'path': '/api/cloudformation/
/', 'method': 'GET', 'description': 'Region-specific CloudFormation templates', 'example': 'curl http:// :8080/api/cloudformation/us-east-1/iam-password-policy\n'}
Rate Limiting:
None (configure as needed for production)
Caching:
Recommended to cache responses locally
Amazon S3 Bucket
Description:
Static file hosting for guidance artifacts
Bucket Name:
fedramp-sec-config-analysis (example)
Access Method:
Public read access or authenticated
Available Files:
- guidance_json: guidance/complete-guidance.json
- guidance_markdown: guidance/complete-guidance.md
- guidance_html: guidance/complete-guidance.html
- cloudformation: cloudformation/*.yaml
- config_packs: config/*.yaml
- oscal: oscal/*.json
Example Access:
# Download via AWS CLI aws s3 cp s3://fedramp-sec-config-analysis/guidance/complete-guidance.json . # Download via HTTP (if public) curl https://fedramp-sec-config-analysis.s3.amazonaws.com/guidance/complete-guidance.json
GitHub Repository
Description:
Version-controlled source code and documentation
Repository Url:
https://github.com//FedRAMPSecConfig (example)
Example Clone:
git clone https://github.com//FedRAMPSecConfig.git cd FedRAMPSecConfig ls guidance/
Static Documentation Website
Description:
Generated documentation from source files
Example Mkdocs:
# mkdocs.yml
site_name: FedRAMP Secure Configuration Guidance
nav:
- Home: index.md
- Requirements:
- RSC-01: rsc01.md
- RSC-02: rsc02.md
- RSC-03: rsc03.md
theme: readthedocs
Publication Formats
HTML (Web Pages)
Description:
Interactive web pages for human consumption
Access:
Via web interface at http://:8080/
Markdown
Description:
Plain text format with formatting
Download:
/guidance_output/aws_secure_configuration_guidance.md
JSON
Description:
Machine-readable structured data
Download:
/guidance_output/aws_secure_configuration_guidance.json
Description:
Printable document format
Generation:
Convert from HTML or Markdown using pandoc or wkhtmltopdf
Example:
# Generate PDF from Markdown pandoc guidance.md -o guidance.pdf # Generate PDF from HTML wkhtmltopdf http://:8080/ guidance.pdf
Access Control
Public Access
Description: Guidance is publicly accessible without authentication
Rationale: FedRAMP requires public availability for transparency
Authenticated Access
Description: Optional authentication for enhanced features
Network Restrictions
Description: Optional IP-based access control
Implementation: # Security group rule aws ec2 authorize-security-group-ingress \ --group-id sg-xxxxx \ --protocol tcp \ --port 8080 \ --cidr 10.0.0.0/8
Distribution Methods
Direct Download
Description: Download files directly from web interface
Api Integration
Description: Programmatic retrieval via API
Example Curl: # Download all guidance
curl -o guidance.json http://
Example Python: import requests
# Download guidance
response = requests.get('http://
S3 Sync
Description: Sync guidance files from S3 bucket
Example: # Sync entire guidance directory aws s3 sync s3://fedramp-sec-config-analysis/guidance/ ./local-guidance/ # Download specific file aws s3 cp s3://fedramp-sec-config-analysis/guidance/complete-guidance.json .
Git Clone
Description: Clone GitHub repository
Example: # Clone repository
git clone https://github.com/
Update Notifications
Rss Feed
Description: RSS feed for guidance updates
Url: /api/updates/rss
Example Subscription: Add to RSS reader (Feedly, Inoreader, etc.)
Email Notifications
Description: Email alerts for new versions
Implementation: Subscribe via web interface or API
Webhook
Description: HTTP callbacks for updates
Use Case: Trigger CI/CD pipelines on guidance changes
Example: # Register webhook POST /api/webhooks { "url": "https://your-system.com/webhook", "events": ["guidance.updated", "guidance.published"] }
Github Watch
Description: Watch GitHub repository for changes
Method: Click 'Watch' button on GitHub repository
Notifications: Email or GitHub notifications
Compliance Documentation
Fedramp Ssp
Description: Include in FedRAMP System Security Plan
Section: Control Implementation Statements
Reference: Provide URL to published guidance
Audit Evidence
Description: Demonstrate public availability to auditors
Customer Communication
Description: Inform customers of guidance availability
Best Practices
- Publish guidance before system goes live
- Keep guidance up-to-date with system changes
- Version guidance and maintain history
- Provide multiple access methods (web, API, download)
- Use HTTPS for production deployments
- Monitor access logs for usage patterns
- Respond to feedback and questions
- Archive old versions for reference
- Test all download links regularly
- Provide clear licensing information
References
- name: FedRAMP Rev5 Requirements
url: https://www.fedramp.gov/ - name: NIST SP 800-70 Rev4
url: https://csrc.nist.gov/publications/detail/sp/800-70/rev-4/final - name: AWS Security Best Practices
url: https://aws.amazon.com/security/best-practices/