អត្ថបទនេះបកប្រែពីភាសាអង់គ្លេសដោយ AI។ អានអត្ថបទដើមជាភាសាអង់គ្លេស →
ការផ្ទៀងផ្ទាត់ JWT ជាមួយ Flask៖ បង្កើត Banking API ប្រកបដោយសុវត្ថិភាពជាមួយ Python (មាន Login, Role និងតេស្តរួចរាល់)
មេរៀន JWT ភាគច្រើនបញ្ចប់ត្រឹមតែ «នេះជា token របស់អ្នក»។ ប៉ុន្តែ token តែមួយមុខ មិនអាចការពារអ្វីបានឡើយ។ ចន្លោះប្រហោងសុវត្ថិភាពពិតប្រាកដកើតឡើងនៅជំហានបន្ទាប់ គឺនៅពេលដែលអតិថិជន login ចូលរួចហើយ បែរជាអាចចូលមើលគណនីធនាគាររបស់ អ្នកដទៃ បាន ដោយគ្រាន់តែប្តូរលេខសម្គាល់ ID។
នៅក្នុងមេរៀននេះ យើងនឹងបង្កើត banking REST API ខ្នាតតូចមួយជាមួយ Flask, Flask-JWT-Extended និង SQLite ហើយយើងនឹងតេស្តគ្រប់ករណីទាំងអស់ ទាំងករណីដំណើរការជោគជ័យ និងករណីមានបញ្ហា៖
- ការ hash ពាក្យសម្ងាត់ប្រកបដោយសុវត្ថិភាព
- ការ login ដែលផ្តល់ JWT access token ត្រឡប់មកវិញ
- route ដែលការពារដោយ Bearer token
- ការញែកទិន្នន័យអតិថិជនដាច់ពីគ្នា (customer data isolation)៖ អ្នកអាចមើលឃើញតែគណនីផ្ទាល់ខ្លួនរបស់អ្នកប៉ុណ្ណោះ
- endpoint សម្រាប់តែ admin ប៉ុណ្ណោះ
- ការតេស្តលើ Postman រួមទាំងការតេស្តស្វ័យប្រវត្តិចំនួន 7 ផ្សេងទៀត
▶ WATCH ON YOUTUBEWatch the video
ទំព័រគម្រោង៖ https://github.com/rainyreaksmey/python-jwt-authentication-api
កូដខាងក្រោមត្រូវបានសម្រួលឱ្យងាយយល់ ដើម្បីបង្ហាញគំនិតសំខាន់ៗឱ្យបានច្បាស់។ ចំណែកក្នុងវីដេអូវិញ គឺមានការសរសេរកូដជាក់ស្តែងមួយជួរម្តងៗនៅលើអេក្រង់។
បញ្ជី Endpoint
GET /api/health៖ បើកចំហ (public)POST /api/auth/login៖ បើកចំហ (public)GET /api/me៖ ត្រូវការ JWTGET /api/accounts៖ ត្រូវការ JWTGET /api/transactions៖ ត្រូវការ JWTGET /api/admin/users៖ ត្រូវការ JWT របស់ admin
1. ការដំឡើង និងការកំណត់
python3 -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt # Flask, Flask-JWT-Extended, python-dotenv
cp .env.example .envហ្វាល់ .env ផ្ទុក secret key វែងមួយសម្រាប់ JWT, អាយុកាល token រយៈពេល 30 នាទី និងទីតាំងផ្លូវ (path) របស់ SQLite។ សូមកុំ commit secret ពិតប្រាកដដែលប្រើក្នុង production ទៅកាន់ Git ឱ្យសោះ។
2. មូលដ្ឋានទិន្នន័យ (Database)៖ កុំរក្សាទុកពាក្យសម្ងាត់ចំៗ និងកុំទុកទិន្នន័យលុយជា float
តារាងទាំងបីរួមមាន៖
- users៖ ឈ្មោះគណនី (username) មិនជាន់គ្នា, password hash, ឈ្មោះពេញ និងតួនាទី (role) កំណត់ត្រឹម
customerឬadmin - accounts៖ គណនីនីមួយៗជារបស់ user ម្នាក់ តាមរយៈ
owner_id - transactions៖ ប្រតិបត្តិការនីមួយៗជារបស់គណនីមួយ
ចំណុចសំខាន់ពីរក្នុងការរៀបចំគឺ៖
- មិនត្រូវរក្សាទុកពាក្យសម្ងាត់ផ្ទាល់ឡើយ គឺទុកតែតម្លៃ hash របស់វាប៉ុណ្ណោះ។
- ចំនួនទឹកប្រាក់ត្រូវបានរក្សាទុកជាចំនួនគត់សេន (integer cents)។ នៅក្នុង floating point ផលបូក
0.1 + 0.2មិនស្មើនឹង0.3នោះទេ ហើយអ្នកច្បាស់ជាមិនចង់ឱ្យរឿងនេះកើតឡើងលើសមតុល្យលុយក្នុងធនាគារឡើយ។
រាល់ query ទាំងអស់ប្រើ parameterized SQL (ប្រើសញ្ញា ? ជា placeholder) ដូច្នេះទិន្នន័យនឹងមិនលាយឡំចូលក្នុងអត្ថបទ query ឡើយ។ វិធីនេះហើយដែលជួយទប់ស្កាត់ការវាយប្រហារបែប SQL injection បានទាំងស្រុង។
3. ការ hash ពាក្យសម្ងាត់ជាមួយ Werkzeug
from werkzeug.security import generate_password_hash, check_password_hash
hash_ = generate_password_hash("RainyDemo123!") # stored in the database
check_password_hash(hash_, submitted_password) # True or False at loginដំណើរការគ្រប់គ្រងពាក្យសម្ងាត់ទាំងមូលមានតែប៉ុណ្ណឹងឯង។ ការបញ្ចូលទិន្នន័យដំបូង (seeding) គឺរក្សាទុកតែ hash ប៉ុណ្ណោះ។ ពេល login វិញ យើងផ្ទៀងផ្ទាត់ដោយសុវត្ថិភាពជាមួយ check_password_hash។ យើងមិនដែល decrypt ឬទាញយកពាក្យសម្ងាត់ដើមដែលបានរក្សាទុកមកវិញនោះទេ ព្រោះថា hash មិនអាច decrypt បានឡើយ។
4. Endpoint សម្រាប់ Login
@app.post("/api/auth/login")
def login():
data = request.get_json(silent=True) or {}
username = str(data.get("username", "")).strip()
password = data.get("password", "")
if not username or not password:
return {"error": "username and password are required"}, 400
user = db().execute("SELECT * FROM users WHERE username = ?", (username,)).fetchone()
if user is None or not check_password_hash(user["password_hash"], password):
return {"error": "invalid_credentials", "message": "Invalid username or password"}, 401
token = create_access_token(identity=str(user["id"]), additional_claims={"role": user["role"]})
return {"access_token": token, "token_type": "Bearer", "expires_in": 1800, "user": safe(user)}សូមកត់សម្គាល់ចំណុចសុវត្ថិភាពត្រង់នេះ៖ ទោះជាវាយ username ខុស ឬ password ខុស ក៏ប្រព័ន្ធឆ្លើយតបសារដូចគ្នាទាំងស្រុងដែរ។ ប្រសិនបើវាបង្ហាញ error ខុសគ្នា អ្នកវាយប្រហារ (attacker) អាចនឹងដឹងថា username ណាខ្លះមាននៅក្នុងប្រព័ន្ធ។
អត្តសញ្ញាណ (identity) របស់ token គឺប្រើ user ID ចំណែក role ត្រូវបានដាក់បញ្ចូលជា claim មួយ។ ឯការឆ្លើយតប (response) វិញ គឺមិនដែលបញ្ចេញ password hash មកក្រៅជាដាច់ខាត។
5. Route ដែលមានការការពារ
@app.get("/api/me")
@jwt_required()
def me():
user_id = int(get_jwt_identity())
return {"user": safe(load_user(user_id))}@jwt_required() នឹងបដិសេធ token ដែលបាត់ ទម្រង់មិនត្រឹមត្រូវ ឬផុតកំណត់ មុនពេល function របស់អ្នកដំណើរការទៅទៀត។ ខាង client ត្រូវផ្ញើ token មកតាមរយៈ header៖
Authorization: Bearer <access_token>6. ការកំណត់សិទ្ធិ (Authorization)៖ ចំណុចដែលមេរៀនភាគច្រើនរំលង
ការ login ចូលបានជោគជ័យ មិនមែនមានន័យថាអ្នកអាចមើលឃើញអ្វីៗគ្រប់យ៉ាងនោះទេ។ ចំពោះគណនី (accounts) admin អាចទាញយកទិន្នន័យតាម query គោលបាន ប៉ុន្តែសម្រាប់ customer គឺត្រូវបន្ថែមលក្ខខណ្ឌមួយទៀត៖
query = "SELECT * FROM accounts"
params = []
if user["role"] != "admin":
query += " WHERE owner_id = ?"
params.append(user["id"])ការត្រួតពិនិត្យសិទ្ធិ (authorization) ត្រូវបានធ្វើឡើងនៅក្នុង database query លើ server ផ្ទាល់តែម្តង។ ដូច្នេះអតិថិជន Rainy មិនអាចលួចមើលគណនីរបស់ Sokha បានឡើយ ទោះបីជាព្យាយាមកែប្រែអ្វីមួយនៅលើ client ក៏ដោយ។ លក្ខខណ្ឌម្ចាស់គណនី (owner) នេះក៏ត្រូវបានយកទៅអនុវត្តលើប្រតិបត្តិការ (transactions) ដូចគ្នាដែរ ដោយរួមបញ្ចូលជាមួយ filter account_number បន្ថែម និង limit ដែលត្រូវស្ថិតនៅចន្លោះពី 1 ដល់ 100 ដោយរៀបពីថ្មីបំផុតមកមុន។
ចំណែក endpoint របស់ admin វិញ គឺពិនិត្យលើ role ដែលបានរក្សាទុក៖
if user["role"] != "admin":
return {"error": "forbidden", "message": "Administrator access required"}, 4037. លទ្ធផលតេស្តជាក់ស្តែង (Postman)
គ្រប់ request ខាងក្រោមនេះត្រូវបានដំណើរការបង្ហាញនៅលើអេក្រង់ ធៀបនឹង local server លើ port 5000៖
GET /api/healthមិនប្រើ token → 200,status: ok- Login ដោយប្រើពាក្យសម្ងាត់ខុស → 401 invalid credentials មិនមាន token ហើយមិនបង្ហាញតម្រុយអ្វីឱ្យដឹងថា username នោះមានឬអត់ឡើយ
- Login ដោយប្រើពាក្យសម្ងាត់ត្រឹមត្រូវ → 200, ទទួលបាន token ដែលមានចុះហត្ថលេខា (signed token), ប្រភេទ
Bearer, មានអាយុកាល 1,800 វិនាទី និង profile របស់ Rainy ជា customer GET /api/meជាមួយ token → 200, បង្ហាញព័ត៌មាន Rainy ជាមួយ role ជា customerGET /api/accounts→ 200, បង្ហាញតែគណនី everyday និង savings របស់ Rainy ប៉ុណ្ណោះ។ គណនីរបស់ Sokha ត្រូវបានផាត់ចេញ បើទោះបីជានៅក្នុង database តែមួយក៏ដោយ។GET /api/transactions?limit=…→ 200, បង្ហាញតែប្រតិបត្តិការរបស់ Rainy ប៉ុណ្ណោះGET /api/accountsដោយមិនមាន token → 401 ហើយប្រព័ន្ធមិនដំណើរការ query ទិន្នន័យដែលការពារនោះឡើយGET /api/admin/usersជាមួយ token ត្រឹមត្រូវរបស់ Rainy ដែលជា customer → 403។ Token ត្រឹមត្រូវពិតមែន ប៉ុន្តែ role មិនមានសិទ្ធិឡើយ។- Login ជា admin រួចហៅ
GET /api/admin/users→ 200, បង្ហាញ user ទាំងបីនាក់ ហើយនៅតែមិនបង្ហាញ password hash ដដែល
ភាពខុសគ្នារវាង 401 និង 403 នេះហើយជាចំណុចគន្លឹះនៃមេរៀនទាំងមូល៖
- 401 Unauthorized៖ យើងមិនដឹងថាអ្នកជានរណាឡើយ (មិនមាន token ឬប្រើ token ខុស)។
- 403 Forbidden៖ យើងដឹងច្បាស់ថាអ្នកជានរណា ប៉ុន្តែអ្នកគ្មានសិទ្ធិចូលមើលឡើយ។
8. ការតេស្តស្វ័យប្រវត្តិ (Automated Tests)
python -m unittest discover -s tests -vការតេស្តទាំង 7 ដំណើរការជោគជ័យទាំងអស់៖ health check, ការ login ជោគជ័យ, ការបដិសេធពាក្យសម្ងាត់ខុស, ការបដិសេធនៅពេលគ្មាន token, ការញែកទិន្នន័យអតិថិជនដាច់ពីគ្នា, ការហាមឃាត់ការចូលប្រើរបស់ customer និងសិទ្ធិចូលប្រើរបស់ admin។ ការតេស្តទាំងនេះប្រើ database បណ្តោះអាសន្នរបស់ SQLite និង JWT secret ដាច់ដោយឡែក ដូច្នេះវាមិនប៉ះពាល់ដល់ទិន្នន័យមេរៀនរបស់អ្នកឡើយ។
មុនពេលដាក់ឱ្យដំណើរការជាក់ស្តែង
- ប្តូរ JWT secret និងព័ត៌មាន login សាកល្បង (demo credentials) ទាំងអស់ចេញ។
- ប្រើ HTTPS។
- កំណត់អាយុកាល access token ឱ្យខ្លី ហើយបន្ថែមមុខងារលុបចោល refresh-token (revocation) នៅពេលចាំបាច់។
- ដំណើរការលើ production server ពិតប្រាកដ កុំប្រើ development server របស់ Flask ឱ្យសោះ។
- ពិនិត្យការអនុញ្ញាតសិទ្ធិ (authorization) លើ server សម្រាប់រាល់ resource ដែលត្រូវបានការពារ កុំពឹងផ្អែកតែលើ UI តែមួយមុខ។
សង្ខេបឡើងវិញ
- ធ្វើ hash ពាក្យសម្ងាត់ (Werkzeug) និងរក្សាទុកទិន្នន័យលុយជា integer cents។
- ប្រើ parameterized SQL នៅគ្រប់ទីកន្លែង។
- Login ត្រូវបញ្ចេញ error ដូចគ្នា ទោះជាខុស username ឬខុស password ក៏ដោយ។
@jwt_required()ទទួលខុសត្រូវលើ ការផ្ទៀងផ្ទាត់អត្តសញ្ញាណ (authentication)។- លក្ខខណ្ឌម្ចាស់ (owner) ក្នុង SQL និងការពិនិត្យ role ទទួលខុសត្រូវលើ ការអនុញ្ញាតសិទ្ធិ (authorization)។
- ត្រូវតេស្តគ្រប់ករណីដែលមានបញ្ហា (failure paths) មិនមែនតេស្តតែករណីជោគជ័យ (happy path) មួយមុខនោះទេ។
▶ WATCH ON YOUTUBEវីដេអូពេញលេញដែលមានការតេស្តគ្រប់ request ទាំងអស់លើ Postman៖
បើអ្នកប្រើ FastAPI វិញ? ខ្ញុំបានបង្កើតគំនិតដូចគ្នានេះក្នុងហ្វាល់មួយដែលមានត្រឹមតែ 118 បន្ទាត់នៅទីនេះ៖ https://rainytech.hashnode.dev/fastapi-jwt-authentication-in-2026-a-complete-login-api-in-one-file-argon2-pyjwt-tested
រៀបរៀងឡើងដោយមានជំនួយពី AI។ កូដ និងលេខទិន្នន័យទាំងអស់បានមកពីការដំណើរការតេស្តជាក់ស្តែង។ ខ្ញុំធ្វើមេរៀនបង្រៀនអំពី AI ការសរសេរកូដ និងបច្ចេកវិទ្យានៅលើ RainyTech។


