Πώς να ρυθμίσετε και να κάνετε εναλλαγή των κλειδιών API παρακολούθησης αποστολών χωρίς να διακόψετε την ενσωμάτωσή σας
Για να διαμορφώσετε και να περιστρέφετε με ασφάλεια τα API keys παρακολούθησης αποστολών, διατηρείτε τα διαπιστευτήρια σε έναν διαχειριστή μυστικών στην πλευρά του διακομιστή, εντοπίστε κάθε εφαρμογή που τα χρησιμοποιεί και δοκιμάστε ένα αντικαταστάτη πριν αποσύρετε το παλιό key. Εάν ο πάροχός σας υποστηρίζει επικαλυπτόμενα διαπιστευτήρια, μεταφέρετε σταδιακά τους καταναλωτές και ανακαλέστε το παλιό key μόνο μετά την επαλήθευση. Εάν η αντικατάσταση ακυρώνει αμέσως το υπάρχον key, σχεδιάστε μια συντονισμένη μετάβαση με ανθεκτικές ουρές και ελέγχους ανάκτησης, αντί να θεωρείτε δεδομένο ότι δεν θα υπάρξει διακοπή λειτουργίας.
Αυτός ο οδηγός απευθύνεται σε προγραμματιστές και ομάδες λειτουργιών που συντηρούν ενσωματώσεις παρακολούθησης σε πλατφόρμες ηλεκτρονικού εμπορίου, συστήματα διαχείρισης παραγγελιών, λογισμικό αποθηκών και υπηρεσίες ειδοποιήσεων πελατών. Ο στόχος δεν είναι απλώς η αποστολή ενός πιστοποιημένου αιτήματος: είναι η διατήρηση των καταχωρίσεων αποστολών, των ενημερώσεων παρακολούθησης και της επεξεργασίας downstream καθ’ όλη τη διάρκεια της αλλαγής.
Επιβεβαιώστε τον τρόπο με τον οποίο ο πάροχός σας χειρίζεται τα διαπιστευτήρια
Πριν αλλάξετε τη διαμόρφωση παραγωγής, καθορίστε τον κύκλο ζωής των διαπιστευτηρίων του παρόχου. Μια ενέργεια πίνακα ελέγχου με την ένδειξη «regenerate» μπορεί να συμπεριφέρεται διαφορετικά από την επιλογή «create another key». Μην συμπεραίνετε τη συμπεριφορά από την ετικέτα του κουμπιού.
- Μορφή ελέγχου ταυτότητας: Επιβεβαιώστε την απαιτούμενη κεφαλίδα ή άλλον μηχανισμό ελέγχου ταυτότητας, την έκδοση του endpoint και τη σύνδεση με τον λογαριασμό.
- Επικάλυψη: Μπορούν δύο διαπιστευτήρια να παραμείνουν έγκυρα ταυτόχρονα; Η δημιουργία αντικαταστάτη ανακαλεί αμέσως το προηγούμενο διαπιστευτήριο;
- Δικαιώματα: Καθορίστε αν τα keys έχουν ξεχωριστά scopes, περιορισμούς περιβάλλοντος ή ελέγχους πρόσβασης. Χρησιμοποιήστε αυτούς τους ελέγχους όπου είναι διαθέσιμοι· μην θεωρείτε δεδομένο ότι υπάρχουν.
- Ανάκληση: Επιβεβαιώστε τον τρόπο απενεργοποίησης ενός διαπιστευτηρίου και αν πρέπει να ληφθεί υπόψη οποιαδήποτε συμπεριφορά διάδοσης.
- Λειτουργικές επιπτώσεις: Καθορίστε αν τα quotas, οι καταχωρισμένες αποστολές και οι ρυθμίσεις webhook ανήκουν στον λογαριασμό, σε μια εφαρμογή ή σε ένα μεμονωμένο key.
Για μια ενσωμάτωση με το 17TRACK, ξεκινήστε από την επίσημη τεκμηρίωση Tracking API και τη σελίδα προϊόντος Tracking API. Χρησιμοποιήστε την τεκμηρίωση για να επιβεβαιώσετε το συμβόλαιο ελέγχου ταυτότητας της ενσωμάτωσής σας και επιβεβαιώστε τη συμπεριφορά του κύκλου ζωής των διαπιστευτηρίων μέσω των ελέγχων του λογαριασμού σας ή της υποστήριξης πριν προγραμματίσετε την περιστροφή. Η παρακάτω διαδικασία είναι ένα επιχειρησιακό runbook και όχι ισχυρισμός ότι το 17TRACK προσφέρει συγκεκριμένη ροή εργασίας διπλού key ή αναδημιουργίας.
Κανόνας απόφασης: Χρησιμοποιήστε ανάπτυξη με επικαλυπτόμενα keys μόνο όταν έχει επιβεβαιωθεί η ταυτόχρονη εγκυρότητα. Διαφορετικά, αντιμετωπίστε την περιστροφή ως συντονισμένη αντικατάσταση διαπιστευτηρίου. Μια στρατηγική ανάπτυξης δεν μπορεί να δημιουργήσει περίοδο επικάλυψης που ο πάροχος δεν υποστηρίζει.
Διαμορφώστε το key μία φορά, χωρίς να το διαδώσετε στο σύστημά σας
Διατηρήστε τον έλεγχο ταυτότητας στον διακομιστή
Αποθηκεύστε το διαπιστευτήριο παραγωγής σε έναν διαχειριζόμενο χώρο αποθήκευσης μυστικών ή σε ισοδύναμο ελεγχόμενο σύστημα. Επιτρέψτε στην εφαρμογή να το ανακτά μέσω της ταυτότητας του workload, της πλατφόρμας ανάπτυξης ή άλλου εγκεκριμένου μηχανισμού. Περιορίστε την πρόσβαση ανάγνωσης στα workloads και στους χειριστές που τη χρειάζονται.
Μην ενσωματώνετε το key σε JavaScript του browser, πακέτα εφαρμογών κινητών, πηγαίο κώδικα, images κοντέινερ ή κοινόχρηστα παραδείγματα διαμόρφωσης. Μια σελίδα παρακολούθησης που απευθύνεται στον πελάτη θα πρέπει να καλεί το backend σας, το οποίο μπορεί να πραγματοποιεί έλεγχο ταυτότητας στον πάροχο παρακολούθησης χωρίς να εκθέτει το διαπιστευτήριο του παρόχου.
Το OWASP Secrets Management Cheat Sheet υποστηρίζει την κεντρική διαχείριση μυστικών, τον ελεγχόμενο έλεγχο πρόσβασης, τον έλεγχο καταγραφών και τη διαχείριση κύκλου ζωής. Το REST Security Cheat Sheet επίσης συμβουλεύει να μην τοποθετούνται API keys σε URLs, όπου η καταγραφή και άλλος χειρισμός μπορούν να τα εκθέσουν. Ακολουθήστε τη documented μέθοδο ελέγχου ταυτότητας του παρόχου και αφαιρέστε τις τιμές ελέγχου ταυτότητας από τα logs αιτημάτων και τις εξαγωγές διαγνωστικών δεδομένων.
Διαχωρίστε τα περιβάλλοντα και εντοπίστε την αναπτυγμένη έκδοση
Χρησιμοποιήστε ξεχωριστά διαπιστευτήρια ανάπτυξης, staging και παραγωγής όταν ο πάροχος τα υποστηρίζει. Όταν δεν είναι διαθέσιμα ξεχωριστά διαπιστευτήρια ή λογαριασμοί, καταγράψτε αυτόν τον περιορισμό και αποτρέψτε τις εργασίες non-production από την εκτέλεση μη ελεγχόμενων εγγραφών σε production.
Δώστε στο μυστικό μια λογική αναφορά διαμόρφωσης, όπως SHIPMENT_TRACKING_API_KEY. Καταγράψτε ξεχωριστά την έκδοση του secret manager ή μια μη ευαίσθητη ετικέτα ανάπτυξης. Αυτή η ετικέτα επιτρέπει στους χειριστές να απαντήσουν στο ερώτημα «Ποια έκδοση χρησιμοποιεί αυτός ο worker;» χωρίς να επιθεωρήσουν ή να καταγράψουν το ίδιο το διαπιστευτήριο.
Αποφασίστε ρητά τον τρόπο με τον οποίο οι εφαρμογές λαμβάνουν ενημερώσεις. Μια διεργασία που διαβάζει μια μεταβλητή περιβάλλοντος κατά την εκκίνηση συνήθως χρειάζεται επανεκκίνηση ή νέα ανάπτυξη για να λάβει μια αλλαγμένη τιμή. Ένα προσαρτημένο αρχείο μυστικού ή μια αναζήτηση κατά τον χρόνο εκτέλεσης έχει διαφορετική συμπεριφορά ανανέωσης. Η ενημέρωση του secret store δεν αποδεικνύει ότι κάθε εκτελούμενη διεργασία έχει υιοθετήσει την αντικατάσταση.
Κάντε τα αιτήματα ανακτήσιμα πριν από την περιστροφή
Αποθηκεύστε την εργασία παρακολούθησης πριν τη στείλετε στον πάροχο. Για την καταχώριση αποστολής, διατηρήστε ένα εσωτερικό αναγνωριστικό λειτουργίας, την αναφορά αποστολής, την κατάσταση επεξεργασίας και το ιστορικό επαναλήψεων. Διατηρήστε αυτό το επιχειρησιακό payload ξεχωριστά από τον έλεγχο ταυτότητας, ώστε οι εργασίες στην ουρά να μπορούν να χρησιμοποιούν το ενεργό διαπιστευτήριο κατά την εκτέλεσή τους.
Μην σειριοποιείτε API keys σε μηνύματα ουράς. Αυτό αφήνει τις καθυστερημένες εργασίες συνδεδεμένες με ένα παρωχημένο διαπιστευτήριο και διαδίδει μυστικά στην αποθήκευση ουρών, στις dead-letter queues και στα εργαλεία αποσφαλμάτωσης.
Για λειτουργίες εγγραφής, καθορίστε τους κανόνες χειρισμού διπλοτύπων του παρόχου πριν ενεργοποιήσετε τις επαναλήψεις. Ένα timeout δεν αποδεικνύει ότι η εγγραφή απέτυχε: ο πάροχος μπορεί να είχε αποδεχθεί το αίτημα πριν διακοπεί η σύνδεση. Χρησιμοποιήστε documented μηχανισμό idempotency, αν υπάρχει, ή συμφωνήστε την κατάσταση της αποστολής πριν την επανυποβολή.
Δημιουργήστε κατάλογο καταναλωτών και βασική γραμμή παρακολούθησης
Ο καταναλωτής που παραλείπεται πιο εύκολα συχνά δεν είναι η κύρια εφαρμογή. Καταγράψτε προγραμματισμένες εισαγωγές, workers ουρών, serverless functions, διαχειριστικά scripts, εργαλεία υποστήριξης, αναπτύξεις disaster recovery και υπηρεσίες που έχουν επί του παρόντος κλιμακωθεί στο μηδέν.
Για κάθε καταναλωτή, καταγράψτε τον υπεύθυνο, το περιβάλλον, την αναφορά μυστικού, τον μηχανισμό ανανέωσης, το πρόγραμμα εκτέλεσης και τη μέθοδο ανάπτυξης. Εντοπίστε εργασίες μεγάλης διάρκειας που μπορεί να διατηρούν διαπιστευτήρια στη μνήμη. Ελέγξτε επίσης επαναχρησιμοποιήσιμους HTTP clients που ενδέχεται να διατηρούν μια παλιά κεφαλίδα ελέγχου ταυτότητας μετά από αλλαγές διαμόρφωσης.
Πριν από τη μετάβαση, καθορίστε μια βασική γραμμή για:
- Αποτυχίες ελέγχου ταυτότητας, ομαδοποιημένες ανά υπηρεσία, περιβάλλον, endpoint και έκδοση ανάπτυξης.
- Καθυστέρηση απόκρισης παρόχου, timeouts, αποκρίσεις περιορισμού ρυθμού και σφάλματα διακομιστή.
- Βάθος ουράς, ηλικία της παλαιότερης εκκρεμούς εργασίας και όγκο dead-letter.
- Επιτυχείς καταχωρίσεις αποστολών και ανεπίλυτες προσπάθειες καταχώρισης.
- Υγεία λήψης και επεξεργασίας webhook, εάν τα webhooks αποτελούν μέρος της ενσωμάτωσης.
Διαχωρίστε την υγεία της ενσωμάτωσης από την κίνηση της αποστολής. Ένα δέμα χωρίς νέο γεγονός μεταφορέα δεν αποτελεί απαραίτητα ένδειξη αποτυχίας API. Κατά την περιστροφή, τα επιτυχή πιστοποιημένα αιτήματα και οι υγιείς ουρές επεξεργασίας είναι πιο άμεσα σήματα από τον αριθμό των αποστολών των οποίων άλλαξε η κατάσταση παράδοσης.
Πραγματοποιήστε περιστροφή με επικαλυπτόμενα keys όταν υποστηρίζονται
- Δημιουργήστε την αντικατάσταση χωρίς να ανακαλέσετε το ενεργό key. Επιβεβαιώστε ότι το παλιό διαπιστευτήριο παραμένει έγκυρο. Αποθηκεύστε το νέο διαπιστευτήριο ως ξεχωριστή έκδοση μυστικού και περιορίστε κατάλληλα την πρόσβαση.
- Επικυρώστε την αντικατάσταση μεμονωμένα. Χρησιμοποιήστε μια documented λειτουργία χαμηλού αντίκτυπου στο προβλεπόμενο περιβάλλον. Ελέγξτε τόσο το αποτέλεσμα HTTP όσο και οποιοδήποτε αποτέλεσμα σε επίπεδο εφαρμογής στο σώμα της απόκρισης.
- Δοκιμάστε μια αντιπροσωπευτική ροή εργασίας. Επικυρώστε τις λειτουργίες που χρειάζεται πραγματικά η εφαρμογή σας, όχι μόνο έναν βασικό έλεγχο συνδεσιμότητας. Εάν απαιτείται εγγραφή, χρησιμοποιήστε εξουσιοδοτημένη δοκιμαστική αποστολή και λάβετε υπόψη πιθανές επιπτώσεις σε quota ή χρέωση.
- Αναπτύξτε σε μια μικρή ομάδα καταναλωτών. Μετακινήστε μία ομάδα worker ή ένα instance εφαρμογής στην αντικατάσταση και, στη συνέχεια, ελέγξτε τον έλεγχο ταυτότητας, τα αποτελέσματα επεξεργασίας και τη συμπεριφορά της ουράς.
- Αναπτύξτε σε όλους τους υπόλοιπους καταναλωτές. Ενημερώνετε τον κατάλογο καθώς κάθε υπηρεσία φορτώνει ξανά ή επανεκκινείται. Συμπεριλάβετε προγραμματισμένες εργασίες, αδρανή workloads και διαμορφώσεις ανάκτησης.
- Παρακολουθήστε για κατάλληλο διάστημα επαλήθευσης. Καλύψτε τη σχετική διάρκεια ζωής worker, τη συμπεριφορά της cache διαμόρφωσης, την καθυστέρηση επανάληψης και το πρόγραμμα εργασιών. Δεν υπάρχει καθολική περίοδος αναμονής που να αποδεικνύει την υιοθέτηση.
- Ανακαλέστε το παλιό key και επαληθεύστε ξανά. Παρακολουθήστε για παλιούς καταναλωτές και, στη συνέχεια, αποσύρετε τις παλιές αναφορές μυστικών σύμφωνα με τις απαιτήσεις διατήρησης και απόκρισης σε περιστατικά.
Όταν δεν είναι διαθέσιμη αναφορά χρήσης key από την πλευρά του παρόχου, χρησιμοποιήστε αρχεία ανάπτυξης και ετικέτες έκδοσης μυστικού που αναφέρονται από την εφαρμογή για να επαληθεύσετε την υιοθέτηση. Αυτό παρέχει επιχειρησιακά στοιχεία, αλλά δεν αντικαθιστά έναν πλήρη κατάλογο καταναλωτών.
Αντιμετωπίστε την άμεση αντικατάσταση ως συντονισμένη μετάβαση
Εάν η έκδοση αντικαταστάτη ακυρώνει αμέσως το παλιό key, δεν μπορεί να εγγυηθεί αδιάλειπτος έλεγχος ταυτότητας μέσω rolling deployment. Σχεδιάστε τη μετάβαση έτσι ώστε η εργασία να καθυστερεί με ασφάλεια αντί να χάνεται.
- Προετοιμάστε την ανάπτυξη της εφαρμογής, την αναφορά μυστικού, την πρόσβαση χειριστών και τις εντολές ανάκτησης πριν αντικαταστήσετε το διαπιστευτήριο.
- Παύστε τα εξερχόμενα αιτήματα παρακολούθησης σε ελεγχόμενο όριο, ενώ συνεχίζετε, όπου είναι πρακτικό, να αποδέχεστε την εργασία σε ανθεκτική αποθήκευση.
- Αδειάστε ή καταγράψτε τα αιτήματα που βρίσκονται σε εξέλιξη. Σημειώστε τα αμφίβολα αποτελέσματα εγγραφής για συμφωνία αντί να τα αντιμετωπίζετε αυτόματα ως αποτυχίες.
- Αντικαταστήστε το διαπιστευτήριο του παρόχου, ενημερώστε το secret store και ανανεώστε κάθε καταναλωτή.
- Εκτελέστε ελέγχους ελέγχου ταυτότητας και ροής εργασίας πριν απελευθερώσετε ολόκληρο το backlog.
- Συνεχίστε σταδιακά την επεξεργασία, τηρώντας τα όρια ρυθμού του παρόχου και ελέγχοντας για διπλές εγγραφές.
Εάν η ενσωμάτωση δεν μπορεί να παύσει, να διατηρήσει την εργασία ή να ανανεώσει προβλέψιμα τα διαπιστευτήρια, διορθώστε αυτές τις αδυναμίες πριν από μια τακτική περιστροφή. Ωστόσο, σε περίπτωση ύποπτης παραβίασης, ο περιορισμός μπορεί να απαιτεί άμεση ανάκληση ακόμη και αν προκαλέσει προσωρινή διακοπή.
Διατηρήστε χωριστό τον έλεγχο ταυτότητας API από την ασφάλεια webhook
Ένα εξερχόμενο API key και ένα μυστικό επαλήθευσης εισερχόμενου webhook εξυπηρετούν διαφορετικούς σκοπούς. Μην θεωρείτε ότι η περιστροφή του ενός αλλάζει το άλλο ή ότι χρησιμοποιούν την ίδια τιμή. Ακολουθήστε ανεξάρτητα την documented συμπεριφορά ελέγχου ταυτότητας και παράδοσης webhook του παρόχου.
Κατά τη μετάβαση εξερχόμενων διαπιστευτηρίων, διατηρήστε ενεργή την εισαγωγή webhook, εκτός αν υπάρχει ξεχωριστός λόγος να τη σταματήσετε. Επικυρώνετε τα εισερχόμενα μηνύματα σύμφωνα με τις προδιαγραφές του παρόχου, αποδέχεστε τα με ανθεκτικό τρόπο πριν από την επιβεβαίωση όταν το επιτρέπει η αρχιτεκτονική και κάνετε την επεξεργασία ανεκτική σε διπλές παραδόσεις.
Μια επιτυχημένη πιστοποιημένη κλήση API δεν αποδεικνύει ότι η παράδοση ή η επεξεργασία webhook είναι υγιής. Ελέγχετε τις δύο διαδρομές ξεχωριστά και αποφεύγετε την αλλαγή και των δύο διαπιστευτηρίων στην ίδια εργασία συντήρησης, εκτός αν το απαιτεί ο σχεδιασμός του παρόχου.
Αντιμετωπίστε τις αποτυχίες χωρίς να δημιουργήσετε καταιγισμό επαναλήψεων
| Σύμπτωμα | Πρώτοι έλεγχοι | Ασφαλής απόκριση |
|---|---|---|
| Αποτυχίες ελέγχου ταυτότητας μετά την ανάπτυξη | Έκδοση μυστικού, μορφή κεφαλίδας, περιβάλλον, κενά διαστήματα, clients με cache | Σταματήστε τις τυφλές επαναλήψεις· διορθώστε τη διαμόρφωση και επικυρώστε ένα αίτημα. |
| Αποτυγχάνουν μόνο ορισμένοι workers | Παλιές διεργασίες, παραλειφθείσες αναπτύξεις, καθυστερημένες εργασίες, παλιές caches μυστικών | Ανανεώστε τους επηρεαζόμενους καταναλωτές και συγκρίνετε τις ετικέτες έκδοσης. |
| Περιορισμοί ρυθμού κατά την ανάκτηση | Ρυθμός απελευθέρωσης backlog και συνολικός ταυτόχρονος αριθμός | Περιορίστε την ανάκτηση και ακολουθήστε τις documented οδηγίες επανάληψης. |
| Η εγγραφή λήγει λόγω timeout | Αν ο πάροχος έχει ήδη αποδεχθεί τη λειτουργία | Κάντε συμφωνία ή χρησιμοποιήστε documented idempotency πριν από την επανάληψη. |
Το HTTP 401 αφορά γενικά ελλιπή ή μη έγκυρο έλεγχο ταυτότητας, ενώ το 403 σημαίνει ότι ο διακομιστής αρνείται το αίτημα. Τα response bodies που αφορούν συγκεκριμένα τον πάροχο μπορεί να εξηγούν την αιτία με μεγαλύτερη ακρίβεια. Μην ταξινομείτε κάθε 403 ως ληγμένο key και μην υποθέτετε ότι κάθε ανεπιτυχής λειτουργία χρησιμοποιεί κωδικό σφάλματος HTTP.
Χρησιμοποιήστε περιορισμένες επαναλήψεις με backoff και jitter για τις κατάλληλες προσωρινές αποτυχίες. Η επανειλημμένη υποβολή μη έγκυρου διαπιστευτηρίου δεν θα το διορθώσει. Ειδοποιήστε έναν χειριστή, διατηρήστε την εργασία και αποτρέψτε ένα σφάλμα διαμόρφωσης από το να μετατραπεί σε ανεξέλεγκτο καταιγισμό αιτημάτων.
Καθορίστε την επαναφορά και την ολοκλήρωση πριν από την αλλαγή
Για περιστροφή με επικαλυπτόμενα keys, η επαναφορά μπορεί να σημαίνει προσωρινή επιστροφή των καταναλωτών στο παλιό διαπιστευτήριο όσο αυτό παραμένει έγκυρο και αξιόπιστο. Μετά την ανάκληση, αυτή η επιλογή δεν υπάρχει πλέον. Εάν το παλιό key ενδέχεται να έχει παραβιαστεί, μην το επαναφέρετε απλώς για να ανακτήσετε τη διαθεσιμότητα· εκδώστε άλλο διαπιστευτήριο και συνεχίστε προς τα εμπρός.
Ολοκληρώστε την περιστροφή μόνο όταν όλοι οι καταγεγραμμένοι καταναλωτές χρησιμοποιούν την αντικατάσταση, τα σφάλματα ελέγχου ταυτότητας έχουν επιστρέψει στη βασική τους γραμμή, η εργασία στην ουρά ανακάμπτει, οι αμφίβολες εγγραφές έχουν συμφωνηθεί και η επεξεργασία webhook παραμένει υγιής. Καταγράψτε τον υπεύθυνο, τον χρόνο ολοκλήρωσης, την αναπτυγμένη έκδοση μυστικού και το αποτέλεσμα ανάκλησης χωρίς να καταγράψετε την τιμή του key.
Για συνεχή ασφάλεια API, επιλέξτε πρόγραμμα περιστροφής με βάση την οργανωτική πολιτική, τον κίνδυνο έκθεσης διαπιστευτηρίων και τις δυνατότητες του παρόχου. Πραγματοποιήστε περιστροφή εκτός προγράμματος μετά από υποψία διαρροής ή ακατάλληλης πρόσβασης. Μια επαναλήψιμη, δοκιμασμένη διαδικασία είναι πιο χρήσιμη από μια αυθαίρετη συχνότητα που η ενσωμάτωση δεν μπορεί να υποστηρίξει με ασφάλεια.
Συχνές ερωτήσεις
Μπορώ να περιστρέψω ένα tracking API key χωρίς διακοπή λειτουργίας;
Ενδεχομένως, εάν ο πάροχος υποστηρίζει ταυτόχρονα διαπιστευτήρια και κάθε καταναλωτής μπορεί να μεταφερθεί πριν από την ανάκληση. Εάν η αναδημιουργία απενεργοποιεί αμέσως το παλιό key, σχεδιάστε ελεγχόμενη διακοπή των εξερχόμενων αιτημάτων. Οι ανθεκτικές ουρές μπορούν να διατηρήσουν την εργασία κατά το διάστημα αυτό, αλλά δεν καθιστούν τη σύνδεση με τον πάροχο συνεχώς διαθέσιμη.
Πρέπει οι εργασίες αποστολών στην ουρά να περιέχουν το API key;
Όχι. Αποθηκεύστε τη λειτουργία αποστολής και τα μεταδεδομένα επεξεργασίας της και, στη συνέχεια, επιλύστε το ενεργό διαπιστευτήριο όταν εκτελείται ο worker. Αυτό μειώνει την έκθεση του μυστικού και αποτρέπει τις καθυστερημένες εργασίες από την επανειλημμένη χρήση ενός ακυρωμένου key.
Η περιστροφή του key διαγράφει τις καταχωρισμένες αποστολές;
Μην θεωρείτε δεδομένο κανένα από τα δύο αποτελέσματα. Επιβεβαιώστε αν οι καταχωρισμένες αποστολές και οι σχετικές ρυθμίσεις συνδέονται με τον λογαριασμό, την εφαρμογή ή το διαπιστευτήριο. Η επιτυχία του ελέγχου ταυτότητας από μόνη της δεν αποδεικνύει ότι η αντικατάσταση έχει πρόσβαση στις αναμενόμενες εγγραφές αποστολών.
Τι πρέπει να κάνω αν ένα key εμφανιστεί σε repository ή log;
Αντιμετωπίστε το ως πιθανώς παραβιασμένο. Ανακαλέστε ή αντικαταστήστε το άμεσα, ελέγξτε τις εγγραφές πρόσβασης και χρήσης όπου είναι διαθέσιμες και ακολουθήστε τη διαδικασία απόκρισης σε περιστατικά. Η αφαίρεση της εμφανιζόμενης τιμής δεν αρκεί, επειδή αντίγραφα μπορεί να παραμένουν στο ιστορικό, σε εξαγωγές logs ή σε άλλα συστήματα.
Πώς μπορώ να καταλάβω αν μια παλιά προγραμματισμένη εργασία εξακολουθεί να χρησιμοποιεί το προηγούμενο key;
Ελέγξτε την αναφορά μυστικού, τη διαμορφωμένη ανάπτυξη και τη συμπεριφορά ανανέωσης κατά τον χρόνο εκτέλεσης. Εκτελέστε την μέσω ελεγχόμενης εκτέλεσης όπου είναι ασφαλές ή επαληθεύστε την ανάπτυξή της πριν από την επόμενη προγραμματισμένη εκκίνηση. Ένας αδρανής πίνακας ελέγχου δεν αποδεικνύει ότι ένας σπάνια χρησιμοποιούμενος καταναλωτής έχει μεταφερθεί.
Πηγές
- Τεκμηρίωση 17TRACK Tracking API — αναφορά παρόχου για τη διαμόρφωση της ενσωμάτωσης και τον έλεγχο του documented συμβολαίου αιτημάτων.
- 17TRACK Tracking API — επίσημο πλαίσιο προϊόντος για ενσωματώσεις παρακολούθησης αποστολών.
- OWASP Secrets Management Cheat Sheet — οδηγίες για αποθήκευση μυστικών, ελέγχους πρόσβασης, auditing, περιστροφή και κύκλο ζωής.
- OWASP REST Security Cheat Sheet — χειρισμός διαπιστευτηρίων API και πρακτικές ασφάλειας REST.
- RFC 9110: HTTP Semantics — κωδικοί κατάστασης που σχετίζονται με τον έλεγχο ταυτότητας HTTP και ζητήματα αυτόματης επανάληψης αιτημάτων.


