# Add or Edit SIP Devices

Use this procedure to add SIP devices and register their credentials for secure authentication on the MBG (set-side) and the ICP-side. Credentials for MBG (set-side) and the ICP (icp-side) do not have to be the same.

Note that SIP device access is always restricted to authorized users. Clients must pass a registration at the MBG server before being passed through to the ICP for approval.

To add a SIP device:

1. On the MBG main page, click the Service configuration tab and then click SIP devices.

2. Click the + sign.

3. Update the device options as required and then click Save.

Field | Description | Notes
Enabled | Select to enable the set and allow it to connect to the ICP. Clear the check box to disable access. |
Configured ICP | Select the ICP to which this device will connect. |
Set-side username | Enter the set-side (MBG side) user name for the SIP client you want to authorize. | For example, smithj. Note: In Auchan mode, MiVoice Border Gateway usernames must always be associated with a PNI. MiVoice Border Gateway maps between PNI+DN (set-side username) and DN (ICP-side username). In case of duplicate DNs, MiVoice Border Gateway will not allow new user creation.
Set-side password | Enter the set-side password for the SIP client you want to authorize. For security reasons, the password field is always blank. | Choose a secure password that is not trivial. Ensure that it contains letters, numbers, and punctuation. (For example, Mitel*Server1!) If you attempt to configure a weak password, you will receive a warning or be prevented from preceding (depending on whether Permit Weak Passwords is enabled). Whenever you update the username, you can either enter a new password or continue to use the existing password. Note that the password field is always blank.
Confirm set-side password | Re-enter the set-side password for confirmation. |
ICP-side username | Enter the Username that this SIP client uses to access the ICP. | Leaving these fields blanks causes the ICP-side credentials to default to the same values as set-side credentials. If you have configured a non-trivial set-side password, this will not match the password configured in the ICP and connections for this set will be denied. We recommend that you enter both credentials for more secure authentication. Note: In Auchan mode, MiVoice Border Gateway usernames must always be associated with a PNI. MiVoice Border Gateway maps between PNI+DN (set-side username) and DN (ICP-side username). In case of duplicate DNs, MiVoice Border Gateway will not allow new user creation.
ICP-side password | Enter the password that this SIP client uses to access the ICP.
Confirm ICP-side password | Re-enter the ICP-side password for confirmation. |
PRACK support | This option controls whether the "Provisional Response ACKnowledgement" (PRACK) method is used between MBG and the device. Use master setting to use the global PRACK option programmed on the Settings screen. This option controls whether MBG supports PRACK between itself and the peer, and is the default setting for all SIP devices. Enabled to enable MBG to use PRACK with the selected device while the global PRACK option is disabled. Disabled to prevent MBG from using PRACK with the selected device while the global PRACK option is enabled. For example, if the PRACK option is globally disabled on MBG and the peer but enabled on the SIP device, then MBG will support PRACK only on calls between itself and the device. Alternatively, if the PRACK option is globally enabled on MBG but disabled on the device, then MBG will use PRACK only between itself and the peer but not with the device. | Default is Use master setting. Most peers now support PRACK, which can be useful in interoperability scenarios with the PSTN (see RFC 3262). If the remote SIP device supports PRACK, this option should be enabled.
Options keepalives | This option controls whether SIP "OPTIONS" messages are sent to the SIP device as a keepalive mechanism. Use master setting to use the global keepalive option programmed on the Settings screen. Never to prevent keepalives from being sent to the selected device. Always to force keepalives to be sent the selected device. Only Behind NAT to send keepalives only if the remote device is behind a NAT server that is not performing traversal such as STUN. | Default is Use master setting. Gap register and Send options can be used together or separately.
Heartbeat interval | If "Options keepalives" is enabled, this is the interval at which keep-alive messages are sent. This setting overrides the "Options interval" programmed on the Settings screen. |
Challenge methods | Use this setting to specify the challenge methods MBG will use to authenticate the remote SIP device. When an incoming request includes one of these methods, MBG will issue a "401 Authorization Required" response. The device must then retry the request with credentials contained within the message. To specify methods for the selected device: Click Override. Select one or more of the following methods: Invite, Subscribe, Refer, Prack, Bye, Options, Info, Notify, Update. Use Shift-click and Ctrl-click to select multiple items on the list. After you have finished updating the screen, click Save. To use the method(s) programmed on the Settings screen, click Use master setting. | Default is Use master setting. The ACK and CANCEL methods cannot be challenged. REGISTER is always challenged.
Set-side RTP security | This option controls whether the Secure Real-time Transport Protocol (SRTP) is required to provide encryption, message authentication and integrity for the media stream on the set side of MBG. Use master setting to use the Set-side RTP security option programmed on the Settings screen. Allow to use either RTP or SRTP. Require to use only SRTP; RTP is disallowed. If this option is selected, the remote SIP set connected to MBG must support SRTP. If the set lacks SRTP, MBG will cause its calls to fail. Note: To implement end-to-end security, enable STRP on both the PBX and MBG. MBG will then facilitate secure communication between remote and local devices. | Default is Use master setting.
Description | Enter a description for this SIP client/device. | For example, JSmith
ICP-side RTP security | This option controls whether the Secure Real-time Transport Protocol (SRTP) should be used as the preferred protocol on the ICP side of MBG. Use master setting to use the ICP-side RTP security option programmed on the Settings screen. Disable to use only RTP; SRTP is disallowed. Prefer to use either SRTP (the default) or RTP. Note: To implement end-to-end security, enable STRP on both the PBX and MBG. MBG will then facilitate secure communication between remote and local devices. | Default is Use master setting
Availability | Select the SIP device/client availability: Everywhere to enable the configured SIP credentials to be used to register a SIP device or WebRTC subscriber. SIP devices only to enable the configured SIP credentials to be used to register a SIP device (but not a WebRTC subscriber). WebRTC only to enable the configured SIP credentials to be used to register a WebRTC subscriber (but not a SIP device). | Default is Everywhere
Local streaming between device calls | Select an option: Use master setting to allow the selected remote device to use the global local streaming option programmed on the Settings screen. Enabled to force the remote device to use local streaming always. Disabled to prevent the remote device from using local streaming. | Default is Use master setting.
Log verbosity | At times, it may be necessary to increase log verbosity for specific troubleshooting purposes. Select Normal, Very Quiet, Quiet, Verbose, Very Verbose, or Use master setting to use the Log Verbosity setting programmed on the Settings screen. | Default is Use master setting.
Codec support | If you are doing secure call recording and the 3rd-party call recording equipment (CRE) only supports G.711a, G.711u and G.729a, you can restrict MBG to using those codecs. If you are not operating under these limitations, you should allow MBG to use an unrestricted range of codecs. : Use master setting to allow the selected remote device to use the global Codec support setting programmed on the Settings screen. Unrestricted to the selected remote device to use any codec. Restricted to G.729, G.711 to force the selected remote device to use G.711a, G.711u, or G.729a. | Default is Use master setting.
Enable Detailed Jitter Log | Similar to log verbosity, this field controls the jitter log. Use master setting to allow the selected remote IP Phone to use the global jitter log setting programmed on the Settings screen. Enabled to enable detailed logging for the selected device. Disabled to disable detailed logging for the selected device. | Default is Use master setting.
RTP Framesize | This setting overrides the default value requested by the ICP or SIP peer request. It should be changed only if your system has specific requirements. For more information about RTP frame size, see the Engineering Guidelines. Use master setting to allow the selected remote IP Phone to use the global RTP Framesize setting programmed on the Settings screen. Enabled to enable detailed logging for the selected device. Disabled to disable detailed logging for the selected device. | Default is Use master setting.
Tone Injection | With this option enabled, a configurable tone will be injected into all calls. See Tone Injection for details. Frequency sets the pitch of the tone. Duration defines the length of the tone. Interval controls the time between the played tones. Volume sets the volume of the tone. The values towards zero are louder. Mix/Mux controls whether to mix the tone into the audio stream, or replace the audio stream with the tone while playing. Direction defines whether to play the tone in the audio stream going towards: RX: the set TX: the ICP RXTX: both Note: To disable the tone, clear the Enabled option and select Use master. | Default is Use master setting.

## Edit SIP Devices

To edit a SIP device:

1. On the MBG main page, click the Service configuration tab and then click SIP devices.

2. In the device listing, locate the device you want edit and click .

3. Edit device information as required.

4. Click Save.

## Delete SIP Devices

To delete a SIP device:

1. On the MBG main page, click the Service configuration tab and then click SIP devices.

2. In the device listing, locate the device you want to delete and click .

3. Click Delete. The deletion is confirmed.

Print Page