Mobile Application

GE Digital no longer provides unsigned .ipa files for you to sign and distribute in your organization. As per the Apple Developer Program License Agreement and Apple Developer Enterprise Program License Agreement, you cannot bypass the App Store to distribute apps to non-employees. Starting from GE Digital APM version 4.4, the GE Digital APM Mobile iOS app is distributed through Apple Business Manager only. You must submit a support request to GE Digital to distribute the GE Digital APM mobile app through Apple Business Manager.

1. Go to GE Digital Customer Center at https://digitalsupport.ge.com/s/.
2. Submit a support request with the following details:
   • Your Apple Organization ID
   • Your Apple Organization Name
   • OnPremises GE Digital APM App Version

GE Digital provides an Android application, but there are specific steps that you must perform to install the GE Digital APM mobile application on Android devices.

1. Access the application package file at C:\Program Files\Meridium\ApplicationServer\distribution\GEDigitalAPM.apk.
   Note: This is the default location of the application package file. The exact location at which you can obtain the application package file may differ based on your initial installation of GE Digital APM.
2. Optional: If your organization does not use mobile device management, in the web page from which you want to distribute the application within your organization, add an anchor tag with an href pointing to the installation file, as shown in the following example:
   <a href="my.company.com/GEDigitalAPM.apk">Install GE Digital APM</a>

   You can use the link you configured to distribute the application within your organization.

1. Access the application package file at C:\Program Files\Meridium\ApplicationServer\distribution\GEDigitalAPM.zip.
   Note: This is the default location of the application package file. The exact location at which you can obtain the application package file may differ based on your initial installation of GE Digital APM.
2. Access the application package file at C:\Program Files\Meridium\ApplicationServer\distribution\GEDigitalAPM.zip.
   Note: This is the default location of the application package file. The exact location at which you can obtain the application package file may differ based on your initial installation of GE Digital APM.
3. On the device on which you want to install the GE Digital APM mobile application, extract the content of the application package file to a local folder.
4. In the folder into which you extracted the application package file content, right-click Install.bat, and then select Run as an Administrator.
   Note: If you are using a touch-screen device, press and hold Install.bat, and then select Run as an Administrator.
   The GE Digital APM mobile application is installed on the Windows device for all current and future Windows user accounts.
5. Optional: To cancel future installations or uninstall the GE Digital APM mobile application, in the folder into which you extracted the application package file content, right-click Uninstall.bat, and then select Run as an Administrator.
   Note: If you are using a touch-screen device, press and hold Uninstall.bat, and then select Run as an Administrator.
   The GE Digital APM mobile application is uninstalled for the Windows user account that is currently logged in, and installations for future Windows user accounts are canceled.

1. On a mobile device, select the GE Digital APM icon to launch the application.

   The login page appears.

   
   
   
2. In the Server box, enter the name or URL of the GE Digital APM Server to which you want to connect.
   Important:

   If your GE Digital APM Server is configured to use a secure connection, you must enter the full server URL or IP Address in one of the following formats:

   • https://<GEDigitalAPMServer.CustomerDomain>

     -or-

   • https://<IP address>

   Examples:

   • https://myserver.mycompany.com
   • https://172.16.254.1

   A list of data sources configured for the server appears.

3. Select the data source to which you want to log in.
4. In the Username box, enter your GE Digital APM User ID.
5. In the Password box, enter your password. Passwords are case sensitive.
6. Select Login.

   You are connected to the GE Digital APM database, and the GE Digital APM default dashboard page appears.

   Note: When logging in to GE Digital APM, a notification may appear, asking if you want to allow your machine to be used for additional local storage. This local storage is used to store log in information and preferences. Allowing this local storage is optional.

This topic describes how to access the GE Digital APM mobile application using SSO.

1. Start the GE Digital APM application.
   The GE Digital APM login page appears.

   
   
   
2. In the Server box, enter the name or URL of the GE Digital APM server to which you want to connect.
   Important: If your GE Digital APM server is configured to use a secure connection, you must enter the URL or IP address of the server in one of the following formats:

   • <GEDigitalAPMServer.CustomerDomain> (for example, myserver.mycompany.com)
   • <IP address> (for example, 172.16.254.1)
   A list of data sources configured for the server appears.
3. In the drop-down list box, select the data source that you want to access.
4. Select Sign-in with SSO.
   The SSO login page appears that is based on the IDP that is selected while configuring SSO.
5. Specify your SSO credentials, and then log in to access GE Digital APM.
   You are connected to GE Digital APM, and the default dashboard page appears.

   Note: If you have configured Single Logout, when you log out, you are logged out of the third-party identity provider (IDP) application as well. Therefore, when you attempt to access the GE Digital APM mobile application the next time, you are first redirected to the IDP login page where you must enter your SSO credentials again to log in.

1. Access the SAML configuration provided in Active Directory, and copy the value provided for the Logout URL parameter. This is the IDP URL to which the GE Digital APM mobile application sends a SAML logout request when you log out of the GE Digital APM mobile application.
2. On the machine on which you have installed the GE Digital APM application server, access the saml.json file. By default, it is located in the C:\Program Files\Meridium\ApplicationServer\api folder.
3. Insert the following parameter, and assign the Logout URL value that you have copied:

   SingleLogoutServiceUrl="<Logout URL of the identity provider (IDP) application>"

   {
       "SAML": {
           "$schema": "https://www.componentspace.com/schemas/saml-config-schema-v1.0.json",
           "Configurations": [
               {
                   "LocalServiceProviderConfiguration": {
                       "Name": "urn:componentspace:Meridium",
                       "AssertionConsumerServiceUrl": "~/core/security/ssologinauth",
                       "LocalCertificates": [
                           {
                               "FileName": "sp.pfx",
                               "Password": "password"
                           }
                       ]
                   },
                   "PartnerIdentityProviderConfigurations": [
                       {
                           "Name": "http://fs.xyz.com/adfs/services/trust",
                           "Description": "ADFS",
                           "SignAuthnRequest": true,
                           "WantSamlResponseSigned": false,
                           "UseEmbeddedCertificate": false,
                           "WantAssertionEncrypted": false,
                           "WantAssertionSigned": true,
                           "SingleSignOnServiceUrl": "https://fs.xyz.com/adfs/ls/idpinitiatedsignon.aspx",
                           "SingleLogoutServiceUrl": "",
                           "PartnerCertificates": [
                               {
                                   "FileName": "idp.cer"
                               }
                           ]
                       }
                   ]
               }
           ]
       }
   }

4. Access Active Directory, and then under Basic SAML Configuration, in the Logout URL box, enter a value in the following format:

   https://<GE Digital APM Application Server Name>/Meridium/api/core/security/singlelogout

   The Logout URL is the GE Digital APM application URL to which the IDP service sends the SAML logout response after you log out.
   After you log out of GE Digital APM mobile application, when you attempt to log in again, you are prompted to enter your SSO credentials.