د CISCO ASA REST API ایپ کارونکي لارښود

منځپانګې پټول

1 د CISCO ASA REST API اپلیکیشن

2 د محصول کارولو لارښوونې

3 اوورview

4 د ASA REST API غوښتنې او ځوابونه

5 د ASA REST API اجنټ او پیرودونکي نصب او تنظیم کړئ

6 د اسنادو کنسول او د API سکریپټونو صادرول

7 په ASA کې د REST API Debugging فعالول

8 د ASA REST API پورې اړوند Syslog پیغامونه

9 اړونده اسناد

10 اسناد / سرچینې

10.1 حوالې

د CISCO ASA REST API اپلیکیشن

د محصول کارولو لارښوونې

اوورview

د سیسکو د ASA REST API په خپرولو سره، تاسو اوس د انفرادي سیسکو ASAs ترتیب او اداره کولو لپاره یو بل لږ وزن لرونکی ، د کارولو اسانه اختیار لرئ. د ASA REST API د RESTful اصولو پراساس د غوښتنلیک برنامې انٹرفیس (API) دی. دا په هر ASA کې په چټکۍ سره ډاونلوډ او فعال کیدی شي چیرې چې API روان وي. Cisco Systems, Inc.

www.cisco.com

د ASA REST API غوښتنې او ځوابونه

ستاسو په براوزر کې د REST پیرودونکي نصبولو وروسته ، تاسو کولی شئ د ASA ځانګړي REST اجنټ سره اړیکه ونیسئ او اوسني ترتیب معلوماتو ته لاسرسي لپاره معیاري HTTP میتودونه وکاروئ او اضافي ترتیب پارامترونه صادر کړئ.

احتیاط: کله چې REST API په ASA کې فعال شي، د نورو امنیتي مدیریت پروتوکولونو لخوا اړیکې نه بندیږي. دا پدې مانا ده چې نور د CLI، ASDM، یا امنیت مدیر کارول کیدی شي د ASA ترتیب بدل کړي پداسې حال کې چې تاسو ورته کار کوئ.

د جوړښت غوښتنه

د ASA REST API تاسو ته د نمایندګۍ ریاست لیږد (REST)API له لارې د انفرادي ASAs اداره کولو لپاره برنامې لاسرسی درکوي. API خارجي پیرودونکو ته اجازه ورکوي چې د ASA سرچینو باندې CRUD (جوړول، لوستل، تازه کول، حذف کول) عملیات ترسره کړي. د API ټولې غوښتنې د HTTPS له لارې ASA ته لیږل کیږي، او ځواب بیرته راستانه کیږي.

چیرته چې د اعتراض ځانګړتیاوې دي:

ملکیت	ډول	تفصیل
پیغامونه	د لغتونو لیست	د خطا یا خبرتیا پیغامونو لیست
کوډ	تار	مفصل پیغام د خطا/خبرتیا/معلوماتو سره مطابقت لري
تفصیلات	تار	مفصل پیغام د خطا/خبرتیا/معلوماتو سره مطابقت لري

یادونه: د REST API کالونو لخوا رامینځته شوي بدلونونه د پیل کولو ترتیب ته دوام نه ورکوي مګر یوازې د روان ترتیب لپاره ټاکل شوي. د پیل کولو ترتیب کې د بدلونونو خوندي کولو لپاره، تاسو کولی شئ د POST a write mem API غوښتنه وکاروئ. د نورو معلوماتو لپاره، د ASA REST API په اړه د منځپانګو جدول کې د حافظې لیکلو API ننوتلو ته مراجعه وکړئ.

د ASA REST API اجنټ او پیرودونکي نصب او تنظیم کړئ

یادونه: د REST API اجنټ د جاوا میشته غوښتنلیک دی. د جاوا رنټیم چاپیریال (JRE) د REST API اجنټ کڅوړه کې بنډل شوی.

اوورview

د انفرادي سیسکو ASAs ترتیب او اداره کولو لپاره ډیری اختیارونه شتون لري:

