Authentification

Aperçu

Les clés d'API sont utilisées pour authentifier toutes les requêtes adressées à l'API Nomid MDM. Incluez votre clé d'API dans l'en-tête X-API-Key avec chaque requête.

X-API-Key: nm_acme_a1b2c3d4e5f6...

Obtenir votre clé d'API

Les clés d'API sont créées et gérées via le portail Nomid. Suivez ces étapes pour créer votre première clé d'API.

Prérequis

• Un compte Nomid MDM avec accès administrateur
• Accès aux Paramètres de l'entreprise dans le portail Nomid

1. 1

   Connectez-vous au portail Nomid

   Ouvrez votre navigateur et accédez au portail Nomid. Connectez-vous avec vos identifiants administrateur.

2. 2

   Accéder aux Intégrations

   Une fois connecté, accédez à la section Paramètres de l'entreprise et sélectionnez l'onglet Intégrations.

3. 3

   Cliquez sur Créer une clé API

   Cliquez sur le bouton "Créer une clé API" situé dans le coin supérieur droit de la page Intégrations.

4. 4

   Entrez un nom

   Dans la fenêtre modale qui apparaît, entrez un nom descriptif pour votre clé API. Cela vous aidera à identifier la clé plus tard (par exemple, "Intégration Power BI" ou "Synchronisation CRM").

5. 5

   Copiez votre clé

   Après avoir cliqué sur Créer, votre clé API s'affichera. Cliquez sur le bouton Copier pour la copier dans votre presse-papiers. La clé ne sera affichée qu'une seule fois !

Format de la clé API

Les clés API suivent ce format :

nm_{company}_{random_32_chars}

• Toutes les clés commencent par 'nm_
• Préfixe spécifique à l'entreprise pour l'identification
• 32 caractères aléatoires pour la sécurité

Utilisation de votre clé d'API

Incluez la clé d'API dans l'en-tête X-API-Key à chaque requête :

curl -X GET "https://api.nomid.tech/emm/api/v1/assets" \
  -H "X-API-Key: nm_acme_a1b2c3d4e5f6..."

Meilleures pratiques de sécurité

• N'exposez jamais les clés d'API dans le code côté client ou dans les dépôts publics
• Faites pivoter les clés régulièrement et révoquez les clés inutilisées
• Stockez les clés dans des variables d'environnement, pas dans le code
• Utilisez les permissions minimales nécessaires pour votre intégration

Erreurs d'authentification

L'API renvoie des codes d'erreur spécifiques pour les problèmes d'authentification :