Partager via

Dépannage de l’adaptateur SharePoint Services

  • Article

Cette rubrique se concentre sur la résolution des problèmes liés à l’adaptateur Windows SharePoint Services (WSS).

Installation

Lors de l’utilisation de l’adaptateur Windows SharePoint Services (WSS), il existe deux options :

Option Description
Utiliser le modèle modèle client défini sur Oui Recommandé. Lorsque la valeur est Oui, le modèle objet côté client (CSOM) SharePoint Services est utilisé. L’adaptateur est installé lorsque BizTalk Server est installé. Aucune étape d’installation supplémentaire n’est nécessaire. Note: L’installation BizTalk Server installe également automatiquement le modèle objet client SharePoint Redistributable.
Utilisez le modèle d’objet client défini sur Non. Déconseillé. Utilise le modèle objet côté service (SSOM) SharePoint Services.

Un service web est installé sur l’ordinateur SharePoint Services, qui peut se trouver sur le même ordinateur que BizTalk Server ou sur un ordinateur distinct.

Pour installer le service web, exécutez l’installation BizTalk Server sur l’ordinateur SharePoint Services et case activée Windows SharePoint Services Adapter. Consultez l’Annexe B : Installer l’adaptateur Microsoft SharePoint pour connaître les étapes d’installation spécifiques.

Il est recommandé d’utiliser le modèle modèle client défini sur Oui. Lorsque la valeur est Oui, le service web n’est PAS installé sur l’ordinateur SharePoint. Si vous préférez utiliser l’option de service web, vous devez définir Utiliser le modèle d’objet client sur Non sur le BizTalk Server.

IIS

Service Web BTSharePointAdapterWS.asmx

Lorsque l’adaptateur Windows SharePoint Services est installé sur l’ordinateur SharePoint, le service web BTSharePointAdapterWS.asmx est créé dans IIS sur l’ordinateur SharePoint. En règle générale, BizTalk Server et SharePoint sont installés sur différents ordinateurs. Lorsque SharePoint est installé, la base de données SQL de contenu peut être locale sur l’ordinateur SharePoint ou sur un SQL Server distant.

Le pool d’applications utilise le compte de domaine

Lorsque BizTalk et SharePoint sont installés sur des ordinateurs distincts, le pool d’applications IIS exécutant le service Web BTSharePointAdapterWS.asmx doit utiliser un compte de domaine. Si BizTalk Server, les bases de données BizTalk, les SharePoint Services et les bases de données SharePoint SQL Server sont tous installés sur le même ordinateur, un compte local peut être utilisé.

Scénario à double tronçon

Lorsqu’il y a trois ordinateurs impliqués (BizTalk Server, SharePoint Services et SQL Server), il existe un scénario à double tronçon qui nécessite une authentification Kerberos. L’adaptateur SharePoint sur l’ordinateur BizTalk effectue une requête POST vers le service Web BTSharePointAdapterWS.asmx sur l’ordinateur SharePoint. L’ordinateur SharePoint interroge ensuite ses bases de données sur l’ordinateur SQL Server.

Cette requête POST en provenance de l’adaptateur BizTalk doit aboutir. Si vous suspectez une défaillance au niveau de l’authentification, consultez les journaux IIS. Par défaut, les journaux IIS se trouvent dans c :\inetpub\logs\LogFiles\W3SVCx. La requête POST doit afficher un code d’état 200 (réussite). Si un code de status ayant échoué est retourné, par exemple 401.2, suivi d’une erreur 401.1, suivi d’une autre erreur 4xx, l’authentification peut échouer.

Lorsque vous utilisez l’authentification Kerberos, des noms de principal de service (SPN) sont requis et la délégation doit être activée.

Activation de l’authentification Kerberos

Dans un scénario à double tronçon, l’authentification Kerberos et l’activation de la délégation sont requis. Procédez comme suit :

  1. Activez Negotiate sur le serveur IIS/SharePoint. Pour plus d’informations, accédez à Authentification <windowsAuthentication>Windows.

  2. Les noms de principal du service (SPN) sont requis pour les comptes de domaine qui exécutent le service SQL Server et le pool d’applications sur l’ordinateur IIS/SharePoint. Pour plus d’informations sur la configuration des noms de principal de service, accédez à Noms de principal de service (SPN).

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

    Important

    La commande SetSPN nécessite des droits d’administrateur de domaine et peut être exécutée à partir de n’importe quel ordinateur dans le domaine.

    Pour renvoyer une liste de tous les noms de principal de service enregistrés dans un compte de domaine :

    setspn.exe -l Domain\UserAccount

    Création des noms de principal de service :

    1. Créez un nom de principal de service pour le nom de domaine complet de l’ordinateur IIS/SharePoint :

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

    2. Créez un nom de principal de service pour le nom NETBIOS de l’ordinateur IIS/SharePoint :

      setspn.exe -s http/IISSharePointComputerNamedomain\IISApplicationPoolDomainAccount

    3. Créez un nom de principal de service pour le nom de domaine complet de l’ordinateur SQL Server utilisé par l’ordinateur IIS/SharePoint :

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

    4. Créez un nom de principal de service pour le nom de domaine complet et le port TCP de l’ordinateur SQL Server utilisé par l’ordinateur IIS/SharePoint :

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

    5. Créez un nom de principal de service pour le nom NETBIOS de l’ordinateur SQL Server utilisé par l’ordinateur IIS/SharePoint :

      setspn.exe -s mssqlsvc/SQLComputerNamedomain\SQLServerServiceDomainAccount

    6. Créez un nom de principal de service pour le nom NETBIOS et le port TCP de l’ordinateur SQL Server utilisé par l’ordinateur IIS/SharePoint :

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

  3. Sur le contrôleur de domaine, accédez à Utilisateurs Active Directory & Ordinateurs et procédez comme suit :

    1. Vérifiez Approuver cet ordinateur pour la délégation à n’importe quel service pour les ordinateurs suivants :

      • Serveur SharePoint/IIS

      • Serveur SQL Server utilisé par SharePoint

    2. Vérifiez que le compte est approuvé pour la délégation et décochez l’option Le compte est sensible et ne peut pas être délégué pour les comptes de domaine suivants :

      • Compte de domaine du service SQL Server

      • Compte de domaine du pool d’applications IIS

    Pour plus de résolution des problèmes, accédez à Résolution des problèmes de l’adaptateur Windows SharePoint Services

Voir aussi

Configurer SharePoint Services emplacement de réception Configurer SharePoint Services modèle CSOM du port d’envoi: adaptateur SharePoint Services