הדגמה של RESTCONF

בלי כתוביותעם כתוביות

מילון מושגים:

Postman - כלי לבדיקת API: שליחת בקשות HTTP לשרת ובחינת התגובות, נפוץ בפיתוח ובבדיקות.

SNMP - פרוטוקול לניטור ולניהול של התקני רשת, כמו ראוטרים ומתגים, ולאיסוף מידע עליהם.

Cisco - חברה מובילה בציוד רשת, כמו ראוטרים ומתגים, ובהסמכות מקצועיות בתחום הרשתות.

URL - הכתובת שמזהה משאב באינטרנט, למשל דף אתר, וכוללת פרוטוקול, שם מארח ונתיב.

GET - שיטת HTTP לבקשת מידע מהשרת בלי לשנות אותו. הפרמטרים מועברים בדרך כלל בכתובת.

POST - שיטת HTTP לשליחת נתונים לשרת כדי ליצור או לעדכן משאב, למשל שליחת טופס.

PUT - שיטת HTTP לשליחת נתונים לשרת כדי ליצור או להחליף משאב קיים במלואו.

Base64 - שיטת קידוד שממירה נתונים בינאריים לטקסט מתווים מודפסים, כדי להעבירם בבטחה בערוצים טקסטואליים.

הדגמה של RESTCONF

אחרי שהסביבה ב-Postman מוכנה, ההרצאה עוברת על הפעולות הבסיסיות ב-RESTCONF בעזרת מעבדת הלמידה של סיסקו: קריאת ממשקים, יצירת Loopback, עדכון, מחיקה ושמירת ההגדרות.

הרקע

SNMP הגיע בשנות ה-90, NETCONF בסביבות 2010, ו-RESTCONF הוגדר ב-2017 (RFC 8040). RESTCONF פועל על HTTPS ולא על SSH, ושניהם מעבירים מידע לפי מבנה YANG, ב-JSON או ב-XML. כיוון שזה RFC אחיד, אותן פקודות אמורות להתאים ל-HP, Cisco וכל יצרן אחר, ואפליקציה לניהול רשת יכולה לשלוח אותן למאות מכשירים.

מבנה בקשה

1. כתובת, פעולה וגוף: לכל בקשה יש URL ופעולה. GET מקבל מידע, POST מוסיף, PUT מעדכן ו-DELETE מוחק. הגוף (Body) קיים רק ב-POST.

2. אימות: Basic Authentication. שם המשתמש והסיסמה בקידוד Base64 בכותרת Authorization. זה קידוד ולא הצפנה, אבל התקשורת עטופה ב-HTTPS. בגרסאות הראשונות שקלו גם HTTP והוחלט לוותר.

3. פורמט: בכותרת מציינים שרוצים לקבל JSON ושולחים JSON.

מה נעשה בפועל

1. יצירת Loopback: נשלח POST עם גוף שמגדיר ממשק 111 וכתובת IP. אחרי שליחה, show ip interface brief ב-SSH הראה אותו. שליחה חוזרת החזירה שגיאה שהממשק כבר קיים.

2. קריאה: אפשר לבקש את כל הממשקים או ממשק ספציפי לפי שמו. אחרי סימן שאלה מציינים אילו שדות רוצים, למשל name ו-description, ומפרידים בנקודה-פסיק. אפשר גם לשלוח זאת ב-curl.

3. הוספת ממשק נוסף: 112 נוצר באותה דרך, ושליחה נוספת נתנה קונפליקט.

4. עדכון ומחיקה: אותו URL משמש לכל הפעולות על ממשק מסוים. PUT מעדכן, למשל כתובת IP, ו-DELETE מוחק. אחרי מחיקת 112 נשאר רק 111.

5. שמירה: הממשק החדש היה ב-running config בלבד ולא ב-startup config. POST ל-saveConfiguration (בלי גוף) החזיר הודעת הצלחה, ואחר כך 111 הופיע גם ב-startup config.

שימו לב

התקן חדש יחסית ורוב הציוד הישן אינו תומך בו, ולכן צריך לעדכן תוכנה.

אחרי ההרצאה אפשר ליצור, לשאול, לעדכן, למחוק ולשמור הגדרות של ממשק בראוטר דרך RESTCONF.

