Skip to content

Commit 3dfa3ba

Browse files
Updated readme with Exchange authentication docs
1 parent 92f6017 commit 3dfa3ba

File tree

2 files changed

+18
-4
lines changed

2 files changed

+18
-4
lines changed

README.md

Lines changed: 14 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -26,6 +26,20 @@ This provides the PSCommandService class which is a wrapper around [StatefulProc
2626

2727
This script simply exports a few useful pre-defined parameter sets (that one would pass to the constructor of StatefulProcessComamndProxy) for the initialization, destruction and auto-invalidation of "powershell" processes who connect to o365 and establish a remote PSSession that will be long lived. (and validate that the session is still legit)
2828

29+
#### Exchange authentication
30+
31+
`o365Utils.js` init command `getO365PSInitCommands` is using a deprecated authentication [method](https://techcommunity.microsoft.com/t5/exchange-team-blog/modern-auth-and-unattended-scripts-in-exchange-online-powershell/ba-p/1497387)
32+
33+
Mictosoft has added [Exchange Online PowerShell V2](https://techcommunity.microsoft.com/t5/exchange-team-blog/announcing-general-availability-of-the-exchange-online/ba-p/1436623) that supports cerificate based authentication.
34+
35+
Full setup is descibed [here](https://adamtheautomator.com/exchange-online-powershell-mfa/)
36+
37+
Three sets of init commands are availiable as of version `1.1.0`:
38+
39+
* `getO365PSInitCommands` - backward compatible old basic authentication
40+
* `getO365PSKeyInitCommands` - new Exchange authentication with private key and password
41+
* `getO365PSThumbprintInitCommands` - new Exchange authentication with the thumb print for the certificate
42+
2943
### <a name="usage"></a>Usage
3044

3145
1) Configure your o365 tenant with a user with the appropriate permissions to manage o365 via Powershell. [See this article to get going](https://bitsofinfo.wordpress.com/2015/01/06/configuring-powershell-for-azure-ad-and-o365-exchange-management/)

o365Utils.js

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -80,8 +80,8 @@ module.exports.getO365PSDestroyCommands = function () {
8080
* to be able to establish a remote PSSession with o365
8181
*
8282
* @see https://github.com/bitsofinfo/powershell-credential-encryption-tools
83-
* @see https: //docs.microsoft.com/en-us/powershell/module/exchange/connect-exchangeonline?view=exchange-ps
84-
* @see https: //adamtheautomator.com/exchange-online-powershell-mfa/#Authenticating_Using_Local_PFX_Certificate
83+
* @see https://docs.microsoft.com/en-us/powershell/module/exchange/connect-exchangeonline?view=exchange-ps
84+
* @see https://adamtheautomator.com/exchange-online-powershell-mfa/#Authenticating_Using_Local_PFX_Certificate
8585
*
8686
* This function takes the full path to:
8787
* - decryptUtil.ps1 from the project above
@@ -173,8 +173,8 @@ module.exports.getO365PSKeyDestroyCommands = function () {
173173
* to be able to establish a remote PSSession with o365
174174
*
175175
* @see https://github.com/bitsofinfo/powershell-credential-encryption-tools
176-
* @see https: //docs.microsoft.com/en-us/powershell/module/exchange/connect-exchangeonline?view=exchange-ps
177-
* @see https: //adamtheautomator.com/exchange-online-powershell-mfa/#Authenticating_Using_Certificate_Thumbprint
176+
* @see https://docs.microsoft.com/en-us/powershell/module/exchange/connect-exchangeonline?view=exchange-ps
177+
* @see https://adamtheautomator.com/exchange-online-powershell-mfa/#Authenticating_Using_Certificate_Thumbprint
178178
*
179179
* This function takes the full path to:
180180
* - decryptUtil.ps1 from the project above

0 commit comments

Comments
 (0)