د کمانډ لاین انٹرفیس (CLI) - تاسو د کنټرول کمانډونه مستقیم ASA ته د وصل شوي کنسول له لارې لیږئ.

د تطابق امنیتي وسیلې مدیر (ASDM) - د ګرافیکي کارونکي انٹرفیس سره د "آن بکس" مدیریت غوښتنلیک چې تاسو کولی شئ د ASA تنظیم کولو ، اداره کولو او څارلو لپاره وکاروئ.
د سیسکو امنیت مدیر - پداسې حال کې چې د ډیری امنیتي وسیلو منځني څخه لوی شبکو لپاره اراده لري، دا ګرافیکي غوښتنلیک د انفرادي ASAs ترتیب، اداره کولو او څارلو لپاره کارول کیدی شي.

د سیسکو د ASA REST API په خپرولو سره، تاسو اوس یو بل لږ وزن لرونکی، د کارولو اسانه اختیار لرئ. دا د اپلیکیشن برنامه کولو انٹرفیس (API) دی ، د "RESTful" اصولو پراساس ، کوم چې تاسو کولی شئ په چټکۍ سره په هر ASA کې ډاونلوډ او فعال کړئ چې API یې پرمخ وړي.

ستاسو په براوزر کې د REST پیرودونکي نصبولو وروسته ، تاسو کولی شئ د ASA ځانګړي REST اجنټ سره اړیکه ونیسئ او اوسني ترتیب معلوماتو ته لاسرسي لپاره معیاري HTTP میتودونه وکاروئ ، او اضافي ترتیب پارامترونه صادر کړئ.

د ASA REST API غوښتنې او ځوابونه

د ASA REST API تاسو ته د نمایندګۍ ریاست لیږد (REST) API له لارې د انفرادي ASAs اداره کولو لپاره پروګراماتي لاسرسي درکوي. API خارجي مراجعینو ته اجازه ورکوي چې د ASA سرچینو باندې CRUD (جوړول، لوستل، تازه کول، حذف کول) عملیات ترسره کړي؛ دا د HTTPS پروتوکول او REST میتودولوژي پراساس دی. د API ټولې غوښتنې د HTTPS له لارې ASA ته لیږل کیږي، او ځواب بیرته راستانه کیږي. دا برخه یو اوور چمتو کويview د غوښتنو د جوړښت څرنګوالی، او متوقع ځوابونه،

د جوړښت غوښتنه

د غوښتنې موجودې طریقې په لاندې ډول دي:

GET - د ټاکل شوي اعتراض څخه ډاټا ترلاسه کوي.
PUT - چمتو شوي معلومات ټاکل شوي اعتراض ته اضافه کوي؛ د 404 سرچینې نه موندل شوې تېروتنه راګرځوي که چیرې اعتراض شتون ونلري.

پوسټ - د چمتو شوي معلوماتو سره اعتراض رامینځته کوي.
DELETE - ټاکل شوی څیز ړنګوي.

PATCH - په ټاکل شوي اعتراض کې جزوي تعدیلات پلي کوي.

د غبرګون جوړښت

هره غوښتنه د ASA څخه د معیاري سرلیکونو، غبرګون منځپانګې، او د حالت کوډ سره د HTTPS ځواب تولیدوي.

د غبرګون جوړښت کیدای شي دا وي:

ځای - د نوي جوړ شوي سرچینې ID؛ یوازې د پوسټ لپاره — د نوې سرچینې ID لري (د URI نمایش په توګه).
د منځپانګې ډول - د رسنیو ډول چې د ځواب پیغام بدن تشریح کوي؛ د ځواب پیغام د بدن استازیتوب او ترکیب بیانوي.

په هر ځواب کې د HTTP حالت یا د خطا کوډ شامل دی. شته کوډونه په دې کټګوریو کې راځي:

