Edits history of script submission #24193 for ' Search fixed addresses (infoblox_nios)'

  • bunnative
    One script reply has been approved by the moderators
    Ap­pro­ved
    //native
    
    function wapiUrl(auth: RT.InfobloxNios, path: string) {
      const host = auth.host
        .trim()
        .replace(/^https?:\/\//, "")
        .replace(/\/+$/, "")
      const version = auth.wapi_version.trim().replace(/^v/, "")
      return new URL(`https://${host}/wapi/v${version}/${path}`)
    }
    
    function basicAuth(auth: RT.InfobloxNios) {
      const bytes = new TextEncoder().encode(`${auth.username}:${auth.password}`)
      return `Basic ${btoa(String.fromCharCode(...bytes))}`
    }
    
    async function wapiError(response: Response) {
      const text = await response.text()
      if (response.status === 401) {
        return new Error(
          "401 Unauthorized: wrong username or password, or the user's admin group has no API access"
        )
      }
      try {
        // WAPI errors are JSON: {"Error": "AdmConDataNotFoundError: ...", "code": "Client.Ibap.Data.NotFound", "text": "..."}
        const { Error: error, code, text: detail } = JSON.parse(text)
        if (error) {
          const message =
            detail && !error.includes(detail) ? `${error}: ${detail}` : error
          return new Error(
            `${response.status} ${message}${code ? ` (${code})` : ""}`
          )
        }
      } catch {}
      return new Error(`${response.status} ${text}`)
    }
    
    /**
     * Search fixed addresses
     * Search static DHCP reservations (fixedaddress) by MAC address (any of aa:bb:cc:dd:ee:ff, AA-BB-CC-DD-EE-FF or aabb.ccdd.eeff), IPv4 address, network CIDR, network view or extensible attribute values (extattr_filters {"Site": "Paris"}), one page at a time. Pass the returned next_page_id as page_id to get the next page; it is null on the last page.
     */
    export async function main(
      auth: RT.InfobloxNios,
      mac: string | undefined,
      ipv4addr: string | undefined,
      network: string | undefined,
      network_view: string | undefined,
      extattr_filters: { [key: string]: string } | undefined,
      max_results: number | undefined,
      page_id: string | undefined,
      return_fields: string[] | undefined
    ) {
      const url = wapiUrl(auth, "fixedaddress")
      if (mac) {
        // NIOS stores MACs as aa:bb:cc:dd:ee:ff; accept AA-BB-..., aabb.ccdd.eeff and bare hex.
        const hex = mac
          .trim()
          .toLowerCase()
          .replace(/[^0-9a-f]/g, "")
        url.searchParams.append(
          "mac",
          hex.length === 12 ? hex.match(/../g)!.join(":") : mac.trim().toLowerCase()
        )
      }
      if (ipv4addr) url.searchParams.append("ipv4addr", ipv4addr)
      if (network) url.searchParams.append("network", network)
      if (network_view) url.searchParams.append("network_view", network_view)
      for (const [name, value] of Object.entries(extattr_filters ?? {})) {
        if (value != null && value !== "")
          url.searchParams.append(`*${name}`, String(value))
      }
      const fields = [
        "mac",
        "name",
        "network",
        "comment",
        "extattrs",
        ...(return_fields ?? []),
      ]
      url.searchParams.append("_return_fields+", fields.join(","))
      url.searchParams.append("_paging", "1")
      url.searchParams.append("_return_as_object", "1")
      url.searchParams.append("_max_results", String(max_results || 100))
      if (page_id) url.searchParams.append("_page_id", page_id)
    
      const response = await fetch(url, {
        headers: {
          Authorization: basicAuth(auth),
          Accept: "application/json",
        },
      })
    
      if (!response.ok) {
        throw await wapiError(response)
      }
    
      const data = await response.json()
      return { result: data.result, next_page_id: data.next_page_id ?? null }
    }
    

    Submitted by hugo989 3 hours ago