SIPSorcery
Sign in

SIP Accounts

The SIP Accounts page is used to create, update and delete SIP accounts. The devices currently registered to each account are listed under Current registrations on the same page. The settings of a SIP account are explained below.

  • SIP username: the username of the account. Your phone or softphone uses it when registering and placing calls. Letters, digits, dot, dash and underscore are allowed, and it is not case sensitive.
  • SIP domain: the domain the account belongs to. Unless you have your own domain it will be the service's default domain, such as sipsorcery.com. Your device needs it as its server, domain or realm. It is chosen when the account is created and can't be changed afterwards, because the stored password digest is tied to it.
  • Password: generated for you when the account is created and shown once. It is stored encrypted, so it can be shown again from the SIP Accounts page when a device needs reconfiguring, or reset if it has been exposed. Passwords are generated rather than chosen so that they are always strong enough; see SIP Password Security for why that matters.
  • Outgoing dial plan: the dial plan that processes calls the account places. With none, the account can still call the other SIP accounts on the server.
  • Incoming dial plan: the dial plan that processes calls arriving for the account. With none, incoming calls ring every device registered to the account.
  • Description: free text, for telling one handset from another.
  • Send NAT keep-alives: on the previous servers this sent small keep-alive packets to each device registered to the account, to keep a home router's connection open between registrations. The setting is kept with the account, but the current servers don't send keep-alives, so if incoming calls stop arriving after a while, shorten the registration interval on the device instead.
  • Incoming calls only: marks an account that is meant for receiving calls, often called an extension, such as one a provider sends its incoming calls to. The current servers don't yet refuse outgoing calls from it, so don't rely on it to stop an account placing calls; give it no outgoing dial plan as well.
  • Do not rewrite the contact address: normally the server sends calls to the address and port a registration actually came from, because a device behind a home router often registers the wrong port or a private address. Tick this only when the contact deliberately names somewhere else, such as a PBX with its own listener; behind a router it stops incoming calls arriving.
  • Disabled: refuses registrations and calls for the account without deleting anything.
  • IP address ACL: an optional regular expression for the addresses the account may be used from. It is kept with the account but not currently enforced by the servers.
  • Network ID: an optional label that marks two or more accounts as being on the same private network. On the previous servers it stopped the call's media addresses being rewritten between them; the current servers never rewrite media addresses, so it has no effect.

An account can also be disabled by an administrator, in which case the SIP Accounts page shows it and the reason.