RabbitMQ 启用 HTTP 后台认证

末蓝、 2022-04-10 01:25 131阅读 0赞

> RabbitMQ 安装配置和 Spring 集成  
> [https://blog.csdn.net/isea533/article/details/84545484][https_blog.csdn.net_isea533_article_details_84545484]

**本文参考资料：**

1.  [https://www.rabbitmq.com/configure.html][https_www.rabbitmq.com_configure.html]
2.  [https://www.rabbitmq.com/access-control.html][https_www.rabbitmq.com_access-control.html]
3.  [https://github.com/rabbitmq/rabbitmq-auth-backend-http][https_github.com_rabbitmq_rabbitmq-auth-backend-http]
4.  [https://github.com/rabbitmq/rabbitmq-auth-backend-cache][https_github.com_rabbitmq_rabbitmq-auth-backend-cache]

**环境：** RabbitMQ 版本为 3.7.9，操作系统为 Ubuntu 18.04 LTS

启用 HTTP 后台认证需要使用 rabbitmq\_auth\_backend\_http 插件，同时该插件还推荐配合 rabbitmq\_auth\_backend\_cache 通过缓存减轻授权认证服务器压力。

## 启用插件 ##

输入以下命令查看所有插件：

$ sudo rabbitmq-plugins list
    # 输出部分日志
     Configured: E = explicitly enabled; e = implicitly enabled
     | Status: * = running on rabbit@redissvr
     |/
    [  ] rabbitmq_amqp1_0                  3.7.9
    [  ] rabbitmq_auth_backend_cache       3.7.9
    [  ] rabbitmq_auth_backend_http        3.7.9
    [  ] rabbitmq_auth_backend_ldap        3.7.9
    [  ] rabbitmq_auth_mechanism_ssl       3.7.9
    [  ] rabbitmq_consistent_hash_exchange 3.7.9
    [  ] rabbitmq_event_exchange           3.7.9
    [  ] rabbitmq_federation               3.7.9
    [  ] rabbitmq_federation_management    3.7.9
    ...

通过下面命令分别启用这两个插件：

$ sudo rabbitmq-plugins enable rabbitmq_auth_backend_http
    
    # 和
    
    $ sudo rabbitmq-plugins enable rabbitmq_auth_backend_cache

通过 `sudo rabbitmqctl environment` 查看系统默认设置，和这两个插件相关的部分配置如下：

{rabbit,
         [{auth_backends,[rabbit_auth_backend_internal]},
          {auth_mechanisms,['PLAIN','AMQPLAIN']},
    ...
    {rabbitmq_auth_backend_cache,
         [{cache_module,rabbit_auth_cache_ets},
          {cache_module_args,[]},
          {cache_refusals,false},
          {cache_ttl,15000},
          {cached_backend,rabbit_auth_backend_internal}]},
     {rabbitmq_auth_backend_http,
         [{http_method,get},
          {resource_path,"http://localhost:8000/auth/resource"},
          {topic_path,"http://localhost:8000/auth/topic"},
          {user_path,"http://localhost:8000/auth/user"},
          {vhost_path,"http://localhost:8000/auth/vhost"}]},
    ...

下面通过添加配置文件来修改默认配置。

## 添加配置 ##

不同操作系统中配置文件默认的位置分别如下：

*  **Generic UNIX** \- `$RABBITMQ_HOME/etc/rabbitmq/`
 *  **Debian** \- `/etc/rabbitmq/`
 *  **RPM** \- `/etc/rabbitmq/`
 *  **Mac OSX (Homebrew)** \- `${install_prefix}/etc/rabbitmq/, the Homebrew prefix is usually /usr/local`
 *  **Windows** \- `%APPDATA%\RabbitMQ\`

本文 Ubuntu 配置文件在 `/etc/rabbitmq/` 目录。

默认情况下 RabbitMQ 使用的默认配置，在该目录下面并没有配置文件，需要自己手动创建。

> RabbitMQ 从 3.7.0 版本开始推荐使用 sysctl 格式的配置，但是仍然支持老版本 Erlang 语法。

不同格式的配置文件名如下：

*  rabbitmq.conf - sysctl 格式的配置文件
 *  advanced.config - Erlang 语法进行高级配置的文件，这个配置会和 rabbitmq.conf 合并使用
 *  rabbitmq.config - 老版本 Erlang 语法

在参考资料的给出的 4 个地址的文档中都给出了两种语法的配置方法，本文采用 sysctl 格式进行配置。

在配置目录新增 rabbitmq.conf 配置文件，添加如下配置：

auth_backends.1 = cache
    # 启用 cache 后，不需要直接指定 http 方式
    # auth_backends.1 = http
    auth_backends.2 = internal
    # 缓存后端指定为 http
    auth_cache.cached_backend = http
    # 认证请求类型
    auth_http.http_method   = post
    # 认证和授权地址，官方提供了 Spring Boot 示例
    # 根据需要配置下面地址
    auth_http.user_path = http://localhost:8080/auth/user
    auth_http.vhost_path = http://localhost:8080/auth/vhost
    auth_http.resource_path = http://localhost:8080/auth/resource
    auth_http.topic_path = http://localhost:8080/auth/topic
    # 缓存时间，单位毫秒
    auth_cache.cache_ttl = 60000

> **认证可选项说明：**
> 
>  *  **internal** for rabbit\_auth\_backend\_internal
>  *  **ldap** for rabbit\_auth\_backend\_ldap (from the [LDAP plugin][])
>  *  **http** for rabbit\_auth\_backend\_http (from the [HTTP auth backend plugin][https_github.com_rabbitmq_rabbitmq-auth-backend-http])
>  *  **amqp** for rabbit\_auth\_backend\_amqp (from the [AMQP 0-9-1 auth backend plugin][])
>  *  **dummy** for rabbit\_auth\_backend\_dummy

配置好后，[重启][Link 1] RabbitMQ 服务：

# 重启
    $ sudo service rabbitmq-server restart

重启后，通过 `sudo rabbitmqctl environment` 查看配置是否成功。

## 启动授权认证服务 ##

使用官方提供的示例进行测试：

[https://github.com/rabbitmq/rabbitmq-auth-backend-http/tree/master/examples/rabbitmq\_auth\_backend\_spring\_boot][https_github.com_rabbitmq_rabbitmq-auth-backend-http_tree_master_examples_rabbitmq_auth_backend_spring_boot]

可以直接从 GitHub 下载，或者从下面网盘下载单独的 Spring Boot 示例部分：

> 链接: [https://pan.baidu.com/s/1RjF-hXdYml0KHgt-wRSweQ][https_pan.baidu.com_s_1RjF-hXdYml0KHgt-wRSweQ]
> 
> 提取码: hsbt

该示例代码中提供了下面几个用户：

private final Map<String, User> users = new HashMap<String, User>() { { 
        put("guest",   new User("guest", "guest", asList("administrator", "management")));
        put("springy", new User("springy", "springy", asList("administrator", "management")));
    }};

> 上面在配置后台认证的时候，同时指定了 cache(http) 和 internal 方式，所以我们原有的账号即使在没有 http 认证服务器的情况下仍然可以登录。

guest 本身是系统默认账号，只能从 localhost 登陆。所以如果你不是 localhost 访问，可以尝试 **springy** 登陆。

通过 springy/springy 可以成功登陆，你并没有创建过该账号，但是可以登录系统。

如果你通过 HTTP 方式登陆后台，由于界面会自动刷新，你可以发现几乎间隔 60 秒就会重新进行认证，这个间隔由 `auth_cache.cache_ttl` 缓存过期时间控制。

当对队列交换机等功能进行操作时，会调用其它的 API 验证权限。

## 注意 ##

当使用 HTTP 认证成功时，会通过 HTTP 方式进行授权。如果认证失败，就会继续调用 internal 方式进行认证，internal 方式认证成功时，后续的授权也是通过 internal 方式进行。

通过那种方式认证成功，就会继续使用该方式进行授权。

[https_blog.csdn.net_isea533_article_details_84545484]: https://blog.csdn.net/isea533/article/details/84545484
[https_www.rabbitmq.com_configure.html]: https://www.rabbitmq.com/configure.html
[https_www.rabbitmq.com_access-control.html]: https://www.rabbitmq.com/access-control.html
[https_github.com_rabbitmq_rabbitmq-auth-backend-http]: https://github.com/rabbitmq/rabbitmq-auth-backend-http
[https_github.com_rabbitmq_rabbitmq-auth-backend-cache]: https://github.com/rabbitmq/rabbitmq-auth-backend-cache
[LDAP plugin]: https://www.rabbitmq.com/ldap.html
[AMQP 0-9-1 auth backend plugin]: https://github.com/rabbitmq/rabbitmq-auth-backend-amqp
[Link 1]: https://pubs.vmware.com/vfabricRabbitMQ32/index.jsp?topic=/com.vmware.vfabric.rabbitmq.3.2/getstart/install-start-server-rhel.html
[https_github.com_rabbitmq_rabbitmq-auth-backend-http_tree_master_examples_rabbitmq_auth_backend_spring_boot]: https://github.com/rabbitmq/rabbitmq-auth-backend-http/tree/master/examples/rabbitmq_auth_backend_spring_boot
[https_pan.baidu.com_s_1RjF-hXdYml0KHgt-wRSweQ]: https://pan.baidu.com/s/1RjF-hXdYml0KHgt-wRSweQ