Solución de problemas del adaptador de SharePoint Services
Este tema se centra en la solución de problemas del adaptador de Windows SharePoint Services (WSS).
Instalación
Al usar el adaptador de Windows SharePoint Services (WSS), hay dos opciones:
Opción | Descripción |
---|---|
Usar om de cliente establecido en Sí | Recomendado. Cuando se establece en Sí, se usa el modelo de objetos del lado cliente (CSOM) de SharePoint Services. El adaptador se instala cuando se instala BizTalk Server. No es necesario ningún paso de instalación adicional. Nota: La instalación de BizTalk Server también instala automáticamente el modelo de objetos de cliente de SharePoint Redistributable. |
Use el OM de cliente establecido en No. | En desuso. Usa el modelo de objetos del lado del servicio (SSOM) de SharePoint Services. Se instala un servicio web en el equipo SharePoint Services, que puede estar en el mismo equipo que BizTalk Server o en un equipo independiente. Para instalar el servicio web, ejecute la instalación de BizTalk Server en el equipo SharePoint Services y compruebe Windows SharePoint Services Adaptador. Consulte el Apéndice B: Instalar el adaptador de Microsoft SharePoint para conocer los pasos de instalación específicos. |
Se recomienda usar om de cliente establecido en Sí . Cuando se establece en Sí, el servicio web NO se instala en el equipo de SharePoint. Si prefiere usar la opción de servicio web, debe establecer Usar OM de cliente en No en el BizTalk Server.
IIS
Servicio web BTSharePointAdapterWS.asmx
Cuando el adaptador de Windows SharePoint Services está instalado en el equipo de SharePoint, el servicio web BTSharePointAdapterWS.asmx se crea en IIS en el equipo de SharePoint. Normalmente, BizTalk Server y SharePoint se instalan en equipos diferentes. Cuando Se instala SharePoint, la base de datos SQL de contenido puede ser local en el equipo de SharePoint o en un SQL Server remoto.
Utilización de la cuenta de dominio por parte del Grupo de aplicaciones
Cuando BizTalk y SharePoint se encuentran en equipos distintos, el grupo de aplicaciones IIS que ejecute el servicio web BTSharePointAdapterWS.asmx debe utilizar una cuenta de dominio. Si BizTalk Server, las bases de datos de BizTalk, SharePoint Services y las bases de datos de SQL Server SharePoint se instalan en el mismo equipo, se puede usar una cuenta local.
Escenarios de salto doble
Cuando hay tres equipos implicados (BizTalk Server, SharePoint Services y SQL Server), hay un escenario de doble salto que requiere autenticación Kerberos. El adaptador de SharePoint del equipo de BizTalk realiza una solicitud POST al servicio web BTSharePointAdapterWS.asmx en el equipo de SharePoint. A continuación, el equipo de SharePoint consulta sus bases de datos en el equipo SQL Server.
Esta solicitud POST del adaptador de BizTalk debe completarse correctamente. Si sospecha que existe algún error de autenticación, revise los registros de IIS. De forma predeterminada, los registros de IIS se encuentran en c:\inetpub\logs\LogFiles\W3SVCx. La solicitud POST debe mostrar el código de estado 200 (operación llevada a cabo correctamente). Si se devuelve un código de estado con errores, como 401.2, seguido de un error 401.1, después de otro error 4xx , es posible que se produzca un error en la autenticación.
Cuando se utilice la autenticación Kerberos, es necesario utilizar los nombres principales de servicio (SPN) y debe habilitarse la delegación.
Habilitar la autenticación Kerberos
En un escenario de salto doble, es necesario utilizar la autenticación Kerberos y habilitar la delegación. Los pasos incluyen:
Habilite Negotiate en el servidor IIS/SharePoint. Para obtener más información, vaya a Autenticación de
<windowsAuthentication>
Windows.Los nombres de entidad de seguridad de servicio (SPN) son necesarios para las cuentas de dominio que ejecutan el servicio de SQL Server y el grupo de aplicaciones en el equipo de IIS/SharePoint. Para obtener más información sobre cómo configurar nombres de entidad de seguridad de servicio, vaya a Nombres de entidad de seguridad de servicio (SPN).
Windows 8, Windows Server 2008 SP2, Windows Server 2008 R2 y Windows Server 2012: SetSPN
Importante
SetSPN requiere derechos de administrador del dominio y puede ejecutarse desde cualquier equipo del dominio.
Para devolver una lista de todos los SPN registrados en una cuenta de dominio:
setspn.exe -l Domain\UserAccount
Cree los SPN:
Cree un SPN para el FQDN del equipo de IIS/SharePoint:
setspn.exe -s http/IISSharePointComputerName.domain.com domain\IISApplicationPoolDomainAccount
Cree un SPN para el nombre de NETBIOS del equipo de IIS/SharePoint:
setspn.exe -s http/IISSharePointComputerNamedomain\IISApplicationPoolDomainAccount
Cree un SPN para el FQDN del equipo de SQL Server utilizado por el equipo de IIS/SharePoint:
setspn.exe -s mssqlsvc/SQLComputerName.domain.com domain\SQLServerServiceDomainAccount
Cree un SPN para el FQDN y el TCP Port del equipo de SQL Server utilizado por el equipo de IIS/SharePoint:
setspn.exe -s mssqlsvc/SQLComputerName.domain.com:1433 domain\SQLServerServiceDomainAccount
Cree un SPN para el nombre de NETBIOS del equipo de SQL Server utilizado por el equipo de IIS/SharePoint:
setspn.exe -s mssqlsvc/SQLComputerNamedomain\SQLServerServiceDomainAccount
Cree un SPN para el nombre de NETBIOS, el puerto TCP del equipo de SQL Server utilizado por el equipo de IIS/SharePoint:
setspn.exe -s mssqlsvc/SQLComputerName:1433 domain\SQLServerServiceDomainAccount
En el controlador de dominio, vaya a Usuarios de Active Directory & Equipos y haga lo siguiente:
Compruebe Confiar en este equipo para la delegación en cualquier servicio para los siguientes equipos:
Servidor de SharePoint/IIS
SQL Server utilizado por SharePoint
Compruebe que la cuenta es de confianza para delegación y desactiva La cuenta es confidencial y no se puede delegar para las siguientes cuentas de dominio:
Cuenta de dominio de servicio de SQL Server
Cuenta de dominio del grupo de aplicaciones de IIS
Para solucionar problemas adicionales, vaya a Solución de problemas del adaptador de Windows SharePoint Services.
Consulte también
Configurar la ubicación de recepción de SharePoint Services configurar el CSOM del puerto de envío SharePoint Services: adaptador de SharePoint Services