# Gerando um agente MacOS

{% stepper %}
{% step %}

#### Acessar a sessão de geração de agent

Clique em ***AGENTS*** → Install

<figure><img src="/files/P5xyPzs3jdhTzKIGqHff" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}

#### Geração de Agent - Client e Site

No pop-up aberto, selecione o Client e o Site aos quais os dispositivos que instalarem o agente serão vinculados.

<figure><img src="/files/cbWefq2vs5HMQ0g8Fi7m" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}

#### Geração de Agent - Sistema Operacional e Tipo de Agent

Após selecionar Client e Site prossiga para a seleção de sistema operacional e tipo de agente.

{% hint style="info" %}
A definição do tipo de agente (Server ou Workstation) serve apenas para fins de identificação no SonarRMM e não afeta as funcionalidades ou a coleta de dados pelo agente, com exceção da funcionalidade ‘Disable Sleep/Hibernate’, que pode ser habilitada ou desabilitada apenas em estações de trabalho (Workstations).
{% endhint %}

<figure><img src="/files/7kLK0wtLy5YzWyRMNLXX" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}

#### Geração de Agent - Validade do Agent e Arquitetura

No campo Token expiration (hours) defina quanto tempo o agente gerado terá de validade em horas.

{% hint style="warning" %}
Se for definido um tempo curto de validade, a instalação pode falhar caso o prazo expire durante o processo. Em ambientes grandes, especialmente ao utilizar GPO para instalação, recomenda-se configurar um período de validade mais longo (em horas) para evitar falhas.
{% endhint %}

No campo ‘Arch’, selecione a arquitetura desejada para o agente: 64 bits ou 32 bits, conforme o sistema operacional dos dispositivos de destino.

<figure><img src="/files/7kLK0wtLy5YzWyRMNLXX" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}

#### Geração do Agent - Funcionalidades Opcionais

No campo ‘Funcionalidades Opcionais’, selecione os recursos que deseja habilitar na geração do agente.

<figure><img src="/files/3L9mMhygr6UfjvW7dJGP" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
Deseja saber mais sobre as Optional Features (Funcionalidades Opcionais)? [Clique aqui](/product-guide/configuracoes/sonar/rmm/how-to/implementar-agentes/funcionalidades-opcionais.md) para acessar a seção explicativa.
{% endhint %}

{% hint style="success" %}
Em sistemas MacOS, a coleta de sockets pode ser habilitada ou desabilitada no arquivo de configuração do Agente Sonar. Para isso, edite o arquivo /etc/sonaragent.json e altere o valor da flag "sockets" para "true" (habilitar) ou "false"(desabilitar).
{% endhint %}

**Exemplo com sockets habilitado:**

{% code lineNumbers="true" %}

```json
{
  "agentid": "rKfqzySHLYpfDWzUMGzBhcFmLDAkMLJlTPIdbuXB",
  "agentpk": "30",
  "apiurl": "sonarapi.altsec.com",
  "baseurl": "https://sonarapi.altsec.com",
  "cert": "",
  "insecure": "true",
  "meshdir": "",
  "natsstandardport": "",
  "proxy": "",
  "sockets": "true",
  "token": "5756522cebdb96720357e5ff88cd3ce9b37e3b67"
}
```

{% endcode %}
{% endstep %}

{% step %}

#### Geração do Agente - Instalação

Após concluir todas as etapas, clique em “View macOS install instructions” para visualizar a instruções de instalação.

<figure><img src="/files/hpSMrn4Dm7c7QXxABtTF" alt=""><figcaption></figcaption></figure>

Clique em "Copy Command Line" para baixar a linha de comando e executar a instalação em dispositivos MacOS via terminal.

<figure><img src="/files/NbnntQJPYy4Z7DNUFvEG" alt=""><figcaption></figcaption></figure>

**Flags disponíveis para sistemas MacOS:**

* -log debug — Ativa o modo de depuração (debug) nos logs de instalação do script;
* -silent — Ativa a instalação silenciosa sem abrir caixas de mensagens durante a instalação;
* -nomesh — Instala apenas o Agente do Sonar, sem o componente MeshCentral;
* -desc — Atribuir uma descrição personalizada ao agente instalado;
* proxy — Configurar o uso de proxy, se necessário.
  {% endstep %}
  {% endstepper %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://wiki.datadike.com/product-guide/configuracoes/sonar/rmm/how-to/implementar-agentes/gerando-um-agente-macos.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.