CISCO ASA REST API App

Istruzzjonijiet dwar l-Użu tal-Prodott

Fuqview

Bir-rilaxx tal-ASA REST API ta 'Cisco, issa għandek għażla oħra ħafifa u faċli biex tużah għall-konfigurazzjoni u l-ġestjoni ta' Cisco ASAs individwali. L-ASA REST API hija interface għall-ipprogrammar tal-applikazzjoni (API) ibbażata fuq prinċipji RESTful. Jista' jitniżżel malajr u jiġi attivat fuq kwalunkwe ASA fejn l-API tkun qed taħdem. Cisco Systems, Inc.

www.cisco.com

ASA REST API Talbiet u Risposti

Wara li tinstalla klijent REST fil-browser tiegħek, tista 'tikkuntattja l-aġent REST speċifiku tal-ASA u tuża metodi HTTP standard biex taċċessa l-informazzjoni attwali tal-konfigurazzjoni u toħroġ parametri ta' konfigurazzjoni addizzjonali.

Attenzjoni: Meta l-API REST hija attivata fuq ASA, konnessjonijiet minn protokolli oħra ta 'ġestjoni tas-sigurtà ma jiġux imblukkati. Dan ifisser li oħrajn li jużaw CLI, ASDM, jew Maniġer tas-Sigurtà jistgħu jbiddlu l-konfigurazzjoni ASA waqt li tkun qed tagħmel l-istess.

Struttura tat-Talba

L-API REST ASA tagħtik aċċess programmatiku għall-ġestjoni ta' ASAs individwali permezz ta' API ta' Trasferiment Statali Rappreżentazzjonali (REST). L-API tippermetti lill-klijenti esterni biex iwettqu operazzjonijiet CRUD (Oħloq, Aqra, Aġġorna, Ħassar) fuq riżorsi ASA. It-talbiet kollha tal-API jintbagħtu fuq HTTPS lill-ASA, u tingħata tweġiba.

fejn il-proprjetajiet tal-oġġett huma:

Proprjetà	Tip	Deskrizzjoni
messaġġi	Lista ta' Dizzjunarji	Lista ta' messaġġi ta' żball jew ta' twissija
kodiċi	Spag	Messaġġ dettaljat li jikkorrispondi għal Żball/Twissija/Informazzjoni
dettalji	Spag	Messaġġ dettaljat li jikkorrispondi għal Żball/Twissija/Informazzjoni

Nota: Bidliet li saru mis-sejħiet tal-API REST ma jibqgħux jippersistu għall-konfigurazzjoni tal-istartjar iżda huma assenjati biss għall-konfigurazzjoni li qed taħdem. Biex issalva bidliet fil-konfigurazzjoni tal-istartjar, tista' tuża t-talba tal-API POST a write mem. Għal aktar informazzjoni, irreferi għall-entrata tal-API tal-Memorja tal-Ikteb fil-kontenut Dwar l-API REST ASA.

Installa u Ikkonfigura l-Aġent u l-Klijent tal-API ASA REST

Nota: L-Aġent tal-API REST huwa applikazzjoni bbażata fuq Java. Il-Java Runtime Environment (JRE) huwa miġbur fil-pakkett REST API Agent.

Fuqview

Diversi għażliet huma disponibbli għall-konfigurazzjoni u l-ġestjoni ta' Cisco ASAs individwali:

• Interface tal-Linja tal-Kmand (CLI) - inti tibgħat kmandi ta 'kontroll direttament lill-ASA permezz ta' console konnessa.
• Adaptive Security Device Manager (ASDM) – applikazzjoni ta’ ġestjoni “on-box” b’interface tal-utent grafika li tista’ tuża biex tikkonfigura, timmaniġġja u timmonitorja ASA.
• Cisco Security Manager - filwaqt li huwa maħsub għal netwerks medji sa kbar ta 'ħafna apparati ta' sigurtà, din l-applikazzjoni grafika tista 'tintuża biex tikkonfigura, timmaniġġja u timmonitorja ASAs individwali.

Bir-rilaxx tal-ASA REST API ta' Cisco, issa għandek għażla oħra ħafifa u faċli biex tużah. Din hija interface għall-ipprogrammar tal-applikazzjoni (API), ibbażata fuq prinċipji "RESTful", li tista' tniżżel u tattiva malajr fuq kwalunkwe ASA li fuqha tkun qed taħdem l-API.

