Connettersi a un servizio protetto con il proxy inverso

In questo articolo viene spiegato come stabilire una connessione protetta tra il proxy inverso e i servizi, abilitando un canale protetto end-to-end. Per altre informazioni sul proxy inverso, vedere Proxy inverso in Azure Service Fabric

Stabilire una connessione protetta tra il proxy inverso e i servizi

Autenticazione del proxy inverso per i servizi:

Il proxy inverso si autoidentifica per i servizi usando il relativo certificato. Per i cluster di Azure, il certificato è specificato con la proprietà reverseProxyCertificate nella sezione relativa al tipo di risorsa Microsoft.ServiceFabric/clusters del modello di Resource Manager. Per i cluster autonomi, il certificato è specificato tramite la proprietà ReverseProxyCertificate o ReverseProxyCertificateCommonNames nella sezione Sicurity di ClusterConfig.json. Per altre informazioni, vedere Abilitare il proxy inverso nei cluster autonomi.

I servizi possono implementare la logica per verificare il certificato presentato dal proxy inverso. I servizi possono specificare i dettagli del certificato client accettati come impostazioni di configurazione nel pacchetto di configurazione. Questo può essere letto in fase di runtime e usato per convalidare il certificato presentato dal proxy inverso. Fare riferimento a Gestire i parametri dell'applicazione per aggiungere le impostazioni di configurazione.

Verifica dell'identità del servizio da parte del proxy inverso tramite il certificato presentato dal servizio:

Per eseguire la convalida del certificato del server per i certificati presentati dai servizi, il proxy inverso supporta i criteri seguenti: None, ServiceCommonNameAndIssuer e ServiceCertificateThumbprints. Per selezionare i criteri da usare per il proxy inverso, specificare ApplicationCertificateValidationPolicy nella sezione ApplicationGateway/Http in fabricSettings.

La prossima sezione illustra i dettagli di configurazione per ognuna di queste opzioni.

Opzioni di convalida dei certificati del servizio

• None: il proxy inverso ignora la verifica del certificato del servizio di proxy e stabilisce la connessione sicura. Si tratta del comportamento predefinito. Specificare ApplicationCertificateValidationPolicy con il valore None nella sezione ApplicationGateway/Http.

  {
  "fabricSettings": [
             ...
             {
               "name": "ApplicationGateway/Http",
               "parameters": [
                 {
                   "name": "ApplicationCertificateValidationPolicy",
                   "value": "None"
                 }
               ]
             }
           ],
           ...
  }
  

• ServiceCommonNameAndIssuer: il proxy inverso verifica il certificato presentato dal servizio in base al nome comune del certificato e all'identificazione personale immediata dell'autorità di certificazione: specificare ApplicationCertificateValidationPolicy con il valore ServiceCommonNameAndIssuer nella sezione ApplicationGateway/Http.

  {
  "fabricSettings": [
             ...
             {
               "name": "ApplicationGateway/Http",
               "parameters": [
                 {
                   "name": "ApplicationCertificateValidationPolicy",
                   "value": "ServiceCommonNameAndIssuer"
                 }
               ]
             }
           ],
           ...
  }
  

  Per specificare l'elenco di nomi comuni del servizio e di identificazioni personali dell'autorità di certificazione, aggiungere una sezione ApplicationGateway/Http/ServiceCommonNameAndIssuer in fabricSettings, come illustrato di seguito. Nella matrice di parametri è possibile aggiungere più coppie nome comune del certificato/identificazione personale dell'autorità di certificazione.

  Se il proxy inverso dell'endpoint si connette per presentare un certificato il cui nome comune e l'identificazione personale dell'autorità di certificazione corrisponde a uno qualsiasi dei valori specificati in questo caso, viene stabilito il canaleTLS. In caso di errore nella corrispondenza dei dettagli del certificato, il proxy inverso non esegue correttamente la richiesta del client e presenta un codice di stato 502, ovvero Gateway non valido. La riga di stato HTTP conterrà anche la frase "Invalid SSL Certificate" (Certificato SSL non valido).

  {
  "fabricSettings": [
             ...
             {
               "name": "ApplicationGateway/Http/ServiceCommonNameAndIssuer",
               "parameters": [
                 {
                   "name": "WinFabric-Test-Certificate-CN1",
                   "value": "b3 44 9b 01 8d 0f 68 39 a2 c5 d6 2b 5b 6c 6a c8 22 b4 22 11"
                 },
                 {
                   "name": "WinFabric-Test-Certificate-CN2",
                   "value": "b3 44 9b 01 8d 0f 68 39 a2 c5 d6 2b 5b 6c 6a c8 22 11 33 44"
                 }
               ]
             }
           ],
           ...
  }
  

