adamburley / PassPushPosh

A PowerShell module for Password Pusher

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

PassPushPosh

PassPushPosh is a PowerShell Module for interfacing with the Password Pusher secure password / string sharing application, primarily through pwpush.com. It supports creating, retrieving, and deleting anonymous and authenticated pushes, links in any supported language, and getting Push and Dashboard data for authenticated users.

A primary design goal with this module was to provide simple, beginner-friendly access to API connections. Cmdlets provide clear responses to errors, support additional messaging via -Debug and -Verbose, transaction testing via -Whatif and -Confirm, and in general try to be as "Powershell-y" as possible.

Using PassPushPosh can be as simple as:

PS> "Here's my secret!" | New-Push | select Link
Link
----
https://pwpush.com/en/p/gzv65wiiuciy

Or more completely...

PS> Import-Module PassPushPosh
PS> $myPush = New-Push "Here's my secret!"
PS> $myPush.Link
https://pwpush.com/en/p/gzv65wiiuciy

See Docs or Get-Help [command] for more information. Happy sharing!

How to Get

  • Available on PowerShell Gallery - Install-Module -Name PassPushPosh
  • Copy PassPushPosh/PassPushPosh.psm1 and PassPushPosh/PassPushPosh.psd1 to a folder called PassPushPosh somewhere on your computer and Import-Module .\PassPushPosh\

Notes

  • For -Verbose and -Debug, output is sanitized to prevent payloads from being written to screen.
  • -Raw is available for cmdlets if you just want the JSON body of the response back.

Links

TODO

  • Publish to PowerShell Gallery
  • Support localization (multiple languages)
  • Support localization in secret link and 1-step link
  • Documentation for [PasswordPush] class
  • Implement automated testing with Pester
  • Implement automatic builds / deploys
  • External Module documentation
  • Add PSVersion info to User-Agent
  • Add 'burn after reading' option to Get-Push and New-Push
  • Issue: [PasswordPush] object Language property reflects global language setting, does not reflect language at time of Push
  • Update expired value on a Get-Push call when views_remaining=0
  • Change session data scope from $global to $script

About

A PowerShell module for Password Pusher

License:GNU General Public License v3.0


Languages

Language:PowerShell 100.0%