跳到主要内容
版本：4.x

CREATE AUTHENTICATION INTEGRATION

描述​

CREATE AUTHENTICATION INTEGRATION 语句用于创建认证集成。认证集成指定 Doris 使用的认证插件及其配置。

版本支持

该功能自 SelectDB Enterprise 4.1.4 起支持。

语法​

CREATE AUTHENTICATION INTEGRATION [IF NOT EXISTS] <integration_name>
PROPERTIES (
    'type' = '<authentication_type>'
    [, '<property_key>' = '<property_value>' ...]
)
[COMMENT '<comment>'];

必选参数​

1. <integration_name>

指定认证集成名称。后续可以通过该名称修改或删除认证集成，也可以将角色映射绑定到该认证集成。

2. PROPERTIES (...)

以键值对形式指定认证集成属性。其中，type 用于指定认证插件类型，例如 oidc；其他属性由对应的认证插件定义。

可选参数​

1. IF NOT EXISTS

如果同名认证集成已存在，不返回错误。

2. COMMENT '<comment>'

指定认证集成的注释。

权限控制​

执行此 SQL 命令的用户必须至少具有以下权限：

权限对象说明
ADMIN_PRIV用户（User）或角色（Role）只有拥有该权限的用户或角色才能执行此操作。

注意事项​

  • type 是必填属性，并且不能在同一个 PROPERTIES 子句中重复定义。
  • 该语句仅创建认证插件的配置实例，不负责安装插件。执行前需要确保当前部署已提供对应的认证插件。
  • 创建后不能通过 ALTER AUTHENTICATION INTEGRATION 修改 type。如需切换认证插件类型，请删除并重新创建认证集成。
  • 除 type 外的属性由对应认证插件解释，并在加载或使用认证集成时进行校验。

示例​

  • 创建 OIDC 认证集成：
CREATE AUTHENTICATION INTEGRATION corp_oidc
PROPERTIES (
    'type' = 'oidc',
    'oidc.issuer' = 'https://idp.example.com/realms/doris',
    'oidc.jwks_uri' = 'https://idp.example.com/realms/doris/protocol/openid-connect/certs',
    'oidc.allowed_audiences' = 'doris'
)
COMMENT '公司 OIDC 认证系统';

相关文档​