「本文已参与好文召集令活动，点击查看：后端、大前端双赛道投稿，2万元奖池等你挑战！」

前言

通常，我们的接口都是需要认证后才能可以访问的，前面我们介绍了 token 的生成和校验，那在 FastApi 中怎么设计需要认证的接口呢？

定义令牌对象

oauth2_scheme = OAuth2PasswordBearer(tokenUrl="/token/")

以上/token/为获取 token 的 URI，具体内容如下：

class Token(BaseModel):
    access_token: str
    token_type: str

@app.post('/token/',response_model=Token)
async def get_token(response:Response,form_data: OAuth2PasswordRequestForm = Depends()):
    if form_data.username=='phyger' and form_data.password=='phyger666':
        response.headers['access_token']=create_token()
        return {"access_token":create_token(),"token_type":"bearer"}

/token/可以返回指定格式的令牌信息。

定义需要认证的接口

@app.get('/format/{name}')
async def fmt(name,token=Depends(oauth2_scheme)):
    print(token)
    print(type(name))
    new_name = name.title()
    return {'result':new_name}

直接访问此接口

如上，直接访问会提示未认证，这样，我们已经达到了目的，但是怎么样才能实现准确无误的认证呢？

带上 bearer token 试试

你会发现，我们携带的错误的 token 也能成功，这是为什么呢？

因为在接口中，我们通过 oauth2_scheme 拿到了 token，这个 token 是标准的 bearer 格式，但是我们没有对其进行校验，所以只要格式正确，接口都能正常返回。

使用错误的 bearer 格式

如上，使用错误的 bearer 格式的 token，就无法访问接口了。

获取和校验 token

思路：通过上面的代码，我们将获取 token，校验 token 封装成一个静态方法，在需要认证的接口中对这个方法进行依赖即可。

封装的接口

from utm import judge_token

def login_required(token=Depends(oauth2_scheme)):
    credentials_exception = HTTPException(
        status_code=status.HTTP_401_UNAUTHORIZED,
        detail="认证失败！",
        headers={"WWW-Authenticate": "Bearer"},
    )

    if judge_token(token=token):
        return True
    else:
        raise credentials_exception

需要认证的接口

@app.get('/format/{name}')
async def fmt(name,token=Depends(login_required)):
    print(token)
    print(type(name))
    new_name = name.title()
    return {'result':new_name}

直接访问/format/{name}接口

提示：未认证！

携带过期的 token 访问

提示：认证失败！

使用错误 bearer 格式