PSA/docs/integrations/provider-setup-order.md
Hermes 284313f908
Some checks are pending
Bidi Control Character Guard / bidi-control-guard (push) Waiting to run
Circular Dependency Check / Check for new circular dependencies (push) Waiting to run
Citus Migration Smoke / Combined migrations on single-node Citus (push) Waiting to run
E2E Fresh Install Tests / fresh-install-e2e (push) Waiting to run
ext-v2 guardrails / Run ext-v2 guard and ESLint (push) Waiting to run
Integration Tests / Check for relevant changes (push) Waiting to run
Integration Tests / ${{ (github.event_name == 'schedule' || github.event.inputs.suite == 'full') && 'Full integration suite' || 'Tier-1 integration subset' }} (push) Blocked by required conditions
Mobile checks / Mobile lint + typecheck (push) Waiting to run
Mobile checks / Mobile unit tests (push) Waiting to run
Mobile checks / Mobile dependency audit (report) (push) Waiting to run
Mobile checks / Mobile reproducibility checks (push) Waiting to run
Secrets guard (env backups) / Ensure no tracked env backup files (push) Waiting to run
Temporal Readiness / fast-readiness (push) Waiting to run
Temporal Readiness / docker-parity (push) Waiting to run
TypeScript Type Check / Nx affected typecheck (push) Waiting to run
Unit Tests / Skipped-test budget (push) Waiting to run
Unit Tests / Nx affected unit tests (push) Waiting to run
Unit Tests / Server unit coverage (informational) (push) Waiting to run
Validate Tenant Management Schema / Check for relevant changes (push) Waiting to run
Validate Tenant Management Schema / Validate Tenant Management Schema (push) Blocked by required conditions
EE Workflows Build Guard / ee-workflows-build-guard (push) Waiting to run
Initial import of AlgaPSA codebase from PSA server
Excluded: .git, node_modules, secrets/, compose.env, assemblyscript tgz

Source: /opt/alga-psa on psa.joliet.tech
2026-06-22 16:12:17 -05:00

1.2 KiB

Provider Setup Order (Google + Microsoft)

Use this order for all CE/EE environments:

  1. Open Settings -> Integrations -> Providers.
  2. Configure provider credentials first:
    • Google: google_client_id, google_client_secret
    • Microsoft: microsoft_client_id, microsoft_client_secret, optional microsoft_tenant_id (common default)
  3. Save provider settings.
  4. Configure MSP SSO login domains for tenant discovery in Settings -> Integrations -> Providers:
    • Add one or more tenant-owned login domains (for example: acme.com).
    • Discovery uses these domains to map login email domain -> tenant provider configuration.
  5. After provider settings and login domains are ready, configure integration-level connections:
    • Settings -> Integrations -> Communication (Inbound Email)
    • Settings -> Integrations -> Calendar (Calendar Sync)
  6. Run OAuth connect/authorize from the integration forms.

Notes:

  • Microsoft and Google integration forms no longer require per-form client ID/client secret entry in CE.
  • MSP login SSO uses tenant-discovered provider credentials first.
  • If a login email domain is unresolved (no mapping or ambiguous mapping), MSP login falls back to app-level *_OAUTH_* provider availability.