Skip to main content

StackJack 0.1.0.10339+ac16154

StackJack 0.1.0.10339+ac16154

This release reworks business email compromise (BEC) investigation in the CIPP connector. Starting an investigation works again against current CIPP, ten BEC tools are new, and the built-in BEC triage template now follows the current CIPP workflow. Microsoft Graph requests and user lookups through CIPP also gain query options, so you can ask for less data.

New features

  • New CIPP BEC tools. Ten tools cover the rest of the BEC workflow:
  • cipp_list_bec_reports lists existing investigations with their status and when they were run.
  • cipp_list_bec_remediation_actions lists the remediation actions CIPP offers.
  • cipp_list_bec_phishing_spread shows how far a suspected phishing message spread.
  • cipp_bec_evidence_export exports an investigation's evidence as a ZIP, delivered as a download link.
  • cipp_bec_report_pdf returns a download link for an investigation's report. Choose the full report or the summary.
  • cipp_bec_ip_review records your review of IP addresses on the CIPP case. It changes only the case record.
  • cipp_delete_bec_report permanently deletes an investigation report.
  • cipp_bec_bulk_check queues a full investigation for each user in a list.
  • cipp_list_bec_remediation_defaults shows the default remediation actions.
  • cipp_set_bec_remediation_defaults replaces the default remediation actions.
  • Tier and permission requirements for the new tools.
  • Read tools are on the Free tier. Tools that change data are on the Pro tier.
  • Each tool requires the CIPP role that the matching CIPP endpoint declares.
  • Remediation defaults apply across your whole CIPP instance. The defaults you set with cipp_set_bec_remediation_defaults are used wherever remediation runs without naming specific actions.
  • Graph query options on cipp_graph_request. The tool now accepts these as separate optional arguments: filter, select, expand, top, count, orderBy, search and noPagination.
  • CIPP now applies these options. Writing them into the endpoint string had no effect, so large endpoints such as sign-in logs could return their entire collection and time out.
  • top sets a page size, not a total limit. Pair it with noPagination to cap the results.
  • Calls without options behave exactly as before.
  • Single-user and filtered lookups in cipp_list_users. Two new optional arguments are available:
  • userId returns one user by object ID or UPN.
  • filter applies a Graph filter to the list.
  • You can't use both in the same call.
  • Without either, the tool still returns every user in the tenant.

Improvements

  • New arguments on cipp_bec_remediate.
  • actions lets you choose which remediation actions to run.
  • confirmation is required when the selected actions include critical ones.
  • caseId links the remediation to an investigation.
  • An actions list that resolves to nothing is now refused, rather than silently running CIPP's default set.
  • How cipp_bec_bulk_check reports results.
  • If at least one user was queued, you get CIPP's full reply, including which users were queued and which were skipped. Previously, a skipped user made the whole call look like a failure.
  • The call counts as an error only if no user was queued.
  • Retry only the users that came back with an error. Re-sending the whole list would queue the found users again.
  • Updated BEC triage preflight template. The built-in template now works with current CIPP. It runs in this order:
  1. Resolves the tenant.
  2. Looks up just the one user. It no longer pulls the whole tenant's user list, which could exceed result limits on large tenants.
  3. Reuses an investigation that is already in progress, or one completed in the last 24 hours, instead of starting a duplicate.
  4. Starts a new investigation if needed.
  5. Gathers sign-in, mailbox and conditional access context.
  6. Polls a limited number of times.
  7. Links the summary PDF once the investigation has completed.
  8. Checks phishing spread.
  • What to expect from one template run. A multi-minute investigation may not finish within one run. Running the template again picks up the completed investigation and finishes the report.
  • Template permissions and runtime. The template's only write action is still starting an investigation. It is not granted any remediation, delete, bulk or settings tool. Its default runtime is now 900 seconds instead of 600.
  • Clearer tool descriptions. cipp_bec_check no longer says that investigations skip mailbox-level forwarding; they do check it. Existing BEC tool descriptions now point to the related new tools.
  • New documentation. The CIPP connector documentation has a new section on investigating a business email compromise and documents the Graph query options.

Bug fixes

  • cipp_bec_check was not starting investigations against current versions of CIPP. Every call reported that no runs existed. It now starts investigations and can poll them until they finish.
  • cipp_bec_remediate could not succeed when no actions were specified, because CIPP's default actions require confirmation. You can now select actions and provide confirmation.

Breaking changes

  • When polling with cipp_bec_check, pass the case ID returned when the investigation started as the guid argument.
  • The overwrite argument on cipp_bec_check is now ignored.

Known issues

  • Existing installs of the BEC triage preflight template keep their previously installed prompt. To use the updated workflow, reinstall the template.