Azure Web and Mobile built-in role

SignalR REST API Owner

Provides full access to the Azure SignalR data-plane REST APIs for hubs, groups, users, and client connections, including client-token generation. It has no control-plane Actions and does not create app-server connections or provide the app-server negotiation workflow.

Role-definition permissions are imported from Microsoft Learn. Practical scope, use cases, prerequisites, best practices, security considerations, assignment guidance, and relationships have been reviewed against the official sources below.

Role definition ID: fd53cd77-2268-407a-8f46-7e7863d0f521

Control-plane actions (0)

None — this role grants no control-plane management actions.

Data-plane actions (5)

Excluded actions (0)

None

Assignable scopes (1)

Practical scope

Assign directly on the Azure SignalR Service resource whose clients and groups the principal manages. A resource-group, subscription, or management-group assignment is inherited by every SignalR resource below it.

Common use cases (2)

Prerequisites (2)

Best practices (3)

Security considerations (3)

Assignment guidance

Assign SignalR REST API Owner to the management application identity directly on one SignalR resource. Use REST API Reader for monitoring, App Server for Default-mode server connections, and Service Owner only for the documented Serverless negotiation workflow that needs both REST and authentication APIs.

Related roles (3)

Common questions

When should I assign the SignalR REST API Owner Azure role?

Assign SignalR REST API Owner when you need to: Use the Azure SignalR Management SDK from a console app, function, or web server to broadcast messages and manage connected clients and groups.; and Operate SignalR data-plane REST APIs without granting server-connection creation required by a Default-mode app server.. Practical scope: Assign directly on the Azure SignalR Service resource whose clients and groups the principal manages. A resource-group, subscription, or management-group assignment is inherited by every SignalR resource below it.

What permissions does the SignalR REST API Owner Azure role grant?

The role definition grants 5 combined control-plane and data-plane actions. Representative operations include: Microsoft.SignalRService/SignalR/auth/clientToken/action; Microsoft.SignalRService/SignalR/hub/*; Microsoft.SignalRService/SignalR/group/*; Microsoft.SignalRService/SignalR/clientConnection/*; and Microsoft.SignalRService/SignalR/user/*. Review the permission sections above for the complete definition and exclusions.

What are the security risks of the SignalR REST API Owner Azure role?

Key considerations when assigning SignalR REST API Owner: The role can generate client tokens and perform write operations affecting hubs, groups, users, and client connections, including broadcasts and connection management.; It does not create server connections, but its REST authority can still affect all connected clients within the assigned SignalR resource.; and A broader assignment gives the same REST control over every inherited SignalR resource.. Follow the assignment guidance above and use the narrowest practical scope.

Editorial sources (6)

Official Microsoft Learn documentation →