Autoconfig

From Evolution

[edit]

E2kAutoconfig

owa_uri: OWA URI entered by the user

gc_server: Global catalog server entered by the user or autodetected during account setup

username: User name entered by the user

password: Password entered by the user

gal_limit: GAL search size limit, entered by user. If -1, assumes no-limit.

version: Version of the Exchange server autodetected by "MS-WebStorage" hearder. Example

    E2K_EXCHANGE_2000
    E2K_EXCHANGE_2003
    E2K_EXCHANGE_FUTURE

display_name: Display name

email: email id

account_uri: The camel URI for account. Example

   exchange: //domain%5cuser;auth=Basic@server/; ad_server=server; use_ssl=always;  
   owa_url=https://server/exchange;save-passwd=true;mailbox=user;owa_path=/exchange

exchange_server: Server name

timezone: OLSON timezone

nt_domain: NT domain . Example

  EXPERT


w2k_domain: Windows domain. Example

  expert.com

home_uri: The URI. Example

  http://server/exchange/user/    


exchange_dn: Exchange 5.5 DN

pf_server: hostname from camel URI

auth_pref: Authentication preferences. Example

   E2K_AUTOCONFIG_USE_NTLM
   E2K_AUTOCONFIG_USE_BASIC (plain text)

require_ntlm: flag which is set to TRUE if authentication mechanism is NTLM in camel URL

use_ntlm: flag which is set to TRUE if authentication mechanism is E2K_AUTOCONFIG_USE_NTLM

saw_basic: flag which is set to TRUE if challenge header for "WWW-Authenticate" has Basic

saw_ntlm: flag which is set to TRUE if challenge header for "WWW-Authenticate" has NTLM

nt_domain_defaulted: flag which is set to TRUE, if the NT domain was set reading the NTLM header

gc_server_autodetected: flag set to TRUE if Global Catalog server is auto-detected while account setup given the user name, password and OWA URL. This is used to unset GC server value in case the OWS URI has changed.

[edit]

e2k_autoconfig_check_exchange

This function tries to connect to the the Exchange server using the OWA URL, username, and password in E2kAutoconfig. calls e2k_autoconfig_get_context() to check URI and the credentials are correct. If this fails because of one of error codes,

 incorrect authenteication preferences (NTLM/BASIC)
 Server requires redirection
 Server requires SSL
 Or OWA URL has not path appended (example: missing "/exchange")

it tires to internally handle these errors and re-attempts the connection.

Attempts to determine the public folder URI, domain name and home_uri, and then given the home_uri, looks up the user's mailbox entryid (used to find his Exchange 5.5 DN) and default timezone.

[edit]

e2k_autoconfig_check_global_catalog

Read the GC object using e2k_autoconfig_get_global_catalog(). Tries to connect to the global catalog associated with E2kAutoconfig using e2k_global_catalog_lookup(). (trying to figure it out from the domain name if the server name is not yet known). On success it will look up the user's full name and email address (based on his Exchange DN).