AWS Security ChangesHomeSearch

AWS amazon-mq high security documentation change

Service: amazon-mq · 2026-03-04 · Security-related high

File: amazon-mq/latest/developer-guide/troubleshooting-rabbitmq.md

Summary

Added documentation section for recovering administrator access using IAM authentication and OAuth 2.0/JWT tokens

Security assessment

The change introduces recovery methods for lost administrator access using secure IAM authentication mechanisms and OAuth 2.0/JWT tokens. This directly addresses a critical security scenario where administrators lose access to broker management, which could lead to operational paralysis or unauthorized access attempts.

Diff

diff --git a/amazon-mq/latest/developer-guide/troubleshooting-rabbitmq.md b/amazon-mq/latest/developer-guide/troubleshooting-rabbitmq.md
index 05aedf4d9..763a78c41 100644
--- a//amazon-mq/latest/developer-guide/troubleshooting-rabbitmq.md
+++ b//amazon-mq/latest/developer-guide/troubleshooting-rabbitmq.md
@@ -5 +5 @@
-I can't see metrics for my queues or virtual hosts in CloudWatch.How do I enable plugins in RabbitMQ on Amazon MQ?I'm unable to change Amazon VPC configuration for the broker.Cluster deployments have paused my queue synchronizations.My Amazon MQ for RabbitMQ single-instance broker is in a restart loop.
+I can't see metrics for my queues or virtual hosts in CloudWatch.How do I enable plugins in RabbitMQ on Amazon MQ?I'm unable to change Amazon VPC configuration for the broker.Cluster deployments have paused my queue synchronizations.My Amazon MQ for RabbitMQ single-instance broker is in a restart loop.I've lost access to all administrator accounts on my broker.
@@ -22,0 +23,2 @@ Use the information in this section to help you diagnose and resolve common issu
+  * [I've lost access to all administrator accounts on my broker.](./troubleshooting-rabbitmq.html#rabbitmq-broker-recovery)
+
@@ -53,0 +56,4 @@ To recover your broker, we recommend upgrading to a larger instance type with mo
+## I've lost access to all administrator accounts on my broker.
+
+You can recover access using IAM authentication. Enable outbound web identity federation for your AWS account, create an IAM role with permissions to obtain web identity tokens, configure your broker to accept IAM authentication via OAuth 2.0, then use IAM credentials to obtain a JWT token and create a new administrator user. For detailed instructions, see [Using IAM authentication and authorization for Amazon MQ for RabbitMQ](./rabbitmq-iam-tutorial.html).
+