Condividi tramite

Procedura: impostare un agente di compilazione per l'utilizzo di HTTPS e Secure Sockets Layer (SSL)

  • Articolo

Aggiornamento: novembre 2007

Per configurare un agente di compilazione per le connessioni SSL, è necessario configurare un certificato HTTPS per ogni combinazione di indirizzo IP e porta. Se tutti gli agenti di compilazione condividono la stessa porta sul computer di compilazione, è necessario configurare un solo certificato. Se si eseguono più agenti di compilazione su più porte, è necessario configurare un certificato per ogni porta.

Prima di configurare un agente di compilazione per le connessioni SSL, assicurarsi che siano soddisfatti i prerequisiti seguenti:

Per configurare un agente di compilazione per richiedere SSL, eseguire le attività seguenti in sequenza:

  1. Creare e configurare l'agente di compilazione per richiedere HTTPS.

  2. Arrestare il servizio Visual Studio Team Foundation Build.

  3. Modificare la configurazione del servizio di compilazione per richiedere HTTPS.

  4. Associare un certificato all'indirizzo IP e alla porta.

  5. Configurare la porta e il protocollo per l'agente di compilazione.

  6. Riavviare il servizio Visual Studio Team Foundation Build.

  7. Verificare la configurazione SSL.

Autorizzazioni necessarie

Per completare questa procedura, è necessario essere membro del gruppo Administrators sul computer in cui è installato Team Foundation Build. Per ulteriori informazioni, vedere Autorizzazioni per Team Foundation Server.

Per configurare l'agente di compilazione per richiedere HTTPS

  1. Nella finestra di dialogo Gestisci agenti di compilazione selezionare la casella di controllo Richiedi canale sicuro (HTTPS).

    Per ulteriori informazioni, vedere la classe Procedura: creare e gestire agenti di compilazione.

  2. Fare clic su Modifica.

  3. Nella finestra di dialogo Proprietà agente di compilazione scegliere Disattivato dal menu a discesa Stato agente.

Per arrestare il servizio Visual Studio Team Foundation Build

  1. Accedere al computer di compilazione utilizzando un account che sia membro del gruppo Administrators sul computer specificato.

  2. Sul computer di compilazione, fare clic su Avvia, quindi su Pannello di controllo, Strumenti di amministrazione e scegliere Servizi.

  3. Nel riquadro Servizi (locale) fare clic con il pulsante destro del mouse su Visual Studio Team Foundation Build, quindi scegliere Proprietà.

    Verrà visualizzata la finestra di dialogo Proprietà di compilazione di Visual Studio Team Foundation (computer locale).

  4. In Stato servizio fare clic su Interrompi.

Per modificare la configurazione di Visual Studio Team Foundation Build per richiedere HTTPS

  1. Accedere al computer di compilazione utilizzando un account che sia membro del gruppo Administrators sul computer specificato.

  2. Aprire Directory principale:\Program Files\Microsoft Visual Studio 9.0\Common7\IDE\PrivateAssemblies, fare clic con il pulsante destroy del mouse su TfsBuildservice.config.exe, quindi scegliere Apri.

    Il file di progetto verrà aperto nell'editor XML di Visual Studio.

  3. Modificare il valore della chiave RequireSecureChannel nella sezione <appSettings> su "true".

    Impostare ad esempio la definizione della chiave sulla stringa seguente:

    <add key="RequireSecureChannel" value="true" />

  4. Salvare le modifiche e chiudere il file.

