CISCO ASA isinmi API App olumulo Itọsọna

Awọn akoonu tọju

1 CISCO ASA isinmi API App

2 Ọja Lilo Awọn ilana

3 Pariview

4 ASA REST API Awọn ibeere ati awọn idahun

5 Fi sori ẹrọ ati Tunto Aṣoju API REST ASA ati Onibara

6 Console Iwe-ipamọ ati Awọn iwe afọwọkọ API Titajasita

7 Ṣiṣe atunṣe REST API lori ASA

8 Awọn ifiranṣẹ Syslog ti o ni ibatan ASA REST API

9 Iwe ti o jọmọ

10 Awọn iwe aṣẹ / Awọn orisun

10.1 Awọn itọkasi

CISCO ASA isinmi API App

Ọja Lilo Awọn ilana

Pariview

Pẹlu itusilẹ ti Sisiko's ASA REST API, o ni iwuwo ina miiran, aṣayan rọrun-si-lilo fun atunto ati iṣakoso Sisiko ASA kọọkan. ASA REST API jẹ wiwo siseto ohun elo (API) ti o da lori awọn ipilẹ RESTful. O le ṣe igbasilẹ ni kiakia ati mu ṣiṣẹ lori eyikeyi ASA nibiti API nṣiṣẹ. Cisco Systems, Inc.

www.cisco.com

ASA REST API Awọn ibeere ati awọn idahun

Lẹhin fifi sori ẹrọ alabara REST kan ninu ẹrọ aṣawakiri rẹ, o le kan si aṣoju ASA REST kan pato ki o lo awọn ọna HTTP boṣewa lati wọle si alaye atunto lọwọlọwọ ati fun awọn aye atunto ni afikun.

Iṣọra: Nigbati API REST ti ṣiṣẹ lori ASA, awọn asopọ nipasẹ awọn ilana iṣakoso aabo miiran ko ni dina. Eyi tumọ si awọn miiran ti nlo CLI, ASDM, tabi Oluṣakoso Aabo le ṣe iyipada iṣeto ASA lakoko ti o n ṣe kanna.

Bere Ilana

API REST ASA n fun ọ ni iraye si eto lati ṣakoso awọn ASA kọọkan nipasẹ Gbigbe Ipinle Aṣoju (REST) API. API ngbanilaaye awọn alabara ita lati ṣe awọn iṣẹ CRUD (Ṣẹda, Ka, Imudojuiwọn, Parẹ) lori awọn orisun ASA. Gbogbo awọn ibeere API ni a firanṣẹ lori HTTPS si ASA, ati pe esi kan ti pada.

nibiti awọn ohun-ini nkan wa:

Ohun ini	Iru	Apejuwe
awọn ifiranṣẹ	Akojọ ti awọn Dictionaries	Akojọ aṣiṣe tabi awọn ifiranṣẹ ikilọ
koodu	Okun	Ifiranṣẹ alaye ti o baamu Aṣiṣe/Ikilọ/Alaye
awọn alaye	Okun	Ifiranṣẹ alaye ti o baamu Aṣiṣe/Ikilọ/Alaye

Akiyesi: Awọn iyipada ti a ṣe nipasẹ awọn ipe API REST ko duro si iṣeto ibẹrẹ ṣugbọn o jẹ sọtọ si iṣeto ṣiṣiṣẹ nikan. Lati fi awọn ayipada pamọ si iṣeto ibẹrẹ, o le lo POST a Kọ mem API ìbéèrè. Fun alaye diẹ sii, tọka si Akọsilẹ Kọ Iranti API titẹsi inu akoonu Nipa ASA REST API tabili awọn akoonu.

Fi sori ẹrọ ati Tunto Aṣoju API REST ASA ati Onibara

Akiyesi: Aṣoju API REST jẹ ohun elo orisun Java kan. Ayika asiko asiko Java (JRE) ti wa ni idapọ ninu apo Aṣoju API REST.

Pariview

Awọn aṣayan pupọ wa fun atunto ati ṣiṣakoso Sisiko ASA kọọkan:

