Loading...
Autenticação
A API Nomid MDM usa chaves de API para autenticar solicitações. Este guia explica como obter e usar sua chave de API.
Visão Geral
As chaves de API são usadas para autenticar todas as solicitações à API Nomid MDM. Inclua sua chave de API no cabeçalho X-API-Key com cada solicitação.
Request Headerhttp
X-API-Key: nm_acme_a1b2c3d4e5f6g7h8i9j0...Obtendo Sua Chave de API
As chaves de API são criadas e gerenciadas através do Portal Nomid. Siga estes passos para criar sua primeira chave de API.
Pré-requisitos
- Uma conta Nomid MDM com acesso de administrador
- Acesso às Configurações da Empresa no Portal Nomid
1
Acesse o Portal Nomid
Abra seu navegador e acesse o Portal Nomid. Entre com suas credenciais de administrador.
portal.nomid.tech2
Navegue até Integrações
Após fazer login, vá para a seção Configurações da Empresa e selecione a aba Integrações.
Configurações da Empresa → Integrações
3
Clique em Criar Chave de API
Clique no botão "Criar Chave de API" localizado no canto superior direito da página de Integrações.
4
Digite um Nome
No modal que aparece, digite um nome descritivo para sua chave de API. Isso ajuda a identificar a chave posteriormente (ex.: "Integração Power BI" ou "Sincronização CRM").
5
Copie Sua Chave
Após clicar em Criar, sua chave de API será exibida. Clique no botão copiar para copiá-la para a área de transferência. A chave será exibida apenas uma vez!
Importante: Salve Sua Chave
Sua chave de API será exibida apenas uma vez no momento da criação. Copie-a imediatamente e armazene-a de forma segura (ex.: em um gerenciador de senhas ou variável de ambiente). Se você perder a chave, precisará criar uma nova.
Formato da Chave de API
As chaves de API seguem este formato:
nm_{company}_{random_32_chars}
nm_- Todas as chaves começam com 'nm_'{company}- Prefixo específico da empresa para identificação{random}- 32 caracteres aleatórios para segurança
Usando Sua Chave de API
Inclua a chave de API no cabeçalho X-API-Key com cada solicitação:
curl -X GET "https://api.nomid.tech/emm/api/v1/assets" \
-H "X-API-Key: nm_acme_a1b2c3d4e5f6..."Permissões
As chaves de API podem ser configuradas com permissões específicas:
| Permission | Description |
|---|---|
| DEVICES_READ | Ler informações de dispositivos |
| POLICIES_READ | Ler informações de políticas |
| EXPORT_READ | Exportar dados |
Melhores Práticas de Segurança
Nunca exponha chaves de API em código do lado do cliente ou repositórios públicos
Rotacione chaves regularmente e revogue chaves não utilizadas
Armazene chaves em variáveis de ambiente, não no código
Use as permissões mínimas necessárias para sua integração
Revogando Chaves de API
Se você suspeitar que sua chave de API foi comprometida ou não é mais necessária, você pode revogá-la imediatamente na página Configurações da Empresa > Integrações no Portal Nomid. Chaves revogadas não podem ser restauradas.