Έλεγχος Ταυτότητας
Το Nomid MDM API χρησιμοποιεί κλειδιά API για τον έλεγχο ταυτότητας των αιτημάτων. Αυτός ο οδηγός εξηγεί πώς να αποκτήσετε και να χρησιμοποιήσετε το κλειδί API σας.
Επισκόπηση
Τα κλειδιά API χρησιμοποιούνται για τον έλεγχο ταυτότητας όλων των αιτημάτων στο Nomid MDM API. Συμπεριλάβετε το κλειδί API σας στην κεφαλίδα X-API-Key με κάθε αίτημα.
X-API-Key: nm_acme_a1b2c3d4e5f6g7h8i9j0...Λήψη του Κλειδιού API σας
Τα κλειδιά API δημιουργούνται και διαχειρίζονται μέσω της Πύλης Nomid. Ακολουθήστε αυτά τα βήματα για να δημιουργήσετε το πρώτο σας κλειδί API.
Προαπαιτούμενα
- Ένας λογαριασμός Nomid MDM με πρόσβαση διαχειριστή
- Πρόσβαση στις Ρυθμίσεις Εταιρείας στην Πύλη Nomid
Συνδεθείτε στην Πύλη Nomid
Ανοίξτε το πρόγραμμα περιήγησής σας και μεταβείτε στην Πύλη Nomid. Συνδεθείτε με τα διαπιστευτήριά σας ως διαχειριστής.
portal.nomid.techΜεταβείτε στις Ενσωματώσεις
Αφού συνδεθείτε, μεταβείτε στην ενότητα Ρυθμίσεις Εταιρείας και επιλέξτε την καρτέλα Ενσωματώσεις.
Κάντε κλικ στο Δημιουργία Κλειδιού API
Κάντε κλικ στο κουμπί "Δημιουργία Κλειδιού API" που βρίσκεται στην επάνω δεξιά γωνία της σελίδας Ενσωματώσεις.
Εισάγετε ένα Όνομα
Στο αναδυόμενο παράθυρο που εμφανίζεται, εισαγάγετε ένα περιγραφικό όνομα για το κλειδί API σας. Αυτό σας βοηθά να αναγνωρίσετε το κλειδί αργότερα (π.χ., "Ενσωμάτωση Power BI" ή "Συγχρονισμός CRM").
Αντιγράψτε το Κλειδί σας
Μετά το κλικ στο Δημιουργία, το κλειδί API σας θα εμφανιστεί. Κάντε κλικ στο κουμπί Αντιγραφή για να το αντιγράψετε στο πρόχειρο. Το κλειδί θα εμφανιστεί μόνο μία φορά!
Σημαντικό: Αποθηκεύστε το Κλειδί σας
Το κλειδί API σας θα εμφανιστεί μόνο μία φορά τη στιγμή της δημιουργίας. Αντιγράψτε το αμέσως και αποθηκεύστε το με ασφάλεια (π.χ., σε έναν διαχειριστή κωδικών πρόσβασης ή μεταβλητή περιβάλλοντος). Αν χάσετε το κλειδί, θα χρειαστεί να δημιουργήσετε ένα νέο.
Μορφή Κλειδιού API
Τα κλειδιά API ακολουθούν αυτήν τη μορφή:
nm_- Όλα τα κλειδιά ξεκινούν με 'nm_{company}- Πρόθεμα ειδικό για την εταιρεία για αναγνώριση{random}- 32 τυχαίοι χαρακτήρες για ασφάλεια
Χρήση του Κλειδιού API σας
Συμπεριλάβετε το κλειδί API στην κεφαλίδα X-API-Key με κάθε αίτημα:
curl -X GET "https://api.nomid.tech/emm/api/v1/assets" \
-H "X-API-Key: nm_acme_a1b2c3d4e5f6..."Δικαιώματα
Τα κλειδιά API μπορούν να ρυθμιστούν με συγκεκριμένα δικαιώματα:
| Permission | Description |
|---|---|
| DEVICES_READ | Ανάγνωση πληροφοριών συσκευής |
| POLICIES_READ | Ανάγνωση πληροφοριών πολιτικής |
| EXPORT_READ | Εξαγωγή δεδομένων |
Βέλτιστες πρακτικές ασφαλείας
Μην εκθέτετε ποτέ κλειδιά API σε κώδικα από την πλευρά του πελάτη ή σε δημόσια αποθετήρια
Περιστρέψτε τα κλειδιά τακτικά και ανακαλέστε τα αχρησιμοποίητα κλειδιά
Αποθηκεύστε τα κλειδιά σε μεταβλητές περιβάλλοντος, όχι σε κώδικα
Χρησιμοποιήστε τις ελάχιστες απαραίτητες άδειες για την ενσωμάτωσή σας
Ανάκληση κλειδιών API
Εάν υποψιάζεστε ότι το κλειδί API σας έχει παραβιαστεί ή δεν χρειάζεται πλέον, μπορείτε να το ανακαλέσετε αμέσως από τη σελίδα Ρυθμίσεις Εταιρείας > Ενσωματώσεις στην Πύλη Nomid. Τα ανακληθέντα κλειδιά δεν μπορούν να αποκατασταθούν.