Skip to content

Updated release 2.8.9

Compare
Choose a tag to compare
@seanmcne seanmcne released this 25 Aug 18:45
· 30 commits to master since this release

semi-significant changes to connect-crmonline to take advantage of newer versions of ADAL capabilities. The module should now be capable of re-using cached tokens and signing in as the user who is signed into the PC. All of this should be backwards compatible.

Changes to connect-crmonline:

  • Enable new CDS/CRM/D365 region TLD
  • Force oAuth now can either use a credential provided which uses the username/pw in the connection string or it can be used without a credential and will natively use adal to get the username and password.
  • NOTE: the username parameter and no credential provided SSO auth flow are designed for desktop use (interactive). If you are using this in dev ops or in a scripted process you'll still want to use credentials (which will continue to function without updates/changes)
  • To avoid confusion and a couple issues a new username parameter was added, username can be provided with no password and will guide adal on which identity to attempt authentication for. If you are signed in with your current identity which has access to a given tenant it should just 'work' with or without the username.
  • Default to oAuth if the UserName parameter is provided, even if you don't provided the forceoAuth switch, using a username parameter will assume you want to use modern auth
  • New switch parameter BypassTokenCache will null out the token cache path if you're using azure dev ops this switch may be of importance to use to avoid token caching trying to access a path that doesn't exist on the sandboxed build host
  • New integer parameter ConnectionTimeoutInSeconds can now be used to set the connection when you first connect
  • New string parameter LogWriteDirectory can be used to force the module to write logs to a specific directory
  • NOTE: Force discovery will force you to provide a credential, not sure if this is a bug in the connector, but it appears a credential is required, that said, if you're using ForceDiscovery, I suggest dropping it as forcing a discovery upon connecting is redundant and shouldn't be required - if you have a scenario where discovery is required please let me know (i'm considering removing this).
  • Finally, I've added an experimental parameter set where you can provide a custom connection string. Please don't use this unless your debugging, I might change it later and wouldn't want to break anyone. If you require the use of a connection string directly can you let me know why so I can better accommodate? Thanks!

Other changes:

  • Verbose parameter on connect-crmonline will output to a log file now in the local directory
  • changed the object template for crmserviceclient to include the last error - the template is applied to avoid showing the auth token by default and clean up the output when the connection object is returned.