Programmation de la sécurité dans WCF

Cette rubrique répertorie les principales tâches de programmation à effectuer pour créer une application Windows Communication Foundation (WCF) sécurisée. Cette rubrique traite uniquement de l'authentification, de la confidentialité et de l'intégrité, désignées collectivement par le terme sécurité de transfert. Cette rubrique n'aborde pas l'autorisation (c'est-à-dire le contrôle d'accès aux ressources ou aux services). Pour plus d'informations sur l'autorisation, consultez Autorisation.

Remarque :
Pour une bonne introduction aux concepts de sécurité, notamment concernant WCF, consultez l'ensemble des didacticiels portant sur les modèles et pratiques sur MSDN dans Scénarios, modèles et guide d'implémentation de Web Services Enhancements (WSE) 3.0 (page pouvant être en anglais).

La programmation de la sécurité WCF s'effectue en trois étapes : mode de sécurité, type d'informations d'identification client et valeurs des informations d'identification. Ces étapes peuvent être effectuées au choix dans le code ou la configuration.

Définition du mode de sécurité

Les explications ci-dessous portent sur les étapes générales de la programmation du mode de sécurité dans WCF:

1. Sélectionnez une liaison prédéfinie adaptée aux spécifications de votre application. Pour obtenir une liste des liaisons, consultez Liaisons fournies par le système. Par défaut, la sécurité de pratiquement toutes les liaisons est activée. La classe BasicHttpBinding fait exception à cette règle (dans la configuration, l'élément basicHttpBinding Element).
   Le transport dépend de la liaison sélectionnée. Par exemple, WSHttpBinding utilise le transport HTTP tandis que NetTcpBinding utilise le transport TCP.
2. Sélectionnez l'un des modes de sécurité disponibles pour la liaison. Remarque : les modes de sécurité disponibles dépendent de la liaison sélectionnée. Par exemple, la liaison WSDualHttpBinding ne permet pas de définir le niveau transport comme mode de sécurité (ce mode n'est pas disponible pour cette liaison). De la même façon, les liaisons MsmqIntegrationBinding et NetNamedPipeBinding ne permettent pas de définir le niveau message comme mode de sécurité.
   Trois choix sont possibles :
   1. Transport
      La sécurité de transport dépend du mécanisme utilisé par la liaison sélectionnée. Par exemple, si vous utilisez la liaison WSHttpBinding, la sécurité utilisée correspondra à Secure Sockets Layer (SSL) (il s'agit également de la sécurité utilisée pour le protocole HTTPS). De manière générale, le principal avantage de la sécurité de niveau transport réside dans le fait qu'elle offre un débit relativement élevé quel que soit le transport utilisé. Elle présente cependant deux inconvénients. Le premier réside dans le fait que le mécanisme de transport impose quel type d'informations d'identification doit être utilisé pour authentifier un utilisateur. Cela pose problème uniquement lorsque le service concerné doit interagir avec d'autres services exigeant un autre type d'informations d'identification. Le second réside dans le fait que la sécurité est implémentée saut par saut plutôt que de bout en bout. Cela peut poser un problème lorsque les messages circulant entre le client et le service concernés rencontrent des intermédiaires. Pour plus d'informations sur le transport à utiliser, consultez Choix d'un transport. Pour plus d'informations sur l'utilisation de la sécurité de transport, consultez Vue d'ensemble de la sécurité des transports.
   2. Message
      La sécurité de niveau message signifie que chaque message comporte les en-têtes et les données nécessaires à sa sécurisation. La composition des en-têtes variant, vous pouvez ajouter aux messages un nombre illimité d'informations d'identification. Cette possibilité est essentielle lorsque votre service doit interagir avec des services exigeant un type d'informations d'identification spécifique qu'un mécanisme de transport ne peut fournir ou lorsqu'un message doit être utilisé par plusieurs services, chacun d'eux exigeant un type d'informations d'identification différent.
      Pour plus d'informations, consultez Sécurité des messages dans WCF.
   3. TransportWithMessageCredential
      Ce mode utilise la couche de transport pour sécuriser le transfert des messages, tandis que chaque message inclut l'ensemble des informations d'identification requises par les autres services. Ce mode allie les avantages de la sécurité de niveau transport aux avantages présentés par la sécurité de niveau message, notamment celui d'utiliser un nombre illimité d'informations d'identification. Ce mode est disponible avec les liaisons suivantes : BasicHttpBinding, WSFederationHttpBinding, NetPeerTcpBinding et WSHttpBinding.
3. Si vous choisissez d'utiliser la sécurité de transport pour HTTP, c'est-à-dire HTTPS, vous devez également configurer l'hôte avec un certificat SSL et activer ce certificat sur l'un des ports de votre ordinateur. Pour plus d'informations, consultez Sécurité de transport HTTP.
4. Si vous utilisez la liaison WSHttpBinding et que vous n'avez pas besoin d'établir une session sécurisée, affectez à la propriété EstablishSecurityContext la valeur false.
   Une session sécurisée intervient lorsqu'un client et un service créent un canal à l'aide d'une clé symétrique (le client et le serveur utilisent la même clé pendant toute la durée de la conversation, jusqu'au terme de celle-ci).

Définition du type d'informations d'identification client

Sélectionnez un type d'informations d'identification client comme requis. Pour plus d'informations, consultez Sélection d'un type d'informations d'identification. Les types suivants d'informations d'identification client sont disponibles :

• Windows
• Certificate
• Digest
• Basic
• UserName
• NTLM
• IssuedToken

Vous devez définir le type d'informations d'identification en fonction du mode de sécurité que vous avez sélectionné. Par exemple, si vous avez sélectionné la liaison wsHttpBinding et que vous avez affecté au mode de sécurité la valeur Message, vous pouvez alors affecter à l'attribut clientCredentialType de l'élément de message l'une des valeurs suivantes : None, Windows, UserName, Certificate et IssuedToken, comme illustré dans l'exemple de configuration suivant.

<system.serviceModel>
<bindings>
  <wsHttpBinding>
    <binding name="myBinding">
      <security mode="Message"/>
      <message clientCredentialType="Windows"/>
    </binding>
</bindings>
</system.serviceModel>

Ou dans le code :

Définition des valeurs d'informations d'identification service

Après avoir sélectionné un type d'informations d'identification client, vous devez définir les informations d'identification que le client et le service devront effectivement utiliser. Du côté service, les informations d'identification sont définies à l'aide de la classe ServiceCredentials et sont retournées par la propriété Credentials de la classe ServiceHostBase. Les types d'informations d'identification service et client ainsi que le mode de sécurité dépendent de la liaison utilisée. L'exemple de code suivant définit un certificat pour les informations d'identification service.

Définition des valeurs d'informations d'identification client

Du côté client, les informations d'identification sont définies à l'aide de la classe ClientCredentials et sont retournées par la propriété ClientCredentials de la classe ClientBase. L'exemple de code suivant définit un certificat pour les informations d'identification client, le protocole TCP étant utilisé.

Voir aussi

Autres ressources

Programmation WCF de base
Scénarios de sécurité courants