import {z} from 'zod' export type GetApiV1AgentsIdArgs = {Id: number}; export type GetApiV1AgentsIdOptions = {baseUrl?: string | undefined, AccessToken?: string | undefined, fetch?: typeof fetch | undefined}; export const affectedPlatform = z.object({architecture: z.string().optional(), name: z.string().optional()}); export const emailConnection = z.object({auth_method: z.string().optional(), authentication: z.string().optional(), client_method: z.string().optional(), encryption: z.string().optional(), host: z.string().optional(), is_modern_auth: z.boolean().optional(), mail: z.string().optional(), port: z.number().int().optional(), service_url: z.string().optional(), timeout: z.number().int().optional(), username: z.string().optional(), validate_ssl: z.boolean().optional()}); export const emailTiming = z.object({attack_interval: z.number().int().optional(), is_new_timing: z.boolean().optional(), result_control_delay: z.number().int().optional(), result_control_window: z.number().int().optional(), trip_time_seconds: z.number().int().optional(), wait_seconds: z.number().int().optional(), window_size: z.number().int().optional()}); export const emailConfig = z.object({attachment_enabled: z.boolean().optional(), connection: emailConnection.optional(), dest_mail: z.string().optional(), dest_name: z.string().optional(), is_o365: z.boolean().optional(), timing: emailTiming.optional(), url_enabled: z.boolean().optional()}); export const exfiltrationGraphConfig = z.object({auth_method: z.string().optional(), is_modern_auth: z.boolean().optional(), timeout: z.number().int().optional(), url: z.string().optional(), validate_ssl: z.boolean().optional()}); export const exfiltrationMapiConfig = z.object({auth_method: z.string().optional(), is_modern_auth: z.boolean().optional(), timeout: z.number().int().optional(), url: z.string().optional(), user: z.string().optional()}); export const exfiltrationSmtpConfig = z.object({auth_method: z.string().optional(), encryption: z.string().optional(), host: z.string().optional(), is_modern_auth: z.boolean().optional(), mail: z.string().optional(), port: z.number().int().optional(), timeout: z.number().int().optional(), user: z.string().optional()}); export const exfiltrationConfig = z.object({graph: exfiltrationGraphConfig.optional(), mapi: exfiltrationMapiConfig.optional(), smtp: exfiltrationSmtpConfig.optional()}); export const lateralConfig = z.object({remote_domain: z.string().optional(), remote_host_name: z.string().optional(), remote_user_name: z.string().optional()}); export const natConfig = z.object({http_enabled: z.boolean().optional(), http_port: z.number().int().optional(), https_enabled: z.boolean().optional(), https_port: z.number().int().optional(), ip: z.string().optional()}); export const urlFilteringResult = z.object({blocked: z.boolean().optional(), reason: z.string().optional(), url: z.string().optional()}); export const urlFilteringConfig = z.object({rule: z.string().optional(), urls: z.array(urlFilteringResult).optional()}); export const watsConfig = z.object({protocol: z.string().optional(), rule: z.string().optional(), url: z.string().optional(), waf_type: z.string().optional()}); export const moduleConfig = z.object({email: emailConfig.optional(), exfiltration: exfiltrationConfig.optional(), lateral: lateralConfig.optional(), nat: natConfig.optional(), url_filtering: urlFilteringConfig.optional(), wats: watsConfig.optional()}); export const module = z.object({config: moduleConfig.optional(), configured: z.boolean().optional(), delay_seconds: z.number().int().optional(), enabled: z.boolean().optional(), id: z.number().int().optional(), name: z.string().optional()}); export const customAttacker = z.object({id: z.number().int().optional(), ip: z.string().optional(), name: z.string().optional()}); export const device = z.object({id: z.number().int().optional(), name: z.string().optional(), product_platform: z.string().optional(), product_version: z.string().optional()}); export const executionUser = z.object({id: z.number().int().optional(), is_default: z.boolean().optional(), user_type: z.string().optional(), username: z.string().optional()}); export const agentDetailReturn = z.object({affected_platforms: z.array(affectedPlatform).optional(), attack_modules: z.array(module).optional(), created_at: z.number().int().optional(), custom_attacker: customAttacker.optional(), devices: z.array(device).optional(), execution_users: z.array(executionUser).optional(), id: z.number().int().optional(), ip: z.string().optional(), is_update_needed: z.boolean().optional(), name: z.string().optional(), nat_ip: z.string().optional(), platform_architecture: z.string().optional(), platform_name: z.string().optional(), status: z.string().optional(), type: z.string().optional(), version: z.string().optional()}); export const getApiV1AgentsIdResponse = z.object({Agent: agentDetailReturn.optional()}); 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 }; /** * # Agent Detail * * GET /v1/agents/{Id} */ export const getApiV1AgentsId = async (args: GetApiV1AgentsIdArgs, options?: GetApiV1AgentsIdOptions) => { const {baseUrl = "https://api.picussecurity.com", fetch: fetchFn = fetch, AccessToken} = options ?? {} const query = new URLSearchParams() const headers = new Headers() headers.set('accept', "application/json") if (AccessToken !== undefined) headers.set("Authorization", AccessToken) const url = `${baseUrl.replace(/\/+$/, '')}/v1/agents/${encodeURIComponent(String(args.Id))}${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(getApiV1AgentsIdResponse, await res.json()) };