App Registration and Licensing
This section covers registration and license verification for the COSMO Core Library AT app. When the app is installed, COSMO Licensing is installed automatically. After installation, you must register the app with either a license activation code or a trial license.
Note
App registration via activation code is available when COSMO Licensing version 2.2 or higher is installed. Customers who purchase new subscriptions for COSMO products through our marketplace receive an activation code.
If you do not have the option to enter an activation code or have not received one, follow the steps in the Register the App with a Trial License section. After registering, you can contact appsource@cosmoconsult.com to upgrade your 30-day trial license to a full license.
COSMO License Overview
If the registration notification does not appear in the notification bar, refresh the environment.

In the notification bar, choose Open License Overview.
The app is listed on the COSMO License Overview page with Status = Not Registered.
Choose the Register Your Apps action.
The COSMO App Registration Wizard opens with the registration options.
Register the App with a License Activation Code
If you purchased the Business Central app through our marketplace, you received an activation code by email.
Enter this activation code on the first page of the COSMO App Registration Wizard in the License Activation Code field.
Note
In SaaS environments, an activation code can be used for exactly one production system. The same activation code can additionally be used in multiple SaaS environments (sandbox environments, e.g. test/demo/development environments). For On-Premises, there is no technical distinction between Production and Sandbox, so the activation code is instead bound to the serial number of the Business Central license (.flf / .bclicense) with which it was first activated. It can therefore be used multiple times On-Premises with the same Business Central license (to allow use in test/demo/development environments). Once redeemed, it cannot be used in BC environments with a different BC license.
To agree to the terms of use, scroll down, activate the I understand and accept these terms toggle, and then choose Next.
You have successfully registered your app. Choose Finish to close the wizard.
The license associated with the entered activation code is then automatically retrieved.
Register the App with a Trial License
On the first page of the COSMO App Registration Wizard, activate the Register a trial license instead toggle to display the app granule to be registered.

To agree to the terms of use, scroll down, activate the I understand and accept these terms toggle, and then choose Next.
Enter your customer name. The name is used to identify the company. For testing purposes, enter any Cronus-related name.
Choose Next to sign in to the COSMO platform and link the registration to your account. The COSMO platform opens in a new browser tab. After signing in, you can close the tab and return to the last page of the COSMO App Registration Wizard.
To skip this step, choose Skip Login.
You have successfully registered for a 30-day trial license for the app. Contact us at appsource@cosmoconsult.com and use the displayed license key to upgrade your trial subscription.
The app has Status = Registered. Choose Finish to close the wizard.

The status of the app is updated on the COSMO License Overview page. Leave the COSMO License Overview page to return to the Role Center.
Note
From the COSMO License Overview page, you can register the app and perform other administrative licensing tasks.
Verify the License
The COSMO License Overview page lists the license status of the COSMO app and is accessed via the Tell Me function.
- Choose the
icon, enter COSMO License Overview, and then choose the related link. This page can also be opened from the last page of the COSMO App Registration Wizard by choosing Open License Overview. - On the COSMO License Overview page, the app can be registered if this was not done via the Role Center notification bar. Other administrative tools are also available.
- Hover over an action on the COSMO License Overview page to read a short description.
Bei der Installation der App wird automatisch COSMO Lizenzierung installiert. Nachdem Sie die App installiert haben, müssen Sie sie entweder mit einem Lizenz-Aktivierungscode oder einer Testlizenz registrieren.
Note
Die App-Registrierung per Aktivierungscode ist verfügbar, wenn COSMO Lizenzierung Version 2.2 oder höher installiert ist. Kunden, die neue Abonnements für COSMO-Produkte über unseren Marketplace erwerben, erhalten einen Aktivierungscode.
Wenn Sie nicht die Möglichkeit haben, einen Aktivierungscode einzugeben oder keinen Aktivierungscode erhalten haben, folgen Sie den Schritten im Abschnitt Die App mit einer Testlizenz registrieren. Nachdem Sie sich registriert haben, können Sie sich an appsource@cosmoconsult.com wenden, um Ihre 30-Tage-Testlizenz in eine vollwertige Lizenz umzuwandeln.
Die COSMO Lizenzübersicht öffnen
Wenn die Registrierungsbenachrichtigung nicht in der Benachrichtigungsleiste angezeigt wird, aktualisieren Sie die Umgebung.

