Search rules

//native

/**

 * Search rules

 * Search the security rules of one device with SecureTrack's rule search text (e.g. an IP, an object name, or "action:accept"). Returns one page; pass next_start as start to get the next one.

 */

export async function main(

  auth: RT.TufinSecuretrack,

  device_id: number,

  search_text: string | undefined,

  start: number | undefined,

  count: number | undefined

) {

  const pageStart = start ?? 0

  const pageCount = count || 100

  const base = auth.base_url.replace(/\/+$/, "")

  const url = new URL(`${base}/securetrack/api/rule_search/${device_id}`)

  url.searchParams.append("search_text", search_text || "")

  url.searchParams.append("start", String(pageStart))

  url.searchParams.append("count", String(pageCount))

  const response = await fetch(url, {

    method: "GET",

    headers: {

      Authorization: `Basic ${btoa(`${auth.username}:${auth.password}`)}`,

      Accept: "application/json",

    },

  })

  if (!response.ok) {

    throw new Error(`${response.status} ${await response.text()}`)

  }

  const data = await response.json()

  // rules.count is the number of rules in this page, rules.total the number of matches.

  const returned = Number(data?.rules?.count ?? 0)

  const total = Number(data?.rules?.total ?? 0)

  const nextStart = pageStart + returned

  return {

    ...data,

    next_start: returned > 0 && nextStart < total ? nextStart : null,

  }

}