Ni wiwo Laini Laini (CLI) - o firanṣẹ awọn aṣẹ iṣakoso taara si ASA nipasẹ console ti o sopọ.

Oluṣakoso Ẹrọ Aabo Adaptive (ASDM) – ohun elo iṣakoso “lori-apoti” pẹlu wiwo olumulo ayaworan ti o le lo lati tunto, ṣakoso ati ṣetọju ASA kan.
Oluṣakoso Aabo Sisiko – lakoko ti a pinnu fun alabọde si awọn nẹtiwọọki nla ti ọpọlọpọ awọn ẹrọ aabo, ohun elo ayaworan yii le ṣee lo lati tunto, ṣakoso ati ṣetọju awọn ASA kọọkan.

Pẹlu itusilẹ Sisiko's ASA REST API, o ni iwuwo fẹẹrẹ miiran, aṣayan rọrun-lati-lo. Eyi jẹ wiwo siseto ohun elo (API), ti o da lori awọn ipilẹ “RESTful”, eyiti o le ṣe igbasilẹ ni iyara ati mu ṣiṣẹ lori eyikeyi ASA eyiti API nṣiṣẹ.

Lẹhin fifi sori ẹrọ alabara REST kan ninu ẹrọ aṣawakiri rẹ, o le kan si aṣoju ASA REST kan pato ki o lo awọn ọna HTTP boṣewa lati wọle si alaye atunto lọwọlọwọ, ki o si fun awọn aye iṣeto ni afikun.

ASA REST API Awọn ibeere ati awọn idahun

ASA REST API n fun ọ ni iraye si eto lati ṣakoso awọn ASA kọọkan nipasẹ API Gbigbe Ipinle Aṣoju (REST). API ngbanilaaye awọn alabara ita lati ṣe awọn iṣẹ CRUD (Ṣẹda, Ka, Imudojuiwọn, Parẹ) lori awọn orisun ASA; o da lori ilana HTTPS ati ilana REST. Gbogbo awọn ibeere API ni a firanṣẹ lori HTTPS si ASA, ati pe esi kan ti pada. Yi apakan pese ohun loriview bawo ni a ṣe ṣeto awọn ibeere, ati awọn idahun ti a nireti,

Bere Ilana

Awọn ọna ibeere ti o wa ni:

GET – Gba data pada lati nkan ti a sọ.
PUT - Ṣe afikun alaye ti a pese si nkan ti a ti sọ; pada a 404 Resource Ko ri aṣiṣe ti o ba ti awọn ohun ko ni tẹlẹ.

POST – Ṣẹda nkan naa pẹlu alaye ti a pese.
Paarẹ – Npa ohun ti a ti sọtọ kuro.

PATCH – Waye awọn iyipada apa kan si nkan ti a sọ.

Ilana Idahun

Ibeere kọọkan ṣe agbejade esi HTTPS lati ASA pẹlu awọn akọsori boṣewa, akoonu idahun, ati koodu ipo.

Ilana idahun le jẹ:

LOCATION – Tuntun da awọn oluşewadi ID; fun POST nikan — di ID orisun orisun tuntun (gẹgẹbi aṣoju URI).
Akoonu-ORISI - Iru media ti n ṣe apejuwe ara ifiranṣẹ esi; ṣe apejuwe aṣoju ati sintasi ti ara ifiranṣẹ idahun.

Idahun kọọkan pẹlu ipo HTTP tabi koodu aṣiṣe. Awọn koodu to wa ṣubu sinu awọn ẹka wọnyi:

