Announcement

**networkdude** · 12-04-2022, 03:47 PM

Đăng nhập và xác thực bằng Python code

Chúng ta sẽ xây dựng các hàm và class trong Python để đăng nhập và xác thực, lợi thế của việc sử dụng hàm và class là việc tái sử dụng được code.

Xây dựng hàm authentication
Bước 1: Đầu tiên bạn cần xác định api endpoint cần trỏ đến, https://{{vmanage}} và sau đó đến phần resource /j_security_check. Giá trị đó sẽ được lưu trong một biến riêng biệt:

Biến base_url_str được dùng để chưa vManage endpoint ở định dạng chuỗi (string)
Biến login_action chứa địa chỉ resource login

Bước 2: Chỉ định username và password trong một biến khác tên là login_data, cả 2 được lưu dưới dạng cặp key value hay còn gọi là dictionary trong Python.
Tổng kết chúng ta có 3 biến được định nghĩa:

**networkdude** · 12-04-2022, 03:48 PM

Kết quả trả về khi khai báo sai password và login thất bại:

GET requests trong Python

Phần này sẽ xây dựng một hàm tên get_request() gọi dữ liệu từ vManage REST API. Hàm sẽ nhận vào 2 tham số đó là địa chỉ ip của vManage và resource để trỏ đến data muốn lấy. phần resource đó sẽ được đặt trong tham số tên mount_point.
Bước 1: Định nghĩa URL

url = f'https://{vmanage_ip}/dataservice/{mount_point}'

Bước 2: Sử dụng phương thức GET để thực hiện call api và lưu trữ trong biến response

response = requests.request("GET", url, verify=False)
data = response.content
return data

Bước 3: Kết hợp lại để xây dựng ra một hàm get_request() hoàn chỉnh:

def get_request(vmanage_ip, mount_point):
"""GET request"""
url = f'https://{vmanage_ip}/dataservice/{mount_point}'

response = requests.request("GET", url, verify=False)
data = response.content
return data

**networkdude** · 12-04-2022, 03:52 PM

POST requests trong Python

Tạo một hàm post_request(), hàm này sẽ nhận vào những tham số sau:

Địa chỉ ip vManage
Resource để gọi API
Payload
Phần Content-Type ở phần header được thực thi dưới dạng application/json

Bước 1: Định nghĩa URL

url = f'https://{vmanage_ip}/dataservice/{mount_point}'

Bước 2: Payload data sẽ được gửi đi cùng với request được lấy tự tham số đầu vào của hàm post_requests()

def post_request(vmanage_ip, mount_point, payload, headers={'Content-Type': 'application/json'}):
url = f'https://{vmanage_ip}/dataservice/{mount_point}'
payload = json.dumps(payload)

Bước 3: Sử dụng phương thức POST gọi api và dữ liệu trả về được lưu trữ trong biến response. Phương thức json() được sử dụng để định dạng lại dữ liệu trả về cho người dùng.

response = requests.request("POST", url, data=payload, headers=headers, verify=False)
data = response.json()
return data

Bước 4: Kết hợp lại để xây dựng ra một hàm post_request() hoàn chỉnh:

def post_request(vmanage_ip, mount_point, payload, headers={'Content-Type': 'application/json'}):
"""POST request"""
url = f'https://{vmanage_ip}/dataservice/{mount_point}'
payload = json.dumps(payload)

response = requests.request("POST", url, data=payload, headers=headers, verify=False)
data = response.json()
return data

**networkdude** · 12-04-2022, 03:53 PM

Xấy dựng rest_api_lib Python class

Chúng ta đã xậy dựng được 3 hàm để có thể tái sử dụng lại khi tương tác với vManage REST API:

login()
get_request()
post_request()

Trong phần này chúng ta sẽ tạo ra class đầu tiên trong chương trình
Class trong Python được định nghĩa cho một đối tượng bao gồm một tập các attributes (thuộc tính) đặc trưng cho tất cả các đối tượng của lớp. Attributes gồm: data members và methods được gọi thông qua ký hiệu dấu chấm.
Hàm __init __ là method đặc biệt, gọi là constructor. Hàm này được Python tự động gọi khi một instance mới được tạo ra. Self đại diện cho một instance của một class, bạn có thể truy cập các thuộc tính và các phương thức của class thông qua self.

**networkdude** · 12-04-2022, 03:56 PM

Thực hiện:
Bạn sẽ khởi tạo phương thức __init__ cùng với các thuộc tính cho địa chỉ ip vManage, một dict rỗng được tạo ra dành cho REST API session và sẽ được khởi tạo ở hàm login.
Tiếp theo, bạn cần định nghĩa các phương thức của class rest_api_lib. Bạn có thể sử dụng lại các hàm đã được định nghĩa ở phần trước login(), get_request(), post_request().
Bạn sẽ cần phải chỉnh sửa lại các hàm đó để có thể ghép vào class. Mỗi phương thức trong Python class cần có tham số self được truyền vào input. Bạn cũng cần phải lưu giữ lại giá trị session để có thể sử dụng nó cho các phương thức sau của class.
Sau khi đã kết hợp tất cả các hàm cũng như tham số, ta sẽ có được class rest_api_lib như sau:

class rest_api_lib:
def __init__(self, vmanage_ip, username, password):
self.vmanage_ip = vmanage_ip
self.session = {}
self.login(self.vmanage_ip, username, password)

def login(self, vmanage_ip, username, password):
"""Login to vmanage"""
base_url_str = f'https://{vmanage_ip}/dataservice/{mount_point}'

login_action = '/j_security_check'

#Format data for loginForm
login_data = {'j_username' : username, 'j_password' : password}

#Url for posting login data
login_url = base_url_str + login_action
url = base_url_str + login_url

sess = requests.session()
#If the vmanage has a certificate signed by a trusted authority change verify to True
login_response = sess.post(url=login_url, data=login_data, verify=False)

if b'<html>' in login_response.content:
print ("Login Failed")
sys.exit(0)

self.session[vmanage_ip] = sess

def get_request(self, mount_point):
"""GET request"""
url = f'https://{self.vmanage_ip}/dataservice/{mount_point}'
#print url
response = self.session[self.vmanage_ip].get(url, verify=False)
data = response.content
return data

def post_request(self, mount_point, payload, headers={'Content-Type': 'application/json'}):
"""POST request"""
url = f'https://{self.vmanage_ip}/dataservice/{mount_point}'

payload = json.dumps(payload)
print (payload)

response = self.session[self.vmanage_ip].post(url=url, data=payload, headers=headers, verify=False)
data = response.json()
return data

Announcement

Lab: Sử dụng python để tương tác với cisco sd-wan api

Lab: Sử dụng python để tương tác với cisco sd-wan api

Comment

Comment

Comment

Comment

Comment