Restrict Extension Registration Based on User Agent
This topic describes how to restrict extension registration based on user agent.
Background information
- User Agent Client (UAC): A client application that initiates a SIP request, such as INVITE, ACK, OPTIONS, BYE, CANCEL, and REGISTER.
- User Agent Server (UAS): A server application that receives the SIP request from a UAC, and returns a response to the request back to the UAC.
When a SIP endpoint tries to register an extension to Yeastar P-Series PBX System, the SIP endpoint working as UAC sends packets containing user agent string to the PBX. By default, Yeastar P-Series PBX System allows registrations from any UAC without authenticating user agent. For security reasons, you can restrict extension registration based on user agent.
Procedure
- Log in to PBX web portal, go to , edit the desired extension.
- Click Security tab.
- In the SIP Security section, select the checkbox of Enable User Agent Registration Authorization.
- Set the user agent.
- Click Add User Agent.
- In the User Agent field, enter a value.
- Click Save and Apply.
Result
When a phone is trying to register an extension, the phone will send SIP packets containing a user agent, such as phone manufacturer, phone model, etc. If the prefix of the user agent does not match the specified value, the registration will fail.