Wara li tinstalla klijent REST fil-brawżer tiegħek, tista 'tikkuntattja l-aġent REST speċifiku tal-ASA u tuża metodi HTTP standard biex taċċessa l-informazzjoni attwali tal-konfigurazzjoni, u toħroġ parametri ta' konfigurazzjoni addizzjonali.

Attenzjoni: Meta l-API REST hija attivata fuq ASA, konnessjonijiet minn protokolli oħra ta 'ġestjoni tas-sigurtà ma jiġux imblukkati. Dan ifisser li oħrajn li jużaw CLI, ASDM, jew Maniġer tas-Sigurtà jistgħu jbiddlu l-konfigurazzjoni ASA waqt li tkun qed tagħmel l-istess.

ASA REST API Talbiet u Risposti

L-API REST ASA tagħtik aċċess programmatiku għall-ġestjoni ta' ASAs individwali permezz ta' API ta' Trasferiment Statali Rappreżentazzjonali (REST). L-API tippermetti lill-klijenti esterni jwettqu operazzjonijiet CRUD (Oħloq, Aqra, Aġġorna, Ħassar) fuq riżorsi ASA; hija bbażata fuq il-protokoll HTTPS u l-metodoloġija REST. It-talbiet kollha tal-API jintbagħtu fuq HTTPS lill-ASA, u tingħata tweġiba. Din it-taqsima tipprovdi overview ta’ kif it-talbiet huma strutturati, u t-tweġibiet mistennija,

Struttura tat-Talba

Il-metodi ta' talba disponibbli huma:

• GET – Jiġbor id-dejta mill-oġġett speċifikat.
• PUT - Iżżid l-informazzjoni fornuta mal-oġġett speċifikat; jirritorna żball 404 Resource Not Found jekk l-oġġett ma jeżistix.
• POST - Joħloq l-oġġett bl-informazzjoni fornuta.
• DELETE – Tħassar l-oġġett speċifikat.
• PATCH – Japplika modifiki parzjali għall-oġġett speċifikat.

Struttura ta' Rispons

• Kull talba tipproduċi tweġiba HTTPS mill-ASA bl-intestaturi standard, il-kontenut tar-rispons, u l-kodiċi tal-istatus.

L-istruttura tar-rispons tista' tkun:

• POST - ID tar-riżorsi maħluqa ġodda; għall-POST biss—jżomm l-ID tar-riżorsi l-ġdid (bħala rappreżentazzjoni URI).
• TIP-KONTENUT – Tip ta' midja li jiddeskrivi l-korp tal-messaġġ tar-rispons; jiddeskrivi r-rappreżentazzjoni u s-sintassi tal-korp tal-messaġġ tar-rispons.

Kull tweġiba tinkludi status HTTP jew kodiċi ta 'żball. Kodiċijiet disponibbli jaqgħu f'dawn il-kategoriji:

• 20x – Kodiċi ta’ mitejn serje jindika tħaddim b’suċċess, inkluż:
  • 200 OK – Tweġiba standard għal talbiet b'suċċess.
  • 201 Maħluq – Talba mimlija; riżors ġdid maħluqa.
  • 202 Aċċettata – Talba aċċettata, iżda l-ipproċessar mhux komplut.
  • 204 Ebda Kontenut – Server ipproċessat b'suċċess talba; l-ebda kontenut mhu qed jiġi rritornat.
• 4xx – Kodiċi ta’ erba’ mitt serje jindika żball min-naħa tal-klijent, inkluż:
  • 400 Talba Ħażina – Parametri ta' mistoqsija invalidi, inklużi parametri mhux rikonoxxuti, parametri neqsin, jew valuri invalidi.
  • 404 Mhux misjuba – Il-provvediment URL ma taqbilx ma' riżors eżistenti. Per example, HTTP DELETE jista' jfalli minħabba li r-riżorsa mhix disponibbli.
  • 405 Metodu mhux Permess – Ġiet ippreżentata talba HTTP li mhix permessa fuq ir-riżors; per example, POST fuq riżors li jinqara biss.
• 5xx – Kodiċi ta' ħames mitt serje jindika żball min-naħa tas-server.

Fil-każ ta' żball, minbarra l-kodiċi ta' żball, ir-rispons tar-ritorn jista' jinkludi oġġett ta' żball li jkun fih aktar dettalji dwar l-iżball. L-iskema tar-rispons għall-iżball/twissija JSON hija kif ġej:

