Difference between revisions of "Setup/Download IAXRpt"

From AllStarLink Wiki
Jump to navigation Jump to search
 
Line 11: Line 11:
  
 
== Modifying iax.conf ==
 
== Modifying iax.conf ==
{{ Note|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 }}
+
{{ Note|'''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.
+
# 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:
+
# 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]
 
  [iaxrpt]
 
  type=user           
 
  type=user           
Line 25: Line 25:
 
  transfer=no
 
  transfer=no
  
Second, a context stanza is added to extensions.conf to transfer control to app_rpt:
+
Add a context stanza to /etc/asterisk/extensions.conf to transfer control to app_rpt:
 
  [radio-gui]                   
 
  [radio-gui]                   
 
  exten = 1234,1,Rpt,1234|X    ; Change 1234 to your node number
 
  exten = 1234,1,Rpt,1234|X    ; Change 1234 to your node number

Latest revision as of 00:35, 20 January 2021

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

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=radio-gui   
auth=md5              
secret=CHANGEMEPLEASE  ; *** Important! Change this!!!
host=dynamic      
disallow=all
allow=ulaw  
allow=gsm        
transfer=no

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

[radio-gui]                   
exten = 1234,1,Rpt,1234|X    ; Change 1234 to your node number

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

After installing, you will use the username iaxrpt and the password you specified above.