Condividi tramite

Risoluzione dei problemi relativi all'adapter SharePoint Services

  • Articolo

Questo argomento è incentrato sulla risoluzione dei problemi dell'adattatore Windows SharePoint Services (WSS).

Installazione

Quando si usa l'adattatore WSS (Windows SharePoint Services), sono disponibili due opzioni:

Opzione Descrizione
Usare l'opzione Om client impostata su Sì Consigliato. Se impostato su Sì, viene usato il modello a oggetti lato client (CSOM) SharePoint Services. L'adattatore viene installato quando viene installato BizTalk Server. Non è necessario eseguire altre operazioni di installazione. Nota: L'installazione di BizTalk Server installa automaticamente anche il modello a oggetti client SharePoint Redistributable.
Usare l'opzione Om client impostata su No. Deprecato. Usa il modello a oggetti lato servizio SharePoint Services (SSOM).

Un servizio Web è installato nel computer SharePoint Services, che può essere nello stesso computer di BizTalk Server o un computer separato.

Per installare il servizio Web, eseguire l'installazione BizTalk Server nel computer SharePoint Services e controllare Windows SharePoint Services Adapter. Vedere Appendice B: Installare l'adattatore Microsoft SharePoint per i passaggi di installazione specifici.

È consigliabile usare l'opzione Om client impostata su Sì. Se impostato su Sì, il servizio Web non è installato nel computer SharePoint. Se si preferisce usare l'opzione servizio Web, è necessario impostare Usa OM client su No nella BizTalk Server.

IIS

Servizio Web BTSharePointAdapterWS.asmx

Quando l'adattatore Windows SharePoint Services viene installato nel computer SharePoint, il servizio Web BTSharePointAdapterWS.asmx viene creato in IIS nel computer SharePoint. In genere, BizTalk Server e SharePoint vengono installati in computer diversi. Quando SharePoint è installato, il database SQL del contenuto può essere locale nel computer SharePoint o in un SQL Server remoto.

Account di dominio utilizzato dal pool di applicazioni

Quando BizTalk e SharePoint sono installati in computer diversi, il pool di applicazioni IIS che esegue il servizio Web BTSharePointAdapterWS.asmx deve utilizzare un account di dominio. Se BizTalk Server, i database BizTalk, SharePoint Services e i database di SharePoint SQL Server vengono installati nello stesso computer, è possibile usare un account locale.

Scenario con doppio hop

Quando sono presenti tre computer coinvolti (BizTalk Server, SharePoint Services e SQL Server), esiste uno scenario a doppio hop che richiede l'autenticazione Kerberos. L'adapter SharePoint nel computer BizTalk invia una richiesta POST al servizio Web BTSharePointAdapterWS.asmx nel computer SharePoint. Il computer SharePoint esegue quindi query sui relativi database nel computer SQL Server.

La richiesta POST proveniente dall'adapter BizTalk deve essere completata correttamente. Se si sospetta un errore di autenticazione, esaminare i registri IIS. Per impostazione predefinita, i log IIS sono in c:\inetpub\logs\LogFiles\W3SVCx. La richiesta POST dovrebbe visualizzare un codice di stato 200, indicante l'esito positivo dell'operazione. Se viene restituito un codice di stato non riuscito, ad esempio 401.2, seguito da un errore 401.1, seguito da un altro errore 4xx , l'autenticazione potrebbe non riuscire.

Quando viene utilizzata l'autenticazione Kerberos, i nomi delle entità servizio (SPN, Service Principal Name) sono obbligatori e la delega deve essere abilitata.

Abilitare l'autenticazione Kerberos

In uno scenario con doppio hop è necessario utilizzare l'autenticazione Kerberos e abilitare la delega. Di seguito è riportata la procedura:

  1. Abilitare Negoziazione nel server IIS/SharePoint. Per altre informazioni, passare a Autenticazione <windowsAuthentication>di Windows .

  2. I nomi dell'entità servizio (SPN) sono necessari per gli account di dominio che eseguono il servizio SQL Server e il pool di applicazioni nel computer IIS/SharePoint. Per altre informazioni sulla configurazione dei nomi dell'entità servizio, passare a Nomi entità servizio (SPN).

    Windows 8, Windows Server 2008 SP2, Windows Server 2008 R2 e Windows Server 2012: SetSPN

    Importante

    SetSPN richiede diritti di amministratore di dominio e può essere eseguito da qualsiasi computer del dominio.

    Per restituire un elenco di tutti gli SPN registrati per un account di dominio:

    setspn.exe -l Domain\UserAccount

    Creare gli SPN:

    1. Creare un SPN per l'FQDN del computer IIS/SharePoint:

      setspn.exe -s http/IISSharePointComputerName.domain.com domain\IISApplicationPoolDomainAccount

    2. Creare un SPN per il nome NETBIOS del computer IIS/SharePoint:

      setspn.exe -s http/IISSharePointComputerNamedomain\IISApplicationPoolDomainAccount

    3. Creare un SPN per l'FQDN del computer SQL Server utilizzato dal computer IIS/SharePoint:

      setspn.exe -s mssqlsvc/SQLComputerName.domain.com domain\SQLServerServiceDomainAccount

    4. Creare un SPN per l'FQDN e la porta TCP del computer SQL Server utilizzato dal computer IIS/SharePoint:

      setspn.exe -s mssqlsvc/SQLComputerName.domain.com:1433 domain\SQLServerServiceDomainAccount

    5. Creare un SPN per il nome NETBIOS del computer SQL Server utilizzato dal computer IIS/SharePoint:

      setspn.exe -s mssqlsvc/SQLComputerNamedomain\SQLServerServiceDomainAccount

    6. Creare un SPN per il nome NETBIOS e la porta TCP del computer SQL Server utilizzato dal computer IIS/SharePoint:

      setspn.exe -s mssqlsvc/SQLComputerName:1433 domain\SQLServerServiceDomainAccount

  3. Nel controller di dominio passare a Utenti di Active Directory & Computer ed eseguire le operazioni seguenti:

    1. Controllare Attendibilità del computer per la delega a qualsiasi servizio per i computer seguenti:

      • Server SharePoint/IIS

      • Server SQL utilizzato da SharePoint

    2. Controllare che l'account sia attendibile per la delega e deselezionare Account è sensibile e non può essere delegato per gli account di dominio seguenti:

      • Account di dominio del servizio SQL Server

      • Account di dominio del pool di applicazioni IIS

    Per altre informazioni sulla risoluzione dei problemi, vedere Risoluzione dei problemi dell'adattatore Windows SharePoint Services

Vedere anche

Configurare SharePoint Services percorso di ricezione Configurare SharePoint Services CSOM della porta di trasmissione: adattatore SharePoint Services