Ενεργοποίηση HTTPS για πιο ασφαλή επικοινωνία api

Επισκόπηση

Αυτός ο οδηγός περιγράφει τα απαραίτητα βήματα για τη διαμόρφωση της διεπαφής REST (swagger) του RetailForce Middleware ώστε να χρησιμοποιεί HTTPS.

Προαπαιτούμενα

• Πρόσβαση στον κεντρικό υπολογιστή των Windows
• Επεξεργαστής κειμένου (π.χ., Notepad++ ή Visual Studio Code)

Οδηγός βήμα προς βήμα

1. Διακοπή της υπηρεσίας των Windows

1. Ανοίξτε τη Διαχείριση υπηρεσιών των Windows:
   • Πατήστε Win + R, πληκτρολογήστε services.msc και πατήστε Enter
   • Εναλλακτικά: Μέσω του Πίνακα Ελέγχου → Εργαλεία Διαχείρισης → Υπηρεσίες
2. Εντοπίστε την υπηρεσία RetailForce στη λίστα
3. Κάντε δεξί κλικ στην υπηρεσία και επιλέξτε «Διακοπή»

2. Επεξεργασία αρχείου διαμόρφωσης

1. Μεταβείτε στον κατάλογο εγκατάστασης:

   • C:\Program Files\RetailForce\Fiscal Webservice

2. Ανοίξτε το αρχείο appsettings.json με ένα πρόγραμμα επεξεργασίας κειμένου
3. Βεβαιωθείτε ότι οι ακόλουθες παράμετροι στην ενότητα «AppSettings» έχουν ρυθμιστεί σωστά:

   ...  
   "AppSettings": {
       "Secret": "****",
       "Portnumber": 7678,
       "PortnumberHttps": 7677,
       "UseHttps": true,
       "UseHttpsRedirection": true,
       "HttpsCertificateFilename": "development.pfx",
       "HttpsCertificatePassword": "changeme",
       "LogName": "RetailForce Fiscalisation",
       "LogEventLog": true,
       "LogLevelFilter": "Debug"
     }
   }
   

   Σημαντικό :

   • Βεβαιωθείτε ότι και οι δύο UseHttps και UseHttpsRedirection έχουν οριστεί σε true
   • Η διαδρομή για το HttpsCertificateFilename είναι σχετική με τον κατάλογο εγκατάστασης
   • Για περιβάλλοντα παραγωγής, χρησιμοποιήστε ένα έγκυρο, αξιόπιστο πιστοποιητικό αντί για το "development.pfx"

4. Αποθηκεύστε το αρχείο και κλείστε τον επεξεργαστή

3. Εκκίνηση της υπηρεσίας των Windows

1. Επιστρέψτε στη Διαχείριση Υπηρεσιών των Windows
2. Εντοπίστε την υπηρεσία RetailForce
3. Κάντε δεξί κλικ στην υπηρεσία και επιλέξτε «Έναρξη»

4. Επαλήθευση

Μετά την επανεκκίνηση της υπηρεσίας, τα τελικά σημεία REST θα πρέπει πλέον να είναι διαθέσιμα μέσω HTTPS:

1. Ανοίξτε έναν περιηγητή ιστού
2. Μεταβείτε στο Swagger UI στη διεύθυνση:

   https://[server-name]:7677/swagger/index.html

3. Βεβαιωθείτε ότι εμφανίζεται ένα εικονίδιο κλειδώματος στη γραμμή διευθύνσεων, το οποίο υποδηλώνει ασφαλή σύνδεση HTTPS

Σύνοψη

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

Αυτό το άρθρο μεταφράστηκε αυτόματα.