Setup/Download IAXRpt: Difference between revisions

From AllStarLink Wiki
Jump to navigation Jump to search
No edit summary
 
(One intermediate revision by the same user not shown)
Line 3: Line 3:


== Download ==
== Download ==
[[media:Setup iaxrpt xipar 010146.exe|Setup file for IAXRPT]] - This was at [http://www.xeletec.com/ Xeletec], but their servers are offline as of 2019-04-04.  
[[media:Setup iaxrpt xipar 010146.exe|Download Setup file for IAXRPT]] - This was at [http://www.xeletec.com/ Xeletec], but their servers are offline as of 2019-04-04.  


=== Security Issues ===
=== Security Issues ===
Line 16: Line 16:
  [iaxrpt]
  [iaxrpt]
  type=user           
  type=user           
  context=radio-gui 
  context=iaxrpt 
  auth=md5               
  auth=md5               
  secret=CHANGEMEPLEASE  ; *** Important! Change this!!!
  secret=CHANGEMEPLEASE  ; *** Important! Change this!!!
Line 24: Line 24:
  allow=gsm         
  allow=gsm         
  transfer=no
  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:
Add a context stanza to /etc/asterisk/extensions.conf to transfer control to app_rpt:
  [radio-gui]                   
  [iaxrpt]
  exten = 1234,1,Rpt,1234|X    ; Change 1234 to your node number
 
;<<< 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.
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 ==
== IAXRpt Usage ==
After installing, you will use the username iaxrpt and the password you specified above.
Program Setup
 
"Account Name" is the node number
 
User is the "stanza name" or iaxrpt in our example.

Latest revision as of 15:45, 24 September 2024

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.