• ServiceCertificateThumbprints: il proxy inverso consente di verificare il certificato del servizio del proxy in base all'identificazione personale. Se i servizi sono configurati con certificati autofirmati, è possibile scegliere di intraprendere questa strada: specificare ApplicationCertificateValidationPolicy con il valore ServiceCertificateThumbprints nella sezione ApplicationGateway/Http.

  {
  "fabricSettings": [
             ...
             {
               "name": "ApplicationGateway/Http",
               "parameters": [
                 {
                   "name": "ApplicationCertificateValidationPolicy",
                   "value": "ServiceCertificateThumbprints"
                 }
               ]
             }
           ],
           ...
  }
  

  Specificare le identificazioni personali anche con una voce ServiceCertificateThumbprints nella sezione ApplicationGateway/Http. Nel campo del valore è possibile specificare più identificazioni personali come un elenco delimitato da virgole, come illustrato di seguito:

  {
  "fabricSettings": [
             ...
             {
               "name": "ApplicationGateway/Http",
               "parameters": [
                   ...
                 {
                   "name": "ServiceCertificateThumbprints",
                   "value": "78 12 20 5a 39 d2 23 76 da a0 37 f0 5a ed e3 60 1a 7e 64 bf,78 12 20 5a 39 d2 23 76 da a0 37 f0 5a ed e3 60 1a 7e 64 b9"
                 }
               ]
             }
           ],
           ...
  }
  

  Se l'identificazione personale del certificato del server è elencata in questa voce di configurazione, il proxy inverso esegue correttamente la connessione TLS. In caso contrario, termina la connessione e non esegue correttamente la richiesta del client con un errore 502, ovvero Gateway non valido. La riga di stato HTTP conterrà anche la frase "Invalid SSL Certificate" (Certificato SSL non valido).

Logica di scelta dell'endpoint quando i servizi espongono endpoint sicuri e non sicuri

Service Fabric supporta la configurazione di più endpoint per un servizio. Per altre informazioni, vedere Specificare le risorse in un manifesto del servizio.

Il proxy inverso consente di selezionare uno degli endpoint per l'inoltro della richiesta in base al parametro di query ListenerName nell'URI del servizio. Se il parametro ListenerName non viene specificato, il proxy inverso può scegliere un endpoint qualsiasi dall'elenco degli endpoint. A seconda degli endpoint configurati per il servizio, l'endpoint selezionato può essere un endpoint HTTP o HTTPS. Possono esistere requisiti o scenari in cui si vuole che il proxy inverso operi in "modalità solo endpoint protetti", per evitare che il proxy inverso protetto inoltri richieste a endpoint non protetti. Per impostare la modalità solo endpoint protetti per il proxy inverso, impostare la voce di configurazione SecureOnlyMode sul valore true nella sezione ApplicationGateway/Http.

{
"fabricSettings": [
          ...
          {
            "name": "ApplicationGateway/Http",
            "parameters": [
                ...
              {
                "name": "SecureOnlyMode",
                "value": true
              }
            ]
          }
        ],
        ...
}

Configurazione dell'autenticazione del certificato client tramite il proxy inverso

La terminazione SSL si verifica sul proxy inverso e si perdono tutti i dati del certificato client. Perché i servizi eseguano l'autenticazione del certificato client, specificare l'impostazione ForwardClientCertificate nella sezione ApplicationGateway/Http.

1. Se ForwardClientCertificate è impostato su false, il proxy inverso non richiede il certificato client durante l'handshake TLS con il client. Si tratta del comportamento predefinito.

2. Se ForwardClientCertificate è impostato su true, il proxy inverso richiede il certificato client durante l'handshake TLS con il client. I dati del certificato client verranno quindi inviati in un'intestazione HTTP personalizzata denominata X-Client-Certificate. Il valore dell'intestazione è la stringa in formato PEM con codifica base64 del certificato del client. Il servizio può eseguire correttamente o meno la richiesta con il codice di stato appropriato dopo aver esaminato i dati del certificato. Se il client non presenta un certificato, il proxy inverso inoltra un'intestazione vuota e il caso viene gestito dal servizio.

Passaggi successivi

• Configurare il proxy inverso in un cluster.
• Vedere Configurare il proxy inverso per connettersi ai servizi protetti
• Vedere un esempio di comunicazione HTTP tra i servizi in un progetto di esempio in GitHub.
• Chiamate di procedura remota con i Reliable Services remoti
• Web API che usa OWIN in Reliable Services
• Gestire i certificati cluster