exchange-autodiscover-es5 v1.0.2

Node Exchange Autodiscover

Retrieve the URL of your EWS by accessing Microsoft's SOAP Autodiscover Service.

Differs from other similar packages in that it queries the DNS. It also tries out all the potential autodiscover urls in parallel, sacrificing a bit more bandwidth for speed.

Usage

var autodiscover = require('exchange-autodiscover');

// Promise
autodiscover({ emailAddress: "foo@bar.onmicrosoft.com", password: "pass"  })
  .then(console.log.bind(console))  // "https://outlook.microsoft.com/ews/exchange.asmx"
  .catch(console.error.bind(console))

// Callback
autodiscover({ emailAddress: "foobar@yourdomain.com", password: "pass", username: "ad\\foobar77" },
  function(err, ewsUrl) {
    if(err) {
      console.error(err);
    } else {
      console.log(ewsUrl); // "https://mail.yourdomain.com/ews/exchange.asmx"
    }
  }

You can optionally request any of the extra settings found here:

// With extra settings
autodiscover({
  emailAddress: "foo@bar.onmicrosoft.com",
  password: "pass",
  settings: [
    'EwsSupportedSchemas',
    'ExternalEwsVersion'
  ]
}).then(function (settings) {
  console.log(settings)
  // Sample response
  // {
  //   EwsSupportedSchemas: 'Exchange2007, Exchange2007_SP1, Exchange2010, Exchange2010_SP1, Exchange2010_SP2, Exchange2013, Exchange2013_SP1, Exchange2015',
  //   ExternalEwsUrl: 'https://outlook.office365.com/EWS/Exchange.asmx',
  //   ExternalEwsVersion: '15.00.0000.000'
  // }
});

This will return an object with matched settings. (EWS address will always be included by default).

API

/**
 * Tries to find the url of the EWS.
 *
 * @param   {Object}   params
 * @param   {String}   params.emailAddress
 * @param   {String}   params.password
 * @param   {String}   [params.username]    - Defaults to emailAddress
 * @param   {Boolean}  [params.queryDns]    - Defaults to true
 * @param   {String[]} [params.settings]
 * @param   {Function} [cb]
 * @returns {Promise}  Resolves with the EWS url
 */
autodiscover(params, callback);

License

See license (MIT License).