account
This command configures the Accounts table, which lets you define user registration accounts.
Syntax
(config-voip)# sip-definition account <Index> (account-<Index>)#
Command |
Description |
---|---|
Index |
Defines the table row index. |
account-name |
Defines an arbitrary name to easily identify the row. |
application-type {gw|sbc} |
Defines the application type. |
contact-user |
Defines the AOR username. |
host-name |
Defines the Address of Record (AOR) host name. |
password |
Defines the digest MD5 Authentication password. Note: If the password contains a question mark (?) and you're configuring the parameter through CLI, you must enclose the entire password in double quotation marks (e.g., "43LSyk+?"). |
re-register-on-invite-failure |
Enables the device to re-register an Account upon the receipt of specific SIP response codes (e.g., 403, 408, and 480) for a failed INVITE message which the device routed from the Account to a remote user agent (UA). |
reg-by-served-ipg-status {reg-always| reg-if-online} |
Defines the device's handling of Account registration based on the connectivity status of the Served IP Group. |
reg-event-package-subscription {disable|enable} |
Enables the device to subscribe to Reg Event Package service with the registrar, which provides notifications of registration state changes, for the Registrar Stickiness feature. |
register {disable|gin|reg} |
Enables registration. |
registrar-search-mode {by-ims-spec|current-server |
Defines the method for choosing an IP address (registrar) in the Proxy Set (associated with the Serving IP Group) to which the Account initially registers and performs registration refreshes, when the Register Stickiness feature is enabled. |
registrar-stickiness {disable|enable|enable-for-non-register-requests} |
Enables the "Registrar Stickiness" feature, whereby the device always routes SIP requests of a registered Account to the same registrar server to where the last successful REGISTER request was routed. |
served-ip-group-name |
Defines the IP Group (e.g., IP-PBX) that you want to register and/or authenticate upon its behalf. |
served-trunk-group |
Defines the Trunk Group that you want to register and/or authenticate. |
serving-ip-group-name |
Defines the IP Group (Serving IP Group) to where the device sends the SIP REGISTER requests (if enabled) for registration and authentication (of the Served IP Group). |
udp-port-assignment {disable|enable} |
Enables the device to dynamically allocate local SIP UDP ports to Accounts using the same Serving IP Group, where each Account is assigned a unique port on the device's leg interfacing with the Accounts' Serving IP Group. |
user-name |
Defines the digest MD5 Authentication username. |
Command Mode
Privileged User
Example
This example configures an Account with a username and password that registers IP Group "IPBX" with IP Group "ITSP":
(config-voip)# sip-definition account 0 (account-0)# user-name JoeD (account-0)# password 1234 (account-0)# register reg (account-0)# served-ip-group-name IPPBX (account-0)# serving-ip-group-name ITSP (account-0)# activate