Who can open an app
Every project has one access setting that controls who can open the app in a browser. Sign-in happens at the Edge with company accounts, and the access check runs before the request reaches your code. The same setting covers the production URL and every preview URL (<app>--<deployment>.<your-domain>).
Access modes
| Mode (console label) | CLI value | Who gets in |
|---|---|---|
| Only me | only_me | The owner only. The default for new projects. |
| My team | team | The owner and everyone who reports to the owner's manager (the owner's peers). If the owner has no manager, the owner's own direct reports. |
| My department | department | Everyone whose directory department matches the owner's (not case-sensitive). |
| Specific people and groups | groups | The owner plus the people and groups you pick from the directory. Group membership is resolved transitively. You need at least one person, group or app role assignment. |
| Everyone in the org | everyone | Every enabled account in the organization. |
In every mode except Only me, people who hold an app role can also open the app. Giving someone a role implies access.
Disabled accounts are always refused, whatever the setting.
Live rules
My team and My department are live rules. vastframe stores the rule, not a list of names, and resolves it against the directory at check time. When someone joins the team, changes department or leaves, access follows without anyone editing the project. The Access page previews who the rule resolves to right now, for example "Everyone reporting to Marcus Lee · 4 people".
Live rules use the organization's directory mirror, which Org Sync refreshes every 5 minutes. A reporting-line change in Microsoft Entra ID applies after the next sync, or right away if an admin runs Sync now on Admin › Org. See Org chart and Org Sync.
Change who can open an app
In the console
- Open the project and select Access.
- Under Who can open this app, pick a mode.
- For Specific people and groups, search the directory and add people or groups.
- Select Save changes. The change applies within seconds.
The page also lists Who opened it recently: people who opened the app in the last 30 days, with their department, the days they were active and when they last opened it.
From the CLI
tc access -p q4-forecast # show the current setting
tc access set team -p q4-forecast # my team (live)
tc access set groups -m "Support Leads" -p q4-forecast # specific groups or people
tc access set everyone -p q4-forecast
From an AI agent
The MCP tools get_access and set_access do the same. set_access accepts team and department as well as groups, people and app roles. See Agents & MCP.
Who can change the setting
The project owner, people with the project's developer app role, Org Admins and Delegated Admins whose scope covers the owner. Auditors see the page read-only. Every change is written to the audit log with the before and after values.
Being an Org Admin doesn't let you open someone's app. Admins can change its access settings, and that change is audited. This keeps app data on a least-privilege footing.
Sharing beyond the owner's department
An Org Admin can turn on the built-in policy "Sharing beyond the owner's department needs their manager" (Admin › Policies, off by default). With it on, widening an app's access to people outside the owner's department doesn't apply right away. It becomes an access request for the owner's manager. Sharing within the owner's own department is auto-approved by default.
What visitors see when they can't get in
| Situation | Page |
|---|---|
| Signed in but not allowed | "No access", naming the owner to ask |
| Not a member of the organization (organizations whose people are managed in vastframe) | "Not a member yet", asking them to contact IT |
| App archived | "Archived", naming the owner |
| App turned off with the kill switch | "Disabled by IT" |
API calls (non-HTML requests) get a JSON error with the same reason instead.
Microsoft Entra B2B guests and a "view as user" preview for owners are in the design but not built yet.