Skip to content

Latest commit

 

History

History
79 lines (56 loc) · 2.44 KB

README.md

File metadata and controls

79 lines (56 loc) · 2.44 KB

Fastmail MaskedEmail CLI

CLI to create Fastmail Masked Emails for whenever you need to

showcase

Setup

go get github.com/dvcrn/maskedemail-cli

or newer Go versions

go install github.com/dvcrn/maskedemail-cli@latest

Authentication

You'll need to create a FastMail API token.

🔒 The only necessary scope is "Masked Email".

Always use unique API tokens with the minimum scope(s) necessary for different purposes.

You can test authentication by running maskedemail-cli -token abcdef12345 session.

Usage

Usage of maskedemail-cli:
Flags:
  -accountid string
      fastmail account id (or MASKEDEMAIL_ACCOUNTID env)
  -appname string
      the appname to identify the creator (or MASKEDEMAIL_APPNAME env) (default: maskedemail-cli)
  -token string
      the token to authenticate with (or MASKEDEMAIL_TOKEN env)

Commands:
  maskedemail-cli create [-domain "<domain>"] [-desc "<description>"] [-prefix "<prefix>"] [-enabled=true|false (default true)]
  maskedemail-cli list [-show-deleted] [-all-fields]
  maskedemail-cli enable <maskedemail>
  maskedemail-cli disable <maskedemail>
  maskedemail-cli delete <maskedemail>
  maskedemail-cli update <maskedemail> [-domain "<domain>"] [-desc "<description>"]
  maskedemail-cli session
  maskedemail-cli version

Example:

$ maskedemail-cli -token abcdef12345 create -domain "facebook.com" -desc "Facebook"
$ maskedemail-cli -token abcdef12345 enable 123@mydomain.com
$ maskedemail-cli -token abcdef12345 disable 123@mydomain.com

$ maskedemail-cli -token abcdef12345 list
Masked Email        For Domain     Description   State
123@mydomain.com    facebook.com   Facebook      disabled

Other resources and things powered by this CLI

Note that these are based on an earlier version of the CLI.

License

MIT

Attributions

JMAP API documentation from jmapio/jmap (Apache 2.0 / Copyright 2016 Fastmail Pty Ltd)