20x - Awọn koodu jara ọgọọgọrun meji tọka iṣẹ ṣiṣe aṣeyọri, pẹlu:
- 200 O dara – Idahun boṣewa fun awọn ibeere aṣeyọri.
- 201 Ṣẹda - Ibere ti pari; titun awọn oluşewadi da.
- 202 Ti gba - Ibere gba, ṣugbọn sisẹ ko pari.
- 204 Ko si akoonu – Olupin ti ni ilọsiwaju ibeere; ko si akoonu ti wa ni pada.
4xx - Awọn koodu lẹsẹsẹ mẹrin-mẹrin tọkasi aṣiṣe ẹgbẹ-ẹgbẹ kan, pẹlu:
- 400 Ibeere Buburu – Awọn igbelewọn ibeere ti ko tọ, pẹlu awọn paramita ti a ko mọ, awọn aye ti o padanu, tabi awọn iye aiṣedeede.
- 404 Ko ri – The pese URL ko baramu awọn oluşewadi ti o wa tẹlẹ. Fun example, HTTP DELETE le kuna nitori awọn oluşewadi ko si.
- Ọna 405 ko gba laaye – A ṣe agbekalẹ ibeere HTTP ti ko gba laaye lori orisun; fun example, POST kan lori orisun kika-nikan.
5xx – koodu lẹsẹsẹ marun-marun tọkasi aṣiṣe ẹgbẹ olupin kan.

Ninu ọran ti aṣiṣe, ni afikun si koodu aṣiṣe, idahun ipadabọ le pẹlu ohun aṣiṣe ti o ni awọn alaye diẹ sii nipa aṣiṣe naa. Aṣiṣe JSON/ero idahun ikilọ jẹ bi atẹle:

nibiti awọn ohun-ini nkan wa:

Ohun ini	Iru	Apejuwe
awọn ifiranṣẹ	Akojọ ti awọn Dictionaries	Akojọ aṣiṣe tabi awọn ifiranṣẹ ikilọ
koodu	Okun	Aṣiṣe/Ikilọ/koodu Alaye
awọn alaye	Okun	Ifiranṣẹ alaye ti o baamu Aṣiṣe/Ikilọ/Alaye

Akiyesi: Awọn iyipada si iṣeto ASA ti awọn ipe REST API ṣe ko duro si iṣeto ibẹrẹ; ti o ni, awọn ayipada ti wa ni sọtọ nikan lati nṣiṣẹ iṣeto ni. Lati ṣafipamọ awọn ayipada si iṣeto ibẹrẹ, o le POST ibeere API writemem kan; fun alaye diẹ sii, tẹle titẹ sii “Kọ Iranti API” ni inu tabili akoonu Nipa ASA REST API.

Fi sori ẹrọ ati Tunto Aṣoju API REST ASA ati Onibara

Aṣoju API REST jẹ atẹjade ni ẹyọkan pẹlu awọn aworan ASA miiran lori Cisco.com. Fun awọn ASA ti ara, package REST API gbọdọ ṣe igbasilẹ si filasi ẹrọ naa ki o fi sii nipa lilo aṣẹ “aworan rest-api”. Aṣoju API REST lẹhinna ṣiṣẹ ni lilo aṣẹ “aṣoju-api isinmi”.
Pẹlu ASA foju kan (ASAv), aworan REST API gbọdọ ṣe igbasilẹ si apakan “bata:”. Lẹhinna o gbọdọ fun aṣẹ “aworan rest-api”, atẹle nipa aṣẹ “aṣoju-api isinmi”, lati wọle ati mu Aṣoju API REST ṣiṣẹ.
Fun alaye nipa sọfitiwia API REST ati awọn ibeere ohun elo ati ibaramu, wo matrix ibaramu Cisco ASA.

O le ṣe igbasilẹ package API REST ti o yẹ fun ASA tabi ASAv lati software.cisco.com/download/home. Wa awoṣe Awọn Ohun elo Aabo Adaptive (ASA) kan pato lẹhinna yan Ohun elo Aabo Adaptive Aabo REST API Plugin.

Akiyesi: Aṣoju API REST jẹ ohun elo orisun Java kan. Ayika asiko asiko Java (JRE) ti wa ni idapọ ninu apo Aṣoju API REST.

Awọn Itọsọna Lilo

