Intrexx Mobile App

Stores

You can download the Intrexx Mobile app from the following stores:

Below is a description of the app and its features.

System Requirements

  • Android devices running Android version 8.1 ("Oreo") or higher

  • Apple devices running iOS version 12.3 or later ("Peace")

Connect to the Portal Server

The Intrexx Mobile app works exclusively with HTTPS portals.

Android

iOS

Address

Enter the address of your portal. You need sufficient permissions; if necessary, as well as VPN access to connect to the portal server. For more information on using VPN apps, click here. If the portal is an HTTPS portal with a self-signed certificate, that certificate must be installed on the mobile device. You can find information on installing the certificate here.

Connect

This button establishes a connection to the portal server.

Register a portal

On this page, you can register a portal on the device. Possible authentication methods:

  • Password Authentication with HTTPS

  • Intrexx Authentication

Other authentication methods require technical adjustments. You can find all the information here.

Android

iOS

Username / Password

Enter your username and password here.

Domain

Select here if necessary. Select the desired domain.

Login

Click this button to log in.

Allow notifications

Android

iOS

Allow

By clicking this button, you will receive notifications from the portal, which can be sent automatically within processes using the push notification action.

Do Not Allow / Reject

The portal does not send notifications to the current mobile device.

Home "Portal Overview"

The registered portals are displayed in a list here. The order of the portals can be changed using drag-and-drop.

Android

Navigation Bar

Click the " " menu button on the left side of the navigation bar to access the settings. Clicking the notification bell at loads the news overview. If there are notifications, the number of unread messages from all portals is displayed next to the notification bell. Clicking the " " button on the right side of the navigation bar loads the registration page.

List of Portals

To the left of each portal name, you'll find a circular button with a number on it. This shows the total number of notifications in the respective portal. Click this button to load the overview of all notifications in the portal. If there are notifications, the number of unread messages for each portal is also displayed here. Clicking on the portal name loads the home page of that portal in the portal browser.

Swiping left on a portal name deletes the portal.

Swiping right on a portal name displays the portal's options.

Settings

Loads the portal settings.

iOS

Navigation Bar

Access the " " menu button on the left side of the navigation bar

Configure the settings. Clicking "Intrexx" loads the news overview. If there are notifications, the number of unread messages from all portals is displayed next to the "Intrexx" link.

List of Portals

To the left of each portal name, you'll find a circular button with a number on it. This shows the total number of notifications in the respective portal. Click this button to load the overview of all notifications in the portal. If there are notifications, the number of unread messages for each portal is also displayed here. Clicking on the portal name loads the home page of that portal in the portal browser. Swiping left on a portal name displays the portal's own options.

Settings

Loads the portal settings.

Delete

The portal's registration will be deleted. Clicking the " " button in the lower right corner loads the registration page.

News Overview for All Portals

This page displays notifications from all portals. "Today" shows only today's news; "All" shows all news items. In the message list, notifications are grouped by portal. Messages you've read are grayed out.

Android

You can delete a message by clicking the " " Delete button to the right of the message.

Using the hamburger menu ( ) in the upper-right corner, you can delete all notifications or just today's notifications. Clicking on a message opens the corresponding section in the portal browser.

iOS

You can delete a message by clicking the " " Delete button to the right of the message.

Clicking the " " Delete button to the right of the portal name deletes all notifications for that portal. Clicking on a message opens the corresponding section in the portal browser.

News Overview for the Current Portal

This page displays notifications from the current portal.

Android

iOS

"Today" shows only today's news; "All" shows all news items. In the message list, read messages are grayed out.

You can delete a message by clicking the " " Delete button to the right of the message. Clicking on a message opens the corresponding section in the portal browser.

Portal Browser

You can navigate your Intrexx portal using the portal browser.

Android

In the navigation bar, you'll find buttons in the upper left and right corners that allow you to navigate forward to and backward to within the portal.

Clicking the " " Home button in the middle of the navigation bar closes the portal browser.

iOS

In the navigation bar at the top left, you'll find buttons that allow you to navigate forward to and backward to within the portal. Clicking "Done" in the upper-right corner of the navigation bar closes the portal browser.

Settings

You can access this page from the "Portal Overview" home page.

Android

iOS

Personal Settings

Background image

A different background image can be added here.

Android

iOS

Intrexx Images

Here you'll find suitable images that can be selected as a background.

Android

iOS

My Own Photos / Camera

