Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Create GSA-pages.md #3814

Merged
merged 35 commits into from
Apr 17, 2024
Merged
Changes from 1 commit
Commits
Show all changes
35 commits
Select commit Hold shift + click to select a range
11f91ac
Create tts-pages.md
JJediny Feb 28, 2024
d225b31
Updates based on review and spellcheck
JJediny Feb 29, 2024
865c857
update-to-confirm-or-add-to-touchpoints
JJediny Mar 1, 2024
bc0dc1d
Updates based on Feedback so far
JJediny Mar 2, 2024
03cbc1d
Update tts-pages.md
JJediny Mar 2, 2024
f240666
Merge branch 'main' into gsa-pages-atu-WIP
JJediny Mar 4, 2024
b22bbdf
rename back to gsa-pages
JJediny Mar 11, 2024
d748a53
Merge branch 'main' into gsa-pages-atu-WIP
JJediny Mar 11, 2024
6e1236e
change request link
JJediny Mar 11, 2024
46ca3b9
Merge branch 'gsa-pages-atu-WIP' of https://github.com/18F/handbook i…
JJediny Mar 11, 2024
548b763
minor edits
JJediny Mar 12, 2024
2761926
Merge branch 'main' into gsa-pages-atu-WIP
JJediny Mar 19, 2024
bdc6643
change blockqoutes to use handbook alert components where appropriate
JJediny Mar 22, 2024
f29edd6
Change capatalization based on feedback
JJediny Mar 22, 2024
531631c
Change passive voice based on
JJediny Mar 22, 2024
70052b6
add to whom
JJediny Mar 22, 2024
7b60847
add to by whom
JJediny Mar 22, 2024
2a7e937
Merge branch 'main' into gsa-pages-atu-WIP
JJediny Mar 22, 2024
05615da
swap banner order and remove multiple links to pages
JJediny Mar 22, 2024
ae99f48
remove more capitalization
JJediny Mar 22, 2024
f450c66
use h4 for low systems alerts to avoid adding to in page nav
drewbo Mar 22, 2024
2af882e
fix link, small formatting
drewbo Mar 22, 2024
429302e
Merge branch 'main' into gsa-pages-atu-WIP
JJediny Mar 29, 2024
1e9358e
Merge branch 'main' into gsa-pages-atu-WIP
JJediny Apr 8, 2024
81e91cf
Delete tts-pages.md
JJediny Apr 11, 2024
8a97bbf
Updates based on outreach feedback
JJediny Apr 12, 2024
d3450b2
Change the workflow
JJediny Apr 15, 2024
6157dff
Merge branch 'main' into gsa-pages-atu-WIP
JJediny Apr 15, 2024
b3e7776
add mailto link
JJediny Apr 15, 2024
af8b367
Merge branch 'gsa-pages-atu-WIP' of https://github.com/18F/handbook i…
JJediny Apr 15, 2024
d63069c
add dns slack link
JJediny Apr 15, 2024
f6d2246
change to form entry
JJediny Apr 15, 2024
4b509e6
Merge branch 'main' into gsa-pages-atu-WIP
JJediny Apr 17, 2024
53659a5
Add DLP link upfront
JJediny Apr 17, 2024
e25fb2c
Merge branch 'gsa-pages-atu-WIP' of https://github.com/18F/handbook i…
JJediny Apr 17, 2024
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
80 changes: 80 additions & 0 deletions pages/general-information-and-resources/tech-policies/tts-pages.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,80 @@
---
title: TTS Pages
questions:
- tts-tech-operations
- cg-pages
redirect_from:
- /tts-pages/
---
# TTS Pages - Authority to Use (ATU) Process

