Difference between revisions of "Setup/Download IAXRpt"

From AllStarLink Wiki
Jump to navigation Jump to search
imported>Bryan
 
(5 intermediate revisions by one other user not shown)
Line 1: Line 1:
 
[[Category:How to]]
 
[[Category:How to]]
IAXRPT is a specialized windows soft phone program which allows users to connect from their PC's to an Allstar node. Setting up IAXRPT access is similar to seting up dial-in access, but a different command line switch is used in extensions.conf, and user autheorization is done in iax.conf.
+
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 ==
[[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 10: Line 10:
 
|}
 
|}
  
=== Setup ===
+
== Modifying iax.conf ==
First, 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:
+
{{ 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''' }}
  [gui]
+
# SSH into your node and modify /etc/asterisk/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]
 
  type=user           
 
  type=user           
 
  context=radio-gui   
 
  context=radio-gui   
 
  auth=md5               
 
  auth=md5               
  secret=nunya ; *** Important! Change this!!!
+
  secret=CHANGEMEPLEASE ; *** Important! Change this!!!
 
  host=dynamic       
 
  host=dynamic       
 
  disallow=all
 
  disallow=all
Line 22: Line 24:
 
  allow=gsm         
 
  allow=gsm         
 
  transfer=no
 
  transfer=no
Second, a context stanza is added to extensions.conf to transfer control to the Rpt application:
+
 
 +
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
 
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 ==
 +
After installing, you will use the username iaxrpt and the password you specified above.

Latest revision as of 15:21, 22 February 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=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.