New installation Asterlink [ SuiteCRM Version 7.12.7 / FreePBX -Asterisk 19.5.0 ]

[johanseld]

FW Console - FreePBX Utility 16.0.21.18
Asterisk 19.5.0 built by mockbuild @ jenkins7 on a x86_64 running Linux on 2022-07-07 06:25:53 UTC
Server IP:172.16.34.21

SuiteCRM Version 7.12.7
Sugar Version 6.5.25 (Build 344)
Server IP:172.16.34.23

When I used the command ./Asterlink I am getting the following message error:

time="2022-10-16T14:40:02+02:00" level=info msg=AsterLink
time="2022-10-16T14:40:02+02:00" level=info msg="Setting log level" fields.level=trace
time="2022-10-16T14:40:02+02:00" level=info msg="Using SuiteCRM Connector"
time="2022-10-16T14:40:02+02:00" level=trace method=GET suite=true url="http://172.16.34.23/index.php?entryPoint=AsterLinkEntryPoint&action=get_ext_users"
time="2022-10-16T14:40:02+02:00" level=trace msg="200 OK" method=GET suite=true url="http://172.16.34.23/index.php?entryPoint=AsterLinkEntryPoint&action=get_ext_users"
time="2022-10-16T14:40:02+02:00" level=info msg="User list updated" suite=true users="map[2002:1]"
time="2022-10-16T14:40:02+02:00" level=info msg="Enabling web server" addr="172.16.34.23:5678" suite=true
**time="2022-10-16T14:40:02+02:00" level=fatal msg="listen tcp 172.16.34.23:5678: bind: cannot assign requested address" suite=true**

[serfreeman1337]

This error means that asterlink failed to start http api on address specified in endpoint_addr.
It may be that port 5678 is already taken or IP doesn't belong to server where asterlink is starting.

I.e. you should specify 172.16.34.21:5678, if you start asterlink on the same server with asterisk.
Also note that in order for popup card to work 172.16.34.21:5678 must be accessibly by user's browser.

[johanseld]

I'm so confused about documentation.

what is the endpoint_addr? It´s the server where are installed Asterlink, PBX Server or SuiteCRM Module.

[serfreeman1337]

endpoint_addr in conf.yml is listen address for asterlink's HTTP api web server. You can specify 0.0.0.0:5678 so asterlink will be accessibly on 5678 tcp port on every IP addresses of a server.

Endpoint URL in suitecrm module settings is address of asterlink. SuiteCRM and user's web browser will connect to asterlink using this address.

If you start asterlink with endpoint_addr: 0.0.0.0:5678 on server with IP 172.16.34.21, then in suitecrm module settings you must specify 172.16.34.21:5678.

I'll try to make it more clear and easy to install in furuther releases.

[johanseld]

Thank you.

ProxyPass "/asterlink/ws/" "ws://my_endpoint_addr:my_endpoint_port/ws/"
ProxyPass "/asterlink/" "http://my_endpoint_addr:my_endpoint_port/"

