Difference between revisions of "Setup/Download IAXRpt"

From AllStarLink Wiki
Jump to navigation Jump to search
imported>N8THN
(created page)
 
 
(7 intermediate revisions by 3 users 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 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 ==
 +
[[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.
 +
 +
=== Security Issues ===
 +
{| class="wikitable"
 +
|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 ==
 +
{{ 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''' }}
 +
# 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         
 +
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.

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.