---
id: 25d8ebea-a7fa-4062-ad45-0833bc52e0e5
---

# RabbitMQ User Account Lockout
---

This incident type refers to the situation when a user account in RabbitMQ messaging system is locked out and inaccessible. This could be caused by various reasons such as incorrect login attempts, system errors or security measures. The incident requires investigation to identify the root cause and unlock the affected accounts to restore proper functionality.

### Parameters
```shell
export USERNAME="PLACEHOLDER"

export NEW_PASSWORD="PLACEHOLDER"
```

## Debug

### 4. Check RabbitMQ user permissions
```shell
sudo rabbitmqctl list_user_permissions ${USERNAME}
```

### 5. Unlock RabbitMQ user account
```shell
sudo rabbitmqctl clear_password ${USERNAME}
```

### 1. Check RabbitMQ status
```shell
sudo systemctl status rabbitmq-server
```

### 2. Check RabbitMQ logs for errors
```shell
sudo journalctl -u rabbitmq-server | grep -i error
```

### 3. Check RabbitMQ user accounts
```shell
sudo rabbitmqctl list_users
```

## Repair

### Once the root cause has been identified, take steps to resolve the issue. For example, if the account was locked due to failed login attempts, reset the password or investigate any potential security breaches.
```shell


#!/bin/bash



# Set variables

USERNAME=${USERNAME}

NEW_PASSWORD=${NEW_PASSWORD}



# Reset user password

sudo rabbitmqctl change_password $USERNAME $NEW_PASSWORD



# Investigate potential security breaches

sudo rabbitmqctl list_connections | grep -i $USERNAME



# Restart RabbitMQ service

sudo systemctl restart rabbitmq-server


```

This incident type refers to the situation when a user account in RabbitMQ messaging system is locked out and inaccessible. This could be caused by various reasons such as incorrect login attempts, system errors or security measures. The incident requires investigation to identify the root cause and unlock the affected accounts to restore proper functionality.


```shell
export USERNAME="PLACEHOLDER"

export NEW_PASSWORD="PLACEHOLDER"
```


### 4. Check RabbitMQ user permissions

```shell
sudo rabbitmqctl list_user_permissions ${USERNAME}
```

### 5. Unlock RabbitMQ user account

```shell
sudo rabbitmqctl clear_password ${USERNAME}
```

### 1. Check RabbitMQ status

```shell
sudo systemctl status rabbitmq-server
```

### 2. Check RabbitMQ logs for errors

```shell
sudo journalctl -u rabbitmq-server | grep -i error
```

### 3. Check RabbitMQ user accounts

```shell
sudo rabbitmqctl list_users
```


### Once the root cause has been identified, take steps to resolve the issue. For example, if the account was locked due to failed login attempts, reset the password or investigate any potential security breaches.

```shell


#!/bin/bash



# Set variables

USERNAME=${USERNAME}

NEW_PASSWORD=${NEW_PASSWORD}



# Reset user password

sudo rabbitmqctl change_password $USERNAME $NEW_PASSWORD



# Investigate potential security breaches

sudo rabbitmqctl list_connections | grep -i $USERNAME



# Restart RabbitMQ service

sudo systemctl restart rabbitmq-server


```


RabbitMQ User Account Lockout

Overview

Parameters

Debug

4. Check RabbitMQ user permissions

5. Unlock RabbitMQ user account

1. Check RabbitMQ status

2. Check RabbitMQ logs for errors

3. Check RabbitMQ user accounts

Repair

Learn more

Related Runbooks

Support