From fafedc5e7348a176393608404afbc4c972f29480 Mon Sep 17 00:00:00 2001 From: Rick Roca Date: Fri, 2 Feb 2024 10:28:20 -0500 Subject: [PATCH] eSignature Release Follow up --- .../SecretServer/eSignature/._Instructions.md | Bin 4096 -> 0 bytes .../eSignature/Delinea.PoSH.Helpers/readme.md | 43 ++++++++++++++++++ .../Discovery/eSignature Discovery.ps1 | 37 ++------------- .../SecretServer/eSignature/Instructions.md | 5 ++ 4 files changed, 52 insertions(+), 33 deletions(-) delete mode 100644 Scripts/SecretServer/eSignature/._Instructions.md create mode 100644 Scripts/SecretServer/eSignature/Delinea.PoSH.Helpers/readme.md diff --git a/Scripts/SecretServer/eSignature/._Instructions.md b/Scripts/SecretServer/eSignature/._Instructions.md deleted file mode 100644 index d2884071a5939a8f1de1a5e889c0bf99523ae528..0000000000000000000000000000000000000000 GIT binary patch literal 0 HcmV?d00001 literal 4096 zcmZQz6=P>$Vqox1Ojhs@R)|o50+1L3ClDJkFz{^v(m+1nBL)UWIUt(=a103v5(`xW zss`y`H~_@DXj*`#fyD(F7^IT(bM+Dn3UX5QauSP6N{drdQW8s2l>>sIdM*HISq27C zgu24g#G=H!lFYnRhFc$Yr-Ia3uqZQvXafTaBWp9$q@*;1WMgaJ%;ci{;{3D{h4B2M z6l;)zQ7{?;qaiRF0;3@?8UmvsFd71*Aut*OqaiRF0;3@?Y(oIlF$8xGK|YiV$;d2L zC`v8PFD*(=RY=P(%2vqCD@g@*C-d_Xb8;#ba#Df)#iX3Xylh}!7^G#W162RReIvsl H_y0ctGDAH{ diff --git a/Scripts/SecretServer/eSignature/Delinea.PoSH.Helpers/readme.md b/Scripts/SecretServer/eSignature/Delinea.PoSH.Helpers/readme.md new file mode 100644 index 0000000..3cdc701 --- /dev/null +++ b/Scripts/SecretServer/eSignature/Delinea.PoSH.Helpers/readme.md @@ -0,0 +1,43 @@ +v# Installation Steps of the PoSH Utils Delinea Helper Module + +1. Open PowerShell with administrative privileges as this will be installed on the root drive in Windows under the Program Files folder. + +2. Navigate to the root directory of your PowerShell module project. + +3. Use the `Copy-Item` cmdlet to copy the module folder to the desired directory. The file: `.\Delinea.PoSH.Helpers\Utils.psm1` Needs to be in the directory: `$env:ProgramFiles\Thycotic Software Ltd\Distributed Engine\Delinea.PoSH.Helpers\` + + ```powershell + Copy-Item -Path ".\Delinea.PoSH.Helpers\Utils.psm1" -Destination "$env:ProgramFiles\Thycotic Software Ltd\Distributed Engine\Delinea.PoSH.Helpers\" -Recurse -Force + +## If the Error Occurs: + +```powershell +Copy-Item : Could not find a part of the path 'C:\Program Files\Thycotic Software Ltd\Distributed Engine\Delinea.PoSH.Helpers\' +``` + +## The Issue is Caused Because the Path Does Not Exist, Run This Command in an Admin Powershell Terminal: + +```powershell +if (-not (Test-Path -Path "$env:ProgramFiles\Thycotic Software Ltd\Distributed Engine\Delinea.PoSH.Helpers" -PathType Container)) { + New-Item -Path "$env:ProgramFiles\Thycotic Software Ltd\Distributed Engine\Delinea.PoSH.Helpers" -ItemType Directory +} +``` + +## The Output Will Show successful: + +```powershell + Directory: C:\Program Files\Thycotic Software Ltd\Distributed Engine + + +Mode LastWriteTime Length Name +---- ------------- ------ ---- +d----- 1/30/2024 2:59 PM Delinea.PoSH.Helpers +``` + +## Then Run the Command Again and it Will Copy Over. + +- Check it by Running: + +```powershell +Get-Content "$env:ProgramFiles\Thycotic Software Ltd\Distributed Engine\Delinea.PoSH.Helpers\" +``` \ No newline at end of file diff --git a/Scripts/SecretServer/eSignature/Discovery/eSignature Discovery.ps1 b/Scripts/SecretServer/eSignature/Discovery/eSignature Discovery.ps1 index 04e2c2c..43b6ff9 100644 --- a/Scripts/SecretServer/eSignature/Discovery/eSignature Discovery.ps1 +++ b/Scripts/SecretServer/eSignature/Discovery/eSignature Discovery.ps1 @@ -1,35 +1,6 @@ #Args used for development (Remove before pushing to production): -$args = @("Advanced","https://demo.docusign.net", "account-d.docusign.com", "c5473482-00fc-4e91-b6cd-476347640bbc", "f55537f1-0d35-490c-b4aa-960e203643fb", "-----BEGIN PRIVATE KEY----- -MIIEvwIBADANBgkqhkiG9w0BAQEFAASCBKkwggSlAgEAAoIBAQDxq/UtsJS3GEgT -yR051dKlCj62rF6FjgTj6mcH4x5xHQ0KfKP98+7tnXQpqXhrxSIvs1QBjNT6xqAd -6PpdIXZ0yCVxexpQmBoIXmbvW6fOrDams2JFD/pNUpTPOQo9fy5BjOAcaEVQTCwp -xgSduak6DbAN8yTU7th9ruNCAnyxekXLfZtQ2G6MOSPKfTzkrO6hGK0JbG5ZYJ+f -qR9BCvLzZTwHTU5YeztIKPJA6rG/a0eyoNyZG+2NLW9fUk0z2B0CAIBPTB0vi1Wu -Ek4jHONX6wO7zJMGOjGV49ZX7YFVTs3aoRQkShsTZ9r5mUszjfDyg8bvV91ZJ8sc -NPJeIP+VAgMBAAECggEAVbTQLLX058IavbmTPdGQ9KrfdtVGaELnhRS6GVf4kdDl -sRRm7Ec4MtimO6g4Zq/w4c3NOweA+La8Th8zuxeE9QGOFeK8gFyQzur7wmNU7byx -XQk9DpUOBaIF2D+4W/rgoqqdSDXKbyG0f9QUCwOu+kGkcC4Mn99cs6X0PpK3OhEc -g2QNyuXNYKd8zfMAWsZUAIQ5ev0a9/o0ioXWn9h6+UbE/OW22qWbIojEhVGYxU48 -j8SqLn+Go8kqT2QSPlKg5UOQXuRLBlgVJs5Vu149As1CwcqsFGj82tsBoDkPU35X -fx1979ghjKvHg3idqCpmUhzsucfx/9nGXaVwvvsVeQKBgQD77vvgkXq8rMyPaez+ -8dij4Jb7l7jdzp4yE5RFRSM7Gc4woUxYdxsl4JaVYDwGt+0cXYqtLB/WdOVSyKiy -Wwv9Tzt1Ca8ErxW50NZBHTi+kEZcV1X0tVspHEj4I/n6WMpigzUoJE6OMP/mLIoG -iErLs20hQyZd2u0vUkZUEuZVwwKBgQD1kpImb+7+4aO5b7MWsffWoJsjA0Ne9vQT -ZWqN1TtgJ6RTPS0WZC3QzfEkcC2v0lj8Un7pfhrDoly1MyzKxx7UYc7I7/UPC1cx -NivxEkWYno5SPQmes1RYmLYoHnciTrB9FLTkhHFYte/OvjXqtzOQyWra6L5xSVyT -NC42RJQHxwKBgQDvWgYDPTQWvTU7q692J99jEqVfMq54TS0O9nsPtLfcFpBGs3gN -NFueiNmH4X4mA+hJ4rU2AY3d+gFFvU5I5Sdm6jfa4fBdytohR7/G7TRUGE5AvNj1 -PLf3PuA0oDmHF4RwQ6flE1luzi7RR896lVI6ZaVwzJNO6AgfxVL73VjocQKBgQCS -aOWL1xZ1jc+QQmFSuZ5arvxvXoWvO6r/WWqyzxuMU3YsTn/wJqAOKoqHv/3tIor9 -PK3/xbhtRQLi4XTmHNtrojioIjBH3OoKJBMEsnEd8gJGU6/Fl4NFIx8PQkKjCKk+ -mbbTu4bcbfRgnZUFsF4lB4EWrMbGQgfYl7apki9zhwKBgQDNFohJIsUaRyGkpbvg -tfes0VV7oQFGe2jndfMrb+JGWBr5fj5v8NGXUIQP3QylbMVizQW3Y5IyqWtL/ivp -LeN8H/p+8dCZLTpOpchKmrcY59vnOcfbFmJNwLJhEyR/eHAwR6KsAc/WLSsSf6tF -dnBi8hMJTK+AnwGF1JhtlNSx4w== ------END PRIVATE KEY-----", "23836283","Sales") -Import-Module -Name "c:\temp\Utils.psm1" -#Import-Module -Name "$env:ProgramFiles\Thycotic Software Ltd\Distributed Engine\Delinea.PoSH.Helpers\Utils.psm1" +Import-Module -Name "$env:ProgramFiles\Thycotic Software Ltd\Distributed Engine\Delinea.PoSH.Helpers\Utils.psm1" #region define variables #Define Argument Variables @@ -46,9 +17,9 @@ Import-Module -Name "c:\temp\Utils.psm1" #Script Constants -#[string]$LogFile = "$env:ProgramFiles\Thycotic Software Ltd\Distributed Engine\log\Docusign-eSignature-Discovery.log" -[string]$LogFile = "c:\temp\Docusign-eSignature-Discovery.log" -[int32]$LogLevel = 3 +[string]$LogFile = "$env:ProgramFiles\Thycotic Software Ltd\Distributed Engine\log\Docusign-eSignature-Discovery.log" + +[int32]$LogLevel = 2 [string]$logApplicationHeader = "Docusign eSignature Discovery" [string]$scope ="signature impersonation" #endregion diff --git a/Scripts/SecretServer/eSignature/Instructions.md b/Scripts/SecretServer/eSignature/Instructions.md index fe680e1..bfbce1a 100644 --- a/Scripts/SecretServer/eSignature/Instructions.md +++ b/Scripts/SecretServer/eSignature/Instructions.md @@ -39,6 +39,11 @@ More information can be found [here](https://developers.docusign.com/docs/esign- > [!NOTE] > Field descriptions and details can be found at [Docusign JWT structure and properties](https://developers.docusign.com/platform/auth/jwt/jwt-get-token/#see-details-jwt-structure-and-properties). +## Install the Delinea Utils Powershell Module + +This module contains to commandlets that are used within this script and the ine installation must be run on all Distributed Engines that will participate in running the scripts provided in this integration. +- Follow the instructions provided [Here](./Delinea.PoSH.Helpers/readme.md) to install the module. + ## Creating secret template for Docusign eSignature Accounts ### eSignature User Account Template