fejn il-proprjetajiet tal-oġġett huma:

Proprjetà	Tip	Deskrizzjoni
messaġġi	Lista ta' Dizzjunarji	Lista ta' messaġġi ta' żball jew ta' twissija
kodiċi	Spag	Żball / Twissija / Kodiċi ta 'Informazzjoni
dettalji	Spag	Messaġġ dettaljat li jikkorrispondi għal Żball/Twissija/Informazzjoni

Nota: Bidliet fil-konfigurazzjoni ASA magħmula mis-sejħiet API REST mhumiex persistenti fil-konfigurazzjoni tal-istartjar; jiġifieri, il-bidliet huma assenjati biss għall-konfigurazzjoni li taħdem. Biex tissejvja l-bidliet fil-konfigurazzjoni tal-istartjar, tista 'POSTA talba writemem API; għal aktar informazzjoni, segwi l-entrata “Write Memory API” fil-Wriwer Dwar l-ASA REST API.

Installa u Ikkonfigura l-Aġent u l-Klijent tal-API ASA REST

• L-Aġent tal-API REST huwa ppubblikat individwalment b'immaġini oħra tal-ASA fuq cisco.com. Għal ASA fiżiċi, il-pakkett REST API għandu jitniżżel fuq il-flash tal-apparat u jiġi installat bl-użu tal-kmand "rest-api image". L-Aġent tal-API REST imbagħad jiġi attivat bl-użu tal-kmand "aġent tal-mistrieħ-api".
• B'ASA virtwali (ASAv), l-immaġni REST API trid titniżżel fil-partizzjoni "boot:". Imbagħad trid toħroġ il-kmand "rest-api image", segwit mill-kmand "rest-api agent", biex taċċessa u tippermetti l-REST API Agent.
• Għal informazzjoni dwar ir-rekwiżiti u l-kompatibbiltà tas-softwer u l-hardware REST API, ara l-matriċi tal-Kompatibbiltà Cisco ASA.
• Tista' tniżżel il-pakkett tal-API REST xieraq għall-ASA jew ASAv tiegħek minn software.cisco.com/download/home. Sib il-mudell speċifiku ta' Adaptive Security Appliances (ASA) u mbagħad agħżel Adaptive Security Appliance REST API Plugin.

Nota: L-Aġent tal-API REST huwa applikazzjoni bbażata fuq Java. Il-Java Runtime Environment (JRE) huwa miġbur fil-pakkett REST API Agent.

Linji Gwida għall-Użu

Importanti Int trid tinkludi l-header Utent-Agent: REST API Agent fis-sejħiet kollha tal-API u l-iskripts eżistenti. Uża -H 'User-Agent: REST API Agent' għas-CURL kmand. Fil-modalità multi-kuntest, il-kmandi tal-Aġent tal-API REST huma disponibbli biss fil-kuntest tas-Sistema.

Daqs Massimu ta' Konfigurazzjoni Appoġġjata

L-ASA Rest API hija applikazzjoni "abbord" li taħdem ġewwa l-ASA fiżika, u bħala tali għandha limitazzjoni fuq il-memorja allokata lilha. Id-daqs massimu tal-konfigurazzjoni tat-tħaddim appoġġjat żdied matul iċ-ċiklu ta' rilaxx għal madwar 2 MB fuq pjattaformi reċenti bħall-5555 u 5585. L-API ta' Rest ASA għandha wkoll restrizzjonijiet ta' memorja fuq il-pjattaformi ASA virtwali. Il-memorja totali fuq l-ASAv5 tista 'tkun ta' 1.5 GB, filwaqt li fuq l-ASAv10 hija ta '2 GB. Il-limiti tal-API tal-bqija huma 450 KB u 500 KB għall-ASAv5 u ASAv10, rispettivament.

Għalhekk, kun konxju li konfigurazzjonijiet kbar li jaħdmu jistgħu jipproduċu eċċezzjonijiet f'diversi sitwazzjonijiet intensivi fil-memorja bħal numru kbir ta 'talbiet konkorrenti, jew volumi kbar ta' talbiet. F'dawn is-sitwazzjonijiet, is-sejħiet ta' Rest API GET/PUT/POST jistgħu jibdew ifallu b'500 - Intern Server Error Messages, u l-Aġent ta' Rest API jerġa' jibda awtomatikament kull darba. Is-soluzzjonijiet għal din is-sitwazzjoni huma jew jimxu għal pjattaformi ASA/FPR jew ASAV b'memorja ogħla, jew inaqqsu d-daqs tal-konfigurazzjoni li taħdem.

