> ## Documentation Index
> Fetch the complete documentation index at: https://university.triggr-app.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.

<Tabs>
  <Tab title="Triggr Core">
    <Steps>
      <Step title="Open the client">
        Go to Clients and click the client. Its Environment can't be Cloud Only.
      </Step>

      <Step title="Generate the credentials">
        Under Agent, click **Generate agent credentials**.
      </Step>

      <Step title="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.

        <Frame caption="Afterwards the Agent section keeps the Client ID and shows the agent's status once it connects.">
          <img src="https://mintcdn.com/triggr/MwzXHG3UWzFixdSz/images/core/add-your-clients/agent-section.png?fit=max&auto=format&n=MwzXHG3UWzFixdSz&q=85&s=e2285a85e9e2a6721a75cc38e0b40d57" alt="The Agent section of a client panel showing an Online status, version, Last seen and Last authenticated times, the Client ID with a Copy button, and Regenerate." width="1310" height="460" data-path="images/core/add-your-clients/agent-section.png" />
        </Frame>
      </Step>
    </Steps>
  </Tab>

  <Tab title="Triggr Studio">
    <Steps>
      <Step title="Open the client's agent credentials">
        In Clients, open the client, click Agent Credentials, then click **New Client**.

        <Frame>
          <img src="https://mintcdn.com/triggr/MwzXHG3UWzFixdSz/images/agent/new-client.png?fit=max&auto=format&n=MwzXHG3UWzFixdSz&q=85&s=7b8851ba7e9dc064568ca0ee8532910f" alt="A client's Agent OAuth Clients page with no OAuth clients yet, and a Click here pointer on the New Client button." width="1452" height="664" data-path="images/agent/new-client.png" />
        </Frame>
      </Step>

      <Step title="Name the machine">
        Enter the name of the machine you're installing the agent on, such as `Client Domain Controller`, and click Create Client. Create one for each machine.

        <Frame>
          <img src="https://mintcdn.com/triggr/MwzXHG3UWzFixdSz/images/agent/click-create-client.png?fit=max&auto=format&n=MwzXHG3UWzFixdSz&q=85&s=acca80ba246f56783b9dd8bd873e5213" alt="The Create New OAuth Client dialog with Domain Controller entered as the name, and a Click here pointer on the Create Client button." width="1454" height="660" data-path="images/agent/click-create-client.png" />
        </Frame>
      </Step>

      <Step title="Create a secret">
        Click **New Secret** in the new row, then Create Secret.

        <Frame>
          <img src="https://mintcdn.com/triggr/MwzXHG3UWzFixdSz/images/agent/click-new-secret.png?fit=max&auto=format&n=MwzXHG3UWzFixdSz&q=85&s=55f18c98d86e996bb9d28899f7e91af7" alt="An OAuth client created successfully message above the new client's row, with Copy Client ID and a Click here pointer on the New Secret button." width="1454" height="662" data-path="images/agent/click-new-secret.png" />
        </Frame>
      </Step>

      <Step title="Copy the credentials">
        Copy the Client ID and Secret. Studio shows the secret only once.
      </Step>
    </Steps>
  </Tab>
</Tabs>

Next: [install the desktop agent](/desktop-agent/install).

## FAQ

<AccordionGroup>
  <Accordion title="I didn't copy the secret">
    In Studio, click New Secret on the machine's row and use the new one; the old one keeps working until you click Revoke Secret. In Core, click Regenerate.
  </Accordion>

  <Accordion title="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.
  </Accordion>
</AccordionGroup>


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