python api接口 安全_Python|fastapi之隐藏docs(安全初探)(三)

fastapi开发api确实fast.东西开发完了,前后端调试也方便,要上线了,怎么保证接口文档不被非法访问呢?简单想了几个场景

内网部署

将swagger的入口监听在内网,域名访问的话,也直接解析成内网,外网不能访问也是个不错的选择.

直接关闭

这招算是釜底抽薪了,直接关门,咱都不访问.算是最简单有效的办法.

代码

app = FastAPI(

docs_url=None,

redoc_url=None

)

动态开关

默认关闭,确实有需要查看,临时打开,用完关闭,也是个不错的选择.

原理就是:访问/docs时,默认没有,通过另一个接口临时调整一个参数,这时才允许访问.

主要代码

app = FastAPI(

docs_url=None,

redoc_url=None

)

@app.get('/add_docs')

def show_docs_by_manager():

logger.info(app.docs_url)

msg = 'ok'

if app.docs_url is None:

app.docs_url = '/docs'

msg = 'docs is open !'

else:

app.docs_url = None

msg = 'docs is disabled !'

logger.info(app.docs_url)

return response_struct(msg=msg)

  • 0
    点赞
  • 3
    收藏
    觉得还不错? 一键收藏
  • 0
    评论
生成 Django API 接口文档一般可以通过以下步骤实现: 1. 安装 Django-rest-swagger 可以通过 pip 安装 Django-rest-swagger: ``` pip install django-rest-swagger ``` 2. 添加 Django-rest-swagger 到 INSTALLED_APPS 在 settings.py 文件中添加 Django-rest-swagger 到 INSTALLED_APPS: ```python INSTALLED_APPS = [ ... 'rest_framework', 'rest_framework_swagger', ... ] ``` 3. 添加 Django-rest-swagger 的 URL 到项目的 URL 配置文件 在项目的 URL 配置文件(例如 urls.py)中添加 Django-rest-swagger 的 URL: ```python from rest_framework_swagger.views import get_swagger_view schema_view = get_swagger_view(title='API 文档') urlpatterns = [ ... url(r'^docs/$', schema_view), ... ] ``` 4. 添加 API 文档注释 在 API 视图函数中,添加类似以下的注释,用于生成 API 文档: ```python from rest_framework.decorators import api_view, schema from rest_framework.response import Response from rest_framework.schemas import AutoSchema @api_view(['GET']) @schema(AutoSchema(manual_fields=[ coreapi.Field(name="param1", required=True, location='query', schema=coreschema.Integer()), coreapi.Field(name="param2", required=True, location='query', schema=coreschema.Integer()), ])) def my_api_view(request): """ API endpoint documentation example. --- parameters: - name: param1 description: Parameter description required: true type: integer paramType: query - name: param2 description: Parameter description required: true type: integer paramType: query """ # Implementation return Response(...) ``` 5. 运行项目 运行项目后,访问 http://localhost:8000/docs/ 即可看到生成的 API 文档。 以上步骤是生成 Django API 接口文档的一种方法,也可以使用其他的工具或框架来实现。

“相关推荐”对你有帮助么?

  • 非常没帮助
  • 没帮助
  • 一般
  • 有帮助
  • 非常有帮助
提交
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值