Access test and access

The following test programs can be run to test connectivity.

The EWS test tool is available on request from ADITO Software GmbH.

EWSTools

The connection of the designated ADITO Server to the Exchange Server via the Java EWS interface can also be tested without ADITO Server and Designer. For this purpose, the ewsTools are available, which can be obtained from ADITO.

These tools call the Exchange Webservices interface. After calling the corresponding classes, the URL of the WSDL file is specified as the first parameter, followed by the username of the impersonation user and the specification of the password of this user. The application establishes a connection but does not perform any action on the Exchange server.

The necessary startup parameters are: 1. access to the Exchange.asmx file 2. e-mail address of the impersonation user 3. password of the impersonation user 4. e-mail address of the user whose access is to be checked

Start file in default case

java -cp ewstools.jar;lib_optional/* de.adito.aditoweb.plugin.ewstools.ExchangeWSTest http://192.168.56.40/EWS/Exchange.asmx m.imperso@EXTEST.LOCAL SomePassword aditotest1@extest.local

The EWStools can also use the Microsoft-API to access Java:

java -cp ewstools.jar;lib_optional/* de.adito.aditoweb.plugin.ewstools.ExchangeWSTestAPI http://192.168.56.40/EWS/Exchange.asmx m.imperso@EXTEST.LOCAL SomePassword aditotest1@extest.local

Please note that the preceding code has line breaks for clarity. These must be removed when pasting into another file.

EWSTools support access to the Exchange backend via impersonation only.

Exchange server with autodiscover

Mailboxes are not always located on the server available for access by applications, in which case it is a Client Access Server (CAS). For these purposes, the address of the mailbox server can be retrieved via autodiscover.

ADITO does not support SCP Autodiscover.

Autodiscover only works if it is set up for the domain of the primary SMTP address. DNS autodiscover is not supported.

Autodiscover on calendar

If Microsoft Exchange is accessed to access calendar objects, ADITO can automatically determine the correct server.

Autodiscover test tool

In order to specify the correct server for the user’s mailbox, the Autodiscover test tool must be run. This is needed for contact synchronization, for example.

The ADITO Autodiscover test tool accesses the Exchange server via web services, not via MAPI.

The Autodiscover test tool is available on request from ADITO Software GmbH.

Procedure

To determine the correct mailbox server, the Autodiscover test tool proceeds as follows:

start the Autodiscover test tool, then.

1. the URL is resolved based on the user’s email.

2. the info is sent back to the test tool as an XML file and output to the console.

3. the URL is output and can then be used further.

Execution

The tool is executed via a prepared shell script.

The following parameters must be specified in this shell script.

Parameters

Parameter	Description
email	Email of the user for which the Exchange server should be determined.
user	Username of the user.
password	Password of the user.
domain	Domain of the user, can be left empty. Blank entry above two quotes.
version	Exchange2007_SP1, Exchange2010, Exchange2010_SP1, Exchange2010_SP2.
verifyhostname	Specifies whether the hostname verification should be performed. Does not always save the connection of a certificate.

It returns the URL of the mailbox server after a series of log outputs:
https://mail.kunde.de/ews/exchange.asmx

The address of the server can then be passed to the contact sync plugin.

Under certain circumstances it may happen that this externally published address cannot be used for internal connections. For this purpose, it is advisable to check the log outputs, because the internal and external address are specified there:

    <s:Envelope>
     <s:Body>
      <GetUserSettingsResponseMessage>
       <Response>
        <UserResponses>
         <UserResponse>
          <UserSettings>
            <UserSetting i:type="StringSetting">
                <Name>InternalEwsUrl</Name>
                    <Value>https://exca.net.kunde.ag/ews/exchange.asmx</Value>
            </UserSetting>
            <UserSetting i:type="StringSetting">
                <Name>ExternalEwsUrl</Name>
                    <Value>https://mail.kunde.de/ews/exchange.asmx</Value>
            </UserSetting>
          </UserSettings>
         </UserResponse>
        </UserResponses>
       </Response>
      </GetUserSettingsResponseMessage>
     </s:Body>
    </s:Envelope>

In this case, check whether the server is really mail.kunde.de, or exca.net.kunde.ag.

Execution on login

The autodiscover process can be executed at any time using the autodiscover test tool. This shows how long the autodiscover process takes. This time period is added to the login process during client login.

Installing certificates

In some circumstances, it may be necessary to import the Exchange server’s certificate into the JRE’s keystore, in order to enable the usage of a certified connection. When doing this, make sure that the server that will ultimately be addressed (i.e., the mailbox mail server) is mentioned in the certificate.

For instructions on how to install an SSL certificate, see AID104-EN_Simplified installation of an SSL certificate in the Java Keystore.

Logging the http connections

The following parameters can be used to document the http connections. These http logs are output to the console (independent of the logger). While this log can be used for all web services connections, it is particularly useful for troubleshooting Exchange web services connections. The parameters are for ADITO5 at server startup:

    -Dcom.sun.xml.internal.ws.transport.http.client.HttpTransportPipe.dump=true
    -Dcom.sun.xml.internal.ws.transport.http.HttpAdapter.dump=true

SoapE

SoapE is an independent test tool that establishes access to web servers via web services. With this tool you can easily test whether it is possible to access Exchange from the desired computer. You can download SoapE from the internet or get it from ADITO on request.

Here you can enter the following data:

• SOAP URL: Access to the Services.wsdl file of the Exchange server.

• Username: User name of the impersonation user.

• Domain: Specification of the domain of the user.