Email links (vastframe accounts)
Overview
Email links are the default sign-in for new vastframe cloud organizations. People enter their work email and receive a one-time link. No identity provider or passwords are involved.
How it works
- A person opens the console or an app and is sent to
auth.<your-domain>. - They enter their email address.
- If the email belongs to an enabled member of the organization (or is on a verified domain while anyone on it may join, in which case they become a member first), vastframe emails a sign-in link. The page says "check your email" either way, so it never reveals who is a member.
- The link is valid for 15 minutes and works once.
- Opening it signs them in and returns them to where they started.
Repeated requests for the same address within 20 seconds don't send another email.
Setup steps
New organizations use email links already. To switch back from another method:
- Open Admin › Sign-in.
- Select Email links, then Use email links.
People keep their accounts; they just sign in differently.
Add people
Only members can sign in. Add them in Admin › People (one by one or by CSV), or verify your email domain and let anyone at the company join. See People and groups.
Troubleshooting
| Symptom | Cause | Fix |
|---|---|---|
| No email arrives | The address isn't a member, or the account is turned off | Add the person, or turn their account on, in Admin › People. Check spam folders. |
| "Link expired" | Older than 15 minutes, or already used | Request a new link. |
| "No access: Your account is not active in this organization" | The account was turned off after the link was sent | Turn the account on in Admin › People. |
Sign-in emails are sent through an SMTP relay configured on the installation; on the development stack that is a local mail catcher. If no relay is configured, no links are sent. Delivery through Azure Communication Services Email is planned.