Custom Domains
Every institution has a Full Fabric address built from its handle, such as ff-business-school.fullfabric.cloud. A custom domain lets the institution serve Full Fabric on a domain it owns instead, such as apply.example.com. Applicants, students and staff then see the institution's own domain in the browser and in the links Full Fabric sends.
Staff set up the custom domain themselves, in four steps, from the institution settings.
Overview
| What it is | A second address for your institution, on a domain you own |
| Limit | One custom domain per institution |
| Who can manage | Staff with the Custom domain permission |
| Where to find it | Settings > Institution > Custom domain |
| Certificate | Managed by Full Fabric, or uploaded by you |
The Custom domain permission (core.institutions.settings_custom_domain_change) lets a user view, configure and remove the custom domain. Every institution has a staff::it role that holds it, and new institutions also grant it to staff::administrator. See User Types & Roles.
Before You Start
- Choose a subdomain you control, such as
apply.example.com. You need access to its DNS records. - Domains are lowercase letters, digits, dots and hyphens. Internationalised domain names are not accepted.
- Decide who should receive certificate expiry emails.
Setting Up a Custom Domain
The page shows four steps. Complete them in order.
1. Request custom domain
- Go to Settings > Institution > Custom domain.
- Enter the Domain.
- Under Certificate, choose how the domain is secured:
- Managed certificate: Full Fabric issues and automatically renews the certificate.
- Upload certificate: you provide your own certificate and private key, and renew it yourself before it expires.
- Click Request (managed) or Upload certificate (uploaded).
2. Issue TLS/SSL certificate
With a managed certificate, the step shows a DNS record to prove you are allowed to manage the domain. Add the record to your DNS. Full Fabric checks for it every few minutes and attaches the certificate once it is found.
With an uploaded certificate, paste:
| Field | Required |
|---|---|
| Certificate (PEM) | Yes |
| Private key (PEM) | Yes |
| Certificate chain (PEM, optional) | No |
Full Fabric checks that the private key matches the certificate, that the certificate is already valid and not expired, and that it covers the domain. If the certificate's chain of trust cannot be confirmed, you see a warning and can choose Upload anyway.
Once issued, the step shows the certificate's Issuer, Valid from, Expires and Auto-renewal details.
3. Point custom domain to canonical host
Add a CNAME record in your DNS that points your domain to your institution's Full Fabric address (the canonical host). The step shows the exact name and value to use.
Full Fabric checks the record every few minutes. When the domain points to the canonical host, the step completes.
4. Activate custom domain
Click Activate. From then on, the custom domain is your institution's main address:
- Links Full Fabric generates, such as those in emails, use the custom domain.
- People can sign in, apply and work on the custom domain.
- The Public API accepts the same requests and tokens on the custom domain.
After Activation
Signing in
When someone signs in on the custom domain, the browser briefly passes through the canonical host to set up the session, then returns to the custom domain. SAML single sign-on works on both addresses. If Microsoft sign-in is enabled, the custom domain is registered for it on activation and removed on deactivation.
Certificate renewal
| Certificate | Renewal |
|---|---|
| Managed | Renewed automatically by Full Fabric |
| Uploaded | Renew it yourself: in step 2, click Renew certificate, paste the new certificate, then Update certificate |
Certificate expiry notifications
Under Certificate expiry notifications, choose the Recipients. The section shows the date the current certificate expires on. Recipients get an email 30, 14, 7, 3 and 1 day before expiry.
Warning: An expired uploaded certificate makes browsers reject the custom domain. Renew it before the last notice.
Deactivating or Changing the Domain
- Deactivate returns the institution to its canonical Full Fabric address. Links Full Fabric generates use the canonical address again. The domain setup is kept, so you can activate it again later.
- Start over clears the setup so you can request a different domain. It asks for confirmation (Yes, start over). While a domain is active, deactivate it before starting over.
Limitations
- One custom domain per institution.
- A new domain cannot be requested while the current one is active.
- Domains must use ASCII characters only.