20x - د دوه سوه لړۍ کوډ بریالي عملیات په ګوته کوي، په شمول:
- 200 OK - د بریالي غوښتنو لپاره معیاري ځواب.
- 201 جوړ شوی - غوښتنه بشپړه شوه نوې سرچینې رامینځته شوې.
- 202 منل شوی - غوښتنه منل شوې، مګر پروسس بشپړ شوی نه دی.
- 204 هیڅ مینځپانګه نشته - سرور په بریالیتوب سره پروسس شوی غوښتنه؛ هیڅ مینځپانګه بیرته نه راځي.
4xx - د څلور سوه لړۍ کوډ د پیرودونکي اړخ غلطی په ګوته کوي، په شمول:
- 400 ناسمه غوښتنه - د پوښتنو ناسم پیرامیټونه، په شمول د ناپیژندل شوي پیرامیټونو، ورک شوي پیرامیټونو، یا ناسم ارزښتونو په شمول.
- 404 ونه موندل شو - چمتو شوی URL د موجوده سرچینې سره سمون نه خوري. د مثال لپارهample، د HTTP ړنګول ممکن ناکام شي ځکه چې سرچینې شتون نلري.
- 405 میتود ته اجازه نه ورکول کیږي - د HTTP غوښتنه وړاندې شوه چې په سرچینې کې اجازه نلري؛ د مثال لپارهample، یوازې د لوستلو سرچینې باندې پوسټ.
5xx - د پنځه سوه لړۍ کوډ د سرور اړخ غلطی په ګوته کوي.

د یوې تېروتنې په صورت کې، د خطا کوډ سربیره، د بیرته راستنیدو ځواب کې ممکن د خطا اعتراض شامل وي چې د خطا په اړه نور جزئیات لري. د JSON تېروتنه/خبرتیا ځواب سکیما په لاندې ډول ده:

چیرته چې د اعتراض ځانګړتیاوې دي:

ملکیت	ډول	تفصیل
پیغامونه	د لغتونو لیست	د خطا یا خبرتیا پیغامونو لیست
کوډ	تار	تېروتنه/خبرداری/معلومات کوډ
تفصیلات	تار	مفصل پیغام د خطا/خبرتیا/معلوماتو سره مطابقت لري

یادونه: د ASA ترتیب کې بدلونونه چې د REST API کالونو لخوا رامینځته شوي د پیل کولو ترتیب ته دوام نه ورکوي؛ دا دی، بدلونونه یوازې د چلولو ترتیب ته ټاکل شوي. د پیل کولو ترتیب کې د بدلونونو خوندي کولو لپاره ، تاسو کولی شئ د رائټ میم API غوښتنه پوسټ کړئ؛ د لا زیاتو معلوماتو لپاره، د ASA REST API په اړه د منځپانګو جدول کې د "Rrite Memory API" ننوتل تعقیب کړئ.

د ASA REST API اجنټ او پیرودونکي نصب او تنظیم کړئ

د REST API اجنټ په انفرادي ډول د نورو ASA عکسونو سره خپور شوی cisco.com. د فزیکي ASAs لپاره، د REST API بسته باید د وسیلې فلش ته ډاونلوډ شي او د "rest-api عکس" کمانډ په کارولو سره نصب شي. د REST API اجنټ بیا د "rest-api agent" کمانډ په کارولو سره فعال شوی.
د مجازی ASA (ASAv) سره، د REST API عکس باید د "بوټ:" برخې ته ډاونلوډ شي. تاسو باید بیا د "Rest-api عکس" کمانډ صادر کړئ، د "rest-api اجنټ" کمانډ تعقیب کړئ، د REST API اجنټ ته لاسرسی او فعالولو لپاره.
د REST API سافټویر او هارډویر اړتیاو او مطابقت په اړه د معلوماتو لپاره، د سیسکو ASA مطابقت میټرکس وګورئ.

تاسو کولی شئ د خپل ASA یا ASAv لپاره مناسب REST API بسته له دې څخه ډاونلوډ کړئ software.cisco.com/download/home. د ځانګړي تطابق امنیتي وسایلو (ASA) ماډل ومومئ او بیا د تطبیقي امنیت تجهیزاتو REST API پلگ ان غوره کړئ.

یادونه: د REST API اجنټ د جاوا میشته غوښتنلیک دی. د جاوا رنټیم چاپیریال (JRE) د REST API اجنټ کڅوړه کې بنډل شوی.

