Jedes Mal, wenn Sie die EMnify-API verwenden möchten, müssen Sie sich authentifizieren. Dafür können Sie entweder Ihre EUI Zugangsdaten (nicht sicher) oder ein Application Token (empfohlen) verwenden.

1. Erstellen Sie ein Application Token auf der EUI;
2. Generieren Sie im Postman ein Authentication Token basierend auf dem Application Token; 
3. Verwenden Sie das Authentication Token für alle anderen APIs.

1. Erstellen Sie ein Application Token auf der EUI

• Klicken Sie auf das Symbol    in der rechten oberen Ecke der EUI;
• Klicken Sie auf "Create New Application Token";
• Speichern Sie das Token.

2. Generieren Sie ein Authentication Token basierend auf dem Application Token

2.1 API authenticate

Jetzt, da wir das Application Token haben, können wir damit ein Authentication Token erstellen, das dann zur Ausführung aller anderen APIs verwendet wird.

Um dieses Token zu erstellen, müssen wir die hier beschriebene Post-API-Authentifizierung ausführen. In unserem Beispiel verwenden wir Postman.

API Call

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

Headers

Content-Type: application/json

Body

{
"application_token":"daDayJhbasaDADGciOiJIUzUxMiJ9.eyJlc2MuYXBwc2VjcmV0IjoiMDgyMmU1MzgtM2NhYi00ZTI1LTlmOTgtZTA2NjU1MzBjYzRkIiwic3ViIjoic3VjY2Vzc0BlbW5pZnkuY29tIiwiYXVkIjoiXC9hcGlcL3YxXC9hcHBsaWNhdGlvbl90b2tlbiIsImVzYy5hcHAiOjczOSNjLnVzZXIiOjE5NDgwMiwiZXNjLm9yZyI6MTU3MiwiZXNjLm9yZ05hbWUiOiJFTW5pZnkgR3Jvd3RoIFRlYW0iLCJpc3MiOiJzcGMtZnJvbnRlbmQxMDFAc3BjLWZyb250ZW5kIiwiZXhwIjoxNjA5NDU1NTk5LCJpYXQiOjE1MTAwNTkyODl9IUHHTbioPOIsZSzar"
}

Response: status  200 OK

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

Im Feld "Response" sehen wir das generierte Authentication Token.

Aus Sicherheitsgründen verfällt das Authentication Token nach 240 Minuten. Daher muss die Authentifizierung erneut durchgeführt werden, um ein neues Authentication Token zu erhalten. Dazu speichern Sie das Request.

2.2 Erstellung einer Variable

Um das Token für jede API zu verwenden, können wir eine Variable erstellen.

In Postman fügen Sie den folgenden Text im "Tests" Tab des Authentication Requests hinzu, um die Variable "Auth_Token" zu kreieren.

Tests: 

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

Sie können die API erneut ausführen, um die Variable zu erstellen.

3. Verwenden Sie den Authentication Token für alle anderen APIs

Da wir uns vor der Verwendung einer anderen API authentifizieren müssen, können wir die neu erstellte Variable verwenden, bevor wir andere Requests aufrufen. Für Demozwecke verwenden wir die hier beschriebene "Endpoint Collection" GET API.

Legen Sie in Postman ein neues Request an.

API Call

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

Diesmal müssen wir zwei "Headers" anlegen. Der erste Header beschreibt die Art der API, die wir verwenden. Der zweite Header dient der Autorisierung / Authentifizierung. 

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
    },
]

Sie können nun die EMnify-API-Bibliothek verwenden. Vergessen Sie nicht, das Authentication Token für jeden Ihrer API-Aufrufe zu integrieren.