Conas a chuireann tú fíordheimhniú i bhfeidhm (OAuth2/JWT)?

Question

Accepted Answer

Soláthraíonn FastAPI uirlisí ionsuite (`OAuth2PasswordBearer`, acmhainní slándála) chun fíordheimhniú a chur i bhfeidhm, go coitianta ag baint úsáide as **sruth fhocal-fhaire OAuth2 le tóchana JWT**. Cumasc a dhéanann an patrún ar aisgiúintí tóchana (logáil isteach) le spleáchas a fhíoraíonn an tócan ar leaganacha cosanta.

## Pasfhocail a dhreamhualadh agus JWT a aisgiúint ar logáil isteach

```python
from passlib.context import CryptContext
from jose import jwt
from datetime import datetime, timedelta

pwd = CryptContext(schemes=["bcrypt"])    # secure password hashing

@app.post("/login")
def login(form: OAuth2PasswordRequestForm = Depends()):
    user = get_user(form.username)
    if not user or not pwd.verify(form.password, user.hashed_password):  # constant-time check
        raise HTTPException(401, "Invalid credentials")
    # issue a signed JWT containing the user identity + expiry
    token = jwt.encode(
        {"sub": user.username, "exp": datetime.utcnow() + timedelta(minutes=30)},
        SECRET_KEY, algorithm="HS256",
    )
    return {"access_token": token, "token_type": "bearer"}
```

Tá pasfhocail **dramhualaithe** (bcrypt) — ní dhíoladh cothrom riamh. Ar logáil isteach bailí, **JWT** a aisgiúintear: tócan sínithe a bhfuil aithint agus faillí an úsáideora ann.

## An tócan a fhíorú ar leaganacha cosanta (spleáchas)

```python
from fastapi.security import OAuth2PasswordBearer

oauth2_scheme = OAuth2PasswordBearer(tokenUrl="login")   # extracts the Bearer token

def get_current_user(token: str = Depends(oauth2_scheme)):
    try:
        payload = jwt.decode(token, SECRET_KEY, algorithms=["HS256"])   # verify signature + expiry
        username = payload.get("sub")
    except JWTError:
        raise HTTPException(401, "Invalid token")
    user = get_user(username)
    if not user:
        raise HTTPException(401, "User not found")
    return user

@app.get("/me")
def read_me(user: User = Depends(get_current_user)):     # PROTECTED — requires a valid token
    return user
```

Baineann spleáchas `get_current_user` an JWT (síniú + faillí) agus **fíoraíonn** sé, lódálann an t-úsáideoir, agus ionsá sé ina leaganacha cosanta — éilíonn aon bhealach a bhraitheans air fíordheimhniú.

## Údarú (róil/scóip)

```python
def require_admin(user: User = Depends(get_current_user)):
    if not user.is_admin:
        raise HTTPException(403, "Forbidden")     # authorization check
    return user
# OAuth2 SCOPES provide fine-grained permission control
```

## Cén fáth a bhfuil sé tábhachtach

Tá fíordheimhniú riachtanach agus **criticiúil ó thaobh slándála** — tá gá ag beagnach gach API fíor ar leaganacha a chosaint, agus má bhíonn drochrud déanta ar auth, cruthaítear leochaileachtaí tromchúiseacha.

Tá sé tábhachtach tuiscint a bheith agat ar chur chuige FastAPI: soláthraíonn sé na bloic thógála (`OAuth2PasswordBearer`, acmhainní slándála) don phatrún caighdeánach **sruth-fhocal-fhaire-OAuth2-le-JWT**, agus bíonn sé gallánta: scaoileann pointe logála isteach tócan sínithe, agus **fíoraíonn spleáchas `get_current_user`** é, ag cosaint go geal aon bhealach a bhraitheans air (an patrún fíordheimhnithe idioimeach FastAPI).

Tá roinnt ghnéithe criticiúil le fáil ceart: **pasfhocail a dhreamhualadh** (bcrypt, ní riamh cothrom, le fíorú tráth-leanúnach), **JWTs a shíniú agus a fhíorú** i gceart (síniú + bailíochtú faillí), idirdhealú a dhéanamh idir **fíordheimhniú** (cé thú) agus **údarú** (cad is féidir leat a dhéanamh, trí sheicí róil/scóip), agus an eochair runda a choinneáil slán.

Tá eolas ar an gconas an patrún seo a chur i bhfeidhm go slán — aisgiúintí tóchana, an spleáchas bailíochtaithe, agus údarú — ina bhunfhaisnéis ar leibhéal sinsirigh chun feidhmchlár FastAPI slán a thógáil, ó tharla go bhfuil auth ina thréith choitianta agus foinse minic ar botúin danartha nuair a chuirtear i bhfeidhm go mícheartmhéar é.