Skip to Content
Version 19.1 by Mark Kohlmann on 2021/10/27 02:00
Show last authors
1 ===== Use ShowRunner version 3.010 or later =====
2
3
4 ===== Host processor (LWAPI Server) Setup (DIN-AP3 @ 10.44.5.91) =====
5
6 Steps 1-3 and 5 always needed.
7
8 1. If 3-series, Enable Authentication [##authentication on##] or SSL [##ssl self##] if not already enabled.  4-Series have authentication enabled by default.  User Page Auth should be turned off on 4-series.
9 1. Enable LWAPI In Config (@ root level):
10 ## "LwApiEnable": true,
11 "LwApiSecurityLevel": "Auth",##
12 1. Create an API User and record the Key and Secret.  User group must have //LWAPI //role and //Execute //permissions.  //Lightweight API Users// group has been created for this purpose:
13 ##DIN-AP3>sradmin add api user "Central Control" "Lightweight API Users"
14 API User Central Control generated with Group permissions Lightweight API Users and Key: (% style="color:blue" %)**YTd2pQn7sjwiOWD9NqCIWw**(%%) Secret: (% style="color:orange" %)**OeiQEFo_-EDfc7sQe_qRpeQzSkZjylV2roa76utpJLI**(%%)##
15 1. If 3-series w/ auth enabled or 4-series with user page auth enabled then add a remote user with permissions to connect to the control system.  This is done by adding a local user to the system with user privileges.  Sample values shown, do not re-use these.
16 ##DIN-AP3>adduser -N:(% style="color:purple" %)**lwapi**(%%) -P:(% style="color:darkgoldenrod" %)**dMFN9pJJXjWLGd7t**(%%)
17 User account was successfully created.
18 DIN-AP3>addusertogroup -N:lwapi -G:Users
19 'lwapi' was successfully added to group 'Users'.##
20 1. Save the configuration
21
22 ===== Client processor (LWAPI Client) Setup (DIN-AP4) Version 3.011 or newer =====
23
24 Steps 1-3 and 6 always needed.
25
26 1. Define remote system in the config:
27 ## {
28 "SystemId": (% style="color:darkcyan" %)1(%%),
29 "IpAddressOrHostname": "10.44.5.91",
30 "Label": "HUB-1-1",
31 "ConnectionType": "LWAPI"
32 },##
33 1. Add Users :
34 if CWS User is not needed:
35 ##DIN-AP4>sr remote system auth (% style="color:darkcyan" %)**1**(%%) (% style="color:blue" %)**YTd2pQn7sjwiOWD9NqCIWw**(%%) (% style="color:orange" %)**OeiQEFo_-EDfc7sQe_qRpeQzSkZjylV2roa76utpJLI**(%%)##
36 if CWS User is needed:
37 ##DIN-AP4>sr remote system auth (% style="color:darkcyan" %)**1**(%%) (% style="color:blue" %)**YTd2pQn7sjwiOWD9NqCIWw**(%%) (% style="color:orange" %)**OeiQEFo_-EDfc7sQe_qRpeQzSkZjylV2roa76utpJLI **(% style="color:purple" %)**lwapi**(%%)** (% style="color:darkgoldenrod" %)dMFN9pJJXjWLGd7t(%%)**
38 Success##
39 1. Save the configuration
40
41 ===== Client processor (LWAPI Client) Setup (DIN-AP4) Version 3.010 or earlier =====
42
43 Steps 1-3 and 6 always needed.
44
45 1. Define remote system in the config:
46 ## {
47 "SystemId": (% style="color:darkcyan" %)1(%%),
48 "IpAddressOrHostname": "10.44.5.91",
49 "Label": "HUB-1-1",
50 "ConnectionType": "LWAPI"
51 },##
52 1. Add remote user for LWAPI (this is the key and secret created on the host):
53 ##DIN-AP4>sradmin add remote user HUB-1 (% style="color:blue" %)**YTd2pQn7sjwiOWD9NqCIWw**(%%) (% style="color:orange" %)**OeiQEFo_-EDfc7sQe_qRpeQzSkZjylV2roa76utpJLI**(%%)
54 Remote User HUB-1 ((% style="color:green" %)//**1a920b8b-3ab8-44bd-bc7b-0fc77abf0a13**//(%%)) added with Group permissions Remote Connection##
55 1. Assign users to the remote connection, System ID in this example is 1.  API user is to authenticate with the API.  CWS user is to authenticate with the Crestron Web Server before authenticating with the ShowRunner REST API:
56 ##DIN-AP4>sradmin assign remote user API (% style="color:darkcyan" %)**1**(%%) (% style="color:green" %)//**1a920b8b-3ab8-44bd-bc7b-0fc77abf0a13**//(%%)##
57 ##User HUB-1 assigned to remote system 1:HUB-1-1 for API Authorization##
58
59 1. If 3-series w/ auth enabled or 4-series with user page auth enabled then add a remote user with permissions to connect to the control system.
60 ##DIN-AP4>sradmin add remote user HUB-1_CWS (% style="color:purple" %)**lwapi**(%%)** (% style="color:darkgoldenrod" %)dMFN9pJJXjWLGd7t(%%)**
61 Remote User HUB-1_CWS ((% style="color:red" %)//**d7c88ecb-7212-4e8b-8749-ddca759c6a62**//(%%)) added with Group permissions Remote Connectio##
62 1. If Necessary:
63 ##DIN-AP4>sradmin assign remote user CWS (% style="color:darkcyan" %)**1**(%%) (% style="color:red" %)//**d7c88ecb-7212-4e8b-8749-ddca759c6a62**//(%%)
64 User HUB-1_CWS assigned to remote system 1:HUB-1-1 for API Authorization##
65 1. Save the configuration and restart ShowRunner™