import {z} from 'zod' export type GetApiApiV2SecurityMonitoringSecurityAgentInvestigationsArgs = {'filter[signal_id]'?: string | undefined, 'filter[title]'?: string | undefined, 'filter[from]'?: string | undefined, 'filter[to]'?: string | undefined, 'filter[verdict]'?: string | undefined, 'filter[state]'?: string | undefined, 'filter[rule_id]'?: string | undefined, 'filter[rule_type]'?: string | undefined, 'filter[signal_severity]'?: string | undefined, 'filter[signal_source]'?: string | undefined, 'filter[tags]'?: string | undefined, 'filter[entity]'?: string | undefined, sort?: string | undefined, 'page[number]'?: number | undefined, 'page[size]'?: number | undefined}; export type GetApiApiV2SecurityMonitoringSecurityAgentInvestigationsOptions = {baseUrl?: string | undefined, apiKeyAuth?: string | undefined, appKeyAuth?: string | undefined, fetch?: typeof fetch | undefined}; export const securityAgentInvestigationSignal = z.object({severity: z.string().optional(), sources: z.array(z.string()).optional(), tactic: z.string().optional(), tags: z.array(z.string()).optional(), technique: z.string().optional(), timestamp: z.string().optional(), title: z.string().optional()}); export const securityAgentInvestigationState = z.enum(["investigating", "completed", "failed"]); export const securityAgentInvestigationVerdict = z.enum(["benign", "suspicious", "malicious"]); export const securityAgentInvestigationListItemAttributes = z.object({created_at: z.string().optional(), is_latest: z.boolean(), rule_id: z.string(), signal: securityAgentInvestigationSignal.optional(), signal_id: z.string(), state: securityAgentInvestigationState, updated_at: z.string().optional(), verdict: securityAgentInvestigationVerdict.optional()}); export const securityAgentInvestigationType = z.literal("investigations"); export const securityAgentInvestigationListItem = z.object({attributes: securityAgentInvestigationListItemAttributes, id: z.string(), type: securityAgentInvestigationType}); export const securityAgentInvestigationNoRunReason = z.enum(["investigation_not_started", "not_investigated", "rule_not_enabled", "signal_not_found", "org_not_activated"]); export const securityAgentInvestigationsListMeta = z.object({reason: securityAgentInvestigationNoRunReason.optional(), total_count: z.number().int()}); export const securityAgentInvestigationsListResponse = z.object({data: z.array(securityAgentInvestigationListItem), meta: securityAgentInvestigationsListMeta}); export const validateResponse = async ( schema: { readonly '~standard': { readonly validate: (value: unknown) => ({ readonly value: Output; readonly issues?: undefined } | { readonly issues: ReadonlyArray<{ readonly message: string; readonly path?: ReadonlyArray | undefined }> }) | Promise<{ readonly value: Output; readonly issues?: undefined } | { readonly issues: ReadonlyArray<{ readonly message: string; readonly path?: ReadonlyArray | undefined }> }> } }, value: unknown ): Promise => { const result = await schema['~standard'].validate(value) if (result.issues !== undefined) { const detail = result.issues .map(({ message, path }) => path?.length ? `${path.map((segment) => String(typeof segment === 'object' ? segment.key : segment)).join('.')}: ${message}` : message ) .join('; ') throw new Error(`Response does not match the schema: ${detail}`, { cause: { issues: result.issues } }) } return result.value }; /** * List Bits Security Analyst investigations * * GET /api/v2/security_monitoring/security_agent/investigations * * Also accepts auth: AuthZ */ export const getApiApiV2SecurityMonitoringSecurityAgentInvestigations = async (args: GetApiApiV2SecurityMonitoringSecurityAgentInvestigationsArgs, options?: GetApiApiV2SecurityMonitoringSecurityAgentInvestigationsOptions) => { const {baseUrl = "https://api.datadoghq.com", fetch: fetchFn = fetch, apiKeyAuth, appKeyAuth} = options ?? {} const query = new URLSearchParams() const headers = new Headers() headers.set('accept', "application/json") if (args['filter[signal_id]'] != null) query.append("filter[signal_id]", String(args['filter[signal_id]'])) if (args['filter[title]'] != null) query.append("filter[title]", String(args['filter[title]'])) if (args['filter[from]'] != null) query.append("filter[from]", String(args['filter[from]'])) if (args['filter[to]'] != null) query.append("filter[to]", String(args['filter[to]'])) if (args['filter[verdict]'] != null) query.append("filter[verdict]", String(args['filter[verdict]'])) if (args['filter[state]'] != null) query.append("filter[state]", String(args['filter[state]'])) if (args['filter[rule_id]'] != null) query.append("filter[rule_id]", String(args['filter[rule_id]'])) if (args['filter[rule_type]'] != null) query.append("filter[rule_type]", String(args['filter[rule_type]'])) if (args['filter[signal_severity]'] != null) query.append("filter[signal_severity]", String(args['filter[signal_severity]'])) if (args['filter[signal_source]'] != null) query.append("filter[signal_source]", String(args['filter[signal_source]'])) if (args['filter[tags]'] != null) query.append("filter[tags]", String(args['filter[tags]'])) if (args['filter[entity]'] != null) query.append("filter[entity]", String(args['filter[entity]'])) if (args.sort != null) query.append("sort", String(args.sort)) if (args['page[number]'] != null) query.append("page[number]", String(args['page[number]'])) if (args['page[size]'] != null) query.append("page[size]", String(args['page[size]'])) if (apiKeyAuth !== undefined) headers.set("DD-API-KEY", apiKeyAuth) if (appKeyAuth !== undefined) headers.set("DD-APPLICATION-KEY", appKeyAuth) const url = `${baseUrl.replace(/\/+$/, '')}/api/v2/security_monitoring/security_agent/investigations${query.size > 0 ? `?${query}` : ''}` const res = await fetchFn(url, {method: "GET", headers}) if (!res.ok) throw new Error(`Request failed with status ${res.status}`, {cause: {status: res.status, body: await res.text()}}) return validateResponse(securityAgentInvestigationsListResponse, await res.json()) };