Login Apps
A login app represents one website or product you're protecting with Subdomain Login. Each app has its own login subdomain, its own identification and authentication settings, and its own users. You can create as many as you need from the Admin Portal.
Creating an app
Click New Application and you'll be asked for:
- App name — a label to identify this app in the portal.
- Login domain — the subdomain on your own domain you want to use for sign-in, e.g.
login.yourdomain.com. - Identification & authentication methods — how users will identify themselves (email, username, phone, or an access code you distribute) and, based on that, how they'll authenticate (password, one-time email code, one-time SMS code, or the access code itself).
Once created, your app is assigned a unique subdomain of subdomainlogin.com, such as
h5ufc.subdomainlogin.com.
Connecting your domain
Add a CNAME record with your DNS provider pointing your login domain at the subdomain you were
assigned:
| Type | Name | Value |
|---|---|---|
| CNAME | login.yourdomain.com | h5ufc.subdomainlogin.com |
Your app's settings page shows whether the CNAME has been detected yet, and includes a
Debug tool that walks through each DNS lookup step if it isn't resolving the way you expect.
CNAME changes are usually visible within a few minutes, though propagation time varies by DNS
provider.
Once the CNAME resolves, Subdomain Login automatically requests and renews a TLS certificate
for your login domain from Let's Encrypt — no action is required on your part.
Login redirect
Each app has a redirect URL — where users land after a successful sign-in — and a cookie domain, derived from your login domain, that the signed session cookie is written to so the rest of your site can see it. Both can be changed at any time from the app's settings page.
Editing an app
Every part of an app's configuration — its name, login domain, redirect URL, and identification
and authentication methods — can be changed later from its settings page. Changing the login
domain requires updating your DNS CNAME record to match.
Deleting an app
An app can be permanently deleted from its settings page. This removes the app, its users, and its authentication history, and cannot be undone.
What's next
- Users — add and manage the people who can sign in to this app.