Verify Domains for Secure SSO Authentication

Log in to the Samsara dashboard.

Select the Settings icon ( ) at the bottom of your Fleet menu to view dashboard settings.

Select Single Sign-On.

Add a new domain.

1. Enter your domain name (for example yourcompany.com) in the Domain Verification section.

2. Click Add Domain.

3. Ensure the domain is entered correctly without typos and excludes any prefix such as http or https.

Obtain the verification code.

A unique verification code is generated and displayed next to your domain. Copy the verification code, for the next step. The verification code is the full string shown on your dashboard, including the ‘code=’ prefix.

Add a TXT record to your DNS provider.

1. Log in to your DNS provider’s management console.

   For more information about adding TXT records, see the instructions for the following common DNS providers:

   • GoDaddy

   • Cloudflare

   • Google Cloud DNS

   • Namecheap

2. Navigate to the DNS Management or DNS Settings section.

3. Add a new TXT Record with the following details:

   • Type: TXT

   • Name/Host: samsara_verify.[yourdomain.com]

     Note

     If your DNS provider does not accept the naming convention samsara_verify—for example, if it does not support underscores—you may alternatively name the DNS record samsara-verify or samsaraverify.

     If you use one of these alternative naming conventions, the Samsara dashboard will still display samsara_verify. However, this will not impact your ability to verify the domain, and you can proceed with domain verification as expected.

   • Value/Text: Paste the verification code from Samsara.

   • TTL: Set it to your desired value. A shorter TTL may result in faster propagation.

4. Save the new TXT record.

Verify the domain in Samsara.

1. Return to the Samsara dashboard.

2. In the Domain Verification section, click on the Verify button next to your domain.

   Samsara will verify for the TXT record in your DNS settings and display a green check mark next to your domain name if verification is successful.

   

   Note

   This example displays the domain as samsarian.com, but yours will reflect your domain name.

3. If domain verification fails, check the following:

   • Ensure the correct verification code is added to your DNS TXT record.

   • Check with your DNS provider to confirm the record has fully propagated.

   • Verify there are no typos or extra spaces in the record, and ensure the full string, including "code=", is included.

   • If you recently updated the DNS record, wait until the TXT record is propogated and try again.

Proceed to configure Single Sign-On (SSO) Authentication for the verified domain.

If you’re still experiencing issues even after verifying that all required attributes are correctly mapped, please reach out to our support team for assistance.