Bài 90b: Thực hành REST API — Lấy ticket và đọc danh sách thiết bị từ Network Controller bằng Python trên Packet Tracer

⏱️ Thời lượng: 45–60 phút · 📶 Độ khó: Trung bình · 🧰 Công cụ: Cisco Packet Tracer 8.x · 📌 Cần học trước: Bài 88, Bài 89, Bài 90

Sơ đồ lab Bài 90b · ⬇️ Tải sơ đồ (SVG) · 🔍 Mở cỡ lớn

💡 Liên hệ thực tế

Sếp cần danh sách toàn bộ thiết bị mạng kèm địa chỉ quản trị, mỗi sáng. Với 5 thiết bị, bạn SSH vào từng cái là xong. Với 500 thiết bị, bạn cần một controller đã biết hết thiết bị trong mạng, và một đoạn script hỏi controller qua REST API.

Packet Tracer có sẵn một Network Controller rút gọn, mô phỏng cách các controller như Cisco Catalyst Center (DNA Center) hay APIC-EM làm việc. Trong bài này bạn cho controller khám phá mạng, rồi dùng Python trên một PC để xin ticket (token) và lấy danh sách thiết bị, host dưới dạng JSON.

Quy tắc ghi nhớ: gọi REST API = phương thức HTTP (GET/POST/PUT/DELETE) + URL + header + (body JSON). Muốn gọi API của controller, trước tiên POST tài khoản để lấy ticket, sau đó gửi ticket trong header X-Auth-Token ở mọi lời gọi tiếp theo.

🎯 Mục tiêu bài lab

• Khởi tạo Network Controller, khai báo tài khoản đăng nhập thiết bị và chạy discovery.
• Gọi API POST /api/v1/ticket để lấy ticket.
• Gọi GET /api/v1/network-device, /network-device/count, /host kèm ticket.
• Đọc cấu trúc JSON trả về; nhận biết mã trạng thái HTTP.

📋 Bảng địa chỉ và đấu nối

⚙️ Các bước thực hiện

⚠️ Network Controller trong Packet Tracer là bản mô phỏng rút gọn. Tên menu và một số trường JSON có thể khác nhẹ giữa các phiên bản — hãy dựa vào những gì phiên bản của bạn hiển thị. Bài viết theo Packet Tracer 8.x.

⚙️ Bước 1 — Dựng sơ đồ và cấu hình thiết bị

Kéo ra 1 router 2911, 1 switch 2960-24TT, 1 Network Controller (mục End Devices), 2 PC. Nối cáp, đặt IP cho NC (tab Config → GigabitEthernet0 và Settings) và hai PC. Dán cấu hình — tài khoản này để controller đăng nhập vào thiết bị:

hostname R1
enable secret class
username netadmin privilege 15 secret Net@2026
ip domain-name vnexperts.local
crypto key generate rsa general-keys modulus 1024
line vty 0 4
 login local
 transport input all
interface gigabitEthernet 0/0
 ip address 192.168.1.1 255.255.255.0
 no shutdown
interface gigabitEthernet 0/1
 ip address 192.168.2.1 255.255.255.0
 no shutdown
end

hostname SW1
enable secret class
username netadmin privilege 15 secret Net@2026
ip domain-name vnexperts.local
crypto key generate rsa general-keys modulus 1024
line vty 0 15
 login local
 transport input all
interface vlan 1
 ip address 192.168.1.2 255.255.255.0
 no shutdown
ip default-gateway 192.168.1.1
end

Kiểm tra: PC-DEV ping được 192.168.1.10, R1, SW1 và PC2. Cho PC2 ping 192.168.2.1 một lần để R1 biết tới PC2.

⚙️ Bước 2 — Khởi tạo Network Controller

1. PC-DEV → Desktop → Web Browser → http://192.168.1.10.
2. Lần đầu, NC yêu cầu tạo tài khoản quản trị: Username admin, Password và Confirm Vne@2026 → SETUP, rồi đăng nhập.
3. Vào mục Provisioning → phần Credentials: tạo một CLI credential — username netadmin, password Net@2026, enable password class.
4. Cũng trong Provisioning → Discovery → thêm discovery mới: kiểu IP Range từ 192.168.1.1 tới 192.168.1.2, chọn credential vừa tạo → lưu và chạy.
5. Đợi một lát (bấm Fast Forward Time nếu cần). Danh sách thiết bị phải có R1 và SW1 ở trạng thái kết nối được.

⚙️ Bước 3 — Xem tài liệu API

Trong giao diện NC, mở mục tài liệu API (API Docs). Tìm 3 mục bạn sắp dùng:

⚙️ Bước 4 — Xin ticket bằng Python

