Configuration: sign-in domains

A sign-in domain is an email domain your organization owns, such as example-engineering.com. Once a domain is verified, anyone who enters an address at that domain on the Kompass sign-in page at app.kompassbms.com is sent straight to your organization's sign-in page, with their email address already filled in. Without a sign-in domain, Kompass looks up each person's account first, and asks for a one-time code when an address belongs to more than one organization.

Sign-in domains are set up in Configuration, which is only available in the new design. For how to open Configuration, see Configuration: client and expense lists.

Who can manage sign-in domains

Sign-in domains are controlled by the Sign-in domains permission, in the Administration area of a group's permissions. No group has it by default, and only Kompass support can grant it, so contact Kompass support and tell us which group should manage your domains. For how groups and permissions work, see Create and change user permissions.

  • Edit adds, verifies and removes domains. The Sign-in domains section appears in Configuration only for users with this level.
  • View alone does not show the section in Configuration.

Add and verify a domain

  1. In Configuration, choose Sign-in domains under Access, then click Add domain.
  2. Enter the exact domain, such as example-surveys.co.uk, and click Add domain. The domain is added as Pending.
  3. The DNS record column shows a TXT record for the domain: its name (_kompass-verify. followed by your domain) and its value (starting kompass-verify=). Use the copy buttons next to them, and publish the record at your domain's DNS provider, or ask whoever manages your domain to do it.
  4. Once the record is published, click the verify button (the circled check mark) on the domain's row. When Kompass finds the record, the domain becomes Verified. DNS changes can take a while to appear; if the domain is not verified yet, check the record and try again later.

The Sign-in domains list with one verified and one pending domain

The Add sign-in domain window

Keep the TXT record published for as long as you use the domain. Kompass checks every domain once a day.

Which domains can be added

  • Exact domains only. A verified example-engineering.com does not cover mail.example-engineering.com. Add each subdomain your people use as a separate domain.
  • No public email providers. Domains such as gmail.com or outlook.com cannot be added. If your organization genuinely owns a domain that Kompass treats as a public provider, contact Kompass support.

What changes for your people

  • Anyone who enters an address at a verified domain on app.kompassbms.com goes straight to your organization's sign-in page, whether or not they have a Kompass account. They still sign in there as usual, with their password or your organization's Microsoft sign-in. See Signing in to Kompass.
  • If another organization has also verified the same domain, people at that domain choose between the organizations instead.
  • Addresses at other domains are not affected: Kompass looks up their account as before.

If a domain lapses

If the daily check no longer finds the TXT record for a verified domain, the domain becomes Lapsed, and people at that domain are no longer sent straight to your organization. Everyone with the Edit level of the Sign-in domains permission receives an email naming the missing record. Publish the record again: the next daily check, or the verify button on the domain's row, makes the domain verified again.

Remove a domain

Click the delete button on the domain's row and confirm. People at that domain are no longer sent straight to your organization, and you can then remove the TXT record from your DNS.

Did this answer your question? Thanks for the feedback There was a problem submitting your feedback. Please try again later.

Still need help? Contact Us Contact Us