Skip to main content
Find a Sales Rep

How to Perform the Apexx Series Software Setup?

Updated

Question

How to Perform the Apexx Series Software Setup?

Answer

Note: The steps may vary depending on your web browser and operating system. If any of these steps are unclear, consult the Google Cloud tutorial for further details.

  1. On your computer, use the file explorer to locate the folder where Apexx Series Software is installed.
  2. Locate and open the “Apexx Client.dll.config” file (located in the “Client” folder).
  3. Edit the Apexx Client.dll.config file to include the Client ID and Client Secret from the credentials created in Google Cloud. Add the highlighted values within the appropriate tags, as shown below:
<?xml version="1.0" encoding="utf-8" ?>
<configuration>
<appSettings>
<add key="APIURL" value="https://localhost:5001"/>
<add key="MQTTHost" value="localhost"/>
<add key="MQTTPort" value="8883"/>
<add key="ClientID" value="xxxxxx"/>
<add key="ClientSecret" value="yyyyyy"/>
</appSettings>
</configuration>

Note: The values in the yellow highlighted portion above should contain the Client ID and Client Secret values in place of the xxxxxx and yyyyyy respectively

  1. Save and close the Apexx Client.dll.config file.
  2. Locate and open the "appsettings.json" file (located in the "API" folder).

  3. Edit the appsettings.json file to include the following: 

    "Authentication": { 
      "Google": { 
          "Authority": "https://accounts.google.com/", "Audience":
           "xxxxxx"
          } 
       }, 
Note: The xxxxxx in the snippet of code above should be replaced with your Client ID
  4. Save and close the appsettings.json file.
  5. Open the Apexx Series Software Client and log in as an administrative user.
    (Note: You must log in as a Software User who has permission to add new Software Users.)
  6. From the main menu, click User Management > Software Users.
  7. On the Software Users screen, click the Add icon at the bottom of the screen.
  8. Use the text boxes and drop-down menus to configure the following:
    1. Username: Set to a valid Gmail address/account that was added to your Google Cloud project.
    2. Login Provider: Set to Google.
  9. Use the sliders to assign one or more Regions and Roles to the new Software User.
    1. Assigned: Slider is blue and to the right
    2. Unassigned: Slider is grey and to the left
  10. Under Permissions, use the sliders to set the Software User’s read and write privileges.
    1. Enabled: Slider is blue and to the right
    2. Disabled: Slider is grey and to the left
  11. Click Save to create the new Software User.
  12. Repeat steps 10–14 for any additional Software Users you wish to add.
  13. Close the Client and restart the API and MQTT services.
  14. Reopen the Client. All users/accounts added to your project can now log in to the Apexx Series Software Client using the Sign in with Google button.

Related to