د کارونې لارښوونې

مهم تاسو باید سرلیک شامل کړئ د کارونکي اجنټ: REST API اجنټ په ټولو API کالونو او موجوده سکریپټونو کې. د C لپاره -H 'User-Agent: REST API Agent' وکاروئURL قومانده په څو اړخیز حالت کې، د REST API اجنټ کمانډونه یوازې د سیسټم په شرایطو کې شتون لري.

اعظمي ملاتړ شوي ترتیب اندازه

د ASA Rest API یو "آن بورډ" غوښتنلیک دی چې په فزیکي ASA کې روان دی، او لکه څنګه چې دې ته تخصیص شوي حافظې کې محدودیت لري. د اعظمي ملاتړ شوي چلولو ترتیب اندازه په وروستي پلیټ فارمونو لکه 2 او 5555 کې د ریلیز دورې په اوږدو کې نږدې 5585 MB ته لوړه شوې. د ASA Rest API په مجازی ASA پلیټ فارمونو کې د حافظې محدودیتونه هم لري. په ASAv5 کې ټوله حافظه کیدای شي 1.5 GB وي، پداسې حال کې چې په ASAv10 کې دا 2 GB دی. د پاتې API حدود په ترتیب سره د ASAv450 او ASAv500 لپاره 5 KB او 10 KB دي.

له همدې امله، په یاد ولرئ چې د چلولو لوی تشکیلات کولی شي په مختلفو حافظو کې د پام وړ حالتونو کې استثناوې رامینځته کړي لکه د ورته غوښتنو لوی شمیر، یا د لوی غوښتنې حجم. په دې حالتونو کې، د Rest API GET/PUT/POST زنګونه ممکن د 500 - داخلي سرور خطا پیغامونو سره ناکامي پیل کړي، او د پاتې API اجنټ به هر ځل په اتوماتيک ډول بیا پیل شي. د دې وضعیت لپاره د حل لارې یا د لوړې حافظې ASA/FPR یا ASAV پلیټ فارمونو ته لیږدول دي ، یا د چلولو ترتیب اندازه کمول دي.

د REST API اجنټ ډاونلوډ او نصب کړئ

د CLI په کارولو سره، په ځانګړي ASA کې د ASA REST API اجنټ ډاونلوډ او نصبولو لپاره دا مرحلې تعقیب کړئ:

لومړی ګام: په مطلوب ASA کې، کاپي خپره کړئ disk0: د اوسني ASA REST API کڅوړې ډاونلوډ کولو قوماندې له دې څخه cisco.com د ASA فلش حافظې ته.
- د مثال لپارهampLe: کاپي tftp://10.7.0.80/asa-restapi-111-lfbff-k8.SPA disk0:
لومړی ګام: د باقی اپی عکس ډیسک 0:/ صادر کړئ د بسته بندي تصدیق او نصبولو قوماندې.
- د مثال لپارهampLe: rest-api انځور disk0:/asa-restapi-111-lfbff-k8.SPA

انسټالر به د مطابقت او اعتبار چکونه ترسره کړي، او بیا به بسته نصب کړي. ASA به بیا پیل نشي.

د REST API اجنټ فعال کړئ

په ځانګړي ASA کې د ASA REST API اجنټ فعالولو لپاره دا مرحلې تعقیب کړئ:

