Workspace
Setup checklist and Workspace health require
dashboard.read. Account is available to signed-in workspace users, with individual changes permission-gated.
Follow the setup wizard for initial configuration or Workspace health to investigate an existing workspace.
Use Your account and team for account security and colleague onboarding.
Access
Start with inviting teammates for human access, or API keys for a programmatic connection. An API token is not required to use Alignr’s app.
Client services
Microsoft
Open Settings → Microsoft to choose your usual connection method. Viewing requiresintegration.read; saving defaults or authorising a partner connection requires integration.manage.
- Direct · authorise each client: save the default, then finish authorisation in each client’s Connections tab. Direct connections support identity and Intune device checks.
- Partner Center · use your partner account: select an enabled live partner connection, or use Add partner connection. Use Authorise partner account where needed, and Save Microsoft defaults. Then assign Microsoft customers and finish each client’s connection and access checks.
Client portal
Open Settings → Client portal to configure how your MSP presents information to clients. Viewing requiresportal.read; changing settings requires portal.write.
1
Set the portal address
Enter the Portal domain and select Save address. Use the domain connected to your portal deployment.Saving an address does not configure hosting, DNS or Microsoft consent. Complete those external prerequisites before sharing Open client sign-in.
2
Choose default sections
Under Portal sections, choose the included sections and their order: Compliance, Risks, Roadmap and Expirations.These are workspace defaults. Existing client-specific overrides are preserved.
3
Define named views when needed
Under Named client views, create a view for a particular audience. Choose its sections and whether to Show introduction and Show roadmap costs, then Save view.Creating a view defines presentation. Choose client sign-in access and person-specific views from the relevant client before sharing it.
4
Review brand presentation
Set MSP name, Light-background logo and Dark-background logo. Inspect both background previews. If only one logo is supplied, it is used for both backgrounds.Your MSP identity is presented within Alignr’s portal layout.
Keep the scopes clear
Workspace settings establish defaults and shared policies. Client configuration and person-level access still need their own review. This applies especially to Microsoft connections and client-portal sharing.Continue: your first client assessment
Connect the setup decisions to evidence, controls and an explained result.