Skip to content

Commit 6eb5830

Browse files
author
Bob Pokorny
committed
Merge branch '75657-Update_Documentation_For_Container_Use' of https://github.com/Keyfactor/iis-orchestrator into 75657-Update_Documentation_For_Container_Use
2 parents 4158972 + 4afa25b commit 6eb5830

File tree

1 file changed

+8
-1
lines changed

1 file changed

+8
-1
lines changed

README.md

Lines changed: 8 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -92,12 +92,19 @@ Before installing the Windows Certificate Universal Orchestrator extension, we r
9292

9393

9494
<details>
95-
<summary><b>Using the WinCert Extension on Linux servers:</b></summary>
95+
<summary><b>Using the WinCert Extension on Linux servers and/or with Docker Containers:</b></summary>
9696

9797
1. General SSH Setup Information: PowerShell 6 or higher and SSH must be installed on all computers. Install SSH, including ssh server, that's appropriate for your platform. You also need to install PowerShell from GitHub to get the SSH remoting feature. The SSH server must be configured to create a SSH subsysten to host a PowerShell process on the remote computer. It is suggested to turn off password authentication as this extension uses key-based authentication.
9898

9999
2. SSH Authentication: When creating a Keyfactor certificate store for the WinCert orchestrator extension, the only protocol supported to communicate with Windows servers is ssh. When providing the user id and password, the connection is attempted by creating a temporary private key file using the contents in the Password textbox. Therefore, the password field must contain the full SSH Private key.
100100

101+
3. If you choose to run this extension in a containerized environment, the container image must include PowerShell version 7.5 or later, along with either OpenSSH clients (for SSH-based connections) or OpenSSL (if SSL/TLS operations are required). Additionally, the PWSMan PowerShell module must be installed to support management tasks and remote session functionality. These dependencies are required to ensure full compatibility when connecting from the container to remote Windows servers. Below is an example Docker file snippet:
102+
```
103+
dnf install https://github.com/PowerShell/PowerShell/releases/download/v7.5.2/powershell-7.5.2-1.rh.x86_64.rpm
104+
pwsh -Command 'Install-Module -Name PSWSMan'
105+
dnf install openssh-clients openssl
106+
```
107+
101108
</details>
102109

103110
<details>

0 commit comments

Comments
 (0)