Wählen Sie in der Benachrichtigungszeile Lizenzübersicht öffnen.
Die App wird auf der Seite COSMO Lizenzübersicht mit Status = Nicht registriert aufgeführt.
Wählen Sie die Aktion Ihre Apps registrieren.
Der COSMO App-Registrierungsassistent öffnet sich mit den Registrierungsoptionen.
Die App mit Lizenz-Aktivierungscode registrieren
Wenn Sie die Business Central-App über unseren Marketplace erworben haben, haben Sie per E-Mail einen Aktivierungscode erhalten.
Geben Sie diesen Aktivierungscode auf der ersten Seite vom COSMO App-Registrierungsassistent im Feld Lizenz-Aktivierungscode ein.
Note
In SaaS-Umgebungen kann ein Aktivierungscode für genau ein Produktivsystem verwendet werden. Derselbe Aktivierungscode kann zusätzlich in mehreren SaaS-Umgebungen (Sandbox-Umgebungen, z. B. Test-/Demo-/Entwicklungsumgebungen) verwendet werden. Für On-Premises gibt es keine technische Unterscheidung zwischen Production und Sandbox, so dass der Aktivierungscode stattdessen an die Seriennummer der Business Central-Lizenz (.flf / .bclicense) gebunden ist, mit der er erstmalig aktiviert wurde. Er kann On-Premises also mit derselben Business Central-Lizenz mehrfach genutzt werden (um die Nutzung in Test-/Demo-/Entwicklungsumgebungen zu ermöglichen). Nachdem er einmal eingelöst wurde, kann er nicht mehr in BC-Umgebungen mit einer anderen BC-Lizenz verwendet werden.
Um den Nutzungsbedingungen zuzustimmen, scrollen Sie nach unten, aktivieren Sie den Schalter Ich verstehe und akzeptiere diese Bedingungen und wählen Sie dann die Schaltfläche Weiter.
Sie haben Ihre App erfolgreich registriert. Wählen Sie die Schaltfläche Fertig stellen, um den Assistenten zu schließen.
Die mit dem eingegebenen Aktivierungscode verbundene Lizenz wird dann automatisch gezogen.
Die App mit einer Testlizenz registrieren
Wenn Sie auf der ersten Seite vom COSMO App-Registrierungsassistent den Schalter Registrieren Sie stattdessen eine Testlizenz aktivieren, wird das zu registrierende App-Granule angezeigt.

Um den Nutzungsbedingungen zuzustimmen, scrollen Sie nach unten, aktivieren Sie den Schalter Ich verstehe und akzeptiere diese Bedingungen und wählen Sie dann die Schaltfläche Weiter.
Geben Sie Ihren Kundennamen ein. Der Name wird zur Identifizierung des Unternehmens verwendet. Geben Sie zu Testzwecken einen beliebigen Cronus-bezogenen Namen ein.
Wählen Sie die Schaltfläche Weiter, um sich bei der COSMO Plattform anzumelden und die Registrierung mit Ihrem Konto zu verknüpfen. Die COSMO Plattform wird in einem neuen Tab im Browser geöffnet. Nachdem Sie sich angemeldet haben, können Sie diesen Tab schließen und zur letzten Seite vom COSMO App-Registrierungsassistent zurückkehren.
Um diesen Schritt zu überspringen, wählen Sie die Schaltfläche Login überspringen.
Sie haben sich erfolgreich für eine 30-Tage-Testlizenz der App registriert. Kontaktieren Sie uns unter appsource@cosmoconsult.com und verwenden Sie den angezeigten Lizenzschlüssel, um Ihr Testabonnement zu aktualisieren.
Die App hat den Status = Registriert. Wählen Sie die Schaltfläche Fertig stellen, um den Assistenten zu schließen.

Der Status der App wird auf der Seite COSMO Lizenzübersicht aktualisiert. Verlassen Sie die Seite COSMO Lizenzübersicht, um zum Rollencenter zurückzukehren.
Note
Von der Seite COSMO Lizenzübersicht aus können Sie die App registrieren und andere administrative Lizenzierungsaufgaben durchführen.
Die Lizenz prüfen
Die Seite COSMO Lizenzübersicht listet den Lizenzstatus der COSMO-App auf und wird über die Funktion Tell Me aufgerufen.
- Wählen Sie das Symbol
, geben Sie COSMO Lizenzübersicht ein und wählen Sie dann den entsprechenden Link. Diese Seite kann auch über die Seite Anzahlungsverwaltung Einrichtung (Aktionen > App-Lizenzierung oder Zugehörig > App-Lizenzierung) und von der letzten Seite vom COSMO App-Registrierungsassistent geöffnet werden, indem Sie Lizenzübersicht öffnen wählen. - Auf der Seite COSMO Lizenzübersicht kann die App registriert werden, wenn dies nicht über die Benachrichtigungsleiste des Rollencenters erfolgte. Andere administrative Werkzeuge sind ebenfalls verfügbar.
- Fahren Sie über eine Aktion auf der Seite COSMO Lizenzübersicht, um eine Kurzbeschreibung zu lesen.
Siehe auch
Feedback
Submit feedback for this page.