📦 Keycloak — Keycloak 集成

Keycloak 是一个开源的身份和访问管理解决方案。开发者和组织使用它来为应用程序和服务添加认证和授权功能。它处理用户登录、注册和单点登录，减少了从头构建这些功能的需要。

官方文档：https://www.keycloak.org/documentation

Keycloak 概述

• Realm
• Client
• User
• Group
• Role

根据需要使用操作名称和参数。

使用 Keycloak

此技能使用 Membrane CLI 与 Keycloak 交互。Membrane 自动处理认证和凭证刷新——因此您可以专注于集成逻辑，而不是认证流程。

安装 CLI

安装 Membrane CLI，以便您可以从终端运行 membrane：

npm install -g @membranehq/cli

首次设置

membrane login --tenant

浏览器窗口将打开以进行身份验证。

无头环境： 运行命令，将打印的 URL 复制给用户在浏览器中打开，然后使用 membrane login complete 完成。

连接到 Keycloak

• 创建新连接：

membrane search keycloak --elementType=connector --json

从 output.items[0].element?.id 获取连接器 ID，然后：

membrane connect --connectorId=CONNECTOR_ID --json

用户在浏览器中完成身份验证。输出包含新的连接 ID。

获取现有连接列表

当您不确定连接是否已存在时：

• 检查现有连接：

membrane connection list --json

如果存在 Keycloak 连接，记下其 connectionId

搜索操作

当您知道想要做什么但不知道确切的操作 ID 时：

membrane action list --intent=QUERY --connectionId=CONNECTION_ID --json

这将返回包含 id 和 inputSchema 的操作对象，这样您就知道如何运行它了。

热门操作

使用 npx @membranehq/cli@latest action list --intent=QUERY --connectionId=CONNECTION_ID --json 来发现可用的操作。

运行操作

membrane action run --connectionId=CONNECTION_ID ACTION_ID --json

传递 JSON 参数：

membrane action run --connectionId=CONNECTION_ID ACTION_ID --json --input "{ \"key\": \"value\" }"

代理请求

当可用的操作不满足您的用例时，您可以通过 Membrane 的代理直接将请求发送到 Keycloak API。Membrane 会自动将基础 URL 附加到您提供的路径，并注入正确的认证头——包括凭证过期时的透明刷新。

membrane request CONNECTION_ID /path/to/endpoint

常用选项：