Per associare un certificato SSL a un indirizzo IP e un numero di porta

  1. Accedere al computer di compilazione utilizzando un account che sia membro del gruppo Administrators sul computer specificato.

    Nota:

    Installare la certificazione per il servizio Team Foundation Build di Visual Studio nell'archivio personale dell'account del servizio Team Foundation Build o nell'archivio personale del computer locale. Se si installa il certificato nell'archivio personale dell'utente collegato, non sarà possibile eseguire Team Foundation Build.

  2. Utilizzare lo snap-in dei Certificati per individuare un certificato X.509 designato per l'autenticazione client.

    Per ulteriori informazioni, vedere http://search.microsoft.com/?mkt=it-it.

  3. Copiare l'identificazione digitale del certificato in un editor di testo, ad esempio Blocco note.

  4. Rimuovere tutti gli spazi tra i caratteri esadecimali.

    È possibile rimuovere gli spazi utilizzando la funzione Trova e sostituisce dell'editor di testo per sostituire ogni spazio con un carattere null.

  5. Sul computer di compilazione, fare clic su Start, Tutti i programmi, Strumenti di supporto di Windows e quindi fare clic su Prompt dei comandi.

  6. Eseguire lo strumento HttpCfg.exe in modalità "impostazione" sull'archivio SSL per associare il certificato a un numero di porta.

    Lo strumento utilizza l'identificazione digitale per identificare il certificato, come illustrato nell'esempio seguente:

    httpcfg set ssl /i 0.0.0.0:9191 /h ThumbprintWithNoSpaces

    Il parametro /i presenta la sintassi indirizzo-IP:porta e indica allo strumento di impostare i certificati sulla porta 9191 del computer di compilazione. L'indirizzo IP 0.0.0.0 riserva tutti gli indirizzi del computer per semplicità. Per un ulteriore precisione specificare l'esatto indirizzo IP su cui viene pubblicato il servizio dell'agente. Il parametro /h specifica l'identificazione digitale del certificato.

    Se è necessario negoziare il certificato client, aggiungere l'argomento /f 2 come illustrato nell'esempio seguente:

    httpcfg set ssl /i 0.0.0.0:9191 /h ThumbprintWithNoSpaces /f 2

    Per ulteriori informazioni sulla sintassi del comando HttpCfg.exe, vedere https://go.microsoft.com/fwlink/?LinkId=93829.

Nota:

Se si utilizzano i sistemi operativi Windows Vista o Windows Server 2008, utilizzare netsh.exe anziché HttpCfg.exe. Per ulteriori informazioni su netsh.exe, vedere https://go.microsoft.com/fwlink/?LinkId=98790.

Per configurare la porta e il protocollo dell'agente di compilazione

  1. Al prompt dei comandi eseguire wcfhttpconfig freeNumeroPorta.

    L'istruzione del comando deve assomigliare alla stringa seguente:

    wcfhttpconfig free OldPortForHttp

    Per ulteriori informazioni, vedere wcfhttpconfig (Team Foundation Build).

  2. Al prompt dei comandi eseguire wcfhttpconfig reserveAccountUtenteURL.

    L'istruzione del comando deve assomigliare alla stringa seguente:

    wcfhttpconfig reserve Domain\Account https://+:NewPortForHttps/Build/v2.0/AgentService.asmx

  3. Aggiungere la porta all'elenco delle eccezioni di Windows Firewall

Per riavviare il servizio Visual Studio Team Foundation Build

  1. Accedere al computer di compilazione utilizzando un account che sia membro del gruppo Administrators sul computer specificato.

  2. Sul computer di compilazione, fare clic su Avvia, quindi su Pannello di controllo, Strumenti di amministrazione e scegliere Servizi.

  3. Nel riquadro Servizi (locale) fare clic con il pulsante destro del mouse su Visual Studio Team Foundation Build, quindi scegliere Proprietà.

    Verrà visualizzata la finestra di dialogo Proprietà di compilazione di Visual Studio Team Foundation (computer locale).

  4. In Stato servizio fare clic su Avvia.

Per verificare la configurazione SSL.

  1. Nella finestra di dialogo Gestisci agenti di compilazione fare clic su Modifica

  2. Nella finestra di dialogo Proprietà agente di compilazione scegliere Attivato dal menu a discesa Stato agente.

    Per ulteriori informazioni, vedere la classe Procedura: creare e gestire agenti di compilazione.

  3. Verificare che la comunicazione sia attiva eseguendo una compilazione tramite il relativo agente.

    Per ulteriori informazioni, vedere Procedura: accodare o avviare una definizione di compilazione.

Vedere anche

Attività

Procedura dettagliata: impostazione di Team Foundation Server con Secure Sockets Layer (SSL) e un filtro ISAPI

Concetti

Team Foundation Server, HTTPS e Secure Sockets Layer (SSL)

Team Foundation Server, autenticazione di base e autenticazione del digest

Altre risorse

Sicurezza di Team Foundation Server tramite HTTPS e Secure Sockets Layer (SSL)