Accfile

Revision as of 13:06, 28 November 2012

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

It allows you to create lines(gateways) for different protocols like SIP, H323, Jabber or IAX.

For YATE to register to outside gateways to terminate, you need to look into accfile.conf : accfile is for YATE to register to others. This will make YATE as client.

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

See also

• Regular expressions
• Regfile
• Register