Διακριτικά πρόσβασης

Για να επιτραπεί σε μια εφαρμογή η πρόσβαση στη διεπαφή JSON (JavaScript Object Notation) ή στη διαδικτυακή διεπαφή χρήστη του KOSTAL Smart Energy Meter, πρέπει να έχει την κατάλληλη εξουσιοδότηση στον KOSTAL Smart Energy Meter.

Η εξουσιοδότηση πραγματοποιείται μέσω διακριτικών πρόσβασης που έχουν δημιουργηθεί προηγουμένως στο KOSTAL Smart Energy Meter.

Δημιουργία διακριτικών πρόσβασης

Τα διακριτικά πρόσβασης μπορούν να δημιουργηθούν στο στοιχείο μενού Προφίλ > Διακριτικά πρόσβασης.

Κάνοντας κλικ στο ΠΡΟΣΘΗΚΗ ανοίγει ένα παράθυρο στο οποίο μπορεί να οριστεί το όνομα, ο ρόλος και η ημερομηνία λήξης των διακριτικών πρόσβασης.

Παράμετρος	Επεξήγηση
Όνομα	Όνομα του χρήστη, της εφαρμογής ή της συσκευής που πρόκειται να χρησιμοποιήσει τη διεπαφή.
Ρόλος	api: Καθιστά δυνατή την αναζήτηση των δεδομένων μέτρησης μέσω της διεπαφής JSON. admin: Καθιστά δυνατή τη σύνδεση στη διεπαφή web και την πραγματοποίηση ρυθμίσεων. Αυτά τα διακριτικά πρόσβασης έχουν όλα τα δικαιώματα που έχει και ένας συνδεδεμένος χρήστης.
Λήγει στις	Ημερομηνία λήξης των διακριτικών πρόσβασης.

Μετά τη δημιουργία, τα διακριτικά πρόσβασης εμφανίζονται μία φορά. Δεν είναι δυνατή η εκ νέου λήψη ή η εμφάνισή τους και, ως εκ τούτου, θα πρέπει να αντιγραφούν και να αποθηκευτούν με ασφάλεια μετά την παραλαβή τους.

Εξουσιοδότηση των διακριτικών πρόσβασης

Τα νέα διακριτικά πρόσβασης πρέπει να λάβουν εξουσιοδότηση. Κάνοντας κλικ στην επιλογή ΕΞΟΥΣΙΟΔΟΤΗΣΗ , τα διακριτικά πρόσβασης πιστοποιούνται και εξουσιοδοτούνται για τη χρήση της διεπαφής JSON ή της διεπαφής χρήστη web.

Διαγραφή των διακριτικών πρόσβασης

Τα διακριτικά πρόσβασης μπορούν να διαγραφούν από το σύστημα κάνοντας κλικ στην επιλογή ΑΝΑΚΛΗΣΗ .

Χρήση των διακριτικών πρόσβασης API

Μόλις τα διακριτικά πρόσβασης API πιστοποιηθούν και εξουσιοδοτηθούν από τον χρήστη, μπορούν να χρησιμοποιηθούν από την εφαρμογή για αίτημα στη διεπαφή JSON.

Για το σκοπό αυτό, τα διακριτικά πρόσβασης μεταδίδονται ως μέρος της κεφαλίδας HTTP:

GET /api/json/<resource> HTTP/1.1
Host: <energy manager>
Content-Type: application/json
Authorization: Bearer eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9[..]

Χρήση των διακριτικών πρόσβασης διαχειριστή

Μόλις τα διακριτικά πρόσβασης διαχειριστή πιστοποιηθούν και εξουσιοδοτηθούν από τον χρήστη, μπορούν να χρησιμοποιηθούν από την εφαρμογή για την εμφάνιση της διεπαφής χρήστη.

Για το σκοπό αυτό, τα διακριτικά πρόσβασης μεταδίδονται ως μέρος της κεφαλίδας HTTP ή πρέπει να αποθηκευτούν στην τοπική μνήμη του προγράμματος περιήγησης, προκειμένου να είναι δυνατή η ανάγνωσή τους από εκεί.

Διακριτικά πρόσβασης TTL

Η διάρκεια ζωής των διακριτικών πρόσβασης μπορεί να περιοριστεί κατά τη διάρκεια του αιτήματος ελέγχου ταυτότητας. Για το σκοπό αυτό, εκτός από το όνομα της εφαρμογής ορίζεται και μια ημερομηνία λήξης. Επιπλέον, τα διακριτικά πρόσβασης που έχουν εκδοθεί μπορούν να ανακληθούν από έναν συνδεδεμένο χρήστη μέσω της διεπαφής web. Όλα τα επόμενα αιτήματα που υποβάλλονται με διακριτικά πρόσβασης που έχουν ανακληθεί θα απορρίπτονται.