Datto RMM

Integre o Defender360 com o Datto RMM para sincronizar dispositivos, receber alertas e automatizar fluxos de trabalho.

Visao Geral

A integracao com Datto RMM permite:

Sincronizar Dispositivos: Importar devices para o CMDB
Receber Alertas: Criar tickets automaticamente
Mapear Sites: Vincular sites Datto a tenants
Executar Scripts: Acoes remotas via tickets

Arquitetura


Datto RMM
    │
    ├── Sites ─────────► Tenants (mapeamento)
    │
    ├── Devices ───────► CMDB (sincronizacao)
    │
    └── Alerts ────────► Tickets (automatico)

Pre-requisitos

No Datto RMM

Acesso administrativo ao Datto RMM
Conta de API habilitada
URL da API (ex: https://vidal-api.centrastage.net)

Credenciais Necessarias

Campo	Descricao
API URL	Endpoint base da API
Username	Email do usuario Datto
Password	Senha do usuario

O Defender360 usa OAuth2 com grant_type=password para autenticar com a API do Datto.

Conectar ao Datto RMM

Passo a Passo

Acesse Configuracoes > Integracoes > Datto RMM
Clique em Conectar
Preencha as credenciais:

Campo	Exemplo
API URL	https://vidal-api.centrastage.net
Username	admin@msp.com
Password	********

Clique em Testar Conexao
Se bem sucedido, clique em Salvar

Verificar Conexao

Apos conectar:

Status muda para Conectado
Ultima sincronizacao e exibida
Lista de sites e carregada

Mapeamento de Sites

O que e Mapeamento

Cada Site no Datto corresponde a um Tenant no Defender360. O mapeamento vincula os dois para:

Dispositivos do site ficam visiveis apenas no tenant correto
Alertas do site criam tickets no tenant correto
Isolamento multi-tenant e mantido

Configurar Mapeamento

Acesse Integracoes > Datto RMM > Sites
Para cada site listado:
- Selecione o Tenant correspondente
- Ou clique em Ignorar para nao sincronizar
Clique em Salvar Mapeamentos

Site Datto	Tenant Defender360	Status
ACME Corp	acme	Mapeado
Beta Inc	beta	Mapeado
Test Site	-	Ignorado

Dispositivos e alertas de sites nao mapeados serao ignorados. Configure todos os sites ativos.

Adicionar Novo Site

Quando um novo site e criado no Datto:

Na proxima sincronizacao, o site aparece como “Nao Mapeado”
Configure o mapeamento
Forca sincronizacao para importar dispositivos

Sincronizacao de Dispositivos

Dados Sincronizados

Campo Datto	Campo CMDB	Tipo
`deviceId`	external_id	string
`hostname`	name	string
`siteName`	location	string
`deviceType`	ci_type	string
`operatingSystem`	os	string
`lastSeen`	last_sync	datetime
`status`	status	string

Tipos de Dispositivo

Mapeamento de tipos:

Tipo Datto	Tipo CMDB
Desktop	workstation
Laptop	workstation
Server	server
Network Device	network_device
Printer	printer
Other	other

Intervalo de Sincronizacao

Configure a frequencia:

Intervalo	Uso
15 minutos	Ambientes criticos
1 hora	Padrao recomendado
4 horas	Baixo volume de mudancas

Forcar Sincronizacao

Para sincronizar imediatamente:

Acesse Integracoes > Datto RMM
Clique em Sincronizar Agora
Aguarde a conclusao
Verifique os logs

Alertas para Tickets

Fluxo de Alertas


1. Alerta gerado no Datto RMM
        │
        ▼
2. Webhook enviado ao Defender360
        │
        ▼
3. Identificar site/tenant
        │
        ▼
4. Criar ticket automaticamente
        │
        ▼
5. Vincular ao dispositivo no CMDB

Configurar Webhook no Datto

No Datto RMM, acesse Setup > Webhooks
Crie um novo webhook:

Campo	Valor
URL	https://api.defender360.com/v1/webhooks/datto
Content Type	application/json
Events	Alert Created, Alert Resolved

Copie o Secret gerado
No Defender360, configure o secret em Integracoes > Datto RMM > Webhooks

Mapeamento de Alertas

Configure como alertas viram tickets:

Severidade Datto	Prioridade Ticket
Critical	Critica
High	Alta
Moderate	Media
Low	Baixa

Categorias de Alerta

Mapeie tipos de alerta para categorias:


"CPU" → Categoria: Performance
"Disk" → Categoria: Hardware
"Memory" → Categoria: Performance
"Network" → Categoria: Rede
"Antivirus" → Categoria: Seguranca
"Patch" → Categoria: Atualizacao

Configurar Mapeamentos

Acesse Integracoes > Datto RMM > Alertas
Para cada tipo de alerta:
- Configure a prioridade
- Selecione a categoria
- Defina a fila de atribuicao
Clique em Salvar

Resolucao Automatica

Fechar Ticket Quando Alerta Resolve

Configure para fechar tickets automaticamente:

Ative Auto-Resolver Tickets
Quando o alerta e resolvido no Datto:
- Ticket muda para Resolvido
- Nota automatica e adicionada
- SLA e calculado

Configuracoes

Opcao	Descricao
Auto-resolver	Fechar ticket quando alerta resolve
Nota automatica	Adicionar comentario explicativo
Delay de fechamento	Aguardar X minutos antes de fechar
Notificar agente	Avisar o agente sobre a resolucao

Acoes Remotas

Executar Scripts via Ticket

Para agentes com permissao:

Abra o ticket vinculado a um dispositivo
Clique em Acoes > Datto RMM
Selecione uma acao:
- Reiniciar dispositivo
- Executar script
- Abrir conexao remota
Confirme a acao
Resultado e registrado no ticket

Apenas agentes com permissao especifica podem executar acoes remotas. Configure em Usuarios > Permissoes.

Auditoria

Logs de Integracao

Todas as acoes sao registradas:

Log	Descricao
`datto.sync.started`	Sincronizacao iniciada
`datto.sync.completed`	Sincronizacao concluida
`datto.device.created`	Dispositivo criado no CMDB
`datto.device.updated`	Dispositivo atualizado
`datto.alert.received`	Alerta recebido
`datto.ticket.created`	Ticket criado de alerta
`datto.action.executed`	Acao remota executada

Acessar Logs

Acesse Integracoes > Datto RMM > Logs
Filtre por:
- Periodo
- Tipo de evento
- Site/Tenant
- Status (sucesso/erro)
Exporte se necessario

Monitoramento

Dashboard Datto

Visualize metricas:

Metrica	Descricao
Dispositivos Sincronizados	Total no CMDB
Alertas Processados	Ultimas 24 horas
Tickets Criados	De alertas
Taxa de Sucesso	Sincronizacoes OK
Ultima Sincronizacao	Timestamp

Alertas de Falha

Configure notificacoes para:

Falha de autenticacao
Erro de sincronizacao
Webhook nao recebido
Site nao mapeado

Troubleshooting

Boas Praticas

Integracao Datto RMM

Mapeie todos os sites ativos

Configure webhook para alertas em tempo real

Defina mapeamento de prioridades

Ative auto-resolucao para alertas

Monitore logs de sincronizacao

Revise dispositivos nao vinculados periodicamente

Configure alertas de falha de integracao

Documente scripts customizados disponiveis

API Datto - Referencia

Endpoints Utilizados

Endpoint	Metodo	Descricao
`/api/v2/account/sites`	GET	Lista sites
`/api/v2/account/devices`	GET	Lista dispositivos
`/api/v2/site/{uid}/devices`	GET	Dispositivos por site
`/api/v2/device/{uid}`	GET	Detalhes do dispositivo
`/api/v2/alert`	GET	Lista alertas

Paginacao

A API usa paginacao 0-based:


page=0 → Primeira pagina
page=1 → Segunda pagina
...

O limite padrao e 250 itens por pagina. O Defender360 processa todas as paginas automaticamente.