Self Service Email

The Self Service Email tool generates a pre-filled email template that users can send via their email client. It automatically composes the email with specified recipients, subject, and body content. If an email client is not set up, the tool provides a fallback by saving the email as a plain text file for manual use.

Quick Start

To quickly compose and open an email, run the following command:

Example Command

rocketman SelfServiceEmail \
  --clientId ... \
  --clientSecret ENC:... \
  --to "helpdesk@example.com" \
  --subject "Assistance Request" \
  --body "Please provide details about your issue."

This example creates an email addressed to helpdesk@example.com with the subject "Assistance Request" and the specified body content. The email will open in the user’s default email client.

Command Options

Required Parameters

--clientId [string]

Specifies the encrypted credentials for Jamf API authentication.

• Type: string
• Example:

  --clientId "..." OR --clientId "ENC:..."

--clientSecret [string]

Specifies the encrypted credentials for Jamf API authentication.

• Type: string
• Example:

  --clientSecret "..." OR --clientSecret "ENC:..."

--to [string]

Specifies the recipient's email address.

• Type: string
• Example:

  --to "helpdesk@example.com"

--subject [string]

Sets the subject of the email.

• Type: string
• Example:

  --subject "Assistance Request"

--body [string]

Defines the main content of the email.

• Type: string
• Example:

  --body "Please provide details about your issue."

Optional Parameters

--cc [string]

Specifies additional recipients to be copied on the email. Separate multiple addresses with commas.

• Type: string
• Default: None
• Example:

  --cc "teamlead@example.com,manager@example.com"

--bcc [string]

Adds blind carbon copy recipients, whose addresses are hidden from other recipients. Separate multiple addresses with commas.

• Type: string
• Default: None
• Example:

  --bcc "admin@example.com"

--simulate

Simulates the email generation process without opening the email client.

• Type: flag
• Default: False
• Example:

  --simulate

--domain [string]

Specifies the domain for settings in local or managed plists.

• Type: string
• Default: tech.rocketman.selfservicemail
• Example:

  --domain "custom.domain.selfservicemail"

Advanced Usage Example

The following command creates an email with multiple recipients and additional information retrieved from Jamf API:

rocketman SelfServiceEmail \
  --to "helpdesk@example.com" \
  --cc "supervisor@example.com" \
  --bcc "admin@example.com" \
  --subject "Technical Support Needed" \
  --body "Please assist with the following issue: ..." \
  --clientId "..." \
  --clientSecret "..."

If the user’s default email client is not configured or fails to open, the email will be saved as a plain text file in /tmp/EmailTemplate.txt for manual use.

Important Notes

1. Fallback for Missing Email Client:

   • If no email client is configured, the tool saves the email content as a text file. The file includes all recipients, subject, and body content, allowing users to manually copy and paste the details into another platform.
   • The text file is saved to: /tmp/EmailTemplate.txt.

2. Jamf API Integration:

   • If --encryptedCredentialsPlistPath are provided, the tool retrieves user and device information from Jamf Pro to append additional context to the email body.
   • Information added includes the user's full name, computer model, Jamf Pro Record ID, and Trellix GUID (if available).

3. Simulation Mode:

   • Use the --simulate flag to validate configurations and view outputs without opening the email client.

4. Platform Limitations:

   • The tool relies on the mailto protocol to interact with the default email client, which may behave differently across platforms. Ensure the default email client is properly configured.

Inspiration

Inspired by @emily's Jamf Nation Post: Sending Emails via JSS