PC-DEV → Programming → tạo project mới, chọn ngôn ngữ Python (mẫu trống) → mở file main.py, gõ:

import requests
import json

NC = "http://192.168.1.10/api/v1"

body = {"username": "admin", "password": "Vne@2026"}
r = requests.post(NC + "/ticket", data=json.dumps(body),
                  headers={"Content-Type": "application/json"}, timeout=30)
print("Status:", r.status_code)
print(r.text)

Bấm Run. Kết quả có mã trạng thái thành công (2xx) và một JSON dạng:

{
  "response": {
    "idleTimeout": 900,
    "serviceTicket": "<chuỗi ticket>",
    "sessionTimeout": 3600
  },
  ...
}

Ticket chỉ dùng được trong một khoảng thời gian (idle 900 giây, tối đa 3600 giây). Hết hạn thì xin lại.

⚙️ Bước 5 — Gọi API lấy thiết bị và host

Thêm vào cuối main.py:

ticket = json.loads(r.text)["response"]["serviceTicket"]
hdr = {"X-Auth-Token": ticket}

r = requests.get(NC + "/network-device/count", headers=hdr, timeout=30)
print("So thiet bi:", r.text)

r = requests.get(NC + "/network-device", headers=hdr, timeout=30)
print(r.text)

r = requests.get(NC + "/host", headers=hdr, timeout=30)
print(r.text)

Chạy lại. Ba kết quả lần lượt là:

• Số thiết bị: trường response có giá trị 2 (R1, SW1).
• Danh sách thiết bị: response là một mảng, mỗi phần tử là một object mô tả một thiết bị — tìm trường chứa hostname và địa chỉ IP quản trị.
• Danh sách host: các máy đầu cuối controller biết được (ví dụ PC2, PC-DEV) kèm IP, MAC, thiết bị và cổng chúng đang nối vào.

⚙️ Bước 6 — Thử gọi API không có ticket

Thêm một dòng gọi thiếu header:

r = requests.get(NC + "/network-device", timeout=30)
print("Khong co ticket:", r.status_code)

Controller từ chối, trả về mã lỗi nhóm 4xx (thường là 401 — chưa xác thực). Đây là lý do mọi lời gọi phải kèm ticket.

🔍 Kiểm tra kết quả

🛠️ Lỗi thường gặp & cách xử lý

🏆 Thử thách mở rộng

1. Thay vì in cả JSON, sửa script để in mỗi thiết bị một dòng: hostname và IP quản trị.
2. Gọi API của Packet Tracer từ máy tính thật của bạn (curl hoặc Postman) thay vì từ PC trong Packet Tracer.

devices = json.loads(r.text)["response"]
for d in devices:
    print(d["hostname"], d["managementIpAddress"])

curl -X POST localhost:58000/api/v1/ticket -H "content-type: application/json" -d "{\"username\":\"admin\",\"password\":\"Vne@2026\"}"

💬 Hỏi & Đáp nhanh

❓ Mã trạng thái nào hay gặp?

✅ 2xx thành công (200 OK, 201 Created). 4xx lỗi phía người gọi (400 sai yêu cầu, 401 chưa xác thực, 403 không có quyền, 404 không tìm thấy). 5xx lỗi phía máy chủ (500).

❓ "Northbound API" là gì?

✅ API mà controller mở ra cho ứng dụng, script phía trên gọi vào — chính là REST API trong bài. "Southbound" là cách controller nói chuyện xuống thiết bị (ở đây là đăng nhập CLI; ngoài thực tế còn NETCONF, RESTCONF, OpenFlow…).

❓ Có phải học thuộc đoạn Python này cho đề thi?

⚠️ Không. CCNA yêu cầu hiểu REST API (phương thức, mã trạng thái, xác thực bằng token) và đọc được JSON. Viết script là để thấy tận tay các khái niệm đó.

📝 Bài tập đánh giá

Câu 1: Script cần lấy danh sách thiết bị từ controller. Phương thức HTTP nào phù hợp?

• A. POST
• B. GET
• C. PUT
• D. DELETE

Câu 2: Lời gọi API trả về mã 401. Nguyên nhân khả dĩ nhất?

• A. Đường dẫn API không tồn tại
• B. Máy chủ bị lỗi nội bộ
• C. Thiếu hoặc sai token xác thực
• D. Yêu cầu thành công nhưng không có dữ liệu

👉 Đáp án

• Câu 1: B — GET dùng để đọc dữ liệu.
• Câu 2: C — A là 404, B là 500, D vẫn là 2xx.

💡 Output trong bài là output mẫu trên Packet Tracer, trên máy bạn có thể khác một chút (ví dụ địa chỉ MAC).

📚 Bài viết thuộc khóa học CCNA của VNExperts

🧭 Điều hướng