Skip to main content
This is not an official U.S. federal government website. The Federal Modernization Workbook is independent technical analysis. It does not represent the position of, and has not been reviewed or endorsed by, any federal agency.

Training module · Draft

Learning path: Provider Notices

Nine modules: why notices go unread, one module per provider, routing, the digest and evidence, and an optional module on the deployment runbook, each with a lab on fixtures and a pointer to a lab in your own test environment

A learning path in nine modules for cloud platform leads, Microsoft 365 service owners, developers, service desk and change managers, and ISSO reviewers: why the notices cloud providers send about the agency’s own estate go unread, then Azure Service Health with Service Health alerts, the Microsoft 365 Message center, Oracle Cloud Infrastructure announcements, AWS Health and its support plan, Google Cloud incidents and the maintenance gap, routing notices to owners as Ticket-to-Machine tasks, and the weekly digest, evidence and go/no-go; then, optionally, the runbook that deploys it all to a test environment and production. Each module links the guide’s gate, the developer workbook’s chapter and its exact-command Lab 1 with no tenant, points to Lab 2 for a test environment, and ends with a knowledge check.

Status — Draft

This page is still being written. Expect gaps and changes; it is not part of the workbook's production guidance. Last reviewed 2026-11-09.

Every cloud provider tells the agency, in writing and ahead of time, what it will change, retire or patch in the agency’s own tenant, account, tenancy or project. The notices land in a portal or one person’s inbox, and nobody owns them. This learning path teaches you to read each provider’s notices from its own record, hold every notice as one record, give the ones that need action an owner and a due date, and keep the evidence. You work through the seven gates of Provider Notices: An Implementation Guide in order. In each module you run the tested code from the developer workbook Building Provider Notices on your laptop, then read what the same step takes in a test environment.

Like a Microsoft Learn learning path, it is a short series of modules, each built on the one before. The modules don’t repeat the guide, the workbook or Book 15, Chapter 14. They tell you what to read, in what order, what to run, and what to check you understood.

Who this path is for

Role What you get from the path
Cloud platform lead Azure Service Health with its alert policy, Oracle Cloud Infrastructure announcements, AWS Health and Google Cloud incidents: the reader each needs, its cloud, and the check that proves it
Microsoft 365 service owner Message center posts and service health issues, read on the tenant’s own Graph host, and who said a post needs action
Developer The code in examples/provider-notices: the notice record and its fingerprint, the five collectors, the router, the digest and the evidence chain
Service desk and change manager The routing file, the task payloads, why a re-run writes nothing, and why a task closes only on the re-read
ISSO reviewer The federal requirements each gate supports, the KSI it aligns to, the evidence you keep, and the go/no-go

Level: intermediate. Products: Azure Service Health and Azure Resource Graph, Azure Policy, the Microsoft Graph service communications API, Oracle Cloud Infrastructure Announcements, AWS Health and Google Cloud Personalized Service Health. Scope: a civilian agency at FedRAMP Moderate, in Microsoft 365 GCC with commercial Azure, with workloads in Oracle Cloud Infrastructure and possibly AWS or Google Cloud, as the workbook assumes. An agency whose HR platform runs on Oracle Cloud Infrastructure reads that tenancy’s announcements in Module 4.

Prerequisites

  • Book 15, Chapter 14: why notices go unread, the six kinds of notice and who owns each. Module 1 reads it with you.
  • The guide’s track at a glance and path on one page: ten minutes, and every module refers back to them.
  • Book 13, Appendix B, the Ticket-to-Machine reference, before Module 7.
  • PowerShell basics: you can run a script, import a module and read the objects it returns.

What you’ll be able to do

When you finish the path, you’ll be able to:

  • explain why provider notices go unread, and name the six kinds of notice and who owns each;
  • read every notice each enabled provider publishes about the agency’s estate, with the least-privileged reader, in the cloud the settings name;
  • tell a provider’s own action date from one the kit’s rule inferred, from the record’s actionBasis;
  • plan Service Health alerts at scale with Azure Policy, applied only with an approved SHA-256;
  • record what each provider doesn’t cover: Google Cloud’s planned maintenance, an AWS account without a qualifying AWS Support plan, a realm or package the kit can’t read;
  • route the notices that need action to an owner as Ticket-to-Machine typed tasks, de-duplicated across runs, closed only on the re-read;
  • write the weekly digest, record every run as hashed and chained evidence, and say whether a stage passes the go/no-go;
  • optionally, dry-run the deployment to a test environment and production, with a pre-flight, a weekly run, a stage check and a rollback plan.

