🔒 ONES 接口前置拦截

适用环境

私有部署

能力废弃说明

此能力自2023年10月13号起已废弃。相关需求需要类似能力，请向开放平台提新的需求单。

要求

ONES
v3.16.1

概述

有时候我们需要改变 ONES 系统中某些行为的表现，在某个行为前增加一些操作，插件可以对 ONES 标准系统中所有对外开放的接口进行前置拦截。

使用

使用须知

组织级别的接口和团队级别的接口的差别在于团队级别接口的 url 中包含有 /team/:teamUUID。
对于同一个接口在其级别的上下文中，可被多个插件同时进行前置拦截。
对于同一个接口在其级别的上下文中，前置拦截跟接口劫持能力不能同时使用。
对于同一个接口在其级别的上下文中，前置拦截跟后置订阅可同时使用。
插件可对这次请求进行拒绝，并决定接口的错误返回，但无法进行其他操作。
在本地调试中，如果修改了插件配置文件config/plugin.yaml，需要运行 npx op invoke clear 并重新运行 npx op invoke run 指令才能使配置生效。

请求流程

配置文件

在插件配置文件中的 apis 字段加上以下配置：

apis:
  - type: intercept #接口类型： intercept:前置拦截
    methods: #接口请求方式
      - GET
    url: /users/me #劫持接口url
    scope: project #project或wiki接口，没有该属性则默认为project
    function: jackFunc #名称与代码里的函数名保持一致

具体代码

该示例前置拦截了 project 获取个人信息接口，代码中的headers跟body分别是原请求的请求头跟请求体

import { Logger } from '@ones-op/node-logger'

export async function jackFunc(
  request: PluginRequest<Record<string, any>>,
): Promise<PluginResponse> {
  const body = request.body as any
  const headers = request.headers as any
  Logger.info('[Plugin] hello ======= 请求成功')
  Logger.info('[Plugin] body ======= 请求成功', body)
  Logger.info('[Plugin] headers ======= 请求成功', headers)
  return {
    body: {
      res: 'hello world',
      requestBody: {},
    },
  }
}

注意事项

接口请求参数需要注意以下几点：
- 拦截的是 ONES API ，所以填写的 url 必须跟访问 ONES API 的 url 保持一致；
- 确认被拦截接口本身是 POST 请求还是 GET 请求；

调试方式

使用 curl 工具进行访问，以/users/me接口为例：

curl --location --request GET 'https://yourhost/users/me' \
--header 'Ones-User-Id: {user_uuid}' \
--header 'Ones-Auth-Token: {user_token}' \
--header 'Content-Type: application/json' \
--data ''

代码请求参数示例

url：https://yourhost/users/me
headers:
    Ones-User-Id:{user_uuid}
    Ones-Auth-Token:{user_token}
    ...
method: GET

要求​

概述​

使用​

使用须知​

请求流程​

配置文件​

具体代码​

调试方式​

要求

概述

使用

使用须知

请求流程

配置文件

具体代码

调试方式