4killo / dsv-cli

⚡ A cross-platform swiss army knife tool for DevOps secrets management.

Delinea DevOps Secrets Vault CLI

An automation tool for the management of credentials for applications, databases, CI/CD tools, and services.

Getting Started

• Pre-built Binaries
• Developer: instructions on running tests, local tooling, and other resources.
• DSV Documentation

Quick Start Install

Any Platform

• 🔨 Download from prebuilt-binaries manually.

• Aquaproject: aqua generate 'DelineaXPM/dsv-cli' -i and update your aqua.yml file.

• PowerShell Cross-Platform (pwsh) with console selector (move to directory in $ENV:PATH for it to be universally discoverable):

  if (-not (Get-InstalledModule Microsoft.PowerShell.ConsoleGuiTools -ErrorAction SilentlyContinue))
  {
      Install-Module Microsoft.PowerShell.ConsoleGuiTools -Force -Confirm:$false -Scope CurrentUser
  }
  
  $json=(Invoke-WebRequest -ContentType 'application/json' -Uri 'https://s3.amazonaws.com/dsv.secretsvaultcloud.com/cli-version.json' -UseBasicParsing).Content | ConvertFrom-Json
  $download=$json.Links | get-member -Type NoteProperty | ForEach-Object {
  [pscustomobject]@{
      FileName = $_.Name
      DownloadLink = $json.Links.$($_.Name)
      OutFileName = ($json.Links.$($_.Name) -split '/')[-1]
  }} | Out-ConsoleGridView  -Title 'Delinea DevOps Secrets Vault CLI'
  $download | ForEach-Object { Invoke-WebRequest -Uri $_.DownloadLink -OutFile $_.OutFileName -UseBasicParsing }

Mac & Linux

• aqua-project provides a binary tool manager similar to Brew.

• 👉 PENDING: Brew: brew install dsv-cli.

• Curl (if you have go installed):

  version=$(curl -sb -H "Accept: application/json" https://s3.amazonaws.com/dsv.secretsvaultcloud.com/cli-version.json | $(go env GOPATH)/bin/yq '.latest')
  echo "version: $version"
  curl -fSsl https://dsv.secretsvaultcloud.com/downloads/cli/$version/dsv-darwin-x64 -o dsv && chmod +x ./dsv && sudo mv ./dsv /usr/local/bin

• Only curl (requires specifying the version):

  curl -fSsl https://dsv.secretsvaultcloud.com/downloads/cli/1.39.0/dsv-darwin-x64 -o dsv && chmod +x ./dsv && sudo mv ./dsv /usr/local/bin

note: It is not required to install to /usr/local/bin. If you choose to install to another location you'll want to make sure it's added to your PATH for the tool to be found.

Windows

• 👉 PENDING: Possible choco/scoop installations depending on demand.

• Using curl in Windows PowerShell (for cross-platform pwsh see top section) and move to whatever directory you want:

  $json=(Invoke-WebRequest -ContentType 'application/json' -Uri 'https://s3.amazonaws.com/dsv.secretsvaultcloud.com/cli-version.json' -UseBasicParsing).Content | ConvertFrom-Json
  # Change this to windows/386 if required to install x86.
  Invoke-WebRequest -Uri $json.links.'windows/amd64' -OutFile 'dsv.exe' -UseBasicParsing

License

See LICENSE for the full license text.

Contributors

Thycotic-Bot

Sheldonhull

Andrii Zakurenyi