Niżżel u Installa l-aġent API REST

Billi tuża l-CLI, segwi dawn il-passi biex tniżżel u tinstalla l-aġent ASA REST API fuq ASA speċifiku:

• Pass 1: Fuq l-ASA mixtieqa, ħarġet il-kopja disk0: kmand biex tniżżel il-pakkett attwali ASA REST API minn cisco.com għall-memorja flash tal-ASA.
  • Per example: kopja tftp://10.7.0.80/asa-restapi-111-lfbff-k8.SPA disk0:
• Pass 2: Ħruġ id-disk0 tal-immaġni tal-bqija-api:/ kmand biex tivverifika u tinstalla l-pakkett.
  • Per example: rest-api image disk0:/asa-restapi-111-lfbff-k8.SPA

L-installatur se jwettaq kontrolli ta 'kompatibilità u validazzjoni, u mbagħad jinstalla l-pakkett. L-ASA mhux se reboot.

Ippermetti l-aġent API REST

Segwi dawn il-passi biex tippermetti l-Aġent tal-API REST ASA fuq ASA speċifiku:

• Pass 1: Kun żgur li l-immaġni tas-softwer korretta hija installata fuq l-ASA.
  • Ikkonsulta t-taqsima tal-API REST tal-Matriċi ta' Kompatibbiltà ASA (https://www.cisco.com/c/en/us/td/docs/security/asa/compatibility/asamatrx.html#pgfId-131643) biex jiddetermina liema immaġni ASA hija meħtieġa.
• Pass 2: Bl-użu tas-CLI, kun żgur li s-server HTTP huwa attivat fuq l-ASA, u li l-klijenti tal-API jistgħu jikkonnettjaw mal-interface tal-ġestjoni.
  • Per example: http server enable
  • http 0.0.0.0 0.0.0.0
• Pass 3: Bl-użu tas-CLI, iddefinixxi l-awtentikazzjoni HTTP għall-konnessjonijiet tal-API. Per example: aaa awtentikazzjoni http console LOKALI
• Pass 4: Bl-użu tal-CLI, oħloq rotta statika fuq l-ASA għat-traffiku tal-API. Per example: rotta 0.0.0.0 0.0.0.0 1
• Pass 5: Billi tuża l-CLI, ppermetti l-Aġent tal-API REST ASA fuq l-ASA. Per example: rest-api agent

Awtentikazzjoni API REST

Hemm żewġ modi kif tivverifika: Awtentikazzjoni HTTP Bażika, li tgħaddi isem tal-utent u password f'kull talba, jew awtentikazzjoni bbażata fuq Tokens bi trasport HTTPS sigur, li jgħaddi token maħluq qabel ma' kull talba. Jew il-mod, l-awtentikazzjoni ssir għal kull talba. Ara t-taqsima, "Token_Authentication_API" fil-gwida Dwar l-ASA REST API v7.14(x) għal informazzjoni addizzjonali dwar l-awtentikazzjoni bbażata fuq Token.

Nota: L-użu ta' ċertifikati maħruġa mill-Awtorità taċ-Ċertifikati (CA) huwa rakkomandat fuq ASA, għalhekk il-klijenti REST API jistgħu jivvalidaw iċ-ċertifikati tas-server ASA meta jistabbilixxu konnessjonijiet SSL.

Awtorizzazzjoni tal-Kmand

Jekk l-awtorizzazzjoni tal-kmand hija kkonfigurata biex tuża server AAA estern (eżample, aaa kmand tal-awtorizzazzjoni ), allura utent bl-isem enable_1 irid jeżisti fuq dak is-server bi privileġġi ta' kmand sħaħ. Jekk l-awtorizzazzjoni tal-kmand hija kkonfigurata biex tuża d-database LOKALI tal-ASA (kmand tal-awtorizzazzjoni LOKALI aaa), allura l-utenti kollha tal-API REST għandhom ikunu rreġistrati fid-database LOKALI b'livelli ta' privileġġ li huma xierqa għar-rwoli tagħhom:

• Livell ta' privileġġ 3 jew akbar huwa meħtieġ biex jinvokaw talbiet ta' monitoraġġ.
• Il-livell ta' privileġġ 5 jew akbar huwa meħtieġ għall-invokazzjoni ta' talbiet GET.
• Il-livell ta' privileġġ 15 huwa meħtieġ għall-invokazzjoni ta' operazzjonijiet PUT/POST/DELETE.

Ikkonfigura l-Klijent Tiegħek tal-API REST

Segwi dawn il-passi biex tinstalla u tikkonfigura klijent REST API fuq il-browser tal-host lokali tiegħek:

• Pass 1: Akkwista u installa klijent REST API għall-browser tiegħek.
  • Għal Chrome, installa l-klijent REST minn Google. Għal Firefox, installa l-add-on RESTClient. Internet Explorer mhuwiex appoġġjat.
• Pass 2: Ibda t-talba li ġejja billi tuża l-browser tiegħek: https: /api/objects/networkobjects
  • Jekk tirċievi tweġiba mingħajr żball, int ilħaqt mal-aġent tal-API REST li jaħdem fuq l-ASA.
  • Jekk qed ikollok problemi bit-talba tal-aġent, tista 'tippermetti l-wiri ta' informazzjoni ta 'debugging fuq il-console CLI, kif deskritt f'Attivazzjoni ta' Debugging REST API fuq l-ASA.
• Pass 3: B'għażla, tista' tittestja l-konnessjoni tiegħek mal-ASA billi twettaq operazzjoni POST.

Per example: Ipprovdi kredenzjali bażiċi ta' awtorizzazzjoni ( ), jew token ta' awtentikazzjoni (ara l-Awtentikazzjoni tat-Token għal informazzjoni addizzjonali).

• Indirizz tat-talba fil-mira: https://<asa management ipaddress>/api/objects/networkobjects
• Tip ta' kontenut tal-ġisem: applikazzjoni/json

Korp mhux maħdum tal-operazzjoni:

Issa tista 'tuża l-API REST ASA biex tikkonfigura u timmonitorja l-ASA. Irreferi d-dokumentazzjoni tal-API għal deskrizzjonijiet tas-sejħiet u examples.

Dwar ir-Restawr sħiħ ta' Konfigurazzjoni ta' Back-up

Ir-restawr ta' konfigurazzjoni ta' back-up sħiħa fuq l-ASA bl-użu tal-API REST jerġa' jtella' l-ASA. Biex tevita dan, uża l-kmand li ġej biex tirrestawra konfigurazzjoni ta 'back-up:

• {
  • "kmandi":["kopja /noconfirm disk0:/fileisem> running-config”]
• }
  • Fejnfileisem> huwa backup.cfg jew kwalunkwe isem li użajt meta tagħmel backup tal-konfigurazzjoni.

Il-Konsola tad-Dokumentazzjoni u l-Iskripts tal-API li jesportaw

Tista 'wkoll tuża l-console ta' dokumentazzjoni online tal-API REST (imsejħa "Doc UI"), disponibbli fuq host:port/doc/ bħala "sandbox" biex titgħallem u tipprova s-sejħiet API direttament fuq l-ASA. Barra minn hekk, tista 'tuża l-buttuna Operazzjoni ta' Esportazzjoni fid-Dok UI biex issalva l-metodu muri example bħala skript JavaScript, Python, jew Perl file lill-ospitant lokali tiegħek. Tista' mbagħad tapplika dan l-iskript għall-ASA tiegħek, u teditjah għall-applikazzjoni fuq ASAs oħra u tagħmir tan-netwerk ieħor. Dan fisser primarjament bħala għodda edukattiva u ta 'bootstrapping.

JavaScript

• Bl-użu ta' JavaScript file teħtieġ l-installazzjoni ta 'node.js, li tista' tinstab fuq http://nodejs.org/.
• Billi tuża node.js, tista' tesegwixxi JavaScript file, tipikament miktuba għal browser, bħal skript tal-linja tal-kmand. Sempliċement segwi l-istruzzjonijiet tal-installazzjoni, u mbagħad mexxi l-iskript tiegħek bin-node script.js.

Python

• L-iskripts Python jeħtieġu li tinstalla Python, disponibbli minn https://www.python.org/.
• Ladarba tkun installat Python, tista' tmexxi l-iskrittura tiegħek bil-password tal-username script.py ta' python.

Perl

L-użu tal-iskripts Perl jeħtieġ xi twaqqif addizzjonali—jeħtieġ ħames komponenti: Perl innifsu, u erba' libreriji Perl:

• Pakkett Perl, misjub fi http://www.perl.org/
• Pakkett::CPAN, misjub fuq http://search.cpan.org/~andk/Bundle-CPAN-1.861/CPAN.pm
• MISSERIE::Klijent, misjub fi http://search.cpan.org/~mcrawfor/REST-Client-88/lib/REST/Client.pm
• MIME::Base64, misjuba fi http://perldoc.perl.org/MIME/Base64.html
• JSON, misjub fi http://search.cpan.org/~makamaka/JSON-2.90/lib/JSON.pm

Hawn example ta 'bootstrapping Perl fuq Macintosh:

• $ sudo perl -MCPAN e shell
• cpan> installa Bundle::CPAN
• cpan> installa REST:: Klijent
• cpan> installa MIME::Bażi64
• cpan> installa JSON

Wara li tinstalla d-dipendenzi, tista' tmexxi l-iskrittura tiegħek billi tuża l-password tal-username perl script.pl.

Jippermettu Debugging REST API fuq l-ASA

Jekk qed ikollok problemi biex tikkonfigura jew tikkonnettja mal-REST API fuq l-ASA, tista 'tuża l-kmand CLI li ġej biex tippermetti l-wiri ta' messaġġi ta 'debugging fuq il-console tiegħek. Uża l-ebda forma tal-kmand biex tiddiżattiva l-messaġġi tad-debug.
debug rest-api [aġent | cli | klijent | daemon | proċess | token-auth] [żball | avveniment] no debug rest-api

Deskrizzjoni tas-Sintassi

• aġent: (Mhux obbligatorju) Ippermetti l-informazzjoni tad-debugging tal-Aġent tal-API REST.
• cli: (Mhux obbligatorju) Ippermetti messaġġi ta' debugging għal komunikazzjonijiet minn Daemon-to-Agent ta' REST API CLI.
• klijent: (Mhux obbligatorju) Ippermetti l-informazzjoni tad-debugging għar-routing tal-Messaġġ bejn il-Klijent tal-API REST u l-Aġent tal-API REST.
• daemon: (Mhux obbligatorju) Ippermetti messaġġi ta' debugging għal komunikazzjonijiet minn Daemon-to-Agent tal-API REST.
• proċess: (Mhux obbligatorju) Ippermetti l-proċess tal-Aġent tal-API REST li tibda/twaqqaf l-informazzjoni tad-debugging.
• token-auth: (Mhux obbligatorju) Informazzjoni ta' debugging ta' awtentikazzjoni ta' token REST API.
• żball: (Mhux obbligatorju) Uża din il-kelma prinċipali biex tillimita l-messaġġi tad-debug għal żbalji illoggjati biss mill-API.
• avveniment: (Mhux obbligatorju) Uża din il-kelma prinċipali biex tillimita l-messaġġi tad-debug għal avvenimenti illoggjati biss mill-API.

Linji Gwida għall-Użu

Jekk ma tipprovdix keyword ta' komponent speċifiku (jiġifieri, jekk sempliċement toħroġ il-kmand debug rest-api), il-messaġġi tad-debug jintwerew għat-tipi kollha ta 'komponenti. Jekk ma tipprovdix la l-kelma prinċipali tal-avveniment jew tal-iżball, kemm il-messaġġi tal-avveniment kif ukoll tal-iżball jintwerew għall-komponent speċifikat. Per example, debug rest-api daemon event se juri biss messaġġi ta' debug tal-avveniment għall-komunikazzjonijiet API Daemon-to-Agent.

Kmandi Relatati

Kmand/Deskrizzjoni

• tiddibaggja HTTP; Uża dan il-kmand biex view informazzjoni dettaljata dwar it-traffiku HTTP.

ASA REST Messaġġi Syslog relatati mal-API

Il-messaġġi tal-log tas-sistema relatati mal-API ASA REST huma deskritti f'din it-taqsima.

342001

• Messaġġ ta' Żball: %ASA-7-342001: REST API Agent beda b'suċċess.
  • Spjegazzjoni: L-Aġent tal-API REST għandu jinbeda b'suċċess qabel Klijent tal-API REST ikun jista' jikkonfigura l-ASA.
  • Azzjoni Rakkomandata: Xejn.

342002

• Messaġġ ta' Żball: %ASA-3-342002: REST API Agent falla, raġuni: raġuni
  • Spjegazzjoni: L-aġent tal-API REST jista 'jonqos milli jibda jew jikkraxxja għal diversi raġunijiet, u r-raġuni hija speċifikata.
  • raġuni—Il-kawża għall-falliment tal-API REST

Azzjoni Rakkomandata: L-azzjonijiet meħuda biex tissolva l-kwistjoni jvarjaw skont ir-raġuni illoggjata. Per example, l-aġent tal-API REST jiġġarraf meta l-proċess Java jispiċċa mingħajr memorja. Jekk iseħħ dan, għandek bżonn terġa 'tibda l-aġent REST API. Jekk il-bidu mill-ġdid ma jirnexxix, ikkuntattja liċ-Cisco TAC biex tidentifika l-soluzzjoni tal-kawża ewlenija.

342003

• Messaġġ ta' Żball: %ASA-3-342003: Riċevuta notifika ta' nuqqas ta' aġent API REST. L-aġent se jerġa' jibda awtomatikament.
  • Spjegazzjoni: Ġiet riċevuta notifika ta' falliment mill-Aġent tal-API REST u qed jiġi ppruvat bidu mill-ġdid tal-Aġent.
  • Azzjoni Rakkomandata: Xejn.

342004

• Messaġġ ta' Żball: %ASA-3-342004: Naqas milli jerġa' jibda awtomatikament l-Aġent tal-API REST wara 5 tentattivi mingħajr suċċess. Uża l-kmandi ta ''no rest-api agent' u 'rest-api agent' biex terġa' tibda l-Aġent manwalment.
  • Spjegazzjoni: L-Aġent tal-API REST naqas milli jibda wara ħafna tentattivi.
  • Azzjoni Rakkomandata: Ara syslog %ASA-3-342002 (jekk illoggjat) biex tifhem aħjar ir-raġuni wara l-falliment. Ipprova tiddiżattiva l-Aġent tal-API REST billi ddaħħal il-kmand tal-aġent no rest-api u erġa' ppermetti l-Aġent tal-API REST billi tuża l-kmand tal-aġent tal-mistrieħ tal-api.

Dokumentazzjoni Relatata

Uża l-link li ġejja biex issib aktar informazzjoni dwar l-ASA, u l-konfigurazzjoni u l-ġestjoni tagħha:

• Navigazzjoni fid-Dokumentazzjoni tas-Serje Cisco ASA: http://www.cisco.com/go/asadocs
• Uża l-link li ġejja biex view lista ta' karatteristiċi ASA mhux appoġġjati fuq l-ASAV: http://www.cisco.com/c/en/us/td/docs/security/asa/asa92/configuration/general/asa-general-cli/introasav.html#pgfId-1156883

Dan id-dokument għandu jintuża flimkien mad-dokumenti disponibbli mit-taqsima “Dokumentazzjoni Relatata”.
Cisco u l-logo ta' Cisco huma trademarks jew trademarks reġistrati ta' Cisco u/jew l-affiljati tagħha fl-Istati Uniti u f'pajjiżi oħra. Biex view lista ta 'trademarks Cisco, mur din URL: www.cisco.com/go/trademarks. Trademarks ta’ partijiet terzi msemmija huma l-proprjetà tas-sidien rispettivi tagħhom. L-użu tal-kelma sieħeb ma jimplikax relazzjoni ta' sħubija bejn Cisco u kwalunkwe kumpanija oħra. (1721R)
Kwalunkwe indirizzi u numri tat-telefon tal-Protokoll tal-Internet (IP) użati f'dan id-dokument mhumiex maħsuba biex ikunu indirizzi u numri tat-telefon attwali. Kwalunkwe examples, output tal-wiri tal-kmand, dijagrammi tat-topoloġija tan-netwerk, u figuri oħra inklużi fid-dokument huma murija għal skopijiet illustrattivi biss.
Kwalunkwe użu ta 'indirizzi IP attwali jew numri tat-telefon f'kontenut illustrattiv huwa mhux intenzjonat u koinċidenza.

Cisco Systems, Inc.

• www.cisco.com

© 2014-2018 Cisco Systems, Inc. Id-drittijiet kollha riżervati.

Dokumenti / Riżorsi

CISCO ASA REST API App [pdfGwida għall-Utent ASA REST API App, ASA, REST API App, API App, App

Referenzi

• Manwal għall-Utent