لومړی ګام: ډاډ ترلاسه کړئ چې سم سافټویر عکس په ASA کې نصب شوی.
- د ASA مطابقت میټرکس د REST API برخې سره مشوره وکړئ (https://www.cisco.com/c/en/us/td/docs/security/asa/compatibility/asamatrx.html#pgfId-131643) د دې معلومولو لپاره چې د ASA عکس ته اړتیا ده.

لومړی ګام: د CLI په کارولو سره، ډاډ ترلاسه کړئ چې HTTP سرور په ASA کې فعال شوی، او د API مراجعین کولی شي د مدیریت انٹرفیس سره وصل شي.
- د مثال لپارهampLe: د http سرور فعالول
- http 0.0.0.0 0.0.0.0

لومړی ګام: د CLI په کارولو سره، د API اړیکو لپاره د HTTP تصدیق تعریف کړئ. د مثال لپارهample: aaa تصدیق http کنسول LOCAL
لومړی ګام: د CLI په کارولو سره، د API ترافیک لپاره په ASA کې یو جامد لاره جوړه کړئ. د مثال لپارهample: لاره 0.0.0.0 0.0.0.0 1
لومړی ګام: د CLI په کارولو سره، په ASA کې د ASA REST API اجنټ فعال کړئ. د مثال لپارهample: rest-api ایجنټ

د REST API تصدیق

د تصدیق کولو لپاره دوه لارې شتون لري: د لومړني HTTP تصدیق ، کوم چې په هره غوښتنه کې د کارونکي نوم او پاسورډ تیریږي ، یا د خوندي HTTPS ټرانسپورټ سره د توکن پراساس تصدیق ، کوم چې د هرې غوښتنې سره دمخه رامینځته شوی نښه تیریږي. په هرصورت، تصدیق به د هرې غوښتنې لپاره ترسره شي. د ASA REST API v7.14 (x) لارښود په اړه د ټوکن پر بنسټ تصدیق کولو په اړه د اضافي معلوماتو لپاره برخه "Token_Authentication_API" وګورئ.

یادونه: د سند ادارې (CA) لخوا جاري شوي سندونو کارول په ASA کې وړاندیز کیږي ، نو د REST API پیرودونکي کولی شي د SSL اړیکې رامینځته کولو پرمهال د ASA سرور سندونه تایید کړي.

د قوماندې واک

که د قوماندې اختیار د بهرني AAA سرور کارولو لپاره تنظیم شوی وي (د مثال لپارهample، aaa د واک ورکولو قومانده )، بیا د enable_1 په نوم یو کارن باید په هغه سرور کې د بشپړ کمانډ امتیازاتو سره شتون ولري. که د قوماندې اختیار د ASA د LOCAL ډیټابیس کارولو لپاره تنظیم شوی وي (aaa د اختیار کولو قوماندې LOCAL)، نو بیا ټول REST API کاروونکي باید د LOCAL ډیټابیس کې د امتیاز کچې سره ثبت شي چې د دوی د رول لپاره مناسب دي:

د څارنې غوښتنې غوښتنه کولو لپاره د امتیاز کچه 3 یا لوړه ته اړتیا ده.

د GET غوښتنو غوښتنه کولو لپاره د امتیاز کچه 5 یا لوړه ته اړتیا ده.
د PUT/POST/DELETE عملیاتو غوښتنه کولو لپاره د امتیاز کچه 15 اړینه ده.

خپل REST API پیرودونکي تنظیم کړئ

په خپل ځایی کوربه براوزر کې د REST API پیرودونکي نصب او تنظیم کولو لپاره دا مرحلې تعقیب کړئ:

لومړی ګام: د خپل براوزر لپاره د REST API پیرودونکي ترلاسه او نصب کړئ.
- د کروم لپاره، د ګوګل څخه REST مراجع نصب کړئ. د فایرفوکس لپاره، د RESTClient اضافه نصب کړئ. د انټرنیټ اکسپلورر ملاتړ نه کوي.

لومړی ګام: د خپل براوزر په کارولو سره لاندې غوښتنه پیل کړئ: https: /api/objects/networkobjects
- که تاسو غیر خطا ځواب ترلاسه کړئ، تاسو د REST API اجنټ ته رسیدلی یاست چې په ASA کې فعالیت کوي.
- که تاسو د اجنټ غوښتنې سره ستونزې لرئ، تاسو کولی شئ په CLI کنسول کې د ډیبګ کولو معلوماتو ښودلو وړ کړئ، لکه څنګه چې په ASA کې د REST API Debugging فعالولو کې تشریح شوي.

لومړی ګام: په اختیاري توګه، تاسو کولی شئ د POST عملیاتو په ترسره کولو سره د ASA سره خپل پیوستون معاینه کړئ.

د مثال لپارهampLe: د اصلي جواز سندونه چمتو کړئ ( )، یا د تصدیق نښه (د اضافي معلوماتو لپاره د توکین تصدیق وګورئ).

د هدف غوښتنې پته: https://<asa management ipaddress>/api/objects/networkobjects

د بدن منځپانګې ډول: غوښتنلیک/json

د عملیاتو خام بدن:

تاسو اوس کولی شئ د ASA تنظیم کولو او څارلو لپاره د ASA REST API وکاروئ. د تلیفون توضیحاتو او مثال لپاره د API اسنادو ته مراجعه وکړئamples.

په بشپړ ډول د بیک اپ ترتیب تنظیم کولو په اړه

د REST API په کارولو سره په ASA کې د بشپړ بیک اپ ترتیب بحال کول به ASA بیا پورته کړي. د دې څخه مخنیوي لپاره ، د بیک اپ ترتیب تنظیم کولو لپاره لاندې کمانډ وکاروئ:

{
- "کمانډونه":["کاپي /نوکنفرم ډیسک0:/fileنوم> د چلولو ترتیب"]
}
- چیرتهfilename> backup.cfg دی یا هر هغه نوم چې تاسو یې د کنفیګریشن د بیک اپ کولو په وخت کې کاروئ.

د اسنادو کنسول او د API سکریپټونو صادرول

تاسو کولی شئ د REST API آنلاین اسنادو کنسول هم وکاروئ (د "Doc UI" په نوم یادیږي)، په کوربه: port/doc/ کې د "سنډ باکس" په توګه شتون لري ترڅو د ASA په مستقیم ډول د API کالونو په اړه زده کړې او هڅه وکړي. برسېره پردې، تاسو کولی شئ د Doc UI کې د صادراتو عملیات تڼۍ وکاروئ ترڅو ښودل شوي میتود خوندي کړئampد جاوا سکریپټ، پایتون، یا پرل سکریپټ په توګه file ستاسو محلي کوربه ته. بیا تاسو کولی شئ دا سکریپټ په خپل ASA کې پلي کړئ، او په نورو ASAs او نورو شبکې وسیلو کې د غوښتنلیک لپاره یې ترمیم کړئ. دا په اصل کې د تعلیمي او بوټ سټریپینګ وسیلې په توګه معنی لري.

جاواسکریپټ

د جاوا سکریپټ کارول file د node.js نصبولو ته اړتیا لري، کوم چې موندل کیدی شي http://nodejs.org/.
د node.js په کارولو سره، تاسو کولی شئ جاوا سکریپټ اجرا کړئ file، معمولا د براوزر لپاره لیکل کیږي ، لکه د کمانډ لاین سکریپټ. په ساده ډول د نصبولو لارښوونې تعقیب کړئ، او بیا خپل سکریپټ د نوډ script.js سره چل کړئ.

پیتون

د Python سکریپټونه تاسو ته اړتیا لري چې Python نصب کړئ، له دې څخه شتون لري https://www.python.org/.
یوځل چې تاسو Python نصب کړئ ، تاسو کولی شئ خپل سکریپټ د python script.py کارن نوم پاسورډ سره پرمخ وړئ.

پرل

د پرل سکریپټونو کارول یو څه اضافي تنظیم ته اړتیا لري — تاسو پنځه برخو ته اړتیا لرئ: پخپله پرل ، او څلور پرل کتابتونونه:

پرل بسته، په کې وموندل شوه http://www.perl.org/
بنډل::CPAN، په http://search.cpan.org/~andk/Bundle-CPAN-1.861/CPAN.pm کې موندل شوی

استراحت::پیرودونکي، په کې وموندل شول http://search.cpan.org/~mcrawfor/REST-Client-88/lib/REST/Client.pm
MIME::بیس 64، موندل شوی http://perldoc.perl.org/MIME/Base64.html
JSON، په کې وموندل شو http://search.cpan.org/~makamaka/JSON-2.90/lib/JSON.pm

دلته یو پخوانی دیampپه Macintosh کې پرل د بوټسټریپ کول:

$ sudo perl -MCPAN e shell
cpan> بنډل نصب کړئ::CPAN

cpan> REST نصب کړئ:: پیرودونکي
cpan> MIME نصب کړئ:اساس 64
cpan> JSON نصب کړئ

د انحصارونو د نصبولو وروسته، تاسو کولی شئ خپل سکریپټ د perl script.pl کارن نوم پټنوم په کارولو سره پرمخ بوځي.

په ASA کې د REST API Debugging فعالول

که تاسو په ASA کې د REST API سره تنظیم کولو یا وصل کولو کې ستونزې لرئ ، تاسو کولی شئ لاندې CLI کمانډ وکاروئ ترڅو ستاسو په کنسول کې د ډیبګ کولو پیغامونو ښودلو وړ کړئ. د ډیبګ پیغامونو غیر فعالولو لپاره د کمانډ هیڅ بڼه وکاروئ.
debug rest-api [اجنټ | cli | پیرودونکي | ډیمون | پروسه | token-auth] [ تېروتنه | پیښه] هیڅ debug rest-api

د نحو تفصیل

اجنټ: (اختیاري) د REST API اجنټ ډیبګ کولو معلومات فعال کړئ.
cli: (اختیاري) د REST API CLI ډیمون څخه اجنټ مخابراتو لپاره د ډیبګ کولو پیغامونه فعال کړئ.
پیرودونکي: (اختیاري) د REST API پیرودونکي او REST API اجنټ تر مینځ د پیغام روټینګ لپاره د ډیبګ کولو معلومات فعال کړئ.

ډیمون (اختیاري) د REST API ډیمون څخه اجنټ مخابراتو لپاره د ډیبګ کولو پیغامونه فعال کړئ.
پروسه: (اختیاري) د REST API اجنټ پروسې فعال کړئ / د ډیبګ کولو معلوماتو مخه ونیسئ.
نښه لیک: (اختیاري) د REST API ټوکن تصدیق کولو ډیبګ کولو معلومات.

تېروتنه: (اختیاري) دا کلیمه وکاروئ د ډیبګ پیغامونو محدودولو لپاره یوازې د API لخوا ننوتل شوي غلطیو ته.
پیښه: (اختیاري) دا کلیمه وکاروئ د ډیبګ پیغامونو محدودولو لپاره یوازې د API لخوا ثبت شوي پیښو ته.

د کارونې لارښوونې

که تاسو د ځانګړي اجزا کلیدي کلمه نه ورکوئ (یعنې که تاسو په ساده ډول د ډیبګ ریسټ اپی کمانډ صادر کړئ) ، د ډیبګ پیغامونه د ټولو برخو ډولونو لپاره ښودل کیږي. که تاسو د پیښې یا خطا کلیدي نه وړاندې کوئ، دواړه پیښې او خطا پیغامونه د ټاکل شوي برخې لپاره ښودل کیږي. د مثال لپارهample، debug rest-api daemon پیښه به د API ډیمون څخه اجنټ مخابراتو لپاره یوازې د پیښې ډیبګ پیغامونه وښیې.

اړونده حکمونه

امر / توضیحات

HTTP debug; د دې کمانډ څخه کار واخلئ view د HTTP ترافیک په اړه تفصيلي معلومات.

د ASA REST API پورې اړوند Syslog پیغامونه

د ASA REST API پورې اړوند سیسټم-لاګ پیغامونه پدې برخه کې تشریح شوي.

342001

د تېروتنې پیغام: %ASA-7-342001: د REST API اجنټ په بریالیتوب سره پیل شو.
- تشریح: د REST API اجنټ باید په بریالیتوب سره پیل شي مخکې لدې چې د REST API پیرودونکي کولی شي ASA تنظیم کړي.
- وړاندیز شوی عمل: هیڅ نه.

342002

د تېروتنې پیغام: %ASA-3-342002: REST API اجنټ ناکام شو، لامل: لامل
- تشریح: د REST API اجنټ د مختلف دلایلو لپاره په پیل یا حادثه کې پاتې کیدی شي ، او لامل یې مشخص شوی.
- لامل - د REST API ناکامۍ لامل

وړاندیز شوی عمل: د مسلې د حل کولو لپاره ترسره شوي اقدامات د ثبت شوي دلیل پورې اړه لري. د مثال لپارهample، د REST API اجنټ خرابیږي کله چې د جاوا پروسه له حافظې څخه تیریږي. که دا پیښ شي، تاسو اړتیا لرئ د REST API اجنټ بیا پیل کړئ. که بیا پیل کول بریالي نه وي، د سیسکو TAC سره اړیکه ونیسئ ترڅو د اصلي لامل حل وپیژني.

342003

د تېروتنې پیغام: %ASA-3-342003: د REST API اجنټ ناکامي خبرتیا ترلاسه شوه. اجنټ به په اوتومات ډول بیا پیل شي.
- تشریح: د REST API اجنټ څخه د ناکامۍ خبرتیا ترلاسه شوې او د اجنټ بیا پیلولو هڅه کیږي.
- وړاندیز شوی عمل: هیڅ نه.

342004

د تېروتنې پیغام: %ASA-3-342004: د 5 ناکامو هڅو وروسته د REST API اجنټ په اتوماتيک ډول بیا پیلولو کې پاتې راغلی. په لاسي ډول د اجنټ بیا پیلولو لپاره 'no rest-api agent' او 'rest-api agent' کمانډونه وکاروئ.
- تشریح: د REST API اجنټ د ډیرو هڅو وروسته په پیل کولو کې پاتې راغلی.
- وړاندیز شوی عمل: syslog %ASA-3-342002 وګورئ (که ننوتل شوی وي) د ناکامۍ تر شا د ښه پوهیدو لپاره. د No rest-api اجنټ کمانډ دننه کولو سره د REST API اجنټ غیر فعال کولو هڅه وکړئ او د rest-api اجنټ کمانډ په کارولو سره د REST API اجنټ بیا فعال کړئ.

اړونده اسناد

د ASA، او د دې ترتیب او مدیریت په اړه د نورو معلوماتو موندلو لپاره لاندې لینک وکاروئ:

د سیسکو ASA لړۍ اسنادو ته حرکت کول: http://www.cisco.com/go/asadocs
د لاندې لینک څخه کار واخلئ view د ASA ځانګړتیاو لیست چې په ASAv کې نه ملاتړ کیږي: http://www.cisco.com/c/en/us/td/docs/security/asa/asa92/configuration/general/asa-general-cli/introasav.html#pgfId-1156883

دا سند باید د "اړونده اسنادو" برخې څخه موجود اسنادو سره په ګډه وکارول شي.
د سیسکو او سیسکو لوګو د سیسکو او/یا په متحده ایالاتو او نورو هیوادونو کې د هغې د اړوندو شرکتونو سوداګریزې نښې یا راجستر شوي سوداګریزې نښې دي. ته view د سیسکو سوداګریزې نښې لیست، دې ته لاړ شئ URL: www.cisco.com/go/trademarks. ذکر شوي د دریمې ډلې سوداګریزې نښې د دوی د اړوندو مالکینو ملکیت دی. د ملګري کلمې کارول د سیسکو او کوم بل شرکت ترمنځ د شراکت اړیکه معنی نه لري. (۱۷۲۱ر)
په دې سند کې کارول شوي د انټرنیټ پروتوکول (IP) پتې او د تلیفون شمیرې د اصلي پتې او تلیفون شمیرو لپاره ندي. هر پخوانیamples، د کمانډ ښودلو محصول، د شبکې ټوپولوژي ډیاګرامونه، او نور ارقام چې په سند کې شامل دي یوازې د توضیحي موخو لپاره ښودل شوي.
په مثالي مینځپانګه کې د اصلي IP پتې یا تلیفون شمیرو هرډول کارول غیر قصدي او تصادفي دي.

Cisco Systems, Inc.

www.cisco.com

اسناد / سرچینې

د CISCO ASA REST API اپلیکیشن [pdf] د کارونکي لارښود
د ASA REST API اپلیکیشن، ASA، REST API اپلیکیشن، API ایپ، اپلیکیشن

حوالې

د کارن لارښود