Files
outline/server/routes/api/apiKeys/apiKeys.ts
Tom Moor a06671e8ce OAuth provider (#8884)
This PR contains the necessary work to make Outline an OAuth provider including:

- OAuth app registration
- OAuth app management
- Private / public apps (Public in cloud only)
- Full OAuth 2.0 spec compatible authentication flow
- Granular scopes
- User token management screen in settings
- Associated API endpoints for programatic access
2025-05-03 19:40:18 -04:00

122 lines
2.8 KiB
TypeScript

import Router from "koa-router";
import { WhereOptions } from "sequelize";
import { UserRole } from "@shared/types";
import auth from "@server/middlewares/authentication";
import { transaction } from "@server/middlewares/transaction";
import validate from "@server/middlewares/validate";
import { ApiKey, User } from "@server/models";
import { authorize, cannot } from "@server/policies";
import { presentApiKey } from "@server/presenters";
import { APIContext, AuthenticationType } from "@server/types";
import pagination from "../middlewares/pagination";
import * as T from "./schema";
const router = new Router();
router.post(
"apiKeys.create",
auth({
role: UserRole.Member,
type: AuthenticationType.APP,
}),
validate(T.APIKeysCreateSchema),
transaction(),
async (ctx: APIContext<T.APIKeysCreateReq>) => {
const { name, scope, expiresAt } = ctx.input.body;
const { user } = ctx.state.auth;
authorize(user, "createApiKey", user.team);
const apiKey = await ApiKey.createWithCtx(ctx, {
name,
userId: user.id,
expiresAt,
scope: scope?.map((s) => (s.startsWith("/api/") ? s : `/api/${s}`)),
});
ctx.body = {
data: presentApiKey(apiKey),
};
}
);
router.post(
"apiKeys.list",
auth({ role: UserRole.Member }),
pagination(),
validate(T.APIKeysListSchema),
async (ctx: APIContext<T.APIKeysListReq>) => {
const { userId } = ctx.input.body;
const { pagination } = ctx.state;
const actor = ctx.state.auth.user;
let where: WhereOptions<User> = {
teamId: actor.teamId,
};
if (cannot(actor, "listApiKeys", actor.team)) {
where = {
...where,
id: actor.id,
};
}
if (userId) {
const user = await User.findByPk(userId);
authorize(actor, "listApiKeys", user);
where = {
...where,
id: userId,
};
}
const apiKeys = await ApiKey.findAll({
include: [
{
model: User,
required: true,
where,
},
],
order: [["createdAt", "DESC"]],
offset: pagination.offset,
limit: pagination.limit,
});
ctx.body = {
pagination,
data: apiKeys.map(presentApiKey),
};
}
);
router.post(
"apiKeys.delete",
auth({
role: UserRole.Member,
type: AuthenticationType.APP,
}),
validate(T.APIKeysDeleteSchema),
transaction(),
async (ctx: APIContext<T.APIKeysDeleteReq>) => {
const { id } = ctx.input.body;
const { user } = ctx.state.auth;
const { transaction } = ctx.state;
const key = await ApiKey.findByPk(id, {
lock: transaction.LOCK.UPDATE,
transaction,
});
authorize(user, "delete", key);
await key.destroyWithCtx(ctx);
ctx.body = {
success: true,
};
}
);
export default router;