Accfile

From Yate Documentation
(Difference between revisions)
Jump to: navigation, search
Line 1: Line 1:
 +
This file is used when Yate is registering itself to a remote server.
  
 +
=== General parameters===
 +
 +
* protocol: The protocol to register on (sip, iax, h323, jabber ...)
 +
* username: Account username
 +
* password: Account password
 +
* interval: Registration interval (in seconds) to request from server (ignored for jabber)
 +
* enabled:
 +
: Sections with enabled=no are always ignored.
 +
: If the enabled parameter is missing sections without username are ignored.
 +
: If enabled=yes the accounts are logged in even without an username.
 +
 +
=== Specific parameters===
 +
 +
====SIP====
 +
 +
* description: Caller name to set on outgoing calls on this account if none specified when routing
 +
* registrar: Registrar address. A port can be specified here (e.g. 1.2.3.4:7999)
 +
* authname: Authentication name to use instead of username when authenticating
 +
* domain: Authentication domain if any
 +
* outbound: Optional outbound proxy server if different from registrar.
 +
: A port can be specified here (e.g. 1.2.3.4:7999)
 +
* ip_transport: Optional SIP transport to use (udp, tcp, tls).
 +
:  Defaults to udp
 +
* ip_transport_remoteip: IP address to connect to register the account.
 +
:  Defaults to outbound or registrar address
 +
* ip_transport_remoteport: IP port to connect to register the account
 +
* ip_transport_localip: UDP: This parameter is used in conjuction ip_transport_localport
 +
:    to identify the transport to use
 +
:    TCP/TLS: Optional local ip to use when connecting
 +
* ip_transport_localport: Local port.
 +
:    UDP only: This parameter is used to identify the transport to use
 +
* localaddress: Local address to set in sent messages
 +
:    Set it to 'yes' to detect NAT and re-register with public ip when NAT is detected
 +
:    Set it to 'no' or ipaddress (e.g. 1.2.3.4 or 1.2.3.4:5060) to disable NAT detection
 +
* keepalive: Optional interval for NAT keep alive.
 +
:    Defaults to 0 if NAT detection is disabled
 +
; NOTE: Default port is 5060 for udp/tcp and 5061 for tls
 +
 +
==== Jabber====
 +
 +
* domain: Authentication domain
 +
* port: Server port. Defaults to 5222
 +
* server: Optional jabber server ip address to connect to.
 +
:    If set the jabber stream will try first to connect to this address
 +
* localip: Optional local ip address to use when connecting.
 +
:    Connect will fail if the address is invalid
 +
* resource: Optional resource to request from server
 +
* priority: Optional resource priority to set in initial presence
 +
* options: Comma separated list of stream flags
 +
:    - allowplainauth: Allow plain password authentication
 +
:    - tlsrequired: Stream encryption is required
 +
:    - noautorestart: Don't restart the stream when disconnected (NOT RECOMMENDED)
 +
* nocompression: Boolean. Set it to 'yes' to disable stream compression
 +
 +
==== IAX ====
 +
 +
* server: Registrar address or domain. A port can be specified here (e.g. 1.2.3.4:7999)
 +
* port: Registrar port if not specified in 'server' parameter
 +
: If not set the port defaults to 4569
 +
 +
==== H323 ====
 +
 +
* server: Registrar IP address
 +
* addr: Local address for H323 listener (leave it empty to listen on all interfaces)
 +
* port: Local port for H323 listener
 +
 +
===Configuration===
 +
 +
accfile.conf
  
; !!! NOTE !!!
 
; This file is used when yate is registering itself to a remote server
 
;
 
; Warning: all strings are case sensitive
 
;
 
; Sections with enabled=no are always ignored.
 
; If the enabled parameter is missing sections without username are ignored.
 
; If enabled=yes the accounts are logged in even without an username.
 
;
 
; Parameter description:
 
;  protocol: The protocol to register on (sip, iax, h323, jabber ...)
 
;  username: Account username
 
;  password: Account password
 
;  interval: Registration interval (in seconds) to request from server (ignored for jabber)
 
;
 
; SIP:
 
;  description: Caller name to set on outgoing calls on this account if none specified when routing
 
;  registrar: Registrar address. A port can be specified here (e.g. 1.2.3.4:7999)
 
;  authname: Authentication name to use instead of username when authenticating
 
;  domain: Authentication domain if any
 
;  outbound: Optional outbound proxy server if different from registrar.
 
;    A port can be specified here (e.g. 1.2.3.4:7999)
 
;  ip_transport: Optional SIP transport to use (udp, tcp, tls).
 
;    Defaults to udp
 
;  ip_transport_remoteip: IP address to connect to register the account.
 
;    Defaults to outbound or registrar address
 
;  ip_transport_remoteport: IP port to connect to register the account
 
;  ip_transport_localip: UDP: This parameter is used in conjuction ip_transport_localport
 
;      to identify the transport to use
 
;    TCP/TLS: Optional local ip to use when connecting
 
;  ip_transport_localport: Local port.
 
;    UDP only: This parameter is used to identify the transport to use
 
;  localaddress: Local address to set in sent messages
 
;    Set it to 'yes' to detect NAT and re-register with public ip when NAT is detected
 
