Command Line Interface

Due to current geo-political atmosphere, SecureSocial.net is no longer available to new customers

SecureSocial framework is also accessible from command-line interface (CLI). CLI runs on your Windows, Linux or Mac machines or on anything else that can run Java platform, version 6 or later. CLI is designed for system administrators and power users and brings power of PGP-secured messaging to your computer. Use SecureSocial CLI to incorporate our powerful encryption network into your scripts.

To start using CLI, follow these steps:

java -cp securesocial-cli.jar:bcprov-jdk16-1.46.jar:bcpg-jdk16-1.46.jar net.securesocial.cli.App options (use ; instead of : to separate jars on Windows)

The complete list of options


-A,--accept-messages           accept messages from specific user
 -a,--get-attachment           get attachment from message
 -c,--format-as-column         format output vertically
 -d,--delete-message           delete message
 -e,--show-stacktrace          show stacktrace on error
 -F,--find-identity            find identities matching name
 -f,--attachment < arg >         attachment file
 -G,--get-messages             get pending messages
 -g,--get-identity             get identity
 -h,--help                     display help
 -I,--identity-name < arg >      identity name
 -i,--identity-id < arg >        identity id
 -K,--public-key-file < arg >    public key file
 -k,--private-key-file < arg >   private key file
 -l,--list-incoming-users      list users who sent you messages
 -M,--message-text < arg >       message text, prompted for if not specified
 -m,--message-id < arg >         message id
 -N,--create-new-identity      create new identity
 -n,--list-new-ids             list suggested new identity ids
 -o,--about                    display about message
 -p,--payment-token < arg >      payment token
 -r,--recipients < arg >         recipients of the message
 -s,--send-message             send message
 -T,--timeline < arg >           timeline scope, yyyy-MM-dd
 -u,--sender-id < arg >          identity id of sender
 -x,--passphrase < arg >         passphrase, if not specified, read from
                               SECSOC_PASSPHRASE env variable or prompted
                               for value

Examples of options

List suggested new identity ids

-n -c

Create new identity

-N -k path-to-pgp-private-key -K path-to-pgp-public-key -i new-identity-id

Send message

-s -i identity-id -k path-to-private-key -r list-of-recipients -M text-of-message

List users sending you messages

-l -i identity-id -k path-to-private-key

Accept messages from user

-A -i identity-id -k path-to-private-key -u user-id-of-sender

get messages

-G -i identity-id -k path-to-private-key -T timeline-yyyy-mm-dd