Aktiewe FTD-terrein-VPN's tel: watter getal bedoel jy?

Voordat jy die Ansible-taak skryf, beantwoord ’n kleiner vraag: wat word getel? ’n Gekonfigureerde eweknie, ’n IKE-sessie, ’n IPsec-sekuriteitsassosiasie en ’n gemoniteerde tonnelstatus-rekord is vier verskillende eenhede, en hersluiting of verskeie beskermde netwerke laat hul totale uiteenloop. As die paneelbord en die playbook verskil, tel hulle gewoonlik verskillende dinge eerder as dat een van hulle verkeerd is.

Vier dinge wat mense aktief noem

’n Gekonfigureerde eweknie is ’n topologie-objek: dit bestaan omdat iemand dit gedefinieer het. ’n IKE-sessie is ’n beheervlak-verhouding wat op kan wees terwyl geen verkeer vloei nie. ’n IPsec-SA is die datavlak-assosiasie vir ’n bepaalde selektorspaar, en een tonnel kan verskeie dra. ’n Gemoniteerde tonnelstatus is die platform se eie operasionele oordeel, wat gewoonlik die naaste is aan wat ’n operateur bedoel met die tonnel is op.

Net die laaste een is ’n redelike basis vir ’n operasionele telling. Die eerste een is ’n konfigurasie-inventaris, en om dit as aktief te rapporteer is hoe ’n paneelbord groen wys vir ’n eweknie wat sedert Dinsdag af is. Besluit watter eenheid die verbruiker van die getal nodig het, en benoem dan die maatstaf met daardie eenheid in sy eie naam.

Beslissing een: watter bestuursvlak?

As die toestel deur FDM bestuur word, is die FTD REST API die relevante oppervlak. As dit deur FMC bestuur word, is daardie API nie ’n uitruilbare plaasvervanger nie, en die objekte woon agter FMC se eie API. Bevestig dit voordat jy ’n enkele versoek skryf, want die verkeerde vlak gee ’n geloofwaardige fout wat soos ’n toestemmingsprobleem lyk.

Vir ’n vloot bepaal die antwoord ook waar die telling hoort: per toestel deur FDM, of per domein deur FMC. Dit is verskillende omvang en hulle lewer verskillende getalle vir dieselfde vloot.

Beslissing twee: watter hulpbron antwoord dit?

Vir ’n weergawe-gebonde voorbeeld dokumenteer die FMC 7.3 API-objekverwysing GET-hulpbronne onder die health-pad:

/api/fmc_config/v1/domain/{domainUUID}/health/tunnelstatuses
/api/fmc_config/v1/domain/{domainUUID}/health/tunnelsummaries

Die tonnelstatus-hulpbron ondersteun toestel- en statusfilters, insluitend TUNNEL_UP. Dit gee jou ’n werklike operasionele hulpbron om vir daardie weergawe te ondersoek eerder as ’n raaiskoot oor ’n veldnaam.

Bevestig beskikbaarheid, toestemmings, versoekparameters en die antwoordskema op die ontplooide FMC se API Explorer voordat jy ’n ontleder implementeer. Dokumentasie vir een weergawe is ’n beginpunt, nie ’n kontrak vir die een wat jy gebruik nie.

Skryf die telkontrak

Stel die maatstaf in een sin: unieke operasionele tonnelrekords vir een beoogde toestel en domein wie se gerapporteerde status TUNNEL_UP is. Dokumenteer dan hoe oortollige toestelle en veelvuldige rekords vir een logiese terrein voorgestel word, want daardie twee gevalle bepaal of jou getal by die een in die vergadering pas.

Moenie die eenheid stilweg van tonnelrekord na afgeleë terrein verander nie. As die besigheid terreine wil hê, karteer rekords eksplisiet na terreine en publiseer die kartering. ’n Telling wat homself stilletjies herdefinieer is erger as geen telling nie, want niemand kan sien wanneer dit verander het nie.

Behandel die opsommingshulpbron as ’n gerief slegs nadat jy bevestig het wat dit opsom. Dit mag presies optel wat jy nodig het, of dit kan ’n subtiel ander vraag beantwoord. Lees sy skema een keer, skryf die verskil neer, en gebruik die statushulpbron as die opsomming nie verduidelik kan word nie. ’n Opsomming wat jy nie verstaan nie is ’n getal wat jy nie in ’n hersiening kan verdedig nie.

Laat die werkvloei onsekerheid bewaar

Gebruik die goedgekeurde HTTPS API, valideer die sertifikaat, hou tekens uit taakuitset, en haal die omvang met die weergawe se ondersteunde filter en paginering. Valideer dan die skema voordat jy iets bereken.

fetch intended domain/device runtime records
validate response, completeness and freshness
deduplicate by the documented tunnel identity
count records matching the approved up-state definition
report count with scope, timestamp and metric unit

Dit is werkvloei-pseudokode, nie ’n getoetste playbook nie. Neem die werklike veldname uit die geïnstalleerde API in plaas daarvan om ’n JSON-sleutel genaamd active te versin.

Die belangrike reël is foutgedrag: ’n magtigingsfout, ’n onondersteunde hulpbron, ’n verouderde monster of ’n onvolledige bladsyversameling moet onbekend of fout lewer, nooit ’n suksesvolle nul nie. ’n Nul wat beteken ek kon nie vra nie is die duurste soort verkeerd.

Valideer teen die platform se eie siening

Vergelyk die eerste resultaat met die weergawe se VPN-moniteringsaansig vir dieselfde toestel en oomblik. Wanneer hulle verskil, vind uit watter eenheid elkeen gebruik voordat jy die playbook verander.

Bewaar nie-geheime konteks vir elke lopie: omvang, tydstempel, maatstafeenheid en rekordtelling. Die FMC 7.3 API-objekverwysing is die bron vir die hulpbronpaaie hierbo, en die API Explorer op jou eie ontplooiing is die bron vir alles anders.