Here, you can select your own photos stored on your mobile device or photos taken with the camera. For camera images, you can select the theme (White / Black).

Android

iOS

General Information

Help

Android

Opens the Help in an internal browser (WebView).

iOS

Opens the Help in an external browser.

Terms and Conditions & Privacy Policy

Opens the Terms and Conditions.

Android

iOS

Legal Notice

Displays the legal notice.

Android

iOS

Advanced

Delete Cookies

All cookies in the portal browser will be deleted.

Set to default

All settings will be reset to their default values.

Version Number

Displays the version number.

Fingerprint

The "Fingerprint" option (on/off) protects the app with a fingerprint you provide, if your device supports this feature. On iOS, the app can also be secured with Touch ID.

Portal Settings

Android

You can access this page from the "Portal Overview" home page by swiping right on a portal name in the list. The portal name, address, and username are displayed here. In addition, you can turn notifications on or off and enable or disable the use of a VPN client.

iOS

You can access this page from the "Portal Overview" home page by swiping left on a portal name in the list. The name, address, and user of the current portal are displayed here. Click on the respective field to edit the portal name, address, username, and password.

The respective changes affect only the data that is stored in encrypted form on the device. The data is not written back to the Intrexx Portal's user management system.

You can turn notifications on or off. If a connection cannot be established during the initial registration of the portal, the option to connect via VPN will be displayed. You can temporarily disable or reset your selection here. In addition, you can choose whether to continue storing your login credentials on the device permanently.

View when only one portal is registered

If there is only one portal in the list or the app, there is an additional option to change the app's home page or home screen.

Android

iOS

Android

iOS

From here, you can navigate to the portal overview, the notification list, or the portal browser.

Certificate Installation

Certificates must be in PKCS12 format (e.g., .pem or .cer). Android devices accept this format without any problems. The PKCS12 format offers the simplest installation process.

Android

The certificate can be installed manually from your smartphone's storage. For manual installation, the certificate is required as a .pem file on the smartphone. Follow these steps:

  1. Transfer the .pem file to the smartphone's Downloads folder, for example.

  2. Open the smartphone's Android settings.

  3. Select the Security & Screen Lock menu / Encryption & Login Credentials / Install from SD Card.

  4. Navigate to the directory where you saved the certificate file, and open it.

  5. If prompted, enter the device's PIN.

  6. Next, enter a name of your choice for the certificate.

You can check whether the certificate was installed successfully in the Android settings under the Security & Screen Lock / Encryption & Credentials / Trusted Credentials / Users menu. Your certificate, along with the name of the organization listed on it, should now be displayed here.

The names of the menu items may vary depending on the Android version.

Another option is to download it: Offer the certificate as a download and download it to your smartphone via your browser. You can then start the installation by clicking on the certificate or by going to "Settings" on your smartphone.

iOS

The certificate can be installed via Mobile Device Management (MDM) by your system administrator or manually from your smartphone's storage. For manual installation, the certificate is required as a .pem file on the smartphone. Follow these steps:

  1. Open the stored certificate to access the configuration profile.

  2. You can install the certificate in the configuration profile.

  3. If prompted, enter the device's PIN.

  4. Enable the certificate by going to Settings > General > About > Certificate Trust Settings.

You can view the installed certificate under Settings / General / Profile.

Using VPN Apps (iOS, Android)

On the connection page of the Intrexx Mobile app, you can connect to the Intrexx portal server by entering the portal address. Before proceeding, make sure you have sufficient permissions to access the server. If necessary, You need VPN access. Please contact your system administrator for assistance. Access can be set up as follows:

  1. The access information is entered manually in your device's system settings

  2. Access is registered via a VPN application

The VPN connection must be established before accessing the portal. You can establish the connection using any VPN app. Some VPN apps allow other apps to launch them. This app can launch the Intrexx app directly. Here are the supported VPN apps (subject to change):

  • Android

    • SonicWall

    • Checkpoint VPN

    • Cisco AnyConnect

    • F5 Access

  • iOS

    • SonicWall

    • Checkpoint VPN

    • Cisco AnyConnect

    • F5 Access

Access may need to be must be created manually before the portal goes live. To do this, launch the VPN app and then register the connection or establish the connection.

Authentication - Technical Adjustments

No additional settings are required for portals that use Intrexx authentication. Register the portal using its HTTPS URL in the Intrexx Mobile app, and log in with your Intrexx username and password.

