| PageIdMakro |
|---|
| Seiteneigenschaften |
|---|
Description:
Wird eine If a Unified Firewall is managed in der the LANCOM Management Cloud (LMC) verwaltet, werden alle Netzwerke in der Standard-Einstellung über die Schnittstelle ETH1 übertragen. In der LMC gibt es in dem Menü Projektvorgaben → Basis → Erweiterte Einstellungen zwar die Möglichkeit, die Netzwerke einer anderen Schnittstelle zuzuweisen, allerdings gelten diese Einstellungen global für alle Unified Firewalls in dem Projekt. Mittels der LMC-API kann die Variable UF_DEFAULT_IF aktiviert werden. Diese kann dann gezielt einer bestimmten Unified Firewall oder einem bestimmten Standort zugewiesen werden.
In diesem Artikel wird beschrieben, wie die Variable UF_DEFAULT_IF mittels der LMC-API in einem LMC-Projekt aktiviert werden kann, damit diese anschließend auf einzelnen Unified Firewalls oder in einem bestimmten Projekt zur Verfügung steht.
Requirements:
- Zugang zur LMC samt eigenem LMC-Projekt
- Benutzerrolle Technical Administrator oder Project Administrator
- Grundkenntnisse der Entwickler-Konsole im Web-Browser
Procedure:
1. Aufrufen der LMC-API:
, by default all of the networks are transmitted via the ETH1 interface. Although the LMC allows you to assign the networks to a different interface via the menu Project specifications → Basic → Extended settings, these settings apply globally to all Unified Firewalls in the project. The LMC API can be used to activate the variable UF_DEFAULT_IF, which is then used to set the interface for a specific Unified Firewall or site.
This article describes how the LMC API is used to activate the variable UF_DEFAULT_IF in an LMC project, so making it available to individual Unified Firewalls or a specific project.
Requirements:
- Access to the LMC including your own LMC project
- User role Technical Administrator or Project Administrator
- Basic knowledge of the developer console in the web browser
Procedure:
1) Calling the LMC API:
1.1 Klicken Sie in der LMC auf 1.1) In the LMC, click System Information.
1.2 Klicken Sie unter Service information auf Show information, damit die LMC-Dienste angezeigt werden) Under Service Information, click Show information to display the LMC services.
1.3 Klicken Sie auf den Dienst ) Click the service service-config (1).
| Info |
|---|
Alternativ können Sie auch den Dienst You can alternatively use the service service-config (2)oder or service-config (3) auswählen. Diese dienen lediglich der Ausfallsicherheit. These are used to ensure reliability. |
2. LMC Bearer-Token über die Entwickler-Konsole des Web-Browsers auslesen:
Öffnen Sie in Ihrem Web-Browser eine separate Instanz Ihres LMC-Projekts. Öffnen Sie anschließend in Ihrem Web-Browser die Entwickler-Konsole (hier am Beispiel von Firefox) und wechseln in die Network.
Klicken Sie auf einen aktuellen Eintrag und lesen unter Request Headers bei Authorization den Bearer-Token aus (ohne das vorangestellte Bearer).
| Hinweis |
|---|
Ein Bearer-Token ist immer nur 120 Sekunden gültig. Stellen Sie daher unbedingt sicher, dass ein aktueller Eintrag ausgelesen wird. Zudem müssen die Schritte 3. und 4. innerhalb dieses Zeitfensters ausgeführt werden. |
3. Anmeldung in der LMC-API:
) Reading out the LMC bearer tokens via the web browser’s developer console:
Open a separate instance of your LMC project in your web browser. Then open the developer console in your web browser (here using Firefox as an example) and switch to the Network.
Click on a current entry and read out the bearer token under Request Headers > Authorization (omitting the preceding Bearer).
| Hinweis |
|---|
A bearer token is valid for 120 seconds only. Therefore, make sure that you read out a current entry. Furthermore, steps 3 and 4 must be carried out within this time window. |
3) Login to the LMC API:
3.1 Klicken Sie in der LMC-API auf 3.1) In the LMC API, click Authorize.
3.2 Tragen Sie unter ) Under bearer (apiKey) bei Value den in Schritt 2. ausgelesenen Bearer-Token ein und klicken auf , enter the value for the bearer token copied in step 2) and click Authorize.
3.3 Klicken Sie auf Close, um das Fenster zu schließen) Click Close to exit the window.
4. Aktivieren der Variable ) Enabling the variable UF_DEFAULT_IF:
4.1 Scrollen Sie zu dem Abschnitt ConfigVariable und klicken bei ) Scroll down to the section ConfigVariable and, for the POST /configvariable/accounts/{accountId}/variables auf das "Pfeil-Symbol", um die erweiterten Einstellungen für diese Methode aufzurufen, click the “arrow” symbol to access the advanced settings for this method.
4.2 Klicken Sie auf ) Click Try it out, um die Variable sowie die Account-ID anzugeben to specify the variable and the account ID.
4.3 Tragen Sie die folgenden Parameter ein und klicken auf ) Enter the following parameters and then click Execute:
- accountId: Tragen Sie die Account-ID Ihres LMC-Projekts ein Enter the account ID for your LMC project.
- variable: Tragen Sie den folgenden Code-Abschnitt einEnter the following code.
{
"name": "UF_DEFAULT_IF",
"restricted": "false",
"system": "true",
"value": "auto",
"defaultValue": "auto"
}
| Info |
|---|
Wenn Sie Ihr LMC-Projekt im Web-Browser öffnen, können Sie die Account-ID in der Adresszeile Ihres Web-Browsers hinter project/ auslesenWhen you open your LMC project in the web browser, you can see the account ID in the address line of your web browser after project/.
|
4.4 Die erfolgreiche Ausführung wird mit dem Code ) Successful execution is acknowledged by the code 200 (HTTP 200 OK) quittiert.
| Info |
|---|
Sollte an dieser Stelle der Code If the code 401 (HTTP 401 Unauthorized) ausgegeben werden, ist der Bearer-Token entweder fehlerhaft oder nicht mehr gültig. Lesen Sie in diesem Fall den Bearer-Token wie in Schritt 2. beschrieben neu aus und autorisieren sich wie in Schritt 3. beschrieben erneutis shown here, the bearer token is either incorrect or has expired. In this case, read out the bearer token again as described in step 2) and authorize yourself again as described in step 3). |
5. Zuweisung der Variable ) Assigning the variable UF_DEFAULT_IF in der the LMC:
Die Variable The variable UF_DEFAULT_IF kann nun in der LMC einem bestimmten Gerät oder einem bestimmten Standort zugewiesen werden (in diesem Beispiel wurde das Standard-Interface auf eth2 gesetzt). Die Variable kann anschließend in einem Add-in referenziert werdenIF can now be assigned to a specific device or a specific location in the LMC (in this example the default interface is set to eth2). The variable can then be referenced in an add-in.
