Apache CouchDB peruser 指南

Apache CouchDB peruser 指南

couchdb-peruserMirror of Apache CouchDB peruser项目地址:https://gitcode.com/gh_mirrors/co/couchdb-peruser

项目介绍

Apache CouchDB peruser 是一个针对Apache CouchDB设计的守护进程，其核心功能是确保为每一个 _users 数据库中的用户文档创建一个私有的、按用户划分的数据库。这些数据库仅供对应用户写入，其命名遵循 userdb- 加上用户名称的UTF-8编码十六进制形式的规则，例如用户“bob”的数据库名为 userdb-626f62。此项目通过增强CouchDB的安全模型，使得数据访问更加粒度化和安全。

项目快速启动

要快速启动并使用 apache/couchdb-peruser，您首先需确保已经安装了Apache CouchDB。接下来，遵循以下步骤：

步骤一：配置CouchDB

编辑CouchDB的配置文件（通常位于 /etc/couchdb/local.ini），加入或修改以下设置以启用peruser插件：

[couch_peruser]
enable = true
delete_dbs = false

请注意，这将开启每个用户的私人数据库特性，并且当用户被删除时不会自动删除对应的数据库（除非您设置 delete_dbs = true）。

步骤二：重启CouchDB服务

执行以下命令来重启CouchDB确保配置生效：

sudo systemctl restart couchdb

或者如果您使用的是其他服务管理工具，相应地操作。

步骤三：验证插件工作

创建一个新的用户来测试，可以通过CouchDB的HTTP API进行：

curl -X PUT "http://localhost:5984/_users/org.couchdb.user:bob" \
     -H "Content-Type: application/json" \
     -d '{"name":"bob","password":"secret","roles":[],"type":"user"}'

然后，检查该用户是否自动拥有了相应的私人数据库：

curl http://localhost:5984/_all_dbs

在响应中应能看到类似userdb-626f62的数据库名。

应用案例和最佳实践

用户特定的数据隔离

此插件特别适用于需要严格用户数据隔离的应用场景，比如SaaS产品。每个用户的数据都存储在他们自己的数据库中，增加了安全性，并简化了权限管理。

单点登录集成

结合JWT（JSON Web Tokens）进行身份验证，可以实现基于角色的访问控制，使单点登录（SSO）集成更为流畅，确保每个用户通过合法的身份认证后，仅能访问自己对应的数据库。

典型生态项目

虽然这个指南专注于CouchDB peruser本身，但它通常与其他前端框架或Node.js后端服务搭配使用，以构建全栈应用程序。例如，在基于React或Vue的前端应用中，可以利用CouchDB的PouchDB客户端库与CouchDB进行无缝交互，特别是在离线优先的Web应用中，利用CouchDB的复制功能，保持用户数据的一致性和可用性。

---

此文档提供了快速上手Apache CouchDB peruser的基本步骤，以及一些应用思路。实际部署时，根据您的具体需求调整配置，并参考CouchDB和peruser的官方文档深入学习。

couchdb-peruserMirror of Apache CouchDB peruser项目地址:https://gitcode.com/gh_mirrors/co/couchdb-peruser