Obtenir les paramètres de l'utilisateur Exchange à l'aide de découverte automatique
Découvrez comment obtenir les paramètres de configuration utilisateur à partir d’un serveur Exchange à l’aide de la découverte automatique.
La découverte automatique simplifie la configuration de l’application en fournissant un accès facile aux informations de configuration utilisateur en utilisant uniquement l’adresse e-mail et le mot de passe de l’utilisateur. Un certain nombre de paramètres de configuration utilisateur sont disponibles via la découverte automatique, comme le nom d’affichage de l’utilisateur ou l’URL du service web externe.
Vous pouvez utiliser l’une des technologies de développement suivantes pour récupérer les paramètres utilisateur à partir du service de découverte automatique :
L'API managée EWS fournit une interface basée sur des objets pour récupérer les paramètres de l'utilisateur. Si votre application cliente utilise du code managé, nous vous recommandons de choisir l'API managée EWS. Si vous utilisez l’API managée EWS, déterminez si les paramètres dont vous avez besoin sont disponibles dans l’énumération Microsoft.Exchange.WebServices.Autodiscover.UserSettingName . Si ce n’est pas le cas, vous pouvez utiliser les services de découverte automatique SOAP ou POX.
Si vous utilisez un service web, nous vous suggérons d’utiliser le service de découverte automatique SOAP, car il prend en charge un ensemble de fonctionnalités plus riche que le service de découverte automatique POX. Si le service de découverte automatique SOAP n’est pas disponible, le service de découverte automatique POX est une bonne alternative.
Configurer pour obtenir les paramètres utilisateur
Avant d’obtenir les paramètres utilisateur à l’aide du service de découverte automatique, vérifiez que vous avez accès aux éléments suivants :
Si vous utilisez l’API managée EWS ou le service de découverte automatique basé sur POX, Exchange Online, Exchange Online dans le cadre de Office 365 ou un serveur qui exécute une version d’Exchange à partir d’Exchange 2007 SP1.
Si vous utilisez le service de découverte automatique soap, Exchange Online ou une version d’Exchange à partir d’Exchange 2010.
Remarque
Si vous utilisez l’API managée EWS, vous devez fournir une méthode de rappel de validation de certificat dans certains cas. Vous pouvez également avoir besoin d’une méthode de rappel de validation de certificat avec certaines bibliothèques proxy générées, telles que celles créées par Visual Studio.
Obtenir les paramètres utilisateur à l’aide de l’API managée EWS
Vous pouvez utiliser la méthode GetUserSettings pour récupérer les informations de configuration d’un utilisateur, comme illustré dans l’exemple suivant. Dans cet exemple, vous pouvez spécifier un tableau de paramètres utilisateur à retourner (à partir de ceux disponibles dans l’énumération UserSettingName ), et la méthode suit les réponses de redirection du serveur Exchange.
using System;
using System.Net;
using Microsoft.Exchange.WebServices.Autodiscover;
public static GetUserSettingsResponse GetUserSettings(
AutodiscoverService service,
string emailAddress,
int maxHops,
params UserSettingName[] settings)
{
Uri url = null;
GetUserSettingsResponse response = null;
for (int attempt = 0; attempt < maxHops; attempt++)
{
service.Url = url;
service.EnableScpLookup = (attempt < 2);
response = service.GetUserSettings(emailAddress, settings);
if (response.ErrorCode == AutodiscoverErrorCode.RedirectAddress)
{
url = new Uri(response.RedirectTarget);
}
else if (response.ErrorCode == AutodiscoverErrorCode.RedirectUrl)
{
url = new Uri(response.RedirectTarget);
}
else
{
return response;
}
}
throw new Exception("No suitable Autodiscover endpoint was found.");
}
Vous pouvez analyser la collection retournée pour accéder à chaque paire clé/valeur dans le tableau des paramètres utilisateur. L'exemple suivant montre comment analyser chaque élément retourné et affiche le nom et la valeur de chaque paire clé/valeur.
// Display each retrieved value. The settings are part of a key/value pair.
// userresponse is a GetUserSettingsResonse object.
foreach (KeyValuePair<UserSettingName, Object> usersetting in userresponse.Settings)
{
Console.WriteLine(usersetting.Key.ToString() + ": " + usersetting.Value);
}
Vous pouvez également obtenir la valeur d'un paramètre spécifique. Dans l’exemple suivant, le paramètre UserDisplayName doit être affiché.
// Display a specific setting, such as UserDisplayName.
Console.WriteLine(userresponse.Settings[UserSettingName.UserDisplayName]);
Obtenir les paramètres utilisateur à l’aide de la découverte automatique SOAP
Si vous n’utilisez pas l’API managée EWS, nous vous recommandons d’utiliser le service web de découverte automatique SOAP. Utilisez uniquement le service web de découverte automatique POX si le service web de découverte automatique SOAP échoue ou n’est pas disponible.
Pour obtenir les paramètres utilisateur, utilisez l’opération GetUserSettings (SOAP). Les paramètres demandés sont retournés en tant qu’éléments UserSetting.
L’exemple suivant montre une demande de découverte automatique SOAP pour obtenir les paramètres utilisateur du serveur.
<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope xmlns:a="https://schemas.microsoft.com/exchange/2010/Autodiscover"
xmlns:wsa="http://www.w3.org/2005/08/addressing"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:soap="https://schemas.xmlsoap.org/soap/envelope/">
<soap:Header>
<a:RequestedServerVersion>Exchange2013</a:RequestedServerVersion>
<wsa:Action>https://schemas.microsoft.com/exchange/2010/Autodiscover/Autodiscover/GetUserSettings</wsa:Action>
<wsa:To>https://autodiscover.exchange.microsoft.com/autodiscover/autodiscover.svc</wsa:To>
</soap:Header>
<soap:Body>
<a:GetUserSettingsRequestMessage xmlns:a="https://schemas.microsoft.com/exchange/2010/Autodiscover">
<a:Request>
<a:Users>
<a:User>
<a:Mailbox>mara@contoso.com</a:Mailbox>
</a:User>
</a:Users>
<a:RequestedSettings>
<a:Setting>UserDisplayName</a:Setting>
<a:Setting>UserDN</a:Setting>
<a:Setting>UserDeploymentId</a:Setting>
<a:Setting>InternalMailboxServer</a:Setting>
<a:Setting>MailboxDN</a:Setting>
<a:Setting>PublicFolderServer</a:Setting>
<a:Setting>ActiveDirectoryServer</a:Setting>
<a:Setting>ExternalMailboxServer</a:Setting>
<a:Setting>EcpDeliveryReportUrlFragment</a:Setting>
<a:Setting>EcpPublishingUrlFragment</a:Setting>
<a:Setting>EcpTextMessagingUrlFragment</a:Setting>
<a:Setting>ExternalEwsUrl</a:Setting>
<a:Setting>CasVersion</a:Setting>
<a:Setting>EwsSupportedSchemas</a:Setting>
<a:Setting>GroupingInformation</a:Setting>
</a:RequestedSettings>
</a:Request>
</a:GetUserSettingsRequestMessage>
</soap:Body>
</soap:Envelope>
L’exemple suivant montre la réponse SOAP retournée par le serveur après avoir analysé la requête du client. La réponse contient uniquement les paramètres demandés, s’ils existent.
<s:Envelope xmlns:s="https://schemas.xmlsoap.org/soap/envelope/" xmlns:a="http://www.w3.org/2005/08/addressing">
<s:Header>
<a:Action s:mustUnderstand="1">https://schemas.microsoft.com/exchange/2010/
Autodiscover/Autodiscover/GetUserSettingsResponse</a:Action>
<h:ServerVersionInfo xmlns:h="https://schemas.microsoft.com/exchange/2010/Autodiscover"
xmlns:i="http://www.w3.org/2001/XMLSchema-instance">
<h:MajorVersion>15</h:MajorVersion>
<h:MinorVersion>0</h:MinorVersion>
<h:MajorBuildNumber>160</h:MajorBuildNumber>
<h:MinorBuildNumber>4</h:MinorBuildNumber>
<h:Version>Exchange2013</h:Version>
</h:ServerVersionInfo>
</s:Header>
<s:Body>
<GetUserSettingsResponseMessage xmlns="https://schemas.microsoft.com/exchange/2010/Autodiscover">
<Response xmlns:i="http://www.w3.org/2001/XMLSchema-instance">
<ErrorCode>NoError</ErrorCode>
<ErrorMessage />
<UserResponses>
<UserResponse>
<ErrorCode>NoError</ErrorCode>
<ErrorMessage>No error.</ErrorMessage>
<RedirectTarget i:nil="true" />
<UserSettingErrors />
<UserSettings>
<UserSetting i:type="StringSetting">
<Name>UserDisplayName</Name>
<Value>Mara Whitley</Value>
</UserSetting>
<UserSetting i:type="StringSetting">
<Name>UserDN</Name>
<Value>/o=microsoft/ou=Exchange Administrative Group (FYDIBOHF23SPDLT)/cn=Recipients/cn=mara</Value>
</UserSetting>
<UserSetting i:type="StringSetting">
<Name>UserDeploymentId</Name>
<Value>649d50b8-a1ce-4bac-8ace-2321 e463f701</Value>
</UserSetting>
<UserSetting i:type="StringSetting">
<Name>CasVersion</Name>
<Value>15.01.0160.004</Value>
</UserSetting>
<UserSetting i:type="StringSetting">
<Name>EwsSupportedSchemas</Name>
<Value>Exchange2007, Exchange2007_SP1, Exchange2010, Exchange2010_SP1, Exchange2010_SP2, Exchange2013</Value>
</UserSetting>
<UserSetting i:type="StringSetting">
<Name>InternalMailboxServer</Name>
<Value>mail.contoso.com</Value>
</UserSetting>
<UserSetting i:type="StringSetting">
<Name>ActiveDirectoryServer</Name>
<Value>dc.contoso.com</Value>
</UserSetting>
<UserSetting i:type="StringSetting">
<Name>MailboxDN</Name>
<Value>/o=microsoft/ou=Exchange Administrative Group
(FYDIBOHF23SPDLT)/cn=Configuration/cn=Servers/cn=mail.contoso.com/cn=Contoso Private MDB</Value>
</UserSetting>
<UserSetting i:type="StringSetting">
<Name>PublicFolderServer</Name>
<Value>public.contoso.com</Value>
</UserSetting>
<UserSetting i:type="StringSetting">
<Name>EcpDeliveryReportUrlFragment</Name>
<Value>PersonalSettings/DeliveryReport.aspx?exsvurl=1&amp;IsOWA=&lt;IsOWA&gt;&amp;MsgID=&lt;MsgID&gt;&amp;Mbx=&lt;Mbx&gt;</Value>
</UserSetting>
<UserSetting i:type="StringSetting">
<Name>EcpTextMessagingUrlFragment</Name>
<Value>?p=sms/textmessaging.slab&amp;exsvurl=1</Value>
</UserSetting>
<UserSetting i:type="StringSetting">
<Name>EcpPublishingUrlFragment</Name>
<Value>customize/calendarpublishing.slab?exsvurl=1&amp;FldID=&lt;FldID&gt;</Value>
</UserSetting>
<UserSetting i:type="StringSetting">
<Name>ExternalEwsUrl</Name>
<Value>https://mail.contoso.com/EWS/Exchange.asmx</Value>
</UserSetting>
<UserSetting i:type="StringSetting">
<Name>ExternalMailboxServer</Name>
<Value>mail.contoso.com</Value>
</UserSetting>
<UserSetting i:type="StringSetting">
<Name>GroupingInformation</Name>
<Value>CONTOSO-1</Value>
</UserSetting>
</UserSettings>
</UserResponse>
</UserResponses>
</Response>
</GetUserSettingsResponseMessage>
</s:Body>
</s:Envelope
Obtenir les paramètres utilisateur à l’aide de la découverte automatique POX
Bien que nous vous recommandons d’utiliser le service web de découverte automatique SOAP, le service web de découverte automatique POX est une bonne option de sauvegarde pour les moments où SOAP n’est pas disponible. Par exemple, Exchange 2007 ne prend pas en charge le service web de découverte automatique SOAP. Par conséquent, si vous ciblez Exchange 2007, vous devez utiliser le service web de découverte automatique POX. Contrairement au service web de découverte automatique SOAP, le service de découverte automatique POX ne vous permet pas de demander des paramètres spécifiques. Au lieu de cela, le serveur retourne une liste complète des paramètres disponibles en tant qu’éléments enfants de l’élément Protocol.
L’exemple suivant montre une demande de découverte automatique POX pour obtenir les paramètres utilisateur du serveur. Le code XML suivant est envoyé au serveur par le biais d’une requête HTTP POST.
<?xml version="1.0" encoding="utf-8"?>
<Autodiscover xmlns="https://schemas.microsoft.com/exchange/autodiscover/outlook/requestschema/2006">
<Request>
<EMailAddress>mara@contoso.com</EMailAddress>
<AcceptableResponseSchema>https://schemas.microsoft.com/exchange/autodiscover/outlook/responseschema/2006a</AcceptableResponseSchema>
</Request>
</Autodiscover>
L’exemple suivant montre la réponse POX retournée par le serveur.
<?xml version="1.0" encoding="utf-8"?>
<Autodiscover xmlns="https://schemas.microsoft.com/exchange/autodiscover/responseschema/2006">
<Response xmlns="https://schemas.microsoft.com/exchange/autodiscover/outlook/responseschema/2006a">
<User>
<DisplayName>Mara Whitley</DisplayName>
<LegacyDN>/o=First Organization/ou=Exchange Administrative Group (FYDIBOHF23SPDLT)/cn=Recipients/cn=f5eeabead90d4b6fb51d6379474692cd-Mara</LegacyDN>
<AutoDiscoverSMTPAddress>mara@contoso.com</AutoDiscoverSMTPAddress>
<DeploymentId>50817eff-b925-4578-a0db-13bfc635e7a5</DeploymentId>
</User>
<Account>
<AccountType>email</AccountType>
<Action>settings</Action>
<MicrosoftOnline>False</MicrosoftOnline>
<Protocol>
<Type>EXCH</Type>
<Server>5f76be3c-9138-4f66-85e0-21bc23ca35f0@contoso.com</Server>
<ServerDN>/o=First Organization/ou=Exchange Administrative Group (FYDIBOHF23SPDLT)/cn=Configuration/cn=Servers/cn=5f76be3c-9138-4f66-85e0-21bc23ca35f0@contoso.com</ServerDN>
<ServerVersion>73C08204</ServerVersion>
<MdbDN>/o=First Organization/ou=Exchange Administrative Group (FYDIBOHF23SPDLT)/cn=Configuration/cn=Servers/cn=5f76be3c-9138-4f66-85e0-21bc23ca35f0@contoso.com/cn=Microsoft Private MDB</MdbDN>
<PublicFolderServer>public.contoso.com</PublicFolderServer>
<AD>dc.contoso.com</AD>
<ASUrl>https://mail.contoso.com/EWS/Exchange.asmx</ASUrl>
<EwsUrl>https://mail.contoso.com/EWS/Exchange.asmx</EwsUrl>
<EmwsUrl>https://mail.contoso.com/EWS/Exchange.asmx</EmwsUrl>
<EcpUrl>https://mail.contoso.com/ecp/</EcpUrl>
<EcpUrl-um>?rfr=olk&amp;p=customize/voicemail.aspx&amp;exsvurl=1&amp;realm=contoso.com</EcpUrl-um>
<EcpUrl-aggr>?rfr=olk&amp;p=personalsettings/EmailSubscriptions.slab&amp;exsvurl=1&amp;realm=contoso.com</EcpUrl-aggr>
<EcpUrl-mt>PersonalSettings/DeliveryReport.aspx?rfr=olk&amp;exsvurl=1&amp;IsOWA=&lt;IsOWA&gt;&amp;MsgID=&lt;MsgID&gt;&amp;Mbx=&lt;Mbx&gt;&amp;realm=contoso.com</EcpUrl-mt>
<EcpUrl-ret>?rfr=olk&amp;p=organize/retentionpolicytags.slab&amp;exsvurl=1&amp;realm=contoso.com</EcpUrl-ret>
<EcpUrl-sms>?rfr=olk&amp;p=sms/textmessaging.slab&amp;exsvurl=1&amp;realm=contoso.com</EcpUrl-sms>
<EcpUrl-publish>customize/calendarpublishing.slab?rfr=olk&amp;exsvurl=1&amp;FldID=&lt;FldID&gt;&amp;realm=contoso.com</EcpUrl-publish>
<EcpUrl-photo>PersonalSettings/EditAccount.aspx?rfr=olk&amp;chgPhoto=1&amp;exsvurl=1&amp;realm=contoso.com</EcpUrl-photo>
<EcpUrl-tm>?rfr=olk&amp;ftr=TeamMailbox&amp;exsvurl=1&amp;realm=contoso.com</EcpUrl-tm>
<EcpUrl-tmCreating>?rfr=olk&amp;ftr=TeamMailboxCreating&amp;SPUrl=&lt;SPUrl&gt;&amp;Title=&lt;Title&gt;&amp;SPTMAppUrl=&lt;SPTMAppUrl&gt;&amp;exsvurl=1&amp;realm=contoso.com</EcpUrl-tmCreating>
<EcpUrl-tmEditing>?rfr=olk&amp;ftr=TeamMailboxEditing&amp;Id=&lt;Id&gt;&amp;exsvurl=1&amp;realm=contoso.com</EcpUrl-tmEditing>
<EcpUrl-extinstall>Extension/InstalledExtensions.slab?rfr=olk&amp;exsvurl=1&amp;realm=contoso.com</EcpUrl-extinstall>
<OOFUrl>https://mail.contoso.com/EWS/Exchange.asmx</OOFUrl>
<UMUrl>https://mail.contoso.com/EWS/UM2007Legacy.asmx</UMUrl>
<OABUrl>https://mail.contoso.com/OAB/c21c7bc2-53b3-4ddc-ad89-1219b486c37c/</OABUrl>
<ServerExclusiveConnect>off</ServerExclusiveConnect>
</Protocol>
<Protocol>
<Type>EXPR</Type>
<Server>mail.contoso.com</Server>
<SSL>Off</SSL>
<AuthPackage>Ntlm</AuthPackage>
<ServerExclusiveConnect>on</ServerExclusiveConnect>
<CertPrincipalName>None</CertPrincipalName>
</Protocol>
<Protocol>
<Type>WEB</Type>
<Internal>
<OWAUrl AuthenticationMethod="Basic, Fba">https://mail.contoso.com/owa/</OWAUrl>
<Protocol>
<Type>EXCH</Type>
<ASUrl>https://mail.contoso.com/EWS/Exchange.asmx</ASUrl>
</Protocol>
</Internal>
</Protocol>
</Account>
</Response>
</Autodiscover>
Étapes suivantes
Une fois que vous avez récupéré les détails de configuration nécessaires pour votre utilisateur à partir du serveur, vous êtes prêt à communiquer avec Exchange pour effectuer les tâches nécessaires à votre application. Ce que vous faites ensuite dépend de la façon dont vous communiquez avec Exchange et de ce que vous souhaitez accomplir. Si vous avez besoin d’inspiration et que vous utilisez EWS, vous pouvez explorer les exemples de code Exchange 101 pour obtenir quelques idées.