;    Set it to 'no' or ipaddress (e.g. 1.2.3.4 or 1.2.3.4:5060) to disable NAT detection
 
;  keepalive: Optional interval for NAT keep alive.
 
;    Defaults to 0 if NAT detection is disabled
 
;
 
;  NOTE: Default port is 5060 for udp/tcp and 5061 for tls
 
;
 
; Jabber:
 
;  domain: Authentication domain
 
;  port: Server port. Defaults to 5222
 
;  server: Optional jabber server ip address to connect to.
 
;    If set the jabber stream will try first to connect to this address
 
;
 
;  localip: Optional local ip address to use when connecting.
 
;    Connect will fail if the address is invalid
 
;  resource: Optional resource to request from server
 
;  priority: Optional resource priority to set in initial presence
 
;  options: Comma separated list of stream flags
 
;    - allowplainauth: Allow plain password authentication
 
;    - tlsrequired: Stream encryption is required
 
;    - noautorestart: Don't restart the stream when disconnected (NOT RECOMMENDED)
 
;  nocompression: Boolean. Set it to 'yes' to disable stream compression
 
;
 
; IAX:
 
;  server: Registrar address or domain. A port can be specified here (e.g. 1.2.3.4:7999)
 
;  port: Registrar port if not specified in 'server' parameter
 
;  If not set the port defaults to 4569
 
;
 
; H323:
 
;  server: Registrar IP address
 
;  addr: Local address for H323 listener (leave it empty to listen on all interfaces)
 
;  port: Local port for H323 listener
 
;
 
 
  [test_sip]
 
  [test_sip]
 
  enabled=no
 
  enabled=no

Revision as of 11:01, 19 November 2012

This file is used when Yate is registering itself to a remote server.

Contents

General parameters

  • protocol: The protocol to register on (sip, iax, h323, jabber ...)
  • username: Account username
  • password: Account password
  • interval: Registration interval (in seconds) to request from server (ignored for jabber)
  • enabled:
Sections with enabled=no are always ignored.
If the enabled parameter is missing sections without username are ignored.
If enabled=yes the accounts are logged in even without an username.

Specific parameters

SIP

  • description: Caller name to set on outgoing calls on this account if none specified when routing
  • registrar: Registrar address. A port can be specified here (e.g. 1.2.3.4:7999)
  • authname: Authentication name to use instead of username when authenticating
  • domain: Authentication domain if any
  • outbound: Optional outbound proxy server if different from registrar.
A port can be specified here (e.g. 1.2.3.4:7999)
  • ip_transport: Optional SIP transport to use (udp, tcp, tls).
Defaults to udp
  • ip_transport_remoteip: IP address to connect to register the account.
Defaults to outbound or registrar address
  • ip_transport_remoteport: IP port to connect to register the account
  • ip_transport_localip: UDP: This parameter is used in conjuction ip_transport_localport
to identify the transport to use
TCP/TLS: Optional local ip to use when connecting
  • ip_transport_localport: Local port.
UDP only: This parameter is used to identify the transport to use
  • localaddress: Local address to set in sent messages
Set it to 'yes' to detect NAT and re-register with public ip when NAT is detected
Set it to 'no' or ipaddress (e.g. 1.2.3.4 or 1.2.3.4:5060) to disable NAT detection
  • keepalive: Optional interval for NAT keep alive.
Defaults to 0 if NAT detection is disabled
NOTE
Default port is 5060 for udp/tcp and 5061 for tls

Jabber

  • domain: Authentication domain
  • port: Server port. Defaults to 5222
  • server: Optional jabber server ip address to connect to.
If set the jabber stream will try first to connect to this address
  • localip: Optional local ip address to use when connecting.
Connect will fail if the address is invalid
  • resource: Optional resource to request from server
  • priority: Optional resource priority to set in initial presence
  • options: Comma separated list of stream flags
- allowplainauth: Allow plain password authentication
- tlsrequired: Stream encryption is required
- noautorestart: Don't restart the stream when disconnected (NOT RECOMMENDED)
  • nocompression: Boolean. Set it to 'yes' to disable stream compression

IAX

  • server: Registrar address or domain. A port can be specified here (e.g. 1.2.3.4:7999)
  • port: Registrar port if not specified in 'server' parameter
If not set the port defaults to 4569

H323

  • server: Registrar IP address
  • addr: Local address for H323 listener (leave it empty to listen on all interfaces)
  • port: Local port for H323 listener

Configuration

accfile.conf

[test_sip]
enabled=no
protocol=sip
;username=me
description=Test SIP account
;interval=600
;authname=metoo
;password=1234
;domain=somewhere.org
;registrar=10.0.0.1:5060
;outbound=10.0.0.1:5061
;localaddress=192.168.0.1:5062
;
[test_h323]
enabled=no
protocol=h323
;username=me
description=Test H.323 account
;interval=600
;password=1234
;
[test_iax]
enabled=no
protocol=iax
;username=me
description=Test IAX2 account
;interval=600
;password=1234
;server=10.0.0.2
;
[test_jabber]
enabled=no
protocol=jabber
;username=me
;domain=example.com
;password=1234
;options=allowplainauth
Personal tools
Namespaces

Variants
Actions
Preface
Configuration
Administrators
Developers