Share via

Tutorial: Configurar Team Foundation Server con Secure Socket Layer (SSL) y un filtro ISAPI

  • Artículo

Actualización: noviembre 2007

En el tutorial siguiente se describe un proceso para solicitar, emitir y asignar certificados que se utilizan para las conexiones SSL (Capa de sockets seguros) en Visual Studio Team System Team Foundation Server, configurar la autenticación básica o implícita, y configurar un filtro ISAPI. Para admitir conexiones externas a sus implementaciones de Team Foundation Server, debe configurar Internet Information Services (IIS) para habilitar la autenticación básica o implícita. Además, debe configurar un filtro de Interfaz de programación de aplicaciones para servidores de Internet (ISAPI).

Nota:

No tiene que configurar un filtro ISAPI para habilitar HTTPS/SSL. Este tutorial proporciona instrucciones para configurar las actividades siguientes, pero puede configurar de manera diferente su propia implementación de Team Foundation Server.

A lo largo de este tutorial, llevará a cabo las tareas siguientes:

  1. Crear una solicitud de certificado para los sitios web de Team Foundation.

  2. Enviar la solicitud de certificado y crear el archivo de certificado binario.

  3. Instalar y asignar el certificado.

  4. Configurar Team Foundation Server para HTTPS y SSL.

  5. Instalar el certificado en los equipos cliente.

  6. Probar el certificado.

Nota:

Los procedimientos de este tutorial no requieren que los clientes utilicen únicamente HTTPS y SSL cuando se conectan a Team Foundation. Para obtener más información sobre cómo restringir las conexiones a HTTPS y SSL únicamente, vea Tutorial: Configurar Team Foundation Server para exigir HTTPS y Secure Sockets Layer (SSL).

Requisitos previos

