In this chapter, you will learn how to connect a new app to your bestzero® Hive and make it available to your users.
Once you are successfully connected to your Hive, you can create a new app by pressing the button 
.
In this menu you specify all the information you can distribute about your bestzero® Hive.
Thereby there are the following sections to edit:
Enter the general information of your app.
This information will be used for administration in your bestzero® Hive.
App active
|
Select this check box to make your app available in the Appsbox of authorized users.
If you clear this check box, your app is not available in the Appsbox.
|
Timeline
|
Activate this checkbox to make your app available in the Appsbox on a time-controlled basis.
If you press the  "Three dots" button, you can make exact time settings when your app is active.
|
Name
|
Specify the internal name of your app.
This is displayed exclusively in the listing of your apps in the Hive Configurator.
|
Version
|
Specify the internal version number of your app.
|
Automatically increment version
|
Select this check box to have the internal version number of your app automatically incremented.
If you deactivate this checkbox, the version number specified under "Version" is used.
|
Only integer version numbers are incremented.
Example: 0, 1, 2, 3, ...
If it is a different version number consisting of alphanumeric characters, the internal version number will be preceded by the string "Z-" each time your app is updated.
Example: a, Z-a, Z-Z-a, ...
|
It is recommended to let the version number increase automatically to counteract a version conflict!
|
If you want to maintain the version number manually, you must keep in mind that an app is only updated in the Appsbox if the version number also changes.
|
|
|
Enter the information about your provider server.
This information was usually provided to you by the company Cordaware GmbH.
Ipv6
|
Select this check box to connect to your provider server using an IPv6 address.
If you deactivate this check box, the address entered will be interpreted as an IPv4 address.
|
Address
|
Enter the address of your provider server.
|
This typically follows a scheme such as px1234.bestzero.world and was provided to you by the company Cordaware GmbH.
|
|
Port
|
Specify the port used to connect to your provider server.
|
Pool count
|
Enter the desired number of connections that are available waiting at the same time.
These are established in advance from your bestzero® Hive to your provider server.
Requests via the Appsbox of your users will be sent to your provider server. The data exchange with your bestzero® Hive is enabled via these already available connections.
|
Default: 10
This is not the maximum number of connections!
As soon as a user accesses this app, the bestzero® Hive will prepare an additional connection with the provider server, so that the specified number of connections are always available simultaneously.
|
|
Please note:
The higher this value is, the better high user fluctuations can be handled.
However, a high "pool count" also significantly increases the server load of your bestzero® Hive!
|
|
|
Provide all the information about your app that is necessary for it to work.
2FA
|
Check this box to lock your app with two-factor authentication.
|
Coid
|
Enter your Company ID (CoID).
|
This was provided to you by the company Cordaware GmbH.
|
|
Dns
|
Specify the DNS entry you want to use to make your app available to your users.
This can be freely selected and is entered in the "hosts" file for your users. This controls access to external applications from the Appsbox, among other things.
|
When choosing your desired DNS entry, make sure that there are certain top-level domains (TLDs) which, by definition, may only be accessible in encrypted form!
When using such TLDs, you must ensure that the application you want to provide is also available in encrypted form.
|
|
Port(Range) Port,Port1-Port2
|
Specify the port you want to use to make your app available to your users.
This is also freely selectable.
|
It is recommended to use the default port of the protocol used. (e.g. port 443 for HTTPS).
|
You also have the option to specify multiple ports comma-separated or an entire port range.
Individual ports and port ranges can also be combined. The order does not matter.
|
Example:
If you want to enable ports 80 and 443, as well as the port range 21 to 23 for an app, you can specify this as follows:
80,443,21-23
|
|
Link to open the app for all operating systems
|
Specify the link that should be opened when your user opens this app in the Appsbox.
If you press the  "Plus" button, you can also specify an Infotext that should appear in the app box when the app button is pressed.
If an Infotext is already stored, a "three dots" button will be displayed instead of the "Plus" button, which you can use to edit the existing Infotext.
Typically, this link contains your specified DNS record as well as your specified port.
|
For more information on storing an Infotext, please refer to the chapter Add Infotext.
|
|
Link to open the app for Windows
Link to open the app for macOS
Link to open the app for Linux
Link to open the app for Android
Link to open the app for iOS
|
If you want to use operating system specific links, you can add them using the  button.
If no specific link is specified, the link will be used for all operating systems.
|
These links are opened on the Windows, MacOS, Linux, Android or iOS operating system respectively.
This is necessary, for example, for a link to your network storage, since this must be specified specifically for the individual operating systems.
|
If you press the respective "Plus" buttons, you can also specify an operating system-specific Infotext that should appear in the Appsbox when the app button is pressed.
As with the link for all operating systems, a "three dots" button is displayed instead of the "Plus" button if an Infotext for an operating system-specific link has already been stored.
You can subsequently edit the existing Infotext via this button.
|
For more information on storing an Infotext, please refer to the chapter Add Infotext.
|
|
|
Specify the description of your app. This is the display name in your users' Appsbox.
You have the option to specify the description language specific. You can add more descriptions using the  button.
Language
|
Select here your desired language for which you want to specify a description of your app.
|
If no description is defined for the language of your own operating system, the description of the English language is used.
In such a case, if there is no description for English, the name in the user's Appsbox will remain empty!
Therefore, you should always define a description for English at best.
|
|
Description
|
Specify the language-specific description of your app.
|
This description is displayed in the Appsbox of your users.
It is the display name of your app in the Appsbox.
Example:
In this example, the description has been set to "Cordaware Start website".
|
|
|
Specify the access options for which domain users you want your app to be available to in the Appsbox.
All
|
Select this check box to make your app available to any user registered in your domain.
If you clear this check box, your app is shared according to the following restrictions.
|
Users list, case-sensitive!
|
Specify a comma-separated list of login names of all users for whom you want your app to be exclusively available.
|
Please pay attention to correct upper and lower case!
|
|
Groups list, upper and lower case!
|
Specify a comma-separated list of all groups for which you want your app to be exclusive.
|
Please pay attention to correct upper and lower case!
|
|
List of OUs, case-sensitive!
|
Specify a comma-separated list of all OUs for which you want your app to be exclusively available.
|
Please pay attention to correct upper and lower case!
|
|
|
Specify the information about the service that you want to make available to your users.
This is the connection information through which the service can be reached internally on your corporate network.
No source, public link
|
Select this check box if your app is only a publicly accessible link and you want to share it in Appsbox.
If you clear this check box, your app is shared according to the following information.
|
Address
|
Specify the address of your service to be shared.
|
When specifying a FQDN, the address is resolved by the DNS server configured on the machine of the bestzero® Hive.
If you specify a FQDN here, make sure that the entries "DNS" and "Link to open the app" in the "Zero App Details" section are usually identical to avoid certificate errors for your users.
For example, if you want to share an internal website and it includes redirection or references to other internal servers, these must also be shared as an app to allow full access.
|
|
Please note:
Enter here only the FQDN or IP address of the machine on which your service is available.
|
|
Ipv6
|
Select this check box to connect to your service using an IPv6 address.
If you clear this check box, the address you enter will be interpreted as an IPv4 address.
|
Port(range)
|
Specify the port over which your service can be addressed internally.
You also have the option of specifying several ports comma-separated or an entire port range.
Individual ports and port ranges can also be combined. The order does not matter.
|
Example:
If you need the ports 80 and 443, as well as the port range 21 to 23 for a service, you can specify this as follows:
80,443,21-23
|
|
Dynamic source
|
Check this box if you want to provide multiple sources with this one app.
|
You can use this feature to provide access via RDP to 100 machines at once, for example.
Without these dynamic addresses, you would have to create a separate app for each machine.
So this reduces the administration effort from setting up 100 different apps to setting up a single app.
|
|
Please note:
For your users who use the Appsbox on a Linux distribution, this functionality is only available when using "systemd-resolved".
|
|
Dynamic address as regular expression
|
Specify here the dynamic prefix of your address as a regular expression.
|
Example:
You have set "cordaware.local" as the address.
This is used in this case as a suffix for the addresses to be provided to the user.
Now the regular expression "winsrv[1-4]" is used here.
This means that the prefix of your address starts with the string "winsrv" and is followed by a number between 1 and 4 (inclusive).
Accordingly, the following addresses are provided for your users via this app:
•winsrv1.cordaware.local •winsrv2.cordaware.local •winsrv3.cordaware.local •winsrv4.cordaware.local |
|
Protocol
|
Select the protocol over which your service can be addressed.
You can choose between the TCP and UDP protocols.
|
For example, for web applications over HTTP/HTTPS, select the TCP protocol.
|
|
App only visible with active connection to source
|
Select this check box if you want your app to be visible in your users' Appsbox only when the shared service is actually reachable.
If you clear this check box, your app is always visible.
|
Secure
|
Select this check box if the query whether the shared service is actually reachable should be SSL-secured.
|
|
Once you have entered all the information, you can use the "Save" button 
to save your app and share it with your users' Appsbox.
If you want to cancel the creation of your app, use the "Cancel" button 
.
You can delete an existing app from the bestzero® Hive configuration as well as from the Appsbox using the "Delete" button 
.
Example of creating a new app
In this example, we create an app that opens the address "http://new-app.zero:4711/" when clicked in the Appsbox.
Behind this address is a web application that can be reached from the perspective of the bestzero® Hive via "my-service.cordaware.local" and port 8000.
It receives the description "Neue App" for German-speaking operating systems and "New App" for English-speaking operating systems.
In addition, it receives the internal name "zero_new_app", which is displayed in the left sidebar of the Hive Configurator.
|
To learn how to customize an already created app, see the Customize an app chapter.
|
