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

  1. Go to Settings > Institution > Custom domain.
  2. Enter the Domain.
  3. 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.
  4. 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.