Comment utiliser un jeton d'application pour l'authentification des API?

Chaque fois que vous voulez utiliser l'API EMnify, vous devez vous authentifier. Vous pouvez le faire avec vos identifiants EMnify ou avec un Jeton d'application plus sécurisé. Voici les étapes :

1. Créez un jeton d'application sur l'EUI ;
2. Générer un jeton d'authentification basé sur le jeton d'application ;
3. Utiliser le jeton d'authentification pour toutes les autres API.

1. Créer un jeton d'application sur l'interface utilisateur d'EMnify. 

• Cliquez sur ce symbole  dans le coin droit de l'EUI.
• Sélectionnez "Create New Application Token"
• Sauvegardez le jeton d'application dans un endroit sûr. 

2. Générer un jeton d'authentification à partir de Postman

Vous pouvez utiliser le jeton d'application pour créer un jeton d'authentification dans Postman, que vous utiliserez ensuite pour exécuter les API EMnify comme expliqué ici.

Une fois le jeton d'application créé, vous pouvez l'utiliser pour générer un jeton d'authentification. Connectez-vous à Postman, copiez le jeton d'application comme ci-dessous et envoyez la requête API suivante. Elle créera un jeton d'application visible dans le corps de la réponse.

Pour automatiser l'authentification, vous devrez créer une variable avec le jeton d'authentification à partir du corps de la réponse. Une nouvelle variable appelée : "Auth_Token" sera créée. 

 

Requête API

POST https://cdn.emnify.net/api/v1/authenticate

Headers

Content-Type: application/json

Body

{

"application_token":"daDayJhbasaDADGciOiJIUzUxMiJ9.eyJlc2MuYXBwc2VjcmV0IjoiMDgyMmU1MzgtM2NhYi00ZTI1LTlmOTgtZTA2NjU1MzBjYzRkIiwic3ViIjoic3VjY2Vzc0BlbW5pZnkuY29tIiwiYXVkIjoiXC9hcGlcL3YxXC9hcHBsaWNhdGlvbl90b2tlbiIsImVzYy5hcHAiOjczOSNjLnVzZXIiOjE5NDgwMiwiZXNjLm9yZyI6MTU3MiwiZXNjLm9yZ05hbWUiOiJFTW5pZnkgR3Jvd3RoIFRlYW0iLCJpc3MiOiJzcGMtZnJvbnRlbmQxMDFAc3BjLWZyb250ZW5kIiwiZXhwIjoxNjA5NDU1NTk5LCJpYXQiOjE1MTAwNTkyODl9IUHHTbioPOIsZSzar"

}

Tests: 

var jsonData = JSON.parse(responseBody);
postman.setEnvironmentVariable("Auth_Token",jsonData.auth_token)

Response: status  200 OK

{

"auth_token":"UINiILhnHOIoiJIUzUxMiJ9.eyJhdWQiOiJcL2FwaVwvdjFcL2F1dGhlbnRpY2F0aW9uIiwiZXNjLmFwcCI6NzM5LCJlc2MudXNlciI6bnVsbCwiZXNjLm9yZyI6MTU3MiwiZXNjLm9yZ05hbWUiOiJFTW5pZnkgR554554454265FRlYW0iLCJpc3MiOiJzcGMtZnJvbnRlbmQxMDFAc3BjLWZyb250ZW5kIiwiZXhwIjoxNTEwMDczNzUzLCJpYXQiOjE1MTAwNTkzNTN9.nSAMOKzBeu33tS-ihdhuHiUIGFRTyGtTRFvytGF"

}

Note : N'oubliez pas d'enregistrer cette demande afin de rafraîchir le jeton d'authentification pour les connexions suivantes.

3. Utilisez le jeton d'authentification pour les requêtes API suivantes

A des fins de démonstration, nous intégrerons le jeton d'authentification dans la requête API pour obtenir la liste des endpoints (GET Endpoint collection). Les étapes seront les suivantes: 

1. Envoyer l'API d'authentification avec le jeton d'application pour rafraîchir le jeton d'authentification (cf. ci-dessus).
2. Envoyez la requête API suivante pour récupérer la collection des endpoints avec le Auth_token.

API Call

GET https://cdn.emnify.net/api/v1/endpoint?page=1&per_page=20&sort=id

Headers

Content-Type: application/json

Authorization: Bearer {{Auth_token}}

Response: status  200 OK

[

  {

    "id": 1,

    "name": "arduino01",

    "tags": "arduino, meter, temp",

    "created": "2014-08-01T08:47:00+00:00",

    "last_updated": "2016-02-29T14:02:47.000+0000",

    "status": {

      "id": 1,

      "description": "Disabled"

    },

    "service_profile": {

      "id": 1,

      "name": "Smart Meter"

    },

    "tariff_profile": {

      "id": 3,

      "name": "Domestic only"

    },

    "sim": {

      "id": 788,

      "iccid": "7368267365454773621",

      "imsi": "90199123565690",

      "msisdn": "+885637486456"

    },

    "imei": "8645454889321",

    "imei_lock": true,

    "ip_address": "10.288.23.75",

    "ip_address_space": {

      "id": 2

    },

]

A partir de maintenant, vous pouvez utiliser la bibliothèque de l'API EMnify. N'oubliez pas d'intégrer le token d'authentification pour chacun de vos requêtes API.