Setup/Download IAXRpt

From AllStarLink Wiki
Jump to navigation Jump to search

IAXRPT is a specialized Windows "soft phone" program which allows users to connect from their PC's to an AllStarLink node. Setting up IAXRPT access is similar to setting up dial-in access, but a different command line switch is used in extensions.conf, and user authorization is done in iax.conf.

Download

Download Setup file for IAXRPT - This was at Xeletec, but their servers are offline as of 2019-04-04.

Security Issues

Incoming IAXRPT connections need to be authorized by making sure the incoming IAX user stanza is protected with a secret. This is the case because incoming IAX calls are not checked against a nodes stanza.

Modifying iax.conf

You may already have a stanza named [iaxrpt] in your iax.conf. You may re-use this stanza, but you will need to change the password
  1. SSH into your node and modify /etc/asterisk/iax.conf.
  2. A user stanza needs to added to iax.conf to allow incoming IAXRPT calls to be routed to a context in extensions.conf. A modified on the following stanza should be placed in iax.conf:
[iaxrpt]
type=user          
context=iaxrpt  
auth=md5              
secret=CHANGEMEPLEASE  ; *** Important! Change this!!!
host=dynamic      
disallow=all
allow=ulaw  
allow=gsm        
transfer=no
; requirecalltoken = no  ; Un-comment or insert for ASL3

Add a context stanza to /etc/asterisk/extensions.conf to transfer control to app_rpt:

[iaxrpt]
<<< choose one of the following formats >>>>>>>
exten = 1234,1,Rpt,1234|X  ; Change 1234 to your node number < this is for "pre" ASL3
exten = 1234,1,Rpt(1234|X)  ; Change 1234 to your node number < this is for ASL3


The X option passed to the Rpt application disables the normal security checks. Because incoming connections are validated in iax.conf, and we don't know where the user will be coming from in advance, the X option is required.

IAXRpt Usage

Program Setup

"Account Name" is the node number

User is the "stanza name" or iaxrpt in our example.