Modules

Work through them in order. Module 1 is the why and the record; Modules 2 to 6 are the five providers, one gate each, and are independent: an agency that doesn’t use AWS or Google Cloud can skip Module 5 or 6. Modules 7 and 8 need at least one provider. Module 9, the deployment runbook, is optional: it is for whoever deploys the kit, and it runs every gate’s code in one safe order.

The modules of the Provider Notices learning path
# Module Gate Workbook chapter Time
1 Why provider notices go unread Before the gates: the track at a glance 01 45 min
2 Azure Service Health and alerts G1 Azure Service Health 01 55 min
3 Microsoft 365 Message center G2 Microsoft 365 02 50 min
4 Oracle Cloud Infrastructure announcements G3 Oracle Cloud Infrastructure 03 45 min
5 AWS Health and the support plan G4 AWS Health 04 50 min
6 Google incidents and the maintenance gap G5 Google Cloud 05 45 min
7 Routing to owners G6 Routing 06 65 min
8 Digest, evidence and go/no-go G7 Digest and evidence 07 60 min
9 Deploying to test and production (optional) Every gate, through the stage steps 08 55 min

Total time: about 6 hours 55 minutes with each module’s Lab 1, or 7 hours 50 minutes with the optional Module 9. Lab 2, in your own test environment, isn’t counted: how long it takes depends on your tenant, account, tenancy or project and your approvals.

Why nine modules. The guide has seven gates. Workbook Chapter 01 holds two things: the notice record every provider fills, and the Azure collector. The record is what makes the other modules make sense, so Module 1 teaches it with the reason notices go unread, and Module 2 teaches Azure. Chapter 08, the runbook, serves every gate and isn’t a gate itself, so it is a module of its own, and optional.

If you’re an ISSO reviewer, read each module’s introduction, its federal requirement table and its summary, and skip the labs. Modules 1 and 8 are yours in full. The workbook’s reading paths suggest an order for each role.

Each module follows the same units: an introduction with the federal requirements it supports, learning objectives, prerequisites, one or two concept units, Lab 1, Lab 2, a knowledge check and a summary.

What you need for the labs

Lab 1: a laptop, no tenant. Every module’s Lab 1 runs the code in examples/provider-notices against the kit’s fictional fixtures: two weeks of notices from every provider, tests/fixtures/day1 and day2, for fictional contoso.example subscriptions, a tenant, a tenancy, AWS’s documentation account 111122223333 and a project. You need:

  • a copy of the repository, so you can work in examples/provider-notices (Module 7’s router test also reads examples/servicenow-sailpoint, which the repository and the kit’s download include);
  • PowerShell 7.1 or later with Pester 5.

Run every command from examples/provider-notices, in PowerShell 7. Each lab writes an out folder there and deletes it at the end. Nothing in Lab 1 signs in to anything or sends a request.

Lab 2: your own test environment. Each provider’s Lab 2 needs that provider’s test environment, never production, with fictional data: an Azure test subscription, a Microsoft 365 test tenant in the worldwide or GCC cloud, an OCI test tenancy, an AWS test account (with a qualifying AWS Support plan, or the error is the result), a Google Cloud test project, or a ServiceNow developer instance. Each module says which. The workbook has no hosted sandbox: you bring the environment. The authors didn’t run the Lab 2 steps. Each one ends with a way to back it out. Read the guide’s prerequisites for the roles and permissions before you start.

Your routing stays at work. The labs use the kit’s fictional routing, config/routing.json. The agency’s own routing, settings files, notices, digests and evidence are written at work, from the kit’s templates and its Copilot prompts in Microsoft 365 Copilot Chat, and stay on agency storage.

How this path fits with the other pieces

The guide is finished when it has four pieces: the guide, a narrated deck series, a developer workbook and a training path. This path is the training piece. The narrated decks for these modules, and the workbook chapters’ narrated tours, come later; each module will link its own.

Where each piece of provider notices lives
Piece Where
The operating model Book 15, Chapter 14, with Chapter 03 for today’s email routing
The gates Provider Notices: An Implementation Guide
The code and its labs Building Provider Notices
The task pattern Book 13, Chapter 10 and Appendix B; the Ticket-to-Machine learning path
The federal sources The guide’s Evidence table and the federal framework crosswalk

Modules in this path

Title Description
Module 1: Why provider notices go unread Before the gates: why the notices five providers send about the agency’s own estate land in a portal or one person’s inbox with no owner, the six kinds of notice and who owns each, and the one record every provider’s notice becomes, with its action basis and a fingerprint that a second read doesn’t change. You collect two weeks of fictional notices from all five providers and read them as one list. About 45 minutes, with a lab on fixtures.
Module 2: Azure Service Health and alerts Gate G1 and workbook Chapter 01: read every Service Health event for the subscriptions in scope through Azure Resource Graph with Learn’s own sample queries, with Reader and Service Health Security Reader; merge one event across subscriptions; make retirements and security advisories action required by a stated rule; and plan Service Health alerts at scale with the built-in Azure Policy definition, applied only with its approved SHA-256. About 55 minutes, with a lab on fixtures and a test subscription lab.
Module 3: Microsoft 365 Message center Gate G2 and workbook Chapter 02: read a tenant’s Message center posts and service health issues through the Microsoft Graph service communications API with only ServiceMessage.Read.All and ServiceHealth.Read.All, on the Graph host for the tenant’s cloud (GCC on the worldwide endpoint, GCC High and DoD on their own); map posts to kinds; keep Microsoft’s actionRequiredByDateTime apart from the kit’s rule; and refuse a next link on another host. About 50 minutes, with a lab on fixtures and a test tenant lab.
Module 4: Oracle Cloud Infrastructure announcements Gate G3 and workbook Chapter 03: read every Oracle Cloud Infrastructure announcement for a tenancy, the latest in each chain, with its affected resources, using one policy statement (read announcements in tenancy); keep Oracle’s own ACTION_REQUIRED date; see a rescheduled maintenance window replace the original; and know which realms the kit reads (OC1, OC2) and refuses (OC3). An agency whose HR platform runs on OCI reads that tenancy here. About 45 minutes, with a lab on fixtures and a test tenancy lab.
Module 5: AWS Health and the support plan Gate G4 and workbook Chapter 04: read every open and upcoming AWS Health event for an account, with a customer managed policy of exactly three read actions, details and affected entities ten events at a time; keep AWS’s actionability apart from the kit’s retirement rule; read from the partition’s own endpoint (us-east-1, or us-gov-west-1 in GovCloud); and know that the API needs a qualifying AWS Support plan, which AWS’s own pages name differently. About 50 minutes, with a lab on fixtures and a test account lab.
Module 6: Google incidents and the maintenance gap Gate G5 and workbook Chapter 05: read a Google Cloud project’s Personalized Service Health incidents with roles/servicehealth.viewer, and write down what the API doesn’t cover: it has one event category, INCIDENT, so planned maintenance never arrives, and Personalized Service Health isn’t in Assured Workloads’ FedRAMP Moderate, FedRAMP High, IL4 or IL5 packages. See the kit refuse a call nobody verified. About 45 minutes, with a lab on fixtures and a test project lab.
Module 7: Routing to owners Gate G6 and workbook Chapter 06: write and check a routing file of ordered rules, route two weeks of fictional notices from five providers as a dry run, read a Ticket-to-Machine task payload with its severity, response window, the provider’s own action date and the five clauses of the request chain, and see why a re-run writes nothing and a provider’s closure asks for the re-read instead of closing the task. About 65 minutes, with a lab on fixtures and a ServiceNow developer instance lab.
Module 8: Digest, evidence and go/no-go Gate G7 and workbook Chapter 07, with the runbook’s promotion criteria: write the weekly digest the owners read (open notices by provider, action required by due date, the next 30 days, new and closed), record every run as hashed evidence chained to the record before it, check the chain and a stage’s coverage the way a go/no-go does, and catch a file edited after it was recorded. About 60 minutes, with a lab on fixtures and a lab on a test environment’s runs.
Module 9: Deploying to test and production (optional) Optional, for whoever deploys the kit: workbook Chapter 08, the deployment runbook, across every gate. One settings file per stage with no secrets, a read-only pre-flight (PF-01 to PF-07), a staged enable one provider at a time, routing as a dry run, a smoke test, Service Health alerts applied with an approved hash, the weekly run on a schedule, the stage’s evidence and a rehearsed rollback; the go/no-go; then production, routing as a dry run for its first week. You dry-run the pre-flight, the weekly run, the stage check and the rollback plans on fixtures. About 55 minutes; the runbook hasn’t been run against a live tenant.
No matching items

Original content for project use. Every fact is carried by link from the guide, the workbook and Book 15, Chapter 14; the claims log is in the repository.

Back to top