Para completar este tutorial:

  • Los componentes lógicos que conforman el nivel de datos de Team Foundation y nivel de aplicación de Team Foundation Server deben estar instalados y en funcionamiento. En este tutorial se hace referencia al servidor o servidores que ejecutan los componentes lógicos que comprenden el nivel de aplicación de Team Foundation como el servidor de nivel de aplicación de Team Foundation. Asimismo, se hace referencia al servidor o servidores que ejecutan los componentes lógicos que comprenden el nivel de datos de Team Foundation como el servidor de nivel de datos de Team Foundation. Según la configuración de su implementación, el servidor de nivel de aplicación de Team Foundationy el servidor de nivel de datos de Team Foundation podrían ser el mismo servidor físico o uno o varios servidores físicos diferentes. Para obtener más información, vea la Guía de instalación de Team Foundation. La versión más reciente de la Guía de instalación de Team Foundation puede descargarse en el Centro de descarga de Microsoft (https://go.microsoft.com/fwlink/?linkid=79226).

  • Para expedir certificados debe disponer de una entidad de certificación (CA). En este tutorial se da por supuesto que va a usar los servicios de Certificate Server de Microsoft como CA. Si no tiene una entidad de certificación, puede instalar servicios de Certificate Server de Microsoft y configurar una. Para obtener más información, vea el sitio web de Microsoft (https://go.microsoft.com/fwlink/?LinkId=70929).

Permisos necesarios

Para completar este procedimiento, debe ser miembro del grupo Administradores de los servidores de nivel de aplicación y nivel de datos de Team Foundation y miembro del grupo Administradores de Team Foundation. Para configurar un agente de compilación para las conexiones SSL, debe ser miembro del grupo Administradores en el equipo de compilación. Para obtener más información acerca de los permisos, vea Permisos de Team Foundation Server.

Suposiciones

En este tutorial se da por supuesto lo siguiente:

  • El servidor de nivel de datos de Team Foundation y el servidor de nivel de aplicación de Team Foundation se han instalado e implementado en un entorno seguro y se han configurado de acuerdo con los procedimientos de seguridad recomendados.

  • El administrador que configura Team Foundation con SSL está familiarizado con las infraestructuras de claves públicas (PKI) y con los certificados, lo que incluye saber cómo solicitar, emitir y asignar certificados. Para obtener más información sobre las PKI y los certificados, vea el sitio web de Microsoft (https://go.microsoft.com/fwlink/?LinkId=70930).

  • El administrador está familiarizado con la configuración de Internet Information Services (IIS), Microsoft SQL Server y los parámetros de redes, y además tiene conocimientos prácticos sobre la topología de red del entorno de desarrollo.

  • Para configurar un agente de compilación para las conexiones SSL:

    • Team Foundation Build y Team Explorer deben estar instalados y en funcionamiento.

    • Debe haberse emitido un certificado para el agente de compilación.

    • Las Herramientas de soporte de Windows deben estar instaladas en el equipo de compilación. Estas herramientas son necesarias para asociar un certificado a una dirección IP y un puerto. Para obtener más información, vea "Windows Support Tools" (https://go.microsoft.com/fwlink/?LinkId=93827).

Instalar Servicios de Certificate Server de Microsoft

Este tutorial utiliza Servicios de Certificate Server de Microsoft como entidad de certificación para expedir los certificados. Para mayor comodidad en este tutorial, se instalan servicios de Certificate Server en el servidor de nivel de aplicación de Team Foundation, pero puede elegir el software de entidad de certificación y la configuración de implementación que mejor se adapten a sus necesidades comerciales. Por motivos de seguridad, debe estudiar la posibilidad de aislar su entidad de certificación raíz cuando implemente los servicios de Certificate Server en una implementación de producción. El aislamiento físico del servidor de la entidad de certificación en un lugar al que sólo tengan acceso los administradores de seguridad, puede reducir significativamente el riesgo de manipulación. Para obtener más información sobre las características de Servicios de Certificate Server, vea el sitio web de Microsoft (https://go.microsoft.com/fwlink/?LinkId=70929).

Precaución:

Una vez que haya instalado Servicios de Certificate Server, no podrá cambiar el nombre del equipo ni el dominio en el cual éste se ha dado de alta. Si cambia el dominio o el nombre del equipo, se invalidará el certificado expedido por la entidad de certificación.

Para instalar Servicios de Certificate Server

  1. Haga clic en Inicio, elija Panel de control y haga clic en Agregar o quitar programas.

  2. Haga clic en Agregar o quitar componentes de Windows.

  3. En el Asistente para componentes de Windows, haga clic en Servicios de Certificate Server en la lista Componentes.

  4. Revise el texto del cuadro de mensaje y, a continuación, haga clic en Sí.

  5. Haga clic en Siguiente para iniciar la instalación.

  6. En la página Tipo de CA, seleccione CA raíz independiente y haga clic en Siguiente.

  7. En la página Identificación de la CA, escriba el nombre del equipo en Nombre común para esta entidad de certificación.

  8. En Período de validez, cambie la duración del certificado a seis (6) meses y haga clic en Siguiente.

  9. En la página Configuración de la base de datos de certificados, haga clic en Siguiente sin realizar ningún cambio.

    Aparecerá un cuadro de mensaje que muestra que debe detenerse Servicios de IIS.

  10. En el cuadro de mensaje, haga clic en Sí.

    Aparecerá la página Configuración de componentes.

  11. Si aparece un cuadro de mensaje con información sobre páginas Active Server (ASP), haga clic en Sí.

  12. Haga clic en Finalizar.

Crear una solicitud de certificado para los sitios web de Team Foundation Server

En el equipo de nivel de aplicación, debe crear una solicitud de certificado para Team Foundation mediante el Administrador de Internet Information Services (IIS).

Para crear una solicitud de certificado para los sitios web de Team Foundation Server

  1. En el menú Inicio, haga clic en Herramientas administrativas y seleccione Administrador de Internet Information Services (IIS).

  2. Expanda nombre del equipo(equipo local) y expanda Sitios Web.

  3. Haga clic con el botón secundario del mouse en Team Foundation Server y, a continuación, en Propiedades.

  4. En Propiedades del servidor Team Foundation Server, haga clic en la ficha Seguridad de directorios.

  5. Bajo Comunicaciones seguras, haga clic en Certificado de servidor.

    Aparecerá el Asistente para certificados de servidor Web. Haga clic en Siguiente.

  6. En la página Certificado de servidor, haga clic en Crear un certificado nuevo y, a continuación, en Siguiente.

  7. En la página Petición demorada o inmediata, haga clic en Siguiente.

  8. En la página Nombre y configuración de seguridad, haga clic en Siguiente sin realizar ningún cambio.

  9. En la página Información de la organización, especifique los valores para Organización y Unidad de organización. Por ejemplo, escriba el nombre de su empresa en Organización y el nombre de su equipo o grupo en Unidad de organización. Haga clic en Siguiente.

  10. En la página Nombre común de su sitio web, haga clic en Siguiente sin realizar ningún cambio.

  11. En la página Información geográfica, especifique la información apropiada en los cuadros País o región, Estado o provincia y Ciudad o localidad y haga clic en Siguiente.

  12. En la página Nombre de archivo de la petición de certificado, bajo Nombre de archivo, especifique la ubicación en la que desea guardar el archivo de la solicitud de certificado y el nombre del archivo y, a continuación, haga clic en Siguiente.

    Nota:

    Asegúrese de que el archivo se guarda en un recurso compartido de red o en otra ubicación a la que se pueda tener acceso desde el equipo de la entidad de certificación.

  13. Revise la información que se muestra en la página Resumen del archivo de petición y haga clic en Siguiente.

  14. Haga clic en Finalizar.

  15. Haga clic en Aceptar para salir del cuadro de diálogo Propiedades del servidor Team Foundation Server.

Enviar una solicitud de certificado y crear un archivo de certificado binario

Después de haber creado la solicitud de certificado, deberá hacer que la entidad de certificación, en este caso los servicios de Certificate Server de Microsoft, expida un certificado basado en la solicitud. Una vez que se crea el certificado, puede asignárselo a los sitios web correspondientes mediante IIS.

Para enviar una solicitud de certificado mediante los Servicios de Certificate Server de Microsoft

  1. Haga clic en Inicio, elija Herramientas administrativas y seleccione Entidad de certificación.

  2. En el panel Explorador, haga clic con el botón secundario del mouse en el nombre del equipo, seleccione Todas las tareas y haga clic en Enviar solicitud nueva.

  3. En el cuadro de diálogo Abrir archivo de solicitud, localice el archivo de texto de la solicitud de certificado que creó en el procedimiento anterior y, a continuación, haga clic en Abrir.

  4. En el panel Explorador, expanda el nombre del equipo y haga clic en Peticiones pendientes.

  5. Tome nota del valor de Id. de petición correspondiente a la solicitud pendiente.

  6. Haga clic con el botón secundario del mouse en la solicitud, seleccione Todas las tareas y haga clic en Emitir.

  7. En la ventana Explorador, bajo el nombre del equipo, seleccione, Certificados emitidos y revise los certificados mostrados para comprobar que el Id. de petición del certificado emitido coincide con el valor de la solicitud.

  8. En Certificados emitidos, haga clic con el botón secundario del mouse en el certificado emitido, seleccione Todas las tareas y haga clic en Exportar datos binarios.

  9. En Columnas que contienen datos binarios, seleccione Certificado binario. Bajo Opciones de exportación, seleccione Guardar datos binarios en un archivo y haga clic en Aceptar.

  10. En Guardar datos binarios, guarde el archivo en un dispositivo de discos portátil o en un recurso compartido de red al que tenga acceso el equipo de nivel de aplicación de Team Foundation.

  11. Salga de Entidad de certificación.

Instalar y asignar el certificado

Para poder usar SSL con Team Foundation, deberá instalar el certificado de servidor en el sitio web del servidor de Team Foundation y, a continuación, configurar HTTPS en los sitios web relacionados con Team Foundation. Entre estos sitios web relacionados se encuentran los siguientes:

  • El sitio web predeterminado

  • La administración central de SharePoint

  • El servidor de informes

Instalar el certificado de servidor

Siga estos pasos para instalar el certificado de servidor en Team Foundation.

Para instalar el certificado de servidor en el sitio web del servidor Team Foundation Server

  1. En el servidor de nivel de aplicación de Team Foundation, haga clic en Inicio, Herramientas administrativas y, a continuación, en Administrador de Internet Information Services (IIS).

  2. Expanda <nombre del equipo> (equipo local) y expanda Sitios Web.

  3. Haga clic con el botón secundario del mouse en Team Foundation Server y, a continuación, en Propiedades.

  4. En Propiedades del servidor Team Foundation Server, haga clic en la ficha Seguridad de directorios.

  5. Bajo Comunicaciones seguras, haga clic en Certificado de servidor.

    Aparecerá el Asistente para certificados de servidor Web. Haga clic en Siguiente.

  6. En la página Petición de certificado pendiente, seleccione Procesar la petición pendiente e instalar el certificado y haga clic en Siguiente.

  7. En la página Procesar petición pendiente, haga clic en Examinar.

  8. En el cuadro de diálogo Abrir, bajo Tipos de archivo, seleccione Todos los archivos (*.*) en la lista desplegable y, a continuación, vaya al directorio en el que guardó el certificado binario en el procedimiento anterior. Seleccione el archivo del certificado binario y haga clic en Abrir.

  9. En la página Procesar petición pendiente, haga clic en Siguiente.

  10. En la página Puerto SSL, acepte el valor predeterminado o escriba un nuevo valor y, a continuación, haga clic en Siguiente. El puerto predeterminado para las conexiones SSL es 443, pero debe asignar un valor de puerto único para cada uno de los tres sitios siguientes: el sitio web de Team Foundation Server, el sitio web predeterminado y el sitio web de Administración central de SharePoint.

    Nota importante:

    Puede ser conveniente utilizar un número de puerto distinto del valor predeterminado, puesto que utilizar un número de puerto predeterminado puede reducir la seguridad de la implementación. Tome nota del valor del puerto SSL que asigne. Antes de aceptar el valor predeterminado, asegúrese de que no haya otro certificado de servidor que utilice el puerto. Los valores de puerto SSL deben ser diferentes para cada certificado de servidor que se instale. Por ejemplo, si aún no se ha utilizado el puerto predeterminado 443 y el usuario acepta el valor de puerto predeterminado 443 para el sitio web de Team Foundation, deberá asignar un valor de puerto diferente para el sitio web predeterminado y para el sitio web de Administración central de SharePoint.

  11. Revise la información sobre la página Resumen del certificado y haga clic en Siguiente.

  12. Haga clic en Finalizar.

  13. En la ficha Seguridad de directorios, bajo Autenticación y control de acceso, haga clic en Editar.

  14. En Métodos de autenticación, asegúrese de que la casilla Habilitar el acceso anónimo esté desactivada. En Acceso autenticado, active Autenticación de Windows integrada y Autenticación de texto implícita para servidores de dominio Windows o Autenticación básica, o ambas opciones, según corresponda a su implementación. Desactive todas las demás opciones y haga clic en Aceptar. Para obtener más información sobre los métodos de autenticación y Team Foundation Server, vea Team Foundation Server, Autenticación básica y Autenticación implícita.

    Nota:

    Después de hacer clic en Autenticación de texto implícita para servidores de dominio Windows, puede que el sistema le pida que confirme la opción elegida. Lea el texto y, a continuación, haga clic en Sí.
    Nota importante:

    Debe configurar la autenticación implícita correctamente. De lo contrario, no podrá obtener acceso a Team Foundation Server. No elija la autenticación implícita a menos que las implementaciones reúnan todos los requisitos para una autenticación implícita. Para obtener más información sobre la autenticación implícita, visite el sitio web de Microsoft (https://go.microsoft.com/fwlink/?LinkId=89709).

  15. Haga clic en Aceptar para salir del cuadro de diálogo Propiedades del servidor Team Foundation Server.

    Nota:

    Si aparece el cuadro de diálogo Omitir herencia después de hacer clic en Aceptar, elija Seleccionar todo y haga clic en Aceptar.

Asignar el certificado al sitio web predeterminado

Siga estos pasos para configurar HTTPS en el sitio web predeterminado en IIS.

Nota:

En función de la jerarquía de certificados y la infraestructura de clave pública (PKI), también puede desear configurar IIS para la autenticación de certificados de cliente. Para obtener más información, vea Certificates (IIS 6.0), Certificate Services y Certificates en el sitio web de Microsoft.

Para configurar HTTP en el sitio web predeterminado

  1. En el servidor de nivel de aplicación de Team Foundation, haga clic en Inicio, Herramientas administrativas y, a continuación, en Administrador de Internet Information Services (IIS).

  2. Expanda <nombre del equipo> (equipo local) y expanda Sitios Web.

  3. Haga clic con el botón secundario del mouse en la carpeta Sitio Web predeterminado y seleccione Propiedades.

  4. En Propiedades del sitio Web predeterminado, haga clic en la ficha Seguridad de directorios.

  5. Bajo Comunicaciones seguras, haga clic en Certificado de servidor.

    Aparecerá el Asistente para certificados de servidor Web. Haga clic en Siguiente.

  6. En la página Certificado de servidor, seleccione Asignar un certificado ya existente y, a continuación, haga clic en Siguiente.

  7. En la página Certificados disponibles, seleccione el certificado cuyo valor de Nombre descriptivo es Team Foundation Server. Puede que sea necesario desplazarse para ver la columna Nombre descriptivo en la lista. Haga clic en Siguiente.

  8. En la página Puerto SSL, acepte el valor predeterminado o escriba un nuevo valor y, a continuación, haga clic en Siguiente. El puerto predeterminado para las conexiones SSL es 443, pero debe asignar un valor de puerto único para cada uno de los tres sitios siguientes: el sitio web de Team Foundation Server, el sitio web predeterminado y el sitio web de Administración central de SharePoint.

    Nota importante:

    Puede ser conveniente utilizar un número de puerto distinto del predeterminado, puesto que utilizar un número de puerto predeterminado puede reducir la seguridad de la implementación. Tome nota del valor del puerto SSL. Los valores de puerto SSL deben ser diferentes para cada certificado de servidor que se instale. Por ejemplo, si acepta el valor de puerto predeterminado 443 para el sitio web de Team Foundation, debe asignar un valor de puerto diferente para el sitio web predeterminado y para el sitio web de Administración central de SharePoint.

  9. Revise la información sobre la página Resumen del certificado y haga clic en Siguiente.

  10. Haga clic en Finalizar. El asistente se cerrará.

  11. En la ficha Seguridad de directorios, bajo Autenticación y control de acceso, haga clic en Editar.

  12. En Métodos de autenticación, asegúrese de que la casilla Habilitar el acceso anónimo esté desactivada. En Acceso autenticado, active Autenticación de Windows integrada y Autenticación de texto implícita para servidores de dominio Windows o Autenticación básica, o ambas opciones, según corresponda a su implementación. Desactive todas las demás opciones y haga clic en Aceptar. Para obtener más información sobre los métodos de autenticación y Team Foundation Server, vea Team Foundation Server, Autenticación básica y Autenticación implícita.

    Nota:

    Después de hacer clic en Autenticación de texto implícita para servidores de dominio Windows, puede que el sistema le pida que confirme la opción elegida. Lea el texto y, a continuación, haga clic en Sí.

  13. Haga clic en Aceptar para cerrar el cuadro de diálogo Propiedades del sitio Web predeterminado.

    Nota:

    Si aparece el cuadro de diálogo Omitir herencia después de hacer clic en Aceptar, elija Seleccionar todo y haga clic en Aceptar.

Asignar el certificado a la administración central de SharePoint

Siga estos pasos a fin de configurar HTTP para la Administración central de SharePoint.

Para configurar HTTP para la Administración central de SharePoint

  1. En el servidor de nivel de aplicación de Team Foundation, haga clic en Inicio, Herramientas administrativas y, a continuación, en Administrador de Internet Information Services (IIS).

  2. Expanda <nombre del equipo> (equipo local) y expanda Sitios Web.

  3. Haga clic con el botón secundario del mouse en Administración central de SharePoint y haga clic en Propiedades.

  4. En Propiedades de administración central de SharePoint, haga clic en la ficha Seguridad de directorios.

  5. Bajo Comunicaciones seguras, haga clic en Certificado de servidor.

    Aparecerá el Asistente para certificados de servidor Web. Haga clic en Siguiente.

  6. En la página Certificado de servidor, seleccione Asignar un certificado ya existente y, a continuación, haga clic en Siguiente.

  7. En la página Certificados disponibles, seleccione el certificado cuyo valor de Nombre descriptivo es Team Foundation Server. Puede que sea necesario desplazarse para ver la columna Nombre descriptivo en la lista.

  8. Haga clic en Siguiente.

  9. En la página Puerto SSL, acepte el valor predeterminado o escriba un nuevo valor y, a continuación, haga clic en Siguiente. El puerto predeterminado para las conexiones SSL es 443, pero debe asignar un valor de puerto único para cada uno de los tres sitios siguientes: el sitio web de Team Foundation Server, el sitio web predeterminado y el sitio web de Administración central de SharePoint.

    Nota importante:

    Puede ser conveniente utilizar un número de puerto distinto del predeterminado, puesto que utilizar un número de puerto predeterminado puede reducir la seguridad de la implementación. Tome nota del valor del puerto SSL. Los valores de puerto SSL deben ser diferentes para cada certificado de servidor que se instale. Por ejemplo, si acepta el valor de puerto predeterminado 443 para el sitio web de Team Foundation, debe asignar un valor de puerto diferente para el sitio web predeterminado y para el sitio web de Administración central de SharePoint.
    Nota:

    Tome nota de este valor, ya que lo necesitará para asignar el certificado al Servidor de informes de SQL.

  10. Revise la información sobre la página Resumen del certificado y haga clic en Siguiente.

  11. Haga clic en Finalizar.

Configurar el filtro ISAPI

Debe crear un archivo de inicialización de ISAPI en el mismo directorio que se encuentre el archivo AuthenticationFilter.dll que forma parte de Team Foundation Service Pack 1. También debe agregar el filtro ISAPI al Registro.

Para configurar el filtro ISAPI

  1. En el servidor de nivel de aplicación de Team Foundation, haga clic en Inicio, elija Programas, seleccione Accesorios y haga clic en Bloc de notas.

  2. En el Bloc de notas, cree el archivo siguiente, donde ProxyAddress es la dirección IP desde la que parecerá originarse el tráfico de red externo a Team Foundation (normalmente un enrutador) y para la que desea exigir el uso de HTTPS/SSL y la autenticación básica o implícita, y donde SubnetMask es la combinación o combinaciones de dirección IP y máscara de red para las que no desea exigir la autenticación básica o implícita.

    Nota importante:

    Si agrega la clave ProxyIPList al archivo, se omitirán la clave SubnetList y sus valores. Para obtener más información, vea Team Foundation Server, Autenticación básica y Autenticación implícita.
    Nota:

    Puede haber más de un valor de ProxyAddress o SubnetMask. Separe los valores de ProxyAddress o SubnetMask con signos de punto y coma.

    [config]

    RequireSecurePort=false

    ProxyIPList=ProxyAddress;

    SubnetList=SubnetMask;

  3. Guarde este archivo como AuthenticationFilter.ini en el mismo directorio que AuthenticationFilter.dll. Este directorio es drive:\Archivos de programa\Microsoft Visual Studio 2008 Team Foundation Server\Tools.

    Nota importante:

    No cambie el directorio del archivo AuthenticationFilter.ini ni del archivo AuthenticationFilter.dll. Si lo hace, aumentará la probabilidad de que surjan problemas a la hora de actualizar Team Foundation SP1 a Team Foundation SP1.

  4. Abra una ventana de símbolo del sistema. Para abrir el símbolo del sistema, haga clic en Inicio, elija Ejecutar, escriba cmd y haga clic en Aceptar.

    Nota:

    Incluso si ha iniciado sesión con credenciales administrativas, debe abrir un símbolo del sistema con privilegios elevados para realizar esta función en un servidor que ejecute Windows Server 2008. Para abrir un símbolo del sistema con permisos elevados, haga clic en Inicio, haga clic con el botón secundario en Símbolo del sistema y, a continuación, haga clic en Ejecutar como administrador. Para obtener más información, visite el sitio web de Microsoft.

  5. En el símbolo del sistema, escriba el siguiente comando:

    reg.exe add "HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\Eventlog\Application\TFS ISAPI Filter" /v EventMessageFile /t REG_SZ /d %windir%\Microsoft.NET\Framework\v2.0.50727\EventLogMessages.dll /f

  6. En el símbolo del sistema, escriba el siguiente comando:

    reg.exe add "HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\Eventlog\Application\TFS ISAPI Filter" /v TypesSupported /t REG_DWORD /d 7 /f

  7. En el servidor de nivel de aplicación de Team Foundation, haga clic en Inicio, Herramientas administrativas y, a continuación, en Administrador de Internet Information Services (IIS).

  8. Expanda <nombre del equipo> (equipo local), expanda Sitios Web, haga clic con el botón secundario en Team Foundation Server y, a continuación, seleccione Propiedades.

  9. En Propiedades del sitio Web predeterminado, haga clic en la ficha Filtros ISAPI.

  10. En Filtros ISAPI, haga clic en Agregar.

  11. En Agregar o modificar propiedades de filtro, escriba TFAuthenticationFilter en Nombre de filtro, escriba drive**:\Program Files\Microsoft Visual Studio 2008 Team Foundation Server\TF Setup\AuthenticationFilter.dll** en Ejecutable y haga clic en Aceptar.

Configurar el firewall para permitir el tráfico SSL

Debe configurar su firewall para permitir el tráfico en los puertos SSL especificados en Internet Information Services para el sitio web predeterminado, el sitio web de Team Foundation y el sitio web de Administración central de SharePoint.

Nota:

Los procedimientos para configurar su firewall de modo que permita el tráfico SSL varían según el software y el hardware de firewall utilizados en su implementación.

Para configurar un firewall de modo que permita tráfico de red en los puertos SSL utilizados por Team Foundation Server

  • Consulte la documentación del producto del firewall para determinar los pasos que es preciso realizar para permitir el tráfico de red en los puertos SSL que ha especificado para el sitio web predeterminado, el sitio web de Team Foundation y el sitio web de Administración central de SharePoint.

Actualizar proyectos de equipo para el Servidor de informes de SQL mediante la herramienta de la línea de comandos TFSConfigWss

Siga estos pasos si desea actualizar los sitios web de proyectos de equipo para el Servidor de informes de SQL de modo que los informes se muestren correctamente en los sitios de portal de proyectos de equipo.

Para actualizar los sitios de proyectos de equipo para el Servidor de informes de SQL

  1. En el servidor de nivel de aplicación para Team Foundation, abra una ventana de símbolo del sistema y cambie los directorios a Unidad:\%Archivos de programa%\Microsoft Visual Studio 2008 Team Foundation Server\Tools.

  2. En el símbolo del sistema, escriba el comando siguiente y reemplace estas cadenas:

    • SharePointSite es el nuevo identificador uniforme de recursos (URI) de la colección de sitios de Productos y tecnologías de SharePoint.

    • Reports es el nuevo identificador URI de SQL Server Reporting Services.

    • ReportServer es el nuevo identificador URI del servicio web ReportsService.asmx.

      **TfsConfigWss ConfigureReporting /SharepointSitesUri:SharePointSite/ReportsUri:Reports/ReportServerUri:**ReportServer

Actualización de la información de configuración de Team Foundation Server

Siga estos pasos para actualizar la información de configuración con los valores de las direcciones URL HTTPS correspondientes a los sitios web de Reporting Services y de Windows SharePoint Services.

Para actualizar la información de configuración de Team Foundation Server

  1. En el servidor de nivel de aplicación de Team Foundation, abra una ventana de símbolo del sistema y cambie los directorios a Unidad:\%ProgramFiles%\Microsoft Visual Studio 2008 Team Foundation Server\Tools.

  2. En el símbolo del sistema, escriba el comando siguiente y reemplace estas cadenas:

    • BaseServerURL es el nuevo identificador URI del servidor web para el servidor de nivel de aplicación de Team Foundation.

    • BaseSiteURL es el nuevo identificador URI del sitio web predeterminado para el servidor de nivel de aplicación.

    • SharePointSite es el nuevo identificador URI para la colección de sitios de productos y tecnologías de SharePoint.

    • SharePointAdministration es el nuevo identificador URI para el sitio web de Administración central de SharePoint.

    • Reports es el nuevo identificador URI de SQL Server Reporting Services.

    • ReportServer es el nuevo identificador URI del servicio web ReportsService.asmx.

      TfsAdminUtil ConfigureConnections /ATUri:BaseServerURL/SharepointUri:BaseSiteURL**/SharepointSitesUri:SharePointSite/SharepointAdminUri:SharePointAdministration/ReportsUri:Reports/ReportServerUri:**ReportServer

    Nota:

    Si utiliza una instancia con nombre, necesitará especificar la instancia con nombre como parte de los valores de Reports y ReportServer. No elimine ni cambie el nombre de la instancia con nombre.

    Por ejemplo, si especificara el puerto 443 para el valor del puerto SSL del sitio web de Team Foundation, 1443 para el valor del puerto SSL del sitio web predeterminado en IIS y 2443 para el valor de puerto de Administración central de SharePoint, y el nombre del servidor de nivel de aplicación fuera Contoso1, el valor se debería modificar del modo siguiente:

    **TfsAdminUtil ConfigureConnections /ATUri:**https://Contoso1:443 **/SharepointUri:**https://Contoso1:1443 /SharepointSitesUri:https://Contoso1:1443/Sites/SharepointAdminUri:https://Contoso1:2443 /ReportsUri:https://Contoso1:1443/Reports/ReportServerUri:https://Contoso1:1443/ReportServer

    Nota:

    El comando ConfigureConnections tiene varias opciones adicionales, como actualizar la dirección web pública utilizada en los avisos de correo electrónico. Para obtener más información, vea Comando ConfigureConnections.

Instalar el certificado en los equipos de compilación

Si instala Build Services en uno o más servidores, debe instalar el certificado en todos ellos.

Nota:

Para poder ejecutar compilaciones mediante SSL, el certificado debe estar instalado en el almacén raíz de confianza tanto del equipo correspondiente a la cuenta en la que se ejecuta el servicio de generación como del equipo que inicia la generación.

Para instalar el certificado en los equipos de compilación

  1. Inicie sesión en el equipo de compilación mediante una cuenta que sea miembro del grupo Administradores de ese equipo.

  2. Abra un explorador y abra el sitio web siguiente, donde CertificateServer es el nombre de su servidor de certificados y port es el número del puerto SSL que asignó a la entidad de certificación:

    https://CertificateServer:port/services/v1.0/serverstatus.asmx

  3. Aparecerá un cuadro de diálogo de mensaje de seguridad. En Alerta de seguridad, haga clic en Ver certificado.

  4. En el cuadro de diálogo Certificado, haga clic en la página Ruta de certificación.

  5. En Ruta de certificación, haga clic en la entidad de certificación. Éste debería ser el nodo superior de la jerarquía de certificados y debería haber una X roja al lado del nombre. Esto indica que la entidad de certificación no es confiable porque no se encuentra en el almacén Entidades de certificación raíz de confianza. Haga clic en Ver certificado.

  6. En el cuadro de diálogo Certificado, haga clic en Instalar certificado.

    Se abrirá el Asistente para importación de certificados. Haga clic en Siguiente.

  7. En la página Almacén de certificados, seleccione Colocar todos los certificados en el siguiente almacén y haga clic en Examinar.

  8. En Seleccionar almacén de certificados, seleccione Mostrar almacenes físicos. En Seleccione el almacén de certificados que quiere usar, expanda Entidades emisoras de certificados raíz de confianza, seleccione Equipo local y haga clic en Aceptar.

  9. En la página Almacén de certificados, haga clic en Siguiente.

  10. En la página Finalización del Asistente para importación de certificados, haga clic en Finalizar.

  11. Puede que aparezca un cuadro de diálogo del Asistente para importación de certificados que confirmará que la importación se realizó correctamente. Si el cuadro de diálogo aparece, haga clic en Aceptar.

  12. En el cuadro de diálogo Certificado, haga clic en Aceptar. Se cerrará el cuadro de diálogo Certificado del nodo superior de la jerarquía de certificados.

  13. En el cuadro de diálogo Certificado, haga clic en Aceptar. Se cerrará el cuadro de diálogo Certificado del certificado subordinado.

  14. En Alerta de seguridad, haga clic en No.

  15. Abra un explorador y abra el sitio web siguiente, donde CertificateServer es el nombre de su servidor de certificados y port es el número del puerto SSL que asignó a la entidad de certificación:

    https://CertificateServer:port/services/v1.0/serverstatus.asmx

  16. Debería abrirse la página Servicio Web ServerStatus. Así se confirma que ha instalado correctamente el certificado y la entidad de certificación. Cierre el explorador.

Configurar un agente de compilación para las conexiones SSL

Para configurar un agente de compilación para conexiones SSL, debe configurar un certificado HTTPS para cada combinación de dirección IP y puerto. Si todos los agentes de compilación comparten el mismo puerto en el equipo de compilación, sólo debe configurar un único certificado. Si ejecuta varios agentes de compilación en varios puertos, debe configurar un certificado para cada puerto.

Para configurar un agente de compilación que requiera SSL, realice el procedimiento siguiente en el orden indicado:

  1. Cree y configure el agente de compilación para que requiera HTTPS.

  2. Detenga el servicio Team Foundation Build de Visual Studio.

  3. Modifique la configuración del servicio de compilación de forma que requiera HTTPS.

  4. Asocie un certificado a la dirección IP y al puerto.

  5. Configure el puerto y el protocolo para el agente de compilación.

  6. Reinicie el servicio Team Foundation Build de Visual Studio.

  7. Compruebe la configuración SSL.

Para configurar el agente de compilación para que requiera HTTPS

  1. Abra el cuadro de diálogo Administrar agentes de compilación y active la casilla Requiere canal seguro (HTTPS).

    Para obtener más información, vea Cómo: Crear y administrar agentes de compilación.

  2. Haga clic en Editar.

    Aparece el cuadro de diálogo Propiedades de agente de compilación.

  3. En la lista Estado de agente, haga clic en Deshabilitado.

Para detener el servicio Visual Studio Team Foundation Build

  1. Inicie sesión en el equipo de compilación mediante una cuenta que sea miembro del grupo Administradores de ese equipo.

  2. En el equipo de compilación, haga clic en Inicio, en Panel de control, en Herramientas administrativas y, a continuación, en Servicios.

  3. En el panel Servicios (Local), haga clic con el botón secundario del mouse en Visual Studio Team Foundation Build y haga clic en Propiedades.

    Aparece el cuadro de diálogo Propiedades de Visual Studio Team Foundation Build (equipo local).

  4. En Estado del servicio, haga clic en Detener.

Para modificar la configuración del servicio de compilación de forma que requiera HTTPS

  1. Inicie sesión en el equipo de compilación mediante una cuenta que sea miembro del grupo Administradores de ese equipo.

  2. Abra Unidad:\Archivos de programa\Microsoft Visual Studio 2008\Common7\IDE\PrivateAssemblies, haga clic con el botón secundario del mouse en TfsBuildservice.config.exe y haga clic en Abrir.

    El archivo se abre en el editor de XML de Visual Studio.

  3. En la sección <appSettings>, cambie el valor de la clave RequireSecureChannel a "true". Por ejemplo, cambie la definición de clave a la cadena siguiente:

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

  4. Guarde los cambios y cierre el archivo.

Para asociar un certificado SSL a una dirección IP y número de puerto

  1. Inicie sesión en el equipo de compilación mediante una cuenta que sea miembro del grupo Administradores de ese equipo.

  2. Utilice el complemento de certificados para buscar un certificado X.509 especialmente diseñado para la autenticación cliente.

    Para obtener más información, vea "How To: Retrieve the Thumbprint of a Certificate" (https://go.microsoft.com/fwlink/?LinkId=93828).

  3. Copie la huella digital del certificado en un editor de texto, como el Bloc de notas.

  4. Quite todos los espacios entre los caracteres hexadecimales.

    Puede realizar esta tarea utilizando la característica de buscar y reemplazar del editor de texto para reemplazar cada espacio por un carácter nulo.

  5. En el equipo de compilación, haga clic en Inicio, en Todos los programas, en Herramientas de soporte de Windows y luego en Símbolo del sistema.

  6. Ejecute la herramienta HttpCfg.exe en modo "set" en el almacén de SSL para enlazar el certificado a un número de puerto. La herramienta utiliza la huella digital para identificar el certificado, como se muestra en el ejemplo siguiente:

    httpcfg set ssl /i 0.0.0.0:9191 /h ThumbprintWithNoSpaces

    El parámetro /i tiene la sintaxis DirecciónIP:Puerto e indica a la herramienta que establezca el certificado en el puerto 9191 del equipo de compilación. La dirección IP 0.0.0.0 reserva todas las direcciones del equipo por motivos de simplicidad. Si necesita mayor precisión, especifique la dirección IP exacta en la que se publica el servicio del agente. El parámetro /h especifica la huella digital del certificado.

    Si se debe negociar el certificado del cliente, agregue el parámetro /f 2 como se muestra en el ejemplo siguiente:

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

    Para obtener más información sobre la sintaxis del comando HttpCfg.exe, vea "How To: Configure a Port with An SSL Certificate" (https://go.microsoft.com/fwlink/?LinkId=93829).

Para configurar el puerto y el protocolo del agente de compilación

  1. En el símbolo del sistema, ejecute wcfhttpconfigfreeNúmeroDePuerto. La instrucción del comando debe ser similar a la siguiente cadena:

    wcfhttpconfig free OldPortForHttp

    Para obtener más información, vea wcfhttpconfig (Team Foundation Build).

  2. En el símbolo del sistema, ejecute wcfhttpconfigreserveCuentaDeUsuarioURL. La instrucción del comando debe ser similar a la siguiente:

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

  3. Agregue el puerto a la lista de excepciones de Firewall de Windows.

Para reiniciar el servicio Visual Studio Team Foundation Build

  1. Inicie sesión en el equipo de compilación mediante una cuenta que sea miembro del grupo Administradores de ese equipo.

  2. En el equipo de compilación, haga clic en Inicio, en Panel de control, en Herramientas administrativas y, a continuación, en Servicios.

  3. En el panel Servicios (Local), haga clic con el botón secundario del mouse en Visual Studio Team Foundation Build y haga clic en Propiedades.

    Aparece el cuadro de diálogo Propiedades de Visual Studio Team Foundation Build (equipo local).

  4. En Estado del servicio, haga clic en Iniciar.

Para comprobar la configuración SSL

  1. Abra el cuadro de diálogo Administrar agentes de compilación.

    Para obtener más información, vea Cómo: Crear y administrar agentes de compilación.

  2. Haga clic en Editar.

    Aparece el cuadro de diálogo Propiedades de agente de compilación.

  3. En la lista Estado de agente, haga clic en Habilitado.

  4. Compruebe si hay comunicación ejecutando una compilación mediante el agente de compilación.

    Para obtener más información, vea Cómo: Poner en cola o iniciar una definición de compilación.

Instalar el certificado en los equipos del proxy de Team Foundation Server

Si ha instalado el servidor proxy de Team Foundation en uno o varios equipos, debe instalar el certificado en todos ellos.

Nota:

Además del procedimiento siguiente, debe configurar todos los firewall para que el equipo proxy permita el tráfico en los puertos SSL que especificó para Team Foundation Server. Los procedimientos para configurar su firewall de este modo varían según el software y el hardware de firewall utilizados en su implementación.

Para instalar el certificado en los equipos del proxy de Team Foundation Server

  1. Inicie sesión en el servidor proxy de Team Foundation mediante una cuenta que sea miembro del grupo Administradores de ese equipo.

  2. Abra un explorador y abra el sitio web siguiente, donde CertificateServer es el nombre de su servidor de certificados y port es el número del puerto SSL que asignó a la entidad de certificación:

    https://CertificateServer:port/services/v1.0/serverstatus.asmx

  3. Aparecerá un cuadro de diálogo de mensaje de seguridad. En Alerta de seguridad, haga clic en Ver certificado.

  4. En el cuadro de diálogo Certificado, haga clic en la página Ruta de certificación.

  5. En Ruta de certificación, haga clic en la entidad de certificación. Éste debería ser el nodo superior de la jerarquía de certificados y debería haber una X roja al lado del nombre. Esto indica que la entidad de certificación no es confiable porque no se encuentra en el almacén Entidades de certificación raíz de confianza. Haga clic en Ver certificado.

  6. En el cuadro de diálogo Certificado, haga clic en Instalar certificado.

    Se abrirá el Asistente para importación de certificados. Haga clic en Siguiente.

  7. En la página Almacén de certificados, seleccione Colocar todos los certificados en el siguiente almacén y haga clic en Examinar.

  8. En Seleccionar almacén de certificados, seleccione Mostrar almacenes físicos. En Seleccione el almacén de certificados que quiere usar, expanda Entidades emisoras de certificados raíz de confianza, seleccione Equipo local y haga clic en Aceptar.

  9. En la página Almacén de certificados, haga clic en Siguiente.

  10. En la página Finalización del Asistente para importación de certificados, haga clic en Finalizar.

  11. Puede que aparezca un cuadro de diálogo del Asistente para importación de certificados que confirmará que la importación se realizó correctamente. Si este cuadro de diálogo aparece, haga clic en Aceptar.

  12. En el cuadro de diálogo Certificado, haga clic en Aceptar. Se cerrará el cuadro de diálogo Certificado del nodo superior de la jerarquía de certificados.

  13. En el cuadro de diálogo Certificado, haga clic en Aceptar. Se cerrará el cuadro de diálogo Certificado del certificado subordinado.

  14. En Alerta de seguridad, haga clic en No.

  15. Abra un explorador y abra el sitio web siguiente, donde CertificateServer es el nombre de su servidor de certificados y port es el número del puerto SSL que asignó a la entidad de certificación:

    https://CertificateServer:port/services/v1.0/serverstatus.asmx

  16. Debería abrirse la página Servicio Web ServerStatus. Así se confirma que ha instalado correctamente el certificado y la entidad de certificación. Cierre el explorador.

Instalar el certificado en los equipos cliente

El certificado debe instalarse localmente en todos los equipos cliente que tienen acceso a Team Foundation. Además, si el equipo cliente ha tenido acceso previamente a un proyecto de equipo de Team Foundation, deberá borrar la caché del cliente correspondiente a todos y cada uno de los usuarios que utilicen el equipo para conectarse a Team Foundation para que esos usuarios puedan conectarse a Team Foundation.

Nota importante:

No siga este procedimiento para los clientes de Team Foundation que están instalados en el servidor que está ejecutando Team Foundation Server.

Para instalar el certificado en los equipos cliente de Team Foundation

  1. Inicie sesión en el equipo cliente de Team Foundation mediante una cuenta que sea miembro del grupo Administradores de ese equipo.

  2. Abra un explorador y abra el sitio web siguiente, donde CertificateServer es el nombre de su servidor de certificados y port es el número del puerto SSL que asignó a la entidad de certificación:

    https://CertificateServer:port/services/v1.0/serverstatus.asmx

  3. Aparecerá un cuadro de diálogo de mensaje de seguridad. En Alerta de seguridad, haga clic en Ver certificado.

  4. En el cuadro de diálogo Certificado, haga clic en la página Ruta de certificación.

  5. En Ruta de certificación, haga clic en la entidad de certificación. Éste debería ser el nodo superior de la jerarquía de certificados y debería haber una X roja al lado del nombre. Esto indica que la entidad de certificación no es confiable porque no se encuentra en el almacén Entidades de certificación raíz de confianza. Haga clic en Ver certificado.

  6. En el cuadro de diálogo Certificado, haga clic en Instalar certificado.

    Se abrirá el Asistente para importación de certificados. Haga clic en Siguiente.

  7. En la página Almacén de certificados, seleccione Colocar todos los certificados en el siguiente almacén y haga clic en Examinar.

  8. En Seleccionar almacén de certificados, seleccione Mostrar almacenes físicos. En Seleccione el almacén de certificados que quiere usar, expanda Entidades emisoras de certificados raíz de confianza, seleccione Equipo local y haga clic en Aceptar.

  9. En la página Almacén de certificados, haga clic en Siguiente.

  10. En la página Finalización del Asistente para importación de certificados, haga clic en Finalizar.

  11. Puede que aparezca un cuadro de diálogo del Asistente para importación de certificados que confirmará que la importación se realizó correctamente. Si el cuadro de diálogo aparece, haga clic en Aceptar.

  12. En el cuadro de diálogo Certificado, haga clic en Aceptar. Se cerrará el cuadro de diálogo Certificado del nodo superior de la jerarquía de certificados.

  13. En el cuadro de diálogo Certificado, haga clic en Aceptar. Se cerrará el cuadro de diálogo Certificado del certificado subordinado.

  14. En Alerta de seguridad, haga clic en No.

  15. Abra un explorador y abra el sitio web siguiente, donde CertificateServer es el nombre de su servidor de certificados y port es el número del puerto SSL que asignó a la entidad de certificación:

    https://CertificateServer:port/services/v1.0/serverstatus.asmx

  16. Debería abrirse la página Servicio Web ServerStatus. Así se confirma que ha instalado correctamente el certificado y la entidad de certificación. Cierre el explorador.

Para borrar la caché en los equipos cliente de Team Foundation

  1. Inicie sesión en el equipo cliente de Team Foundation mediante las credenciales del usuario que desea actualizar.

  2. En el equipo cliente de Team Foundation, cierre todas las instancias abiertas de Visual Studio.

  3. Abra un explorador y abra la carpeta siguiente:

    unidad**:\Documents and Settings\nombreUsuario\Local Settings\Application Data\Microsoft\Team Foundation\2.0\Cache**

  4. Elimine el contenido del directorio Cache. Asegúrese de eliminar todas las subcarpetas.

  5. En el menú Inicio, elija Ejecutar, escriba devenv /resetuserdata y haga clic en Aceptar.

  6. Repita estos pasos para todas las cuentas de usuario del equipo que tengan acceso a Team Foundation.

    Nota:

    Puede ser conveniente distribuir instrucciones sobre cómo borrar la caché a todos los usuarios de Team Foundation para que puedan borrar la caché ellos mismos.

Vea también

Conceptos

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

Otros recursos

Tutoriales sobre la administración de Team Foundation

Proteger Team Foundation Server con HTTPS y Secure Sockets Layer (SSL)