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_reportslists existing investigations with their status and when they were run.cipp_list_bec_remediation_actionslists the remediation actions CIPP offers.cipp_list_bec_phishing_spreadshows how far a suspected phishing message spread.cipp_bec_evidence_exportexports an investigation's evidence as a ZIP, delivered as a download link.cipp_bec_report_pdfreturns a download link for an investigation's report. Choose the full report or the summary.cipp_bec_ip_reviewrecords your review of IP addresses on the CIPP case. It changes only the case record.cipp_delete_bec_reportpermanently deletes an investigation report.cipp_bec_bulk_checkqueues a full investigation for each user in a list.cipp_list_bec_remediation_defaultsshows the default remediation actions.cipp_set_bec_remediation_defaultsreplaces 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_defaultsare 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,searchandnoPagination. - 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.
topsets a page size, not a total limit. Pair it withnoPaginationto 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: userIdreturns one user by object ID or UPN.filterapplies 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. actionslets you choose which remediation actions to run.confirmationis required when the selected actions include critical ones.caseIdlinks 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_checkreports 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:
- Resolves the tenant.
- Looks up just the one user. It no longer pulls the whole tenant's user list, which could exceed result limits on large tenants.
- Reuses an investigation that is already in progress, or one completed in the last 24 hours, instead of starting a duplicate.
- Starts a new investigation if needed.
- Gathers sign-in, mailbox and conditional access context.
- Polls a limited number of times.
- Links the summary PDF once the investigation has completed.
- 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_checkno 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_checkwas 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_remediatecould 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 theguidargument. - The
overwriteargument oncipp_bec_checkis 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.