פרקי ההרצאה: הדגמה של RESTCONF

תמלול ההרצאה: הדגמה של RESTCONF

הטקסט המלא של הדקות הראשונות בהרצאה «הדגמה של RESTCONF» בקורס הווידאו של PracticU – כתוביות בעברית עם זמן התחלה לכל פסקה. כך תוכלו לקרוא ולחפש את הנושאים לפני שמתחילים ללמוד.

00:02
שלום לכולם בהרצאה הזו אנחנו נחקור את השאילתות restcon בשביל להוסיף לובק בשביל למחוק אינטרפייס לשמור את ההגדרות אני מזכיר לכם מה עשינו בהרצאה הקודמת בהרצאה הקודמת התקנו את כל הפוסטמן והגענו למצב שאנחנו יכולים לשלוח שאילתות לשרת נניח לפתוח אותו את הקווירי את השאילתה ששולחים
00:26
לבחור את הסביבה שלנו ולעשות send ולקבל תשובה זה מה שעשינו ועשינו את כל זה לפי ההוראות שיש פה בלומדה של סיסקו set up your own computer למעלה אחרי שעברנו את השלב הזה אנחנו ממשיכים בלומדה עד עכשיו כל זה היה כמו הכנות אז אנחנו רואים שנטקונף זה למעשה שיפור של snmp שעובד על ssh
00:49
אבל אנחנו רצינו יותר מזה רצינו לעבור לא דרך ssh אלא דרך וואב ואז ב-2017 המציאו תקן שנקרא 8040 של רסטקונף זאת אומרת היה פעם SNMP שאנחנו מדברים איתכם על שנות ה-90 1990 אחרי זה בשנות ה-2010 בערך המציאו את הנטקונף ועכשיו ב-2017 המציאו
01:13
את התקן של רסטקונף כאשר הרסטקונף הוא מבוסס HTTPS ולא SSH כמו הנטקונף לא משנה אם זה נטקונף אם יעשה סייג' או רסטקונף עם HTTPS, בכל מקרה שניהם מעבירים מידע לפי מבנה definitions, הגדרות מידע של יאנג.
01:35
יאנג זה למעשה המבנה והוא יודע לעבוד גם ג'ייסון וגם אקס-אמ-אל, הרסטקונף. זאת אומרת שאם יש לי פה ראוטר, זה זה, או סוויץ' או לא משנה איזשהו התקן, הוא יכול לקבל ממני, נטרוק אינג'ינר, פקודות ברסטקונף, וזה בדיוק מה שראינו, או שהוא יכול לקבל את הפקודות האלו מאיזושהי
01:53
אפליקציה, בביט שמנהלת לנו את הרשת ותחשבו שאין לנו ראוטר אחד יש לנו מאות ראוטרים וסוויצ'ים וכולם מקבלים אותה פקודה לא משנה גם איזה יצרן שימו לב זה תקן זה תקן זה rfc בגלל שזה rfc אחיד לכל היצרנים אז התקן הרשת הזה יודע לקבל בדיוק אותן פקודות גם אם זה hp גם אם זה cisco גם
02:16
אם זה כל יצרן אחר ואם יש לנו network management system יש לנו איזשהו שרת שרוצה לנהל את הרשת איזשהו כלי עזר אנחנו יכולים לשלוח את הפקודות בנט קונף שזה SSH מאחורי הקלעים אבל SSH בתקן של יאנג לא סתם פקודות של CLI שלכל יצרן יש לו CLI אחר אלא תקן אחיד רסט קונף מבוסס על HTTPS אנחנו גם נותנים איזה פקודה אנחנו רוצים גט פוסט פוט שימו לב זה הפקודות שיש לנו פה לדוגמה
02:47
להוסיף אינטרפס של לובק זה פוסט לקבל מידע זה גט להגדיר משהו זה פוט זאת אומרת יש לנו ליד כל URL גם את הפעולה שלה. זאת אומרת, חוץ מ-URL יש לנו גם את הפעולות וגם יש לנו את ה-Body.
03:03
זאת אומרת, אם אנחנו באים להוסיף אינטרפייס, אז יש לנו את ה-URL הזה, אבל איפה כתוב מה להוסיף? מה הנתונים? אם יש לנו פה פוסט, אתם רואים פה מבנה של פוסט ולא גט, אז יש לנו גם Body.
03:17
Body זה מידע נוסף שאני שולח ואני יכול לראות פה שלדוגמה אני אומר לו תיצור לי אינטרפייס 111. שלוש פעמים אחד ואז אני נותן לו גם IP 111.
03:30
אני עושה send ואני שולח ל-URL הזה לא רק את הבקשה אלא גם את ה-body הזה, את הגוף הזה. הגוף הזה לא קיים ב-GET, זאת אומרת כל ה-GETים האלו אין בהם את ה-BODY, ה-BODY קיים רק בפוסט ואז אני עושה send, מסתכל אם יש לי הודעת שגיאה, אני לא רואה הודעת שגיאה,
03:49
בגלל שאין לי הודעת שגיאה אם אני אתחבר עכשיו ב-SSH לאותה מכונה, הנה אני בפנים show IP interface brief, אני רואה שאחד, אחד, אחד שלי נוצר, אתם רואים?
04:02
אם אני אשלח עוד פעם את הפקודה הזאת, פעם שנייה הוא אומר לי אירור. למה אירור? כי זה כבר קיים. מה הוא יכתוב לי פה? All ready exists, אינטרפס כבר קיים.
04:14
אז הבנו שלהודעות חוץ מ-URL יש גם את המאפיין הנוסף הזה של פוסט, גט, דיליט, לדוגמה, למחוק, וכשזה פוסט ולא גט הוא שולח גם את ה-body.
04:26
אז זה הפעולה למעשה, Operations. איזו פעולה לעשות. זה יכול להיות או XML או JSON, הפורמט של המידע, איך אני מארגן אותו, וזה ב-HTTPS.
04:39
שימו לב, הוא גם דורש אימות. הוא מכניס יוזרנם ופסוורד בקידוד בייס 64. זה לא הצפנה, זה רק קידוד צורת הצגת המידע. אין שם מפתח סודי, אין פה שום דבר, זה פשוט, אפשר להגיד, שולח את זה clear text, אבל בגלל שזה HTTPS, אז כל התקשורת מוצפנת על ידי המפתחות, אז אני לא דואג שמישהו יראה בתוך ה-HTTP מה קורה,
05:02
כי הוא לא יכול להגיד יש לי HTTפי, כי כל ה-HTTP עטוף ב-SSL, מוצפן ב-SSL. דרך אגב, פה הם כותבים שבגרסאות הראשוניות הם חשבו לתמוך ב-HTTP, אבל בסוף ירדו מזה ועשו HTTPS, אז בגלל שזה רק HTTPS אפשר לשלוח את היוזרנם והפסוורד בקידוד פשוט, שזה נקרא Basic Authentication.
05:23
אז הקליינט שולח פה בקשה לשרת, אומר HTTP request get, מביא לי ונותן לו איזשהו לינק והשרד נותן לו HTTP ריספונס בפורמט של ג'ייסון ונותן לו סטטוס 200 אוקיי.
05:37
מאוד פשוט, משתמשים בבייסיק אותיטיקיישן, מעבירים שם וסיסמה פשוט בהדר, זאת אומרת אם יש לנו פה הדר של הבקשה שימו לב באופטריזיישן בתוך ההדר, זאת אומרת בדברים הנוספים שאני שולח אליו, זאת אומרת אני שולח אליו ל-url הזה את ה-body הזה כי זה פוסט,
05:58
יש לי גם הדרים שאני שולח ובהדר יש אוסטוריזיישן וזה למעשה הקידוד שם והסיסמה כאשר יש לי פה גם באיזה פורמט אני רוצה לקבל את התשובות אני רוצה לקבל אותם בדאטה ג'ייסון עכשיו המידע הזה אתם רואים פה אני מקבל ג'ייסון ואני גם שולח ג'ייסון ואז אפשר לראות בבאדי שבאמת יש פה את הג'ייסון עם הסוגריים המסולסלים אנחנו יכולים לבקש כל
06:21
האינטרפייסים או אינטרפייס ספציפי בואו נראה את הדבר הזה קורה אתם רואים דאטה