> For the complete documentation index, see [llms.txt](https://wiki.datadike.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://wiki.datadike.com/product-docs/product-guide/configuracoes/sonar/rmm/how-to/implementar-agentes/gerando-um-agente-macos.md).

# Gerando um agente MacOS

Nesta sessão iremos abordar como gerar um agente do SonarRMM para dispositivos MacOS

{% stepper %}
{% step %}

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

Clique em ***AGENTS*** → Install

<figure><img src="https://2253944601-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FFTstDFQSgSb2pWuuew1q%2Fuploads%2Fgit-blob-4f76ae20a80bc039defe6cfb7e885299959d67d6%2FCaptura%20de%20Tela%202025-07-31%20a%CC%80s%2014.15.42.png?alt=media" 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="https://2253944601-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FFTstDFQSgSb2pWuuew1q%2Fuploads%2Fgit-blob-b4af67ea47eee30b3506bfaad0a72241b833acee%2FCaptura%20de%20Tela%202025-08-04%20a%CC%80s%2009.52.57.png?alt=media" 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="https://2253944601-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FFTstDFQSgSb2pWuuew1q%2Fuploads%2Fgit-blob-d698f8cd2da0743e374bb38e9478c562f9e0ab55%2FCaptura%20de%20Tela%202025-08-04%20a%CC%80s%2009.52.57.png?alt=media" 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="https://2253944601-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FFTstDFQSgSb2pWuuew1q%2Fuploads%2Fgit-blob-d698f8cd2da0743e374bb38e9478c562f9e0ab55%2FCaptura%20de%20Tela%202025-08-04%20a%CC%80s%2009.52.57.png?alt=media" 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="https://2253944601-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FFTstDFQSgSb2pWuuew1q%2Fuploads%2Fgit-blob-a1d05f3c0011c6941bf5c5bf5bbe81c610009967%2FCaptura%20de%20Tela%202025-08-04%20a%CC%80s%2010.30.53.png?alt=media" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
Deseja saber mais sobre as Optional Features (Funcionalidades Opcionais)? [Clique aqui](/product-docs/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="https://2253944601-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FFTstDFQSgSb2pWuuew1q%2Fuploads%2Fgit-blob-22afe85ecdbf51bbe5cf389b2b706f32072320eb%2FCaptura%20de%20Tela%202025-08-04%20a%CC%80s%2009.52.57.png?alt=media" 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="https://2253944601-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FFTstDFQSgSb2pWuuew1q%2Fuploads%2Fgit-blob-aeb87d40e14af8c89561b8edd2600e93fdbfe9bc%2FCaptura%20de%20Tela%202025-08-04%20a%CC%80s%2010.17.12.png?alt=media" 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 %}