Procédure : Configurer Service Bus Client à l'aide d'un fichier de configuration
Une fois que vous avez défini et implémenté votre interface Service Bus de Windows Azure, vous pouvez configurer l’application cliente. Vous pouvez configurer votre application par programme ou dans un fichier App.config. La configuration de votre application dans un fichier App.config permet de voir facilement les paramètres de configuration et permet aux utilisateurs de les modifier après le déploiement. Notez que la configuration d’une application Service Bus à l’aide d’un fichier de configuration est très similaire à la configuration d’une application Windows Communication Foundation (WCF), procédure abordée dans la rubrique Configuration de services à l’aide de fichiers de configuration de la documentation Windows Communication Foundation (WCF). Par conséquent, la présentation suivante donne une vue d’ensemble simplifiée de la configuration, en mettant l’accent sur les fonctionnalités uniques en rapport avec le Service Bus.
La principale différence entre la configuration d’un service et d’un client est que le client doit connaître les paramètres de configuration que le service utilise et les faire correspondre. Ces paramètres incluent généralement le type de liaison à utiliser ainsi que les protocoles de sécurité que vous devez avoir pour accéder au service (c’est-à-dire la sécurité au niveau de l’authentification et du transport). Pour en savoir plus sur la sécurité des paramètres Pour plus d'informations sur le sujet suivant, voir Sécurisation et authentification d'une connexion Service Bus.
Pour configurer Service Bus Client à l’aide d’un fichier App.config
-
Créez le fichier App.config pour définir le point de terminaison du client.
<?xml version="1.0" encoding="utf-8" ?> <configuration> <system.serviceModel> <client> <endpoint name="RelayEndpoint" contract="Microsoft.ServiceBus.Samples.IEchoContract" binding="netTcpRelayBinding" bindingConfiguration="default" behaviorConfiguration="sharedSecretEndpointBehavior" address="" /> </client> </system.serviceModel> </configuration>Comme pour la configuration d’une application de service, les paramètres minimaux que vous devez avoir pour configurer un point de terminaison sont le contrat qui implémente le service et le type de liaison utilisé. L’attribut de l’adresse est l’adresse Service Bus. Il peut être spécifié explicitement dans le fichier de configuration, mais il est habituellement construit par programme à l’aide de la méthode CreateServiceUri. Cet exemple associe également un comportement de point de terminaison au client.
-
Définissez le comportement de point de terminaison qui contient les paramètres de sécurité.
<behaviors> <endpointBehaviors> <behavior name="sharedSecretEndpointBehavior"> <transportClientEndpointBehavior credentialType="SharedSecret"> <clientCredentials> <sharedSecret issuerName="ISSUER_NAME" issuerSecret="ISSUER_SECRET" /> </clientCredentials> </transportClientEndpointBehavior> </behavior> </endpointBehaviors> </behaviors>Dans cet exemple, par souci de simplicité, les informations d’identification de sécurité sont définies à l’aide du nom de l’émetteur et du secret en texte clair Notez qu’il s’agit d’une pratique de programmation non sécurisée : un processus plus sécurisé (et le processus utilisé par un grand nombre d’exemples du kit de développement logiciel Windows Azure) consiste à demander ces informations à l’utilisateur. Vous pouvez également décider de crypter le fichier App.config pour éviter d’exposer ces informations.
-
Définissez la liaison que l’application cliente doit utiliser lorsqu’elle se connecte au Service Bus.
<bindings> <!-- Application Binding --> <netTcpRelayBinding> <!-- Default Binding Configuration--> <binding name="default" /> </binding> </bindings> -
Vous avez terminé la configuration de l’application cliente via le fichier App.config. Pour plus d’informations sur la création d’une application cliente Service Bus, voir Génération d'une application Service Bus Client.