Marco Blessing
afab3c870c
## About This pull request reflects all changes done in the `linuxsupport` branch. ## Content - Enable PowerShell 6 Core support - Use PFX Certificate for encryption ( fixes #32 ) - Updates CI / CD pipeline ( fixes #31 ) - uses portable libressl ( fixes #34 ) - adds `-PassThru` switch for returning current `VIServer` session in `Connect-To` ( fixes #34 ) - adds git lfs for embedded libressl files - restructured internal functions into `Private` dir - added certificate related functions - adds travis build pipeline for tests
124 lines
6.9 KiB
Markdown
124 lines
6.9 KiB
Markdown
[](https://ci.appveyor.com/project/OCram85/pscredentialstore/branch/master)
|
|
[](https://ci.appveyor.com/project/OCram85/pscredentialstore/branch/master/tests)
|
|
[](https://coveralls.io/github/OCram85/PSCredentialStore?branch=master)
|
|
[](https://www.powershellgallery.com/packages/PSCredentialStore)
|
|
[](https://www.powershellgallery.com/packages/PSCredentialStore)
|
|
|
|
|
|
|
|
|
|
General
|
|
=======
|
|
|
|
The PSCredentialStore is a simple credential manager for PSCredentials. It stores PSCredentials in a simple json
|
|
file. You can choose between a private and shared credential store. The private one exists in your profile and can
|
|
ony accessed by your account on the same machine. The shared store enables you to use different credentials for your
|
|
scripts without exposing them as plain text.
|
|
|
|
**The shared store isn't 100% secure and I don't recommend using it in production!**
|
|
|
|
PSCredentialStore was developed to simplify the delegation of complex powershell scripts. In this case you often
|
|
need to store credentials for non interactive usage like in scheduled tasks.
|
|
|
|
For more details read the [about_PSCredentialStore](/docs/about_PSCredentialStore.md) page on github or via CLI with
|
|
`Get-Help about_PSCredentialStore`.
|
|
|
|
:exclamation: Upcoming Changes :exclamation:
|
|
================
|
|
|
|
The will be some breaking changes starting with the `0.5.0.xxx`:
|
|
|
|
- **PSCredentialStore will use PFX certificates to encrypt your credentials.**
|
|
- This replaces the the current encryption methods and you need to recreate or upgrade your pre existing stores.
|
|
- The changes allows the PSCredentialStore module to support the PowerShell `Core` editions.
|
|
- Yes this means, you can use the module on any PowerShell 6 supported linux distribution.
|
|
- It's also possible to create a shared credential store and transfer it onto a another platform like:
|
|
`Windows -- to --> Linux` and vice versa.
|
|
- Automatically creates self signed certificate with 2048 bits RSA keys for encryption.
|
|
|
|
Installation
|
|
============
|
|
|
|
PowerShellGallery.com (Recommended Way)
|
|
---------------------------------------
|
|
|
|
* Make sure you use PowerShell 5.1 or higher with `$PSVersionTable`.
|
|
* Use the builtin PackageManagement and install with: `Import-Module PowerShellGet; Install-Module 'PSCredentialStore' -Repository 'PSGallery'`
|
|
* Additionally use the `-AllowPrerelease` switch until we publish the final release!
|
|
* Done. Start exploring the Module with `Import-Module PSCredentialStore ; Get-Command -Module PSCredentialStore`
|
|
|
|
Manual Way
|
|
----------
|
|
|
|
* Take a look at the [Latest Release](https://github.com/OCram85/PSCredentialStore/releases/latest) page.
|
|
* Download the `PSCredentialStore.zip`.
|
|
* Unpack the zip file and put it in your Powershell module path.
|
|
* Don't forget to change the NTFS permission flag in the context menu.
|
|
* Start with `Import-Module PSCredentialStore`
|
|
|
|
Quick Start
|
|
-----------
|
|
|
|
**1.** First we need a blank credential store. You can decide between a *private* or *shared* store. The private
|
|
Credential Store can only be accessed with your profile on the machine you created it.
|
|
```powershell
|
|
# Private credential store
|
|
New-CredentialStore
|
|
|
|
# Shared credential rtore
|
|
New-CredentialStore -Shared
|
|
|
|
#Shared credential store in custom Location
|
|
New-CredentialStore -Shared -Path 'C:\CredentialStore.json'
|
|
```
|
|
|
|
**2.** Now you can manage your credential store items:
|
|
```powershell
|
|
# This will prompt for credentials and stores it in a private store
|
|
New-CredentialStoreItem -RemoteHost 'dc01.myside.local' -Identifier 'AD'
|
|
|
|
# You can now use it in other scripts like this:
|
|
$DCCreds = Get-CredentialStoreItem -RemoteHost 'dc01.myside.local' -Identifier 'AD'
|
|
Invoke-Command -ComputerName 'dc01.myside.local' -Credential $DCCreds -ScripBlock {Get-Process}
|
|
```
|
|
|
|
The credential store contains also a simple function to establish a connection with several systems or protocols.
|
|
If you have already installed the underlying framework / modules, you can connect these endpoints:
|
|
|
|
* **CiscoUcs** - Establish a connection to a Cisco UCS fabric interconnect.
|
|
* Required Modules: [`Cisco.UCS.Core`, `Cisco.UCSManager`](https://software.cisco.com/download/release.html?i=!y&mdfid=286305108&softwareid=284574017&release=2.1.1)
|
|
* **FTP** - Establish a connection to a FTP host.
|
|
* Required Modules: [`WinSCP`](https://www.powershellgallery.com/packages/WinSCP)
|
|
* **NetAppFAS** - Establish a connection to a NetApp Clustered ONTAP filer.
|
|
* Required Modules: [`DataONTAP`](http://mysupport.netapp.com/tools/info/ECMLP2310788I.html?productID=61926)
|
|
* **VMware** - Establish a connection to a VMware vCenter or ESXi host.
|
|
* Required Modules: [`VMware.VimAutomation.Core`](https://www.powershellgallery.com/packages/VMware.PowerCLI)
|
|
* **CisServer** - Establish a connection to the CisServer Service on vCenter Host.
|
|
* Required Modules: [`VMware.VimAutomation.Cis.Core`](https://www.powershellgallery.com/packages/VMware.PowerCLI)
|
|
* **ExchangeHTTP** - Establish a remote connection with an Exchange endpoint via http.
|
|
* Requires PowerShell remoting
|
|
* **ExchangeHTTPS** - Establish a remote connection with an Exchange endpoint via https.
|
|
* Requires PowerShell remoting
|
|
* **SCP** - Establish a SCP connection.
|
|
* Required Modules: [`WinSCP`](https://www.powershellgallery.com/packages/WinSCP)
|
|
|
|
Here are some basic examples:
|
|
|
|
```powershell
|
|
Connect-To -RemoteHost "ucs.myside.local" -Type CiscoUcs
|
|
Connect-To -RemoteHost "ftp.myside.local" -Type FTP
|
|
Connect-To -RemoteHost "fas.myside.local" -Type NetAppFAS
|
|
Connect-To -RemoteHost "esx01.myside.local" -Type VMware
|
|
Connect-To -RemoteHost "vcr.myside.local" -Type CisServer
|
|
```
|
|
|
|
Credits
|
|
-------
|
|
|
|
A huge thanks to all the people who helped with their projects and indirect contributions which made this possible!
|
|
|
|
- This module is inspired by the awesome work of @dlwyatt with articles like these:
|
|
- https://powershell.org/2013/11/24/saving-passwords-and-preventing-other-processes-from-decrypting-them/
|
|
- https://powershell.org/2014/02/01/revisited-powershell-and-encryption/
|
|
- The awesome people from [LibreSSL](http://www.libressl.org/) which publishes the [portable openssl/libressl binaries](https://github.com/libressl-portable/portable)!
|