Skip to content

Commit 43554ce

Browse files
authored
Improve wording about certificate authentication
1 parent 41722a7 commit 43554ce

File tree

1 file changed

+14
-8
lines changed

1 file changed

+14
-8
lines changed

README.md

Lines changed: 14 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -133,28 +133,33 @@ Ubuntu 16.04. See issue [#9](https://github.com/swisscom/PowerGRR/issues/9).
133133

134134
**Client certificate authentication using PowerShell Core**
135135

136-
The client certificate authentication is currently not supported in PowerShell
137-
Core 6.0.0-beta.5 release packages on Github (see issue [#8](https://github.com/swisscom/PowerGRR/issues/8)).
136+
The client certificate authentication using certificate files without the Windows certificate
137+
store is currently not supported in PowerShell Core 6.0.0-beta.5 release packages on
138+
Github (see issue [#8](https://github.com/swisscom/PowerGRR/issues/8)). Only certificate authentication
139+
using the Windows certificate store is supported as of PowerShell Core 6.0.0-beta.5.
138140
_This is a known issue in PowerShell Core and is tracked in the following
139141
[issue #4544](https://github.com/PowerShell/PowerShell/issues/4544) and corresponding
140142
[PowerShell Core pull request #4546](https://github.com/PowerShell/PowerShell/pull/4546)_.
143+
In combination with the missing certificate store support on non-Windows platforms, as
144+
tracked in [#1865](https://github.com/PowerShell/PowerShell/issues/1865), certificate authentication
145+
is not possible on non-Windows platforms.
141146

142-
Certificate authentication is currently only supported when using a custom
143-
PowerShell Core build with the patch mentioned by @markekraus
147+
Certificate authentication based on certificate files is currently only supported when using
148+
a custom PowerShell Core build with the patch mentioned by @markekraus
144149
on [#4544](https://github.com/PowerShell/PowerShell/issues/4544). See Mark's comments or
145150
build commands below regarding the used commands to build PowerShell Core from
146151
scratch on your platform (no special environment is needed and reserve a
147152
20min-:coffee:-break).
148153

149-
The certificate handling was tested on Windows with
154+
The authentication based on certificate files was tested on Windows with
150155
PowerShell v5 and on Windows and Ubuntu 16.04 with PowerShell Core
151156
6.0.0-beta.5 with the needed code changes.
152157

153158
You can build your own PowerShell Core binaries _after_ you installed
154159
an available PowerShell version first, see section [PowerShell](#powershell)
155160
in requirements above.
156161

157-
1. Fix the code in the file
162+
* **Fix the code in the file**
158163
_PowerShell/src/Microsoft.PowerShell.Commands.Utility/commands/utility/WebCmdlet/CoreCLR/WebRequestPSCmdlet.CoreClr.cs_
159164
in your PowerShell Core clone on line 167 to this lines:
160165

@@ -168,10 +173,11 @@ in requirements above.
168173
Build the binaries based on your clone for the platform your are currently running the commands on:
169174
170175
```
171-
powershell -noprofile -ExecutionPolicy bypass -command 'Import-Module ./build.psm1; Sync-PSTags; Start-PSBootstrap; Start-PSBuild'
176+
$ cd <folder-of-your-PowerShell-clone>
177+
$ powershell -noprofile -ExecutionPolicy bypass -command 'Import-Module ./build.psm1; Sync-PSTags; Start-PSBootstrap; Start-PSBuild'
172178
```
173179
174-
2. Build PowerShell Core based on Mark's fork:
180+
* **Build PowerShell Core based on Mark's fork**:
175181
176182
```
177183
mkdir ~/gittest

0 commit comments

Comments
 (0)