Guida All'Installazione

1. Prerequisiti

• ASP.NET Core Runtime 6: Scaricare e installare l'ultima versione dell'Hosting Bundle di ASP.NET Core Runtime 6 (Scarica).
• Microsoft SQL Server: Scaricare e installare l'ultima versione di Microsoft SQL Server (Scarica).
  Scegliere l'installazione Custom e, durante l'installazione, abilitare l'autenticazione ibrida scegliendo una password per l'utente sa.
  Completata l'installazione, creare un database chiamato CleverSuite.
• IIS: Aggiungere dal Server Manager il ruolo Web Server (IIS)
  Tra le funzionalità di IIS, aggiungere: Application Development e tutte le funzionalità al suo interno, IIS 6 Management Compatibility.
  
• URL Rewrite Module: Scaricare e installare il modulo URL Rewrite per IIS per permettere il redirect HTTPS automatico. (Scarica)
• WIN-ACME: Scaricare e installare WIN-ACME per poter generare i certificati Let's Encrypt. (Scarica)
• ID Manager: Scaricare e installare l'ID Manager di Instant Developer (Scarica). Lasciare le configurazioni di default.
• Apertura Porte: Il server dev'essere raggiungibile sulle porte 80 e 443.

2. Configurazione ID Manager

• Aprire le proprietà di C:\inetpub\wwwroot e assegnare al gruppo IIS_IUSRS il controllo completo.
• Aprire la console di IIS eliminare il Default Web Site e creare un site con le seguenti proprietà:
  Nome: IDManager
  Physical path: C:\inetpub\wwwroot\IDManager
  Host name: DNS che si vorrà creare per l'accesso all'IDManager (solitamente appserver.nomeazienda.cleversuite.it)
• Fare click col tasto destro sul site appena creato, andare su Manage Website -> Advanced Settings e impostare i seguenti valori:
  Preload Enabled: True
• Andare su Application Pools, fare click col tasto destro sul pool IDManager, andare su Advanced Settings e impostare i seguenti valori:
  Enabled 32-Bit Applications: True
  Start Mode: AlwaysRunning
• Creare il DNS impostato per l'IDManager in modo che punti all'IP pubblico del server.
• Avviare WIN-ACME e procedere alla generazione del certificato per l'IDManager con i seguenti comandi:
  N -> Create certificate (default settings),
  Numero del sito dell'IDManager (Di norma 1),
  A -> Pick *all* bindings,
  Invio -> Continua con questa selezione,
  2 volte Invio nel caso venga richiesta l'accettazione dei termini di servizio,
  Inserire un'email per gli avvisi di scadenza dei certificati (Solitamente assistenza@opensolution.it).
• Aprire la console IIS, cliccare sul site IDManager e poi sul modulo URL Rewrite. Cliccare su Add Rule sulla destra e creare una nuova regola inserendo i seguenti parametri:
  Rule Template: Blank Rule,
  Name: HTTPS Redirect
  Sezione Match URL
  Requested URL: Matches the Pattern,
  Using: Regular Expressions,
  Pattern: (.*),
  Ignore Case: Check
  Sezione Conditions
  Logical Grouping: Match All,
  Cliccare su Add per aggiungere una condizione,
  Condition input: {HTTPS},
  Check if input string: Matches the Pattern,
  Pattern: ^OFF$,
  Ignore case: Check,
  Cliccare su Ok
  Sezione Action
  Action type: Redirect,
  Rewrite URL: https://{HTTP_HOST}/{REQUEST_URI},
  Append query string: Uncheck,
  Redirect type: Permanent (301)
  Cliccare su Apply sulla destra.
• Accedere all'IDManager tramite il DNS appena creato e creare l'utente per l'accesso tramite il wizard che si apre.
• Una volta creato l'utente, cliccare su Configure domain per configurare l'IDManager inserendo i seguenti valori:
  Application path: C:/inetpub/wwwroot/
  Web Server Username: Administrator (Aggiungere anche il dominio se presente)
  Web Server Password: La password dell'utente Administrator di Windows

3. Installazione CleverSuite

• Aprire il progetto di CleverSuite su Instant Developer e cliccare su Pubblica.
• Inserire i seguenti dati nell'interfaccia di pubblicazione e poi cliccare su Avanti:
  Url Manager: https://[URL_IDMANAGER]/IDManager.aspx
  E-mail utente: L'email scelta come username durante la configurazione del manager
  Password: La password scelta durante la configurazione del manager
• Verrà restituito un errore di connessione al database. Collegarsi all'interfaccia web dell'IDManager, effettuare il login, cliccare sulla lente di ingrandimento accanto all'applicazione CleverSuite e modificare i seguenti parametri:
  Sezione Dati Applicazione
  Url: Inserire l'URL che verrà utilizzata per CleverSuite (Solitamente nomeazienda.cleversuite.it)
  Sezione Database
  Aprire la configurazione di CleverSuite DB e modificare Username, Password e Connection String in base alla configurazione del database effettuata in precedenza.
• Riaprire l'interfaccia di pubblicazione del Progetto CleverSuite su Instant Developer, cliccare nuovamente su Avanti e poi su Pubblica.
• Aprire la console di IIS sul server e creare un site con le seguenti proprietà:
  Nome: CleverSuite
  Physical path: C:\inetpub\wwwroot\CleverSuite
  Host name: DNS che si vorrà creare per l'accesso a CleverSuite (solitamente nomeazienda.cleversuite.it)
• Fare click col tasto destro sul site appena creato, andare su Manage Website -> Advanced Settings e impostare i seguenti valori:
  Preload Enabled: True
• Andare su Application Pools, fare click col tasto destro sul pool CleverSuite, andare su Advanced Settings e impostare i seguenti valori:
  Enabled 32-Bit Applications: False
  Start Mode: AlwaysRunning
• Creare il DNS impostato per CleverSuite in modo che punti all'IP pubblico del server.
• Avviare WIN-ACME e procedere alla generazione del certificato per CleverSuite con i seguenti comandi:
  N -> Create certificate (default settings),
  Numero del sito di CleverSuite (Di norma 2),
  A -> Pick *all* bindings,
  Invio -> Continua con questa selezione,
  
• Aprire la console IIS, cliccare sul site IDManager e poi sul modulo URL Rewrite. Cliccare su Add Rule sulla destra e creare una nuova regola inserendo i seguenti parametri:
  Rule Template: Blank Rule,
  Name: HTTPS Redirect
  Sezione Match URL
  Requested URL: Matches the Pattern,
  Using: Regular Expressions,
  Pattern: (.*),
  Ignore Case: Check
  Sezione Conditions
  Logical Grouping: Match All,
  Cliccare su Add per aggiungere una condizione,
  Condition input: {HTTPS},
  Check if input string: Matches the Pattern,
  Pattern: ^OFF$,
  Ignore case: Check,
  Cliccare su Ok
  Sezione Action
  Action type: Redirect,
  Rewrite URL: https://{HTTP_HOST}/{REQUEST_URI},
  Append query string: Uncheck,
  Redirect type: Permanent (301)
  Cliccare su Apply sulla destra.
• Accedere a CleverSuite da web e completare la configurazione tramite il Wizard di prima configurazione.