Portals that use Active Directory for user authentication must be slightly modified to allow the Intrexx Mobile App to access them. First, the LDAP server's SSL certificate must be imported into the portal properties if the server is accessible via the LDAP protocol on port 636 using encryption. If it is listening in clear text via the LDAP protocol on port 389, this is not necessary.

Now add another authentication module to the "LucyAuth.cfg" file in the portal directory internal/cfg. Adjust the Active Directory server's provider URL to match your environment, and then copy the entire section into the LucyAuth.cfg file—for example, at the end of the file.

            IntegratedMobileAuth
{
	de.uplanet.lucy.server.auth.module.integrated.IntegratedLoginModule sufficient
		debug=false;

	de.uplanet.lucy.server.auth.module.ldap.LdapBindLoginModule sufficient
		java.naming.provider.url="ldaps://example.domain:636"
		java.naming.security.authentication="simple"
		java.naming.security.principal="$[DN]"
		debug=false;

	de.uplanet.lucy.server.auth.module.anonymous.AnonymousLoginModule sufficient
		debug=false;
};

If the connection to the Active Directory server via LDAP is unencrypted, please adjust the provider URL accordingly. Port 389 is usually used in such cases.

Enter the name of the new authentication module (IntegratedMobileAuth) in the "om.cfg" file in the portal directory /cfg under the "Web" binding scope:

            <binding scope="web" auth-type=" IntegratedMobileAuth"/>

If authentication against Active Directory is required, the request must be made via an HTTPS-encrypted web page on the web server, with anonymous authentication enabled and Windows authentication disabled.

A second website is not required if users who are not in Active Directory are to be able to log in to the portal when Integrated Windows Authentication is enabled. If all users are stored in Active Directory, simply enabling Basic Authentication in IIS is sufficient.

Then restart the portal service. In both scenarios, we expect encrypted connections via SSL/TLS for security reasons.

Both users of the Intrexx Mobile app and users who access the portal via a desktop browser can now log in to the portal using their Active Directory username and password.

Officially Signed Certificate

If you are already using an officially signed certificate, you can now enter the URL of your Intrexx portal within the app. If the connection request is successful, you will then be prompted to authenticate. If you use a self-signed certificate, a configuration file containing the full certificate chain must be stored on the end device. In order for the self-signed certificate to be trusted, the respective device must recognize the chain of CA certificates. You must bundle the certificates in this chain into a profile using any software (e.g., via Apple Configurator 2 or AirWatch). You then install it on the devices. The self-signed certificate itself does not need to be included in the profile. Please keep in mind that if you access the system from outside the company network, you will also need a mobile VPN client.

Register an API Key

Registered customers can request the API key for receiving push notifications from the portal on their mobile device at Intrexx Support Center. Enter it in the "Tools" module.

Troubleshooting / FAQ

Why can't I access my portal?

Possible solution:

  • The portal server is not running.

  • The URL is incorrect.

  • The portal requires HTTPS (authentication against Active Directory); the URL was accessed via HTTP (only possible with Intrexx authentication).

  • If you are using a self-signed certificate, import the certificate chain onto the mobile device.

  • The current network does not allow access to the portal (for example, the portal is accessible only via the intranet or through a VPN).

  • Incorrect Intrexx version. At least Intrexx 8 OU 17 is required.

Why can't I log in?

Possible solution:

  • The portal server is not running.

  • The username, password, or domain is incorrect.

  • Authentication in the portal is set up incorrectly.

Why am I not receiving push notifications?

Possible solution:

  • The option is not selected in the mobile app's portal settings.

  • Device token not stored in the Intrexx portal (e.g., deleted manually via the Portal Manager). Temporarily turn off the option to receive notifications in the portal settings, then turn it back on.

  • An error occurred in Intrexx while creating or sending the push notification (check portal log and workflow.log).

  • Android: The app was closed via the Android app settings ("Force Stop").

iOS: I received a push notification, but I don't see it in the app.

Possible solution:

  • The app was closed via the list of recently opened apps.

I selected a desktop layout using Intrexx's mobile layout switcher, and now I can't switch back to the mobile layout.

Possible solution:

  • Delete cookies in the mobile app's settings.

Why am I still receiving push notifications even though the portal has been deleted?

Possible solution:

  • The Intrexx portal was unavailable on the smartphone while attempting to remove the registration, and the device token could not be removed. Manually remove the device token in the portal.

When you click on a push notification, the Intrexx portal's login page opens instead of the destination page.

Possible solution:

  • Set page permissions.

More Information

Settings in the "Tools" module