cargo run -- --port 8080

运行二进制文件

要运行二进制文件，请确保您已执行构建步骤，然后运行此命令

./target/debug/cedar-agent

要检查可以向二进制文件传递的参数，请运行

./target/debug/cedar-agent --help

使用docker运行

要执行Cedar Agent的Docker镜像，请使用以下命令：

docker run -p 8180:8180 permitio/cedar-agent

测试

要测试Cedar-Agent，请使用以下命令：

cargo test

API端点

运行Cedar-Agent后，应用程序提供了使用Rapidoc和Swagger UI的全面API文档和端点模式，您可以通过以下路径访问：

• https://127.0.0.1:8180/rapidoc：在您的网络浏览器中访问此路径，以探索由Rapidoc工具提供的交互式API文档。它提供了每个端点的详细信息，包括它们的参数、请求体和响应结构。
• https://127.0.0.1:8180/swagger-ui：访问此路径以与Swagger UI交互，它提供了一个用户友好的界面来浏览API端点。它展示了可用路由的视觉表示，包括它们的描述、请求和响应模式以及示例请求。

快速入门

1. 运行Cedar Agent

2. 使用此命令存储模式

   curl -X PUT -H "Content-Type: application/json" -d @./examples/schema.json https://127.0.0.1:8180/v1/schema
   

3. 使用此命令存储策略

   curl -X PUT -H "Content-Type: application/json" -d @./examples/policies.json https://127.0.0.1:8180/v1/policies
   

4. 使用此命令存储数据

   curl -X PUT -H "Content-Type: application/json" -d @./examples/data.json https://127.0.0.1:8180/v1/data
   

5. 使用此命令执行IsAuthorized检查

   curl -X POST -H "Content-Type: application/json" -d @./examples/allowed_authorization_query.json https://127.0.0.1:8180/v1/is_authorized
   

   响应是

   {
     "decision": "Allow",
     "diagnostics": {
       "reason": [
         "admins-policy"
       ],
       "errors": []
     }
   }
   

   如您所见，用户被允许访问资源，因为策略ID admins-policy 允许。
   检查不允许访问资源的用户

   curl -X POST -H "Content-Type: application/json" -d @./examples/denied_authorization_query.json https://127.0.0.1:8180/v1/is_authorized
   

   响应是

   {
   "decision": "Deny",
   "diagnostics": {
     "reason": [],
     "errors": []
     }
   }
   

   如您所见，用户被拒绝访问资源，因为没有策略允许此请求。

有关执行请求的更多详细信息，您可以查看示例目录

使用OPAL大规模运行Cedar-agents

想要运行多个Cedar-agents并加载您所需的数据和策略？尝试OPAL。OPAL（开放策略管理层）是Cedar-Agent的姐妹项目，已成为在规模上管理策略代理（包括OPA等）的事实标准。查看OPAL文档中的Cedar+OPAL教程。

社区

和我们谈谈Cedar Agent，或者一般性的授权 - 我们非常乐意听到您的意见 ❤️

您可以在我们的GitHub讨论中提出问题，要求添加功能到路线图，在GitHub问题中报告问题，加入我们的Slack社区讨论授权、开源、实时通信、技术或任何其他内容！

如果您正在使用我们的项目，请考虑给我们一个⭐️

贡献

如果您遇到任何问题或对改进有建议，请在我们Cedar-Agent GitHub存储库中打开一个问题，以获得社区的帮助。

• 欢迎拉取请求！（请确保包括通过测试和文档）
• 在提交PR之前 - 在GitHub上打开一个问题，或者确保您的PR很好地解决了现有问题。