> ## Documentation Index
> Fetch the complete documentation index at: https://kb.mspprocess.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Generate agent credentials

> Create the client ID and secret that link a desktop agent to one Triggr client.

Each agent signs in with a client ID and secret created for the Triggr client whose network it runs in.

<video controls preload="none" playsInline poster="/images/videos/agent-credentials.jpg" src="https://mintcdn.com/triggr/jthEaTOAfk2OUODQ/images/videos/agent-credentials.mp4?fit=max&auto=format&n=jthEaTOAfk2OUODQ&q=85&s=50c69f566edcf5a787e5f0714cb9fc52" />

Generate agent credentials: Studio's Agent Credentials, copying the secret, replacing it, and Core's Agent section (1:22).

> [tab] Triggr Core
>
> **1. Open the client**
>
> Go to Clients and click the client. Its Environment can't be Cloud Only.
>
> **2. Generate the credentials**
>
> Under Agent, click **Generate agent credentials**. Core keeps one set per client.
>
> **3. Copy the Client ID and secret**
>
> Core shows the secret only once; click Done — hide secret when you've copied it. Regenerate replaces it and revokes the old one.
>
> ![The Agent section of a client panel showing an Online status, Last seen and Last authenticated times, and the Client ID with a Copy button.](https://mintcdn.com/triggr/MwzXHG3UWzFixdSz/images/core/add-your-clients/agent-section.png?fit=max\&auto=format\&n=MwzXHG3UWzFixdSz\&q=85\&s=e2285a85e9e2a6721a75cc38e0b40d57)
>
> Afterwards the Agent section keeps the Client ID and shows the agent's status once it connects.

> [tab] Triggr Studio
>
> **1. Open the client's agent credentials**
>
> In Clients, open the client, click Agent Credentials, then click **New Client**.
>
> ![Initech's Agent OAuth Clients page with no OAuth clients yet, and the Refresh and New Client buttons.](https://mintcdn.com/triggr/jthEaTOAfk2OUODQ/images/agent/new-client.png?fit=max\&auto=format\&n=jthEaTOAfk2OUODQ\&q=85\&s=3100d46e0a4b6c8a7ba5d1ffe8ec0950)
>
> **2. Name it**
>
> Enter a name, such as the machine you're installing the agent on, and click **Create Client**. Create one for each machine.
>
> ![The Create New OAuth Client dialog with Initech agent entered as the name, and the Cancel and Create Client buttons.](https://mintcdn.com/triggr/jthEaTOAfk2OUODQ/images/agent/click-create-client.png?fit=max\&auto=format\&n=jthEaTOAfk2OUODQ\&q=85\&s=9b534d5acd980693dfa7c3fe793a0887)
>
> **3. Create a secret**
>
> Click **New Secret** in the new row, then Create Secret. The label is optional.
>
> ![The new client's row, Initech agent, with No secrets and the Copy Client ID and New Secret buttons.](https://mintcdn.com/triggr/jthEaTOAfk2OUODQ/images/agent/click-new-secret.png?fit=max\&auto=format\&n=jthEaTOAfk2OUODQ\&q=85\&s=c19ad865886e77fbbf7cba4a9624bcc1)
>
> **4. Copy the credentials**
>
> Copy the Client ID and Secret. Studio shows the secret only once.
>
> ![The Secret Created dialog: Copy these values now as you will only see them once, then the Client ID and a sample secret, each with Copy, and Close.](https://mintcdn.com/triggr/jthEaTOAfk2OUODQ/images/agent/secret-created.png?fit=max\&auto=format\&n=jthEaTOAfk2OUODQ\&q=85\&s=5edaf8d6eff3dad035f417de7d8ae1a2)

Next: [install the desktop agent](https://kb.mspprocess.com/desktop-agent/install.md).

## FAQ

> [accordion] I didn't copy the secret
>
> In Studio, click New Secret on the client's row and use the new one; the old one keeps working until you revoke it. In Core, click Regenerate.

> [accordion] How do I replace a secret?
>
> Create a new one and rerun the [install script](https://kb.mspprocess.com/desktop-agent/install.md) with it. In Studio, then click the client's row and Revoke the old secret; in Core, Regenerate revokes it for you.

> [accordion] Can two machines share one credential?
>
> Create a client for each machine instead. Agent Summary on the client's page then shows each one's Status and Last Seen separately.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.