25 lines
879 B
Markdown
25 lines
879 B
Markdown
# Quickstart: Entra Group Directory Cache (Groups v1)
|
|
|
|
## Goal
|
|
Populate a tenant-scoped cache of Entra ID groups (metadata only) via background sync runs, enabling safe UI rendering without live directory calls.
|
|
|
|
## Prerequisites
|
|
- Graph integration configured (client credentials / app-only)
|
|
- Queue worker running for jobs
|
|
- Scheduler/cron running for periodic sync (if enabled)
|
|
|
|
## Operator workflow (manual)
|
|
1. Switch into a tenant workspace.
|
|
2. Start “Sync Groups”.
|
|
3. Check the run status until it completes.
|
|
4. Browse “Directory → Groups” and confirm search + detail work.
|
|
|
|
## Scheduled sync
|
|
- Enable scheduled sync for tenants/environment.
|
|
- Verify runs appear without manual initiation.
|
|
|
|
## Verification
|
|
- UI pages that show group IDs render using cached data only.
|
|
- Unresolved IDs show a clear fallback.
|
|
- Groups not seen for >90 days are eventually purged.
|