Pataki O gbọdọ ni akọsori Olumulo-Aṣoju: Aṣoju API REST ninu gbogbo awọn ipe API ati awọn iwe afọwọkọ to wa tẹlẹ. Lo -H 'Aṣoju-olumulo: Aṣoju API REST' fun CURL pipaṣẹ. Ni ipo ọrọ-ọpọlọpọ, awọn pipaṣẹ Aṣoju API REST wa nikan ni ipo eto.

Iwọn Iṣeto ni atilẹyin ti o pọju

API Isinmi ASA jẹ ohun elo “lori-ọkọ” ti n ṣiṣẹ inu ASA ti ara, ati pe iru bẹ ni opin lori iranti ti a pin si. Iwọn iṣeto ni atilẹyin ti o pọju ti pọ si lori ọna itusilẹ si isunmọ 2 MB lori awọn iru ẹrọ aipẹ bii 5555 ati 5585. ASA Rest API tun ni awọn idiwọ iranti lori awọn iru ẹrọ ASA foju. Lapapọ iranti lori ASAv5 le jẹ 1.5 GB, lakoko ti o wa lori ASAv10 o jẹ 2 GB. Awọn opin API isinmi jẹ 450 KB ati 500 KB fun ASAv5 ati ASAv10, lẹsẹsẹ.

Nitorinaa, ṣe akiyesi pe awọn atunto ṣiṣiṣẹ nla le gbejade awọn imukuro ni ọpọlọpọ awọn ipo aladanla iranti gẹgẹbi nọmba nla ti awọn ibeere nigbakan, tabi awọn iwọn ibeere nla. Ni awọn ipo wọnyi, Awọn ipe API GET/PUT/POST isinmi le bẹrẹ si kuna pẹlu 500 – Awọn ifiranṣẹ aṣiṣe olupin inu, ati Aṣoju API Isinmi yoo tun bẹrẹ laifọwọyi ni igba kọọkan. Awọn iṣẹ-ṣiṣe si ipo yii jẹ boya gbe si iranti ASA / FPR ti o ga julọ tabi awọn iru ẹrọ ASAV, tabi dinku iwọn iṣeto ti nṣiṣẹ.

Ṣe igbasilẹ ati Fi Aṣoju API REST sori ẹrọ

Lilo CLI, tẹle awọn igbesẹ wọnyi lati ṣe igbasilẹ ati fi sori ẹrọ aṣoju ASA REST API lori ASA kan pato:

Igbesẹ 1: Lori ASA ti o fẹ, gbe ẹda naa jade disk0: pipaṣẹ lati ṣe igbasilẹ package ASA REST API lọwọlọwọ lati Cisco.com si iranti filasi ASA.
- Fun example: daakọ tftp://10.7.0.80/asa-restapi-111-lfbff-k8.SPA disk0:
Igbesẹ 2: Jade disk-api aworan isinmi0:/ aṣẹ lati mọ daju ati fi sori ẹrọ ni package.
- Fun example: rest-api image disk0:/asa-restapi-111-lfbff-k8.SPA

Insitola yoo ṣe ibamu ati awọn sọwedowo afọwọsi, ati lẹhinna fi package sii. ASA kii yoo tun bẹrẹ.

Mu Aṣoju API REST ṣiṣẹ

Tẹle awọn igbesẹ wọnyi lati mu Aṣoju API REST ASA ṣiṣẹ lori ASA kan pato:

Igbesẹ 1: Rii daju pe aworan sọfitiwia ti o tọ ti fi sori ẹrọ lori ASA.
- Kan si apakan REST API ti ASA Ibamu Matrix (https://www.cisco.com/c/en/us/td/docs/security/asa/compatibility/asamatrx.html#pgfId-131643) lati pinnu iru aworan ASA ti o nilo.

Igbesẹ 2: Lilo CLI, rii daju pe olupin HTTP ti ṣiṣẹ lori ASA, ati pe awọn alabara API le sopọ si wiwo iṣakoso.
- Fun example: http olupin ṣiṣẹ
- http 0.0.0.0 0.0.0.0

Igbesẹ 3: Lilo CLI, ṣalaye ijẹrisi HTTP fun awọn asopọ API. Fun example: aaa ìfàṣẹsí http console LOCAL
Igbesẹ 4: Lilo CLI, ṣẹda ipa ọna aimi lori ASA fun ijabọ API. Fun example: ona 0.0.0.0 0.0.0.0 1
Igbesẹ 5: Lilo CLI, mu Aṣoju API REST ASA ṣiṣẹ lori ASA. Fun example: isinmi-api oluranlowo

REST API Ijeri

Awọn ọna meji lo wa lati jẹri: Ijeri HTTP ipilẹ, eyiti o kọja orukọ olumulo ati ọrọ igbaniwọle ni gbogbo ibeere, tabi ijẹrisi ti o da lori Token pẹlu gbigbe HTTPS to ni aabo, eyiti o kọja ami ami ti o ṣẹda tẹlẹ pẹlu ibeere kọọkan. Ọna boya, ìfàṣẹsí yoo ṣee ṣe fun gbogbo ìbéèrè. Wo apakan, "Token_Authentication_API" ni About ASA REST API v7.14(x) itọnisọna fun afikun alaye nipa Token-orisun ìfàṣẹsí.

Akiyesi: Lilo Alaṣẹ Iwe-ẹri (CA) -awọn iwe-ẹri ti o funni ni iṣeduro lori ASA, nitorinaa awọn alabara API REST le fọwọsi awọn iwe-ẹri olupin ASA nigbati o ba ṣeto awọn asopọ SSL.

Aṣẹ aṣẹ

Ti o ba tunto aṣẹ aṣẹ lati lo olupin AAA ita (fun example, aaa aṣẹ aṣẹ ), lẹhinna olumulo kan ti a npè ni agbara_1 gbọdọ wa lori olupin yẹn pẹlu awọn anfani aṣẹ ni kikun. Ti o ba tunto aṣẹ aṣẹ lati lo aaye data LOCAL ASA (aṣẹ aṣẹ aaa LOCAL), lẹhinna gbogbo awọn olumulo API REST gbọdọ wa ni iforukọsilẹ ni aaye data LOCAL pẹlu awọn ipele anfani ti o baamu fun awọn ipa wọn:

Ipele anfani 3 tabi ju bẹẹ lọ ni a nilo lati pe awọn ibeere ibojuwo.

Ipele anfani 5 tabi ju bẹẹ lọ ni a nilo fun pipe awọn ibeere GET.
Ipele anfani 15 jẹ pataki fun pipe PUT/POST/PA awọn iṣẹ ṣiṣe.

Ṣe atunto Onibara API REST rẹ

Tẹle awọn igbesẹ wọnyi lati fi sori ẹrọ ati tunto alabara REST API kan lori ẹrọ aṣawakiri agbalejo agbegbe rẹ:

Igbesẹ 1: Gba ki o si fi onibara REST API sori ẹrọ fun ẹrọ aṣawakiri rẹ.
- Fun Chrome, fi sori ẹrọ alabara REST lati Google. Fun Firefox, fi afikun RESTClient sori ẹrọ. Internet Explorer ko ni atilẹyin.

Igbesẹ 2: Bẹrẹ ibeere atẹle nipa lilo ẹrọ aṣawakiri rẹ: https: /api/ohun/networkobjects
- Ti o ba gba esi ti kii ṣe aṣiṣe, o ti de aṣoju REST API ti n ṣiṣẹ lori ASA.
- Ti o ba ni awọn ọran pẹlu ibeere aṣoju, o le mu ifihan alaye n ṣatunṣe aṣiṣe ṣiṣẹ lori console CLI, gẹgẹbi a ti ṣe apejuwe rẹ ni Muu ṣiṣẹ REST API N ṣatunṣe aṣiṣe lori ASA.

Igbesẹ 3: Ni yiyan, o le ṣe idanwo asopọ rẹ si ASA nipa ṣiṣe iṣẹ POST kan.

Fun example: Pese awọn iwe-ẹri ipilẹ aṣẹ ( ), tabi àmi ìfàṣẹsí (wo Ijeri Tokini fun alaye ni afikun).

Adirẹsi ibeere ibi-afẹde: https://<asa management ipaddress>/api/objects/networkobjects

Iru akoonu ti ara: ohun elo / json

Ara aise ti iṣẹ:

O le lo ASA REST API lati tunto ati atẹle ASA. Tọkasi awọn iwe API fun awọn apejuwe ipe ati examples.

Nipa mimu-pada sipo ni kikun Iṣeto ni Afẹyinti

Mimu-pada sipo iṣeto ni kikun lori ASA ni lilo API REST yoo tun gbe ASA naa. Lati yago fun eyi, lo aṣẹ atẹle lati mu atunto ifẹhinti pada:

{
- "awọn aṣẹ": ["daakọ /noconfirm disk0:/fileorukọ> nṣiṣẹ-konfigi”]
}
- Nibofileorukọ> jẹ backup.cfg tabi orukọ eyikeyi ti o lo nigbati o n ṣe afẹyinti iṣeto ni.

Console Iwe-ipamọ ati Awọn iwe afọwọkọ API Titajasita

O tun le lo REST API lori ori ayelujara iwe console (ti a tọka si bi “Doc UI”), ti o wa ni agbalejo: ibudo/doc/ bi “apoti iyanrin” fun kikọ ẹkọ nipa ati gbiyanju awọn ipe API taara lori ASA. Siwaju sii, o le lo bọtini Iṣiṣẹ Ijabọ okeere ni Doc UI lati ṣafipamọ ọna ti o han example bi JavaScript, Python, tabi iwe afọwọkọ Perl file si alejo agbegbe rẹ. Lẹhinna o le lo iwe afọwọkọ yii si ASA rẹ, ki o ṣatunkọ rẹ fun ohun elo lori awọn ASA miiran ati awọn ẹrọ nẹtiwọọki miiran. Eyi tumọ si nipataki bi eto ẹkọ ati ohun elo bootstrapping.

JavaScript

Lilo JavaScript kan file nbeere fifi sori ẹrọ ti node.js, eyi ti o le ri ni http://nodejs.org/.
Lilo node.js, o le ṣiṣẹ JavaScript kan file, ti a kọ ni igbagbogbo fun ẹrọ aṣawakiri kan, bii iwe afọwọkọ laini aṣẹ. Nìkan tẹle awọn ilana fifi sori ẹrọ, ati ki o si ṣiṣe rẹ akosile pẹlu node script.js.

Python

Awọn iwe afọwọkọ Python nilo ki o fi Python sori ẹrọ, ti o wa lati https://www.python.org/.
Ni kete ti o ba ti fi Python sori ẹrọ, o le ṣiṣẹ iwe afọwọkọ rẹ pẹlu ọrọ igbaniwọle script.py orukọ olumulo.

Perl

Lilo awọn iwe afọwọkọ Perl nilo diẹ ninu iṣeto ni afikun-o nilo awọn paati marun: Perl funrararẹ, ati awọn ile-ikawe Perl mẹrin:

Perl package, ri ni http://www.perl.org/
Lapapo::CPAN, ti a rii ni http://search.cpan.org/~andk/Bundle-CPAN-1.861/CPAN.pm

ISINMI::Onibara, ri ni http://search.cpan.org/~mcrawfor/REST-Client-88/lib/REST/Client.pm
MIME::Base64, ri ni http://perldoc.perl.org/MIME/Base64.html
JSON, ri ni http://search.cpan.org/~makamaka/JSON-2.90/lib/JSON.pm

Eyi jẹ ẹya Mofiample ti bootstrapping Perl lori Macintosh kan:

$ sudo perl -MCPAN e ikarahun
cpan> fi sori ẹrọ lapapo ::CPAN

cpan> fi sori ẹrọ REST :: Onibara
cpan> fi MIME sori ẹrọ::Ipilẹ64
cpan> fi JSON sori ẹrọ

Lẹhin fifi awọn igbẹkẹle sii, o le ṣiṣe iwe afọwọkọ rẹ nipa lilo ọrọ igbaniwọle orukọ olumulo perl script.pl.

Ṣiṣe atunṣe REST API lori ASA

Ti o ba ni awọn iṣoro atunto tabi sisopọ si API REST lori ASA, o le lo aṣẹ CLI atẹle lati mu ifihan awọn ifiranṣẹ n ṣatunṣe aṣiṣe ṣiṣẹ lori console rẹ. Lo fọọmu ti ko si aṣẹ lati mu awọn ifiranṣẹ yokokoro kuro.
yokokoro isinmi-api [oluranlowo | cli | onibara | daemon | ilana | token-auth] [aṣiṣe | iṣẹlẹ] ko si yokokoro rest-api

Apejuwe sintasi

aṣoju: (Eyi je ko je) Jeki REST API Aṣoju alaye n ṣatunṣe aṣiṣe.
cli: (Eyi je ko je) Mu awọn ifiranṣẹ yokokoro ṣiṣẹ fun REST API CLI Daemon-to-Agent awọn ibaraẹnisọrọ.
onibara: (Eyi je ko je) Jeki alaye n ṣatunṣe aṣiṣe fun ipa-ọna Ifiranṣẹ laarin Client API REST ati Aṣoju API REST.

daemon: (Eyi je ko je) Jeki awọn ifiranse n ṣatunṣe aṣiṣe fun REST API Daemon-si-Aṣoju awọn ibaraẹnisọrọ.
ilana: (Eyi je ko je) Jeki REST API Ilana ibere/da alaye n ṣatunṣe aṣiṣe ṣiṣẹ.
àmi-ifọwọsi: (Eyi je ko je) REST API ìfàṣẹsí àmi n ṣatunṣe aṣiṣe.

aṣiṣe: (Eyi je ko je) Lo yi koko lati se idinwo awọn ifiranṣẹ yokokoro si nikan asise wọle nipa API.
iṣẹlẹ: (Eyi je eyi ko je) Lo koko yii lati fi opin si awọn ifiranṣẹ yokokoro si awọn iṣẹlẹ nikan ti o wọle nipasẹ API.

Awọn Itọsọna Lilo

Ti o ko ba pese Koko paati kan pato (iyẹn ni, ti o ba funni ni aṣẹ yokokoro rest-api nikan), awọn ifiranṣẹ yokokoro yoo han fun gbogbo awọn oriṣi paati. Ti o ko ba pese boya iṣẹlẹ tabi koko-ọrọ aṣiṣe, iṣẹlẹ mejeeji ati awọn ifiranṣẹ aṣiṣe yoo han fun paati pato. Fun example, yokokoro rest-api daemon iṣẹlẹ yoo fihan nikan iṣẹlẹ awọn ifiranṣẹ yokokoro fun API Daemon-si-Agent awọn ibaraẹnisọrọ.

Awọn ofin ti o jọmọ

Òfin / Apejuwe

yokokoro HTTP; Lo aṣẹ yii si view alaye alaye nipa HTTP ijabọ.

Awọn ifiranṣẹ Syslog ti o ni ibatan ASA REST API

ASA REST API ti o ni ibatan si awọn ifiranṣẹ log-log ni a ṣe apejuwe ni apakan yii.

342001

Ifiranṣẹ aṣiṣe: %ASA-7-342001: Aṣoju API REST bẹrẹ ni aṣeyọri.
- Alaye: Aṣoju API REST gbọdọ bẹrẹ ni aṣeyọri ṣaaju ki Onibara API REST le tunto ASA.
- Iṣe iṣeduro: Ko si.

342002

Ifiranṣẹ aṣiṣe: % ASA-3-342002: REST API Aṣoju kuna, idi: idi
- Alaye: Aṣoju API REST le kuna lati bẹrẹ tabi jamba fun awọn idi pupọ, ati pe idi ti wa ni pato.
- idi-Ohun ti o fa fun ikuna API REST

Iṣe iṣeduro: Awọn iṣe ti a ṣe lati yanju ọran naa yatọ da lori idi ti o wọle. Fun example, REST API Aṣoju ipadanu nigbati Java ilana nṣiṣẹ jade ti iranti. Ti eyi ba waye, o nilo lati tun Aṣoju API REST bẹrẹ. Ti atunbere naa ko ba ṣaṣeyọri, kan si Sisiko TAC lati ṣe idanimọ idi idi root.

342003

Ifiranṣẹ aṣiṣe: %ASA-3-342003: REST API Aṣoju ikuna iwifunni gba. Aṣoju yoo tun bẹrẹ laifọwọyi.
- Alaye: Ifitonileti ikuna lati ọdọ Aṣoju API REST ti gba ati pe a tun gbiyanju Aṣoju naa.
- Iṣe iṣeduro: Ko si.

342004

Ifiranṣẹ aṣiṣe: %ASA-3-342004: Kuna lati tun bẹrẹ laifọwọyi Aṣoju API REST lẹhin awọn igbiyanju 5 ti ko ni aṣeyọri. Lo aṣoju 'ko si isinmi-api' ati awọn aṣẹ 'aṣoju-api isinmi' lati tun Aṣoju naa bẹrẹ pẹlu ọwọ.
- Alaye: Aṣoju API REST ti kuna lati bẹrẹ lẹhin ọpọlọpọ awọn igbiyanju.
- Iṣe iṣeduro: Wo syslog% ASA-3-342002 (ti o ba wọle) lati ni oye daradara idi ti o wa lẹhin ikuna naa. Gbiyanju lati mu Aṣoju API REST kuro nipa titẹ aṣẹ aṣoju-api isinmi ko si ki o tun mu Aṣoju API REST ṣiṣẹ ni lilo aṣẹ aṣoju-api isinmi.

Iwe ti o jọmọ

Lo ọna asopọ atẹle yii lati wa alaye diẹ sii nipa ASA, ati iṣeto ni ati iṣakoso rẹ:

Lilọ kiri Sisiko ASA Series Iwe: http://www.cisco.com/go/asadocs
Lo ọna asopọ atẹle yii si view atokọ ti awọn ẹya ASA ti ko ni atilẹyin lori ASAv: http://www.cisco.com/c/en/us/td/docs/security/asa/asa92/configuration/general/asa-general-cli/introasav.html#pgfId-1156883

Iwe yii ni lati lo ni apapo pẹlu awọn iwe aṣẹ ti o wa lati apakan “Iwe ti o jọmọ”.
Sisiko ati aami Sisiko jẹ aami-išowo tabi aami-išowo ti a forukọsilẹ ti Sisiko ati/tabi awọn alafaramo rẹ ni AMẸRIKA ati awọn orilẹ-ede miiran. Si view akojọ kan ti Sisiko-iṣowo, lọ si yi URL: www.cisco.com/go/trademarks. Awọn aami-išowo ti ẹnikẹta mẹnuba jẹ ohun-ini ti awọn oniwun wọn. Lilo ọrọ alabaṣepọ ko tumọ si ibasepọ ajọṣepọ laarin Sisiko ati ile-iṣẹ miiran. (1721R)
Awọn adirẹsi Ayelujara Ilana Ayelujara eyikeyi (IP) ati awọn nọmba foonu ti a lo ninu iwe yii ko ni ipinnu lati jẹ awọn adirẹsi gangan ati awọn nọmba foonu. Eyikeyi examples, iṣafihan ifihan aṣẹ, awọn aworan atọka topology netiwọki, ati awọn isiro miiran ti o wa ninu iwe jẹ afihan fun awọn idi alapejuwe nikan.
Lilo eyikeyi ti awọn adiresi IP gangan tabi awọn nọmba foonu ninu akoonu alaworan jẹ aimọkan ati lairotẹlẹ.

Cisco Systems, Inc.

www.cisco.com

Awọn iwe aṣẹ / Awọn orisun

CISCO ASA isinmi API App [pdf] Itọsọna olumulo
ASA REST API App, ASA, REST API App, API App, App

Awọn itọkasi

Itọsọna olumulo