external_line
phone sections contain all settings for a phone profile.
sections contain all settings for a
to be applied to a
line
line
phone
sections contain all settings for registration to an external SIP server, e.g. another Asterisk machine
external_line
The phone and lines section of res_digium_phone.conf, are defined by a section identifier encapsulated in square brackets, and are
user-definable.
Example
This is an example, using invalid options and functions, of a res_digium_phone.conf configuration file, displaying the organizational layout. The
various options and functions are described later in this page.
Example res_digium_phone.conf layout.
[general]
; comments are preceded by a comma
;
; the general section contains many options
generaloption=value
generaloption2=othervalue
;
[MyPhone] ; A phone
type=phone
; Phone options go here
phoneoption=value
phoneoption2=othervalue
;
[MyAccount] ; A SIP peer from sip.conf
type=line
; Line options go here
lineoption=value
lineoption2=othervalue
;
[MyExternalAccount] ; An external SIP registration
type=external_line
; External Line options go here
externallineoption=value
externallineoption2=othervalue
;
Authentication Options
The General Section provides the following options related to authentication:
Option
Values
Description
globalpin
integer;
e.g.
10101019
If userlist_auth is set to globalpin, sets the PIN that must be entered on a phone, at boot, in order to retrieve the list
of available phone configurations. If config_auth is set to globalpin, sets the PIN that must be entered on a phone, at
the userlist screen, in order to request a particular phone configuration - note that if the globalpin has already been
entered to authenticate to retrieve the list of available phone configurations, that it will not required a second time in
order to request a particular phone configuration.
userlist_auth
disabled,
globalpin
Specifies the kind of authentication required to retrieve the list of available phone profiles from the provisioning
server. Options are “disabled,” where no authentication is required to retrieve the list of phone profiles; and
“globalpin,” where entry of the Global PIN is required in order to retrieve the list of phone profiles.
config_auth
mac, pin,
globalpin,
disabled
Specifies the kind of authentication required to retrieve a phone’s configuration from the provisioning server.
Options are “mac,” where the MAC address of the device requesting the configuration must match the phone profile,
and if it does, the phone will be automatically provisioned with the matching phone profile; “pin” where the entered
PIN must match the phone profile; “globalpin,” where the entered PIN must match the Global PIN; and disabled,
where profiles are served without authentication - with this setting, any phone can pull any phone profile defined in
this configuration file with no authentication challenges.
Registration Server Options
The General Section provides the following options related to the registration server:
