biscuit

概览

版本

构建

您可以使用 pig build 命令构建 pg_biscuit 扩展的 RPM / DEB 包：

pig build pkg pg_biscuit         # 构建 RPM / DEB 包

安装

您可以直接安装 pg_biscuit 扩展包的预置二进制包，首先确保 PGDG 和 PIGSTY 仓库已经添加并启用：

pig repo add pgsql -u          # 添加仓库并更新缓存

使用 pig 或者是 apt/yum/dnf 安装扩展：

• 安装
• pig
• dnf
• apt

pig install pg_biscuit;          # 当前活跃 PG 版本安装

pig ext install -y pg_biscuit -v 18  # PG 18
pig ext install -y pg_biscuit -v 17  # PG 17
pig ext install -y pg_biscuit -v 16  # PG 16

dnf install -y pg_biscuit_18       # PG 18
dnf install -y pg_biscuit_17       # PG 17
dnf install -y pg_biscuit_16       # PG 16

apt install -y postgresql-18-biscuit   # PG 18
apt install -y postgresql-17-biscuit   # PG 17
apt install -y postgresql-16-biscuit   # PG 16

创建扩展：

CREATE EXTENSION biscuit CASCADE;  -- 依赖: plpgsql

用法

GitHub: CrystallineCore/pg_biscuit

biscuit（pg_biscuit）是一个 PostgreSQL 扩展，提供类似 IAM 的模式匹配和位图索引。它使用专用位图索引实现权限风格模式与文本值的高效匹配。

功能特性

• 类 IAM 模式匹配：支持类似 AWS IAM 策略模式的通配符匹配
• 位图索引：使用位图索引加速模式匹配查询
• 权限评估：评估给定操作是否与权限模式集合匹配

快速开始

CREATE EXTENSION biscuit CASCADE;  -- 需要 plpgsql

-- 创建含权限模式的表
CREATE TABLE permissions (
  id serial PRIMARY KEY,
  pattern text NOT NULL
);

-- 插入类 IAM 模式
INSERT INTO permissions (pattern) VALUES
  ('s3:GetObject'),
  ('s3:*'),
  ('ec2:Describe*'),
  ('iam:Create*');

模式语法

Biscuit 支持 IAM 风格的通配符模式：

• * 匹配任意字符序列
• ? 匹配任意单个字符
• 精确字符串按字面匹配

说明

• 需要 plpgsql 扩展（使用 CASCADE 自动安装）
• 可用于 PostgreSQL 16、17 和 18
• MIT 许可证