Installazione e configurazione Microsoft IIS
Prima di iniziare
La guida è stata realizzata utilizzando Windows Server 2019 in lingua inglese.
Le istruzioni riportate nel paragrafo Installazione Microsoft Internet Information Server (IIS) sono valide quando IIS non è già installato sul server. Quando IIS è già presente la procedura guidata mostra una sequenza differente
Verifica requisiti
- Verificare associazione indirizzo ip server / nome host:
Per esempio
- certificato con nome: 80627650_mgr.emmebit.app.pfx
- nome host è mgr.emmebit.app
Eseguire il comando “ping mgr.emmebit.app” e verificare che venga restituito il messaggio “Esecuzione di Ping mgr.emmebit.app [10.163.38.34] …” dove “10.163.38.34” è l’indirizzo ip del server
- Presenza del .NET Framework
Installazione Microsoft Internet Information Server (IIS)
- Avviare Server Manager (Start => Run, digitare servermanager e premere INVIO)
- In alto a destra, dal menu Manage, selezionare Add Roles and Features
- Nella videata sottostante premere Next
- Nella videata sottostante selezionare Role-based or feature-based installation e premere Next
- Nella videata sottostante selezionare Select a server from the server pool e, dalla griglia, selezionare il server su cui installare Microsoft Internet Information Server
- Nella videata sottostante selezionare Web Server (IIS)
- Confermare la videata sottostante premendo il pulsante Add Features
- Premere il pulsante Next
- Nella videata sottostante premere il pulsante Next
- Nella videata sottostante premere il pulsante Next
- Nella videata sottostante selezionare:
- Default Document
- HTTP Logging
- Static Content Compression
- Dynamic Content Compression
- Request Filtering
- .NET Extensibility 4.x
- ASP.NET 4.x
- Application Initialization
- ISAPI Extensions
- ISAPI Filters
- IIS Management Console
- premere il pulsante Next
- nella videata sottostante verificare la presenza di tutti i componenti richiesti e premere Install
- Al termine dell’installazione premere il pulsante Close
Importazione certificato SSL
- Avviare IIS Manager (Start => Run, digitare inetmgr e premere INVIO)
- Nella sezione di sinistra selezionare il server
- Nella sezione centrale fare doppio click su Server Certificates
- Nella sezione di destra cliccare su Import
- Utilizzare la funzione di ricerca per selezionare il certificato SSL (file con estensione pfx), indicare la password comunicata da Emmebit Sistemi insieme al certificato, selezionare Web Hosting per l’opzione Select Certificate Store
- Premere il pulsante OK
Verifica attivazione compressione
- Nella sezione di sinistra selezionare il server
- Nella sezione centrale fare doppio click su Compression
- Verificare che le opzioni Enable dynamic content compression ed Enable static content compression siano spuntate
Creazione cartella di base nel file system
- Aprire Esplora Risorse e posizionarsi nella cartella C:\inetpub\wwwroot
- Creare una nuova cartella e denominarla Emmebit_Sistemi
Creazione sito web
- Avviare IIS Manager (Start => Run, digitare inetmgr e premere INVIO)
- Nella sezione di sinistra selezionare il server e aprire il nodo
- Nella sezione di sinistra selezionare Sites
- Fare click destro su Sites e selezionare Add Website
- Indicare Emmebit Sistemi per il parametro Site name
- Per il parametro Physical path selezionare la cartella creata al paragrafo Creazione cartella di base nel file system
- Selezionare https per il parametro Type
- Impostare 44300 per il parametro Port
- Per il parametro SSL certificate selezionare il certificato corrispondente al file importato al paragrafo Importazione certificato SSL
Creazione utente Windows
Per questa attività va identificata la casistica corretta.
Casistica 1: IIS e SQL installati sullo stesso server
Per questa casistica non è necessario creare un utente Windows dedicato all'esecuzione dei servizi REST.
Casistica 2: IIS e SQL installati su server distinti
Attenzione: Per la corretta esecuzione dei servizi REST è necessario creare un utente Windows dedicato e dotato dei seguenti requisiti:
- privilegi di “user”: per ragioni di sicurezza non deve essere associato a gruppi con privilegi più elevati
- permessi di lettura sulla cartella ..\SISTEMI. L’utente deve essere in grado di accedere alla condivisione \\{nome server}\SISTEMI e di scrivere nel path adibito all'esportazione dei file TXT (per es. \\{nome server}\SISTEMI\LOGISTICA_LITE)
Per convenzione l’utente è denominato emmebitsistemi; la password di questo utente non deve avere scadenza.
Configurazione application pool
- Nella sezione di sinistra selezionare il server e aprire il nodo
- Nella sezione di sinistra selezionare Application Pools
- Nella sezione centrale selezionare l’application pool Emmebit Sistemi
- Nella sezione di destra cliccare su Advanced Settings
- selezionare AlwaysRunning per l’opzione Start Mode (Modalità avvio)
- Per il parametro Identity (Identità):
- se Casistica 1 del paragrafo Creazione utente Windows: lasciare il valore proposto (ApplicationPoolIdentity)
- se Casistica 2 del paragrafo Creazione utente Windows: cliccare sui 3 puntini, selezionare l’opzione Custom account, infine premere il pulsante Set per impostare l’account creato al paragrafo Creazione utente Windows
- Impostare 0 per il parametro Idle Time-out (Timeout di inattività)
- Impostare 0 per il parametro Regular Time Interval (Intervallo di tempo regolare)
Configurazione firewall di Windows
Qualora il firewall di Windows fosse attivo, è necessario aggiungere una regola in ingresso per consentire il traffico sulla porta (default 44300) indicata nel paragrafo Creazione sito web
Altre impostazioni
- Nella sezione di sinistra selezionare il server
- Nella sezione centrale fare doppio click su Configuration Editor
- In alto, dalla combo Section, selezionare system.webServer/httpCompression
- Nella sezione centrale selezionare la voce dynamicTypes
- Cliccare sui 3 puntini a destra
- Nella sezione di destra cliccare su Add. Selezionare True per il parametro enabled e impostare application/json per il parametro mimeType
- Chiudere la finestra
- Selezionare la voce staticTypes
- Cliccare sui 3 puntini a destra
- Nella sezione di destra cliccare su Add. Selezionare True per il parametro enabled e impostare image/* per il parametro mimeType
- Chiudere la finestra
- Nella sezione di destra cliccare su Apply
- In alto, dalla combo Section, selezionare system.webServer/asp
- Impostare a 20000000 il parametro limits/maxRequestEntityAllowed
- Nella sezione di destra cliccare su Apply
- In alto, dalla combo Section, selezionare system.web/httpRuntime
- Impostare a 40960 il parametro maxRequestLength
- Nella sezione di destra cliccare su Apply