"TTS Pages" is [GSA's Implementation of the Cloud.gov FEDRAMP Package](https://marketplace.fedramp.gov/products/F1607067912). As such it adds the Security Controls around the Source Code and Contents for the Website (e.g. Github). It provides TTS users with a fast and secure approach to getting a Web Presence for your projects/programs.

## Incident Response
Follow [TTS Incident Response Plan](https://handbook.tts.gsa.gov/general-information-and-resources/tech-policies/security-incidents/)

## Contingency Plan
1. Sign up for [Cloud.gov Pages Status](https://cloudgov.statuspage.io/) notifications
1. Follow [Cloud.gov Contingency Plan](https://cloud.gov/docs/ops/contingency-plan/)

## Launching a New Static Website at TTS

- [ ] Determine who will serve as the `Website Manager`
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

code formatting isn't appropriate here.

Copy link
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

changed to bold


>`Website Manager` is defined by the [GSA's Digital.gov Program](https://digital.gov/2023/03/24/who-is-your-website-manager/)

- [ ] Turn on [Github Advanced Security](https://docs.github.com/en/get-started/learning-about-github/about-github-advanced-security) for the Site's Repository and `Enable`:
- [ ] CodeQL
- [ ] Dependabot
- [ ] Secret Scanning
- [ ] Designate (One) Github Team with `Admin` Access to the repository
- [ ] Designate (One or More) Github Team(s) with `Write` Access to the repository
- [ ] Submit a Pull Request to add the Github Repository for the Website to [GSA](https://github.com/GSA/.allstar/blob/main/allstar.yaml) or [GSA-TTS](https://github.com/GSA-TTS/.allstar/blob/main/allstar.yaml) .allstar Github Configuration Scanner)
- [ ] Complete [Digital Lifecycle Program](https://insite.gsa.gov/employee-resources/communications/websites/strategy-policy-and-standards/digital-lifecycle-program?term=DLP) Self-Assessment for the Website

## Authority to Use (ATU) Review
Submit an [Authority to Use (ATU) Request](https://github.com/GSA-TTS/tts-pages/issues/new?)

- [ ] Resolve any Critical or High security findings from Security Scanners
- [ ] Resolve any Web Scan findings provided by GSA Security Team

Once the review is completed the Site Manager will be sent their ATU Approval package via Docusign. The Site Manager will be responsible for managing Security Findings over the lifecycle of the Website.
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

comma needed after "completed". Also not sure about all of these capitalized nouns.


POAMs and potentially a Correct Critical or High

## Maintaining Approved Sites
Sites hosted on TTS Pages are required to have their URLs scanned in accordance with CIO-IT Security-06-30: Managing Enterprise Cybersecurity Risk and GSA’s parameter for National Institute of Standards and Technology (NIST) Special Publication (SP) 800-53, control RA-5, Vulnerability Scanning.
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Might we link to these controls?

Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

"hosted on TTS Pages" doesn't make sense; its hosted on cloud.gov Pages, but ATOd by TTS Pages?


>This is performed after the ATU request is submitted

## Reassessment
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
## Reassessment
## Reassessment

Copy link
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

accepted

A Site’s ATU will have to be reassessed and an ATU reissued if the Site is found `NOT` to be in conformity with the requirements within this guide.
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This is passive voice. Who must perform the reassessment? if we start with that, it will be clearer.

Also, code formatting should be swapped for bold on the "NOT".

Also, we went from Website to Site here. We should be consistent, especially if we're Capitalizing Things.


Conditions/events that may require a reassessment and ATU reissuance include:
- New third party integrations not on the approved list are added.
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

third-hyphen-party

- The data types or information presented on the site changes.
- A significant security incident occurs.
- There are deviations from the ATU maintenance requirements.

>This Determination is made by the TTS Pages System Owner `[email protected]`. Generally, this is done if security findings are not being addressed promptly.
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Please use a mailto link instead of codeformatting here. It should look like [[email protected]](mailto:[email protected])


Website Managers will be notified, the following steps are only in the event that the Website Manager is none responsive.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I'm having trouble parsing this next item. Which "following steps" does it refer to? The next ## subheadings?

Also there's a typo:

Suggested change
Website Managers will be notified, the following steps are only in the event that the Website Manager is none responsive.
Website Managers will be notified, the following steps are only in the event that the Website Manager is nonresponsive.

Copy link
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

updated to remove ref to steps and note that it is only conditioned on no response

Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

none -> not


## Failure to Maintain Site - Site Removal
Sites that fail to maintain the ATU requirements will be issued a formal notice. The TTS Pages team may take steps to disable the site or remediate the vulnerabilities. ATU site owners who hit certain triggers of overdue POA&Ms and/or failure to maintain alignment to ATU requirements will be required to provide a **Corrective Action Plan (CAP)** addressing the plan to address the deficiencies.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
Sites that fail to maintain the ATU requirements will be issued a formal notice. The TTS Pages team may take steps to disable the site or remediate the vulnerabilities. ATU site owners who hit certain triggers of overdue POA&Ms and/or failure to maintain alignment to ATU requirements will be required to provide a **Corrective Action Plan (CAP)** addressing the plan to address the deficiencies.
Sites that fail to maintain the ATU requirements will be issued a formal notice. The TTS Pages team may take steps to disable the site or remediate the vulnerabilities. ATU site owners who hit certain triggers of overdue POA&Ms and/or failure to maintain alignment to ATU requirements will be required to provide a **Corrective Action Plan (CAP)** detailing the steps that will be taken to address the deficiencies.

Copy link
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

accepted

Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Can we spell out POA&M here, its the first time we use this acronym in this document

Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This is the first time the document describes a team for TTS Pages. It's not immediately clear to me (and I'm on the cloud.gov Pages team) whether that means us :D. Who or what is the team? is it an office? Can you introduce or identify it, provide a contact for it, or otherwise disambiguate it from the cloud.gov pages team?

Copy link
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Updated to introduce TY!


The CAP must be approved by the Site owner, System Owner, ISSM, and IST Director. Sites or Site owners who fail to respond to a CAP, or complete approved actions will be removed from the ATO boundary, and will no longer be authorized. The removal process steps are further described below:
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
The CAP must be approved by the Site owner, System Owner, ISSM, and IST Director. Sites or Site owners who fail to respond to a CAP, or complete approved actions will be removed from the ATO boundary, and will no longer be authorized. The removal process steps are further described below:
The CAP must be approved by the Site owner, System Owner, ISSM, and IST Director. Sites or Site owners who fail to respond to a CAP or complete approved actions will be removed from the ATO boundary, and will no longer be authorized. The removal process steps are further described below:

Copy link
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

accepted

- **Detailed Finding Review (DFR)** - Site owners will be issued a DFR upon failing to address a deficiency within the site or alignment with the ATU requirements.
- **Corrective Action Plan** - Site Owners who fail to adequately respond or address a DFR, will be issued a CAP request.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
- **Corrective Action Plan** - Site Owners who fail to adequately respond or address a DFR, will be issued a CAP request.
- **Corrective Action Plan** - Site Owners who fail to adequately respond or address a DFR will be issued a CAP request.

Copy link
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

accepted

Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Site Owner is capitalized here, but not "Site owners" in the bullet point above. I still think this is easier to read without the Extra Capitals, but whichever, please be consistent.

Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

There's a lot of passive voice throughout this document. Site owners will be issued a DFR... will be issued a request... etc. It'd be clearer and easier to read throughout if we start with who is issuing these to the site owners. "The TTS Pages office will issue a DFR in the event a site owner fails to adequately respond.... " etc. It also makes it clearer who is doing what, rather than things just happening.

If you'd like, I can take a stab at reordering these phrases. I don't mind :)

Copy link
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Updated to avoid passive language

The Site Owner must provide a CAP to the System owner within 30 days of the CAP request. The CAP must detail how the team will address the deficiencies and the timeline for completion.

The Site Owners CAP must be approved by the TTS Pages system owner, the ISSM, and IST Director.
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

owners'


## Site Disablement
Site Owners who fail to respond to the CAP within the 30 day timeframe, or fail to provide an adequate CAP, or fail to comply with the provisions, timeline and duration of their CAP will have their site Disabled.
- Disabling a site consists of unpublishing the site within the Cloud.gov Pages Platform which will result in a site being unreachable.

## Site Removal
Site Owners who fail to address deficiencies within 90 days of disablement will have their site removed from the TTS Pages ATO boundary and the site will be deleted.
- Deleting a site removes the published site from TTS Pages servers and from the dashboards of all site users. This will bring the entire site offline and make it inaccessible for users.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
- Deleting a site removes the published site from TTS Pages servers and from the dashboards of all site users. This will bring the entire site offline and make it inaccessible for users.
- Deleting a site removes the published site from the Cloud.gov Pages platform and from the dashboards of all site users. This will bring the entire site offline and make it inaccessible for users.

Copy link
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

accepted

Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

is this TTS Pages servers or Cloud.gov Pages servers? I believe it's the latter.

- A Site Removal letter will be issued indicating that the site is no longer authorized to operate.
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Issued to whom?

Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Also: Issued by whom?

Copy link
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Updated to be specific - by whom and to whom

Loading