If you’re using single sign-on for login and user management, claim your domain to prevent users that don’t belong to your organization from logging in to your account.
You can have more than one claimed domain; however, a domain can only be claimed once, and can only be applied to one Formstack account. If your domain has already been claimed, you must either join that Formstack account to use that domain for SSO or use a different domain for SSO.
Claiming your domain is quick and easy and verifying your domain can be done automatically in the app.
Step 1: On the Single Sign-On tab in the Formstack administration panel, select “Claim domain.”
You have two ways to verify your domain: DNS or HTTPS.
DNS
With this option, you can publish a txt record in your domain name system (DNS) host. Please see the instructions below the screenshot for more information on how to set this up.
Note: There may be a delay for the changes to post within your DNS host.
If you're verifying your domain through your DNS settings, follow these steps to add a TXT record:
Step 1: Copy the TXT Record from the Admin Panel
Log in to your Formstack Admin Panel. Navigate to Single Sign On > Domains. Find the domain you'd like to verify and select the DNS method. Copy the TXT Value provided here. You’ll use this in your domain registrar’s DNS settings in the next step.
Note: This value is unique to your domain and account. Be sure to copy it exactly as shown.
Step 2: Access Your Domain's DNS Settings
Next, log in to your domain registrar or DNS hosting provider. This could be:
- GoDaddy
- Namecheap
- Google Domains
Or wherever your DNS records are managed. Once you're logged in, look for the section labeled something like DNS Management, Name Server Management, or Zone File Settings.
Step 3: Add the TXT Record
In your DNS settings: Click to add a new record.
For Record Type, choose TXT.
Fill in the fields: Host/Name: Enter @ unless otherwise specified.
Value/Content: Paste the TXT value you copied from the Formstack Admin Panel.
TTL (Time to Live): You can leave this at the default unless instructed otherwise.
Save the record once everything is filled out.
Step 4: Allow Time and Verify
DNS changes can take some time to update. It may take anywhere from 15 minutes to several hours for the new record to propagate across the internet. Once you've added the record, you can check if it's live using an online tool like the Google Admin Toolbox Dig tool.Once the record is detected, return to the Formstack Admin Panel to complete Auth Provider setup process.
HTTPS
Your second option is HTTPS. This can be verified by having a valid SSL certificate from your web host. Simply download the HTML file from the Formstack claimed domain model and upload it to your root directory and publish it.
Select Verify now to capture your claimed domain and confirm verification.
Once you’ve verified your domain, the following modal will appear and your claimed domain will appear in the “verified” state.
What if my domain has already been claimed?
If someone has already claimed the domain, an error message will pop up letting you know that the domain has already been claimed.
Do I have to verify my domain right away?
You also have the option to save and verify later. If you choose to save and verify later, your domain will appear as pending verification.
What if I cannot verify my domain?
If you are able to claim your domain but are not able to verify, the following modal will appear. Check for errors and contact your IT administrator for assistance to complete the verification process.