//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