guide: Microsoft 365 and Google Workspace as sources #46

Merged
jcoffey-dev merged 1 commits from feat/guide-cloud-sources into main 2026-10-30 21:54:12 +00:00
Owner

The guide gains two sources that need no password from anyone:

  • Microsoft 365: tenant, app (client) id and client secret. The run uses import exchange-graph --app-only --user {email}. Check signs the app in and reads the token's roles, naming any Graph application permission it lacks.
  • Google Workspace: the path to a service account's JSON key. The run uses import imap --url imaps://imap.gmail.com --google-key FILE --auth-user {email}. Check asks Google for a token for the first account in the list.

Also:

  • JwtClaims.roles, read from the token.
  • The service-account key helper moves into tests/integration/google.rs, so mock_imap and mock_guide share it.
  • Updates to docs/usage.md and the CHANGELOG.

Tested: fmt, clippy -D warnings, the full suite, a new mock test for the Google check, and unit tests for the new sources. I looked at both forms in a browser. Neither has been tried against a real tenant.

The guide gains two sources that need no password from anyone: - **Microsoft 365**: tenant, app (client) id and client secret. The run uses `import exchange-graph --app-only --user {email}`. Check signs the app in and reads the token's roles, naming any Graph application permission it lacks. - **Google Workspace**: the path to a service account's JSON key. The run uses `import imap --url imaps://imap.gmail.com --google-key FILE --auth-user {email}`. Check asks Google for a token for the first account in the list. Also: - `JwtClaims.roles`, read from the token. - The service-account key helper moves into `tests/integration/google.rs`, so `mock_imap` and `mock_guide` share it. - Updates to `docs/usage.md` and the CHANGELOG. Tested: fmt, clippy `-D warnings`, the full suite, a new mock test for the Google check, and unit tests for the new sources. I looked at both forms in a browser. Neither has been tried against a real tenant.
jcoffey-dev added 1 commit 2026-10-30 21:50:31 +00:00
guide: Microsoft 365 and Google Workspace as sources
ci / test (pull_request) Skipped
github/ci (branch) GitHub Actions
ci / github (pull_request) Successful in 3m31s
ci / announce (pull_request) Skipped
6ca40a68b5
Microsoft 365 reads every mailbox as an Entra app with a client secret
(--app-only); Check signs the app in and names any Graph application
permission it lacks. Google Workspace reads Gmail as a service account
with domain-wide delegation (--google-key); Check asks Google for a token
for the first account.
jcoffey-dev merged commit 22f1f55588 into main 2026-10-30 21:54:12 +00:00
jcoffey-dev deleted branch feat/guide-cloud-sources 2026-10-30 21:54:12 +00:00
Sign in to join this conversation.