Where are the location "DocumentRoot" [/asterlink/ws/ & /asterlink/"] to configure the proxypass?

[serfreeman1337]

ProxyPass "/asterlink/ws/" "ws://172.16.34.21:5678/ws/"
ProxyPass "/asterlink/" "http://172.16.34.21:5678/"

It's apache2 config. Usually located at /etc/httpd/conf/httpd.conf or /etc/apache2/apache2.conf.
ProxyPass can also be put inside <VirtualHost> config (/etc/apache2/sites-available/000-default.conf etc.) for suitecrm, if you have one.

Also For ProxyPass to work following modules need to be enabled first: mod_proxy, mod_proxy_http, mod_proxy_wstunnel.

For Ubuntu execute following commands:

a2enmod proxy
a2enmod proxy_http
a2enmod proxy_wstunnel

Or simply uncomment them in httpd.conf (or apache2.conf) file:

LoadModule proxy_module modules/mod_proxy.so
LoadModule proxy_wstunnel_module modules/mod_proxy_wstunnel.so
LoadModule proxy_http_module modules/mod_proxy_http.so

Then you can update suitecrm module settings to use proxy:

Endpoint URL: http://172.16.34.23/asterlink
WebSocket URL: ws://172.16.34.23/asterlink

[johanseld]

I can be sure that what I do. I'll do the proxypass configuration in the server where I installed Asterlink or SuiteCRM Module?

[serfreeman1337]

On the SuiteCRM web-server. So, user will be able to reach asterlink via suitecrm webserver.

[johanseld]

On the SuiteCRM Web-server, I configured the Proxy_pass but when tying to access from the SuiteCRM Web-server to http://myasterlink.myserver.lan:5678/asterlink give an error :404 page not found.

server {
    listen 80;
    server_name myasterlink.myserver.lan;
    }

    location /asterlink/ {
        proxy_pass http://172.16.34.21:5678/;
        proxy_redirect off;
        proxy_set_header X-Forwarded-Host $host;
        proxy_set_header Host "myasterlink.myserver.lan";
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Real-IP $remote_addr;
    }

[serfreeman1337]

give an error :404 page not found

That's ok, 404 page not found is from asterlink (if you access http://172.16.34.21:5678/ you will get same result).
At this point you should have click2call working.

For popup card you will also need to setup ws proxy.
Place it above location /asterlink/:

location /asterlink/ws/ {
    proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
    proxy_set_header Host $host;

    # enable WebSockets
    proxy_http_version 1.1;
    proxy_set_header Upgrade $http_upgrade;
    proxy_set_header Connection "upgrade";

    proxy_pass http://172.16.34.21:5678;
}

SuiteCRM Module config:

• Endpoint URL: http://myasterlink.myserver.lan/asterlink
• WebSocket URL: ws://myasterlink.myserver.lan//asterlink

Also, those location rules are recommended to be placed inside nginx config for suitecrm. Overall it could look like this:

• http://172.16.34.23/ - suitecrm
• http://172.16.34.23/asterlink - asterlink proxy

But it's also fine to use subdomain.

[johanseld]

after setup setup ws proxy:

ws.js?v=wGrHdMwUNY-5ft4YcYeuoA:5 WebSocket connection to 'ws://myasterlink.myserver.lan/asterlink/ws/?token=eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJpZCI6IjEifQ.6hgFFl6riTZ6FYY0NITbyhpnP_D-tOxS3bHo-MJrnbM' failed: 
alWs @ ws.js?v=wGrHdMwUNY-5ft4YcYeuoA:5 "http://172.16.34.23/modules/AsterLink/javascript/ws.js?v=wGrHdMwUNY-5ft4YcYeuoA"

[serfreeman1337]

Here is correct proxy configuration (note the trailing / for proxy_pass):

location /asterlink/ws/ {
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header Host $host;

        # enable WebSockets
        proxy_http_version 1.1;
        proxy_set_header Upgrade $http_upgrade;
        proxy_set_header Connection "upgrade";

        proxy_pass http://172.16.34.21:5678/ws/;
}

location /asterlink/ {
        proxy_pass http://172.16.34.21:5678/;
        proxy_redirect off;
        proxy_set_header X-Forwarded-Host $host;
        proxy_set_header Host "myasterlink.myserver.lan";
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Real-IP $remote_addr;
}

[johanseld]

The same error:

ws.js?v=wGrHdMwUNY-5ft4YcYeuoA:5 WebSocket connection to 'ws://myasterlink.myserver.lan/asterlink/ws/?token=eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJpZCI6IjEifQ.6hgFFl6riTZ6FYY0NITbyhpnP_D-tOxS3bHo-MJrnbM' failed: 
alWs @ ws.js?v=wGrHdMwUNY-5ft4YcYeuoA:5

[serfreeman1337]

Is it still fails because of "404" ? Please check network tab on browser developer tools, it should show requests to myasterlink.myserver.lan.

Does click2call work ?