Skip to main content

Set Up Kadence Agent Auto Login

Set up Kadence Agent Auto Login so your team signs in automatically using Microsoft Entra, Okta or Google Workspace — no Kadence password required.

Written by Liza

Auto login signs your people into the Kadence Agent when they start their computer, using the identity your company already trusts — Microsoft Entra or Okta on Windows and Mac, and Google Workspace on Chromebooks. There's no Kadence password and no Kadence sign-in form.

On Windows with Entra, it's silent from the very first launch. On a Mac, on a Chromebook, or with Okta, the first launch asks for one step — every launch after that is silent.

Auto login supports Windows and macOS with Microsoft Entra or Okta, and ChromeOS with Google Workspace.

If your company uses Google Workspace as its identity provider on Mac or Windows, auto login isn't available yet.


What Your People Will See

The first launch depends on platform and identity provider. Every launch after that is silent.

Platform + Identity Provider

First Launch

Windows + Entra

Nothing — not even the first time. The Windows sign-in already holds the credential the agent uses.

macOS + Entra

A Microsoft account picker — the person picks their account, no password.

The Mac must be registered with Entra through Company Portal (Step 4c).

Windows + Okta

An embedded window shows the Okta sign-in once.

With Okta Verify or FastPass, there's nothing to type.

macOS + Okta

The browser opens for one Okta sign-in.

ChromeOS + Google Workspace

Google's sign-in sheet opens once — the person picks the work account they're signed in to the Chromebook with, and confirms. No password.

ChromeOS doesn't open Android apps at sign-in, so people open the agent from the shelf (Step 4d pins it there).

If auto login can't run on a device — the configuration is missing, or the sign-in is declined — the agent quietly shows its normal sign-in screen instead.

One exception: if a person's identity is verified but their email doesn't match anyone in your Kadence workspace, the agent shows "Contact your admin." On a Chromebook, the agent shows its normal sign-in screen instead. See Troubleshooting below.


Before You Begin

This guide is for IT administrators. It covers the one-time setup: prepare your identity provider, configure Kadence, generate your device configuration, and roll it out with your device management (MDM) service.

You'll need:

  • An administrator for your identity provider (Entra, Okta or Google Workspace), for your MDM, and for Kadence (directory-sync access)

  • Managed devices — Auto login runs only on devices your company manages through an MDM service, or on Chromebooks managed through the Google Admin console — never on unmanaged or personal machines

  • Supported systems — macOS 26 or later, Windows 10/11, and ChromeOS. For Entra, Windows devices must be Microsoft Entra joined. Chromebooks must allow Android apps, and people must sign in to them with a managed Google Workspace account

  • Your Kadence workspace connected to your login provider — once this is complete, you'll be able to generate the required configuration files and deploy them

Kadence generates the device configuration for you as standard files — an Apple configuration profile for macOS and Windows policy settings — so any MDM can deploy them. For Chromebooks, Kadence gives you a short configuration to paste into the Google Admin console.


Step 1: Prepare Your Identity Provider

Pick the identity provider your company already uses for Kadence sign-in on Windows and Mac, and follow that section. If you also have Chromebooks, follow Option C as well.


Option A: Microsoft Entra

Kadence ships its own Entra application, so you don't create one or share a client secret. You grant it permission to run in your tenant and, on Macs, add the Microsoft sign-in extension.

  1. Grant admin consent to the Kadence Desktop Agent application in your Entra tenant. Have an Entra admin visit this URL and click Grant.

    Grant permission

  2. Note your Entra tenant ID (Directory ID) — you'll paste it into Kadence in Step 2. Find it in the Entra admin center under Overview for your tenant.
    ​

    Entra tenant ID

  3. Windows devices need no further identity setup, as long as they're Microsoft Entra joined. The Windows sign-in already holds the credential the agent uses.

  4. macOS devices need the Microsoft Enterprise SSO plug-in and Company Portal. You'll deploy both through your MDM in Step 4, and each user signs into Company Portal once to register their Mac — this is standard Microsoft setup.

Kadence configures the identity token claims on its side. You don't need to set optional claims in Entra.


Option B: Okta

Create a dedicated Okta application for the agent. Keep it separate from the Okta application you already use for Kadence browser sign-in — the two must not be shared.

  1. In the Okta Admin Console, go to Applications → Create App Integration.

  2. Choose OIDC — OpenID Connect, then application type Native Application. Select this exactly — a Native app uses PKCE and holds no client secret, which is what the agent needs.
    ​

  3. Under Grant type, tick Authorization Code and Refresh Token. The refresh token is what lets later launches stay silent.

  4. Set the Sign-in redirect URI to exactly: co.kadence.kadence-agent:/callback

  5. Under Assignments, assign the application to the people or groups who will use the agent.
    ​

    Native app integration

  6. Check the application's sign-on policy lets your assigned users authenticate. The one-time first-launch sign-in follows this policy.

    User authentication

When the application is created, note two values for Step 2:

  • Your Okta org URL (for example https://your-company.okta.com) — use the plain org URL, not a custom authorization server address

  • The application's Client ID

    Client ID

Option C: Google Workspace (Chromebooks)

Kadence ships its own Google sign-in client, so there's nothing to create in Google Cloud and no client ID to enter.

  1. Note the Google Workspace domains your people sign in with — for example your-company.com. You'll enter them in Step 2.

Only accounts from these domains can sign in. Personal Gmail accounts can't.

Each person's Google account email must match their email in Kadence.


Step 2: Configure Auto Login in Kadence

  1. In Kadence, open Settings → Integrations → Auto login (directory-sync access required).
    ​

    Edit agent auto login

  2. Choose your identity provider and enter its details:

    • Entra: your Tenant ID from Step 1

    • Okta: your Okta org URL and the agent application's Client ID from Step 1

    For Chromebooks, also turn on Enable ChromeOS and enter your Google Workspace domains from Step 1, one per line. ChromeOS works alongside your Entra or Okta settings, so choose one of those as well.

  3. Email claim order is optional. Leave the defaults unless your directory puts a person's real email somewhere other than the standard claim — for example, an Entra tenant synced from on-premises Active Directory, where the sign-in name is the reliable value. If unsure, leave it as is.

  4. Click Save.

You enter these values once. Kadence puts the right values into the device configuration for you in Step 3, so there's nothing to copy by hand and nothing to keep in sync across two places.

Test with one person first. A wrong value here stops auto login for your whole workspace — confirm it works for a single user before rolling out to everyone.


Step 3: Generate Your Device Configuration

Kadence builds the exact configuration file each platform needs, filled in with your workspace's values. You don't write these by hand — they're standard formats any MDM can deploy.

  1. On the same auto login settings screen, use Download configuration.
    ​

    Device configuration

  2. Download the file for each platform you deploy to:

    • macOS: kadence-agent.mobileconfig — an Apple configuration profile

    • Windows: a zip containing kadence-agent-intune.ps1 (a device policy script for Intune or any MDM that runs scripts) and kadence-agent-policy.reg (for on-premises fleets using Group Policy). Deploy one of the two, not both.

    • ChromeOS: there's no file. The ChromeOS section of the auto login card shows a short JSON configuration with your Kadence tenant ID and region. Use Copy required JSON configuration.

  3. Keep these files for Step 4. If you later change any value in Step 2, download the files again — the old ones go out of date.

The configuration contains no passwords or secrets. It tells the agent which identity provider, which Kadence workspace, and which region to use.


Step 4: Deploy With Your MDM

Deploy three things: the Kadence Agent app, the auto login configuration from Step 3, and — for Entra on macOS — Microsoft's sign-in extension.

The configuration files are standard formats, so any MDM handles them.

The steps below use Microsoft Intune as a worked example — the same items apply in any MDM, each deploying the platforms it manages.

For Chromebooks, you deploy the app and its configuration from the Google Admin console instead — see 4d.


4a. The Kadence Agent App

Install the latest agent. These links always point at the current production build:

  • macOS (covers Intel and Apple Silicon): https://static.onkadence.co/kadence-agent/latest/kadence-agent-latest-universal.pkg

  • Windows (64-bit): https://static.onkadence.co/kadence-agent/latest/kadence-agent-latest-x64.msi

  • Windows (Arm): https://static.onkadence.co/kadence-agent/latest/kadence-agent-latest-arm64.msi

  • ChromeOS: Kadence Agent for ChromeOS on Google Play, installed through the Google Admin console (4d)

Deploy the file as an app and assign it to your device or user groups.

In Intune: add the .pkg as a macOS app and the .msi as a Windows app.


4b. The Auto Login Configuration

macOS: deploy kadence-agent.mobileconfig from Step 3 as a configuration profile, assigned to the same devices as the agent.

Any MDM that accepts a custom Apple configuration profile takes this file unchanged.

In Intune: Devices → Configuration → Create → macOS → Templates → Custom, and upload the .mobileconfig.

Create a profile

Windows: deploy kadence-agent-intune.ps1 from the zip as a device policy script, assigned to the same devices. It runs in the system context and writes the agent's policy settings under HKLM\SOFTWARE\Policies\Kadence\Agent.

On-premises fleets can deploy kadence-agent-policy.reg through Group Policy instead. Deploy one, not both.

In Intune: Devices → Scripts and remediations → Platform scripts → Windows, upload the .ps1, and assign it.

Add powershell script

4c. macOS with Entra Only: The Microsoft Sign-In Extension

Windows with Entra, macOS with Okta, and Windows with Okta need no sign-in extension — skip 4c for those. ChromeOS needs none either.

For Entra on Macs, the device also needs Microsoft's own sign-in components.

These are Microsoft's, not any one MDM's, so any MDM that supports the macOS single sign-on extension payload can deliver them.

  1. Deploy Company Portal for macOS as a macOS app.

  2. Deploy a Single sign-on app extension profile of type Microsoft Entra ID, assigned to your Macs.
    ​
    This is Microsoft's Enterprise SSO plug-in, so every field is a fixed Microsoft value — not something Kadence provides — and is the same for every organization:

Field

Value

Extension Identifier

com.microsoft.CompanyPortalMac.ssoextension

Team Identifier

UBF8T346G9 (Microsoft's Apple team ID, not Kadence's)

Type

Redirect

URLs

https://login.microsoftonline.com
​https://login.microsoft.com
​https://sts.windows.net

Configuration settings

Each user signs into Company Portal once. This registers the Mac with Entra and is the one-time step behind the "one account picker" first launch.


4d. ChromeOS: The Google Admin Console

On Chromebooks, the Google Admin console installs the agent and delivers its configuration in one place.

  1. If your Chromebooks don't run Android apps yet, go to Devices → Chrome → Apps & extensions → User app settings, allow users to install Android apps, and click Save.

  2. Go to Devices → Chrome → Apps & extensions → Users & browsers, and select the organizational unit your Chromebook users belong to.

  3. Click Add → Add from Google Play, search for Kadence Agent for ChromeOS, click Select, then Accept.

  4. Under Installation policy, choose Force install + pin to ChromeOS taskbar.

  5. Under Managed configuration, paste the JSON from Step 3 exactly as Kadence shows it.

  6. Click Save.

The agent reads its configuration when it opens. After you change it, close and reopen the agent.


Step 5: Confirm It Works

  1. On a test device that has the app and the configuration, sign the user in and start the Kadence Agent.

  2. Expect the first-launch step for that platform and provider (see What Your People Will See above), then a signed-in agent.

  3. Restart the device and start the agent again. This time it should sign in with nothing shown.
    ​

    Kadence Agent Logged In

If the agent shows its normal sign-in screen instead, see Troubleshooting below.


Troubleshooting

The agent shows the normal sign-in screen

Auto login couldn't run and fell back safely. Common causes:

  • The device configuration is missing, or was changed by hand and is now invalid. Re-download it from Kadence (Step 3) and redeploy it unchanged.

  • Auto login isn't yet enabled for your workspace. Confirm with your Kadence contact.

  • The device is unmanaged, or is on a platform or identity provider that auto login doesn't support. Those users keep the normal sign-in.

ChromeOS: the agent shows the normal sign-in screen

Check each of these:

  • The managed configuration is on Kadence Agent for ChromeOS, in the organizational unit the person belongs to, and matches the JSON Kadence shows (Step 3). Close and reopen the agent after any change.

  • Enable ChromeOS is on in Kadence, and the person's Google Workspace domain is in your list (Step 2).

  • The person exists in Kadence under the same email as their Google account. On a Chromebook, a mismatch shows the normal sign-in screen, not "Contact your admin."

  • The person closed Google's sign-in sheet without choosing an account. Close and reopen the agent to see it again.

One person is asked to "Contact your admin"

Their identity was verified, but their email doesn't match any Kadence user in your workspace. Check that the person exists in Kadence under the same email your identity provider holds for them.

Okta: nobody can sign in silently

Confirm the agent's Okta application grants offline_access and has both Authorization Code and Refresh Token grant types (Step 1, Option B).

Entra on macOS: the account picker or a sign-in comes back every launch

The Mac isn't staying registered with Entra. Confirm Company Portal is installed and the user has signed into it, and that the Single sign-on app extension profile is assigned (Step 4c).

Entra: no Entra user can sign in

Confirm admin consent was granted to the Kadence Desktop Agent application in your tenant (Step 1, Option A).


Need Help?

For setup support, reach out to:
📩 [email protected]

Did this answer your question?