Barcode Service on Product Documentation

Überblick

Mon, 01 Jan 0001 00:00:00 +0000

Zweck

BE-terna Barcode Service ist ein Container-basierter Middleware-Service, der von Business Central und weiteren Anwendungen aufgerufen wird, um QR- und Barcodes zu erzeugen und Nachrichten an externe Kanäle zu versenden. Der Service läuft wahlweise lokal auf einem eigenen Server oder als Azure Container Instance.

Fachlicher Nutzen

Erzeugt über 90 Barcode-Typen auf Knopfdruck, von EAN-13 und Code 128 bis QR Code und GS1-Varianten.
Bindet Barcodes nahtlos in Word-Layouts und Berichte in Business Central ein.
Liefert Barcodes als base64-kodierte PNG-Bilder und ist damit in beliebige Dokumente und Portale einbindbar.
Bietet eine einheitliche Middleware für Messaging-Kanäle wie Microsoft Teams, Telegram und WhatsApp.
Kann sowohl On-Premises als auch in der Azure Cloud als Software-as-a-Service betrieben werden.

Inhaltlicher Fokus

QR- und Barcode-Generierung

Der BE-terna Barcode Service erzeugt ein- und zweidimensionale Codes für alle relevanten Industrie- und Postal-Standards. Aufrufe erfolgen über eine einfache HTTP-GET-Schnittstelle; die Antwort enthält das Barcode-Bild direkt als base64-kodiertes PNG.

Einrichtung

Mon, 01 Jan 0001 00:00:00 +0000

Zweck

Diese Seite führt durch die grundlegende Einrichtung des BE-terna Barcode Service und hilft, das passende Bereitstellungsmodell auszuwählen. Der Service wird als Container-Image ausgeliefert und entweder lokal auf einem Windows-Server oder als Azure Container Instance betrieben.

Voraussetzungen

Zugang zur BE-terna Azure Container Registry becode.azurecr.io. Die Authentifizierung erfolgt über Tokens, die in der ACR erstellt werden. Für jeden Kunden wird ein eigenes Token bzw. Passwort angelegt.
Ein gültiges SSL-Zertifikat als .pfx-Datei für die Bereitstellung unter HTTPS.
Je nach Betriebsmodell zusätzlich:
- On-Premises: Windows-Server ab Build 22H2, mindestens 1 CPU-Kern, 1 GB RAM und 10 GB freier Festplattenspeicher; installierte Docker Engine und Docker Compose.
- Azure: aktives Azure-Abonnement, Azure CLI oder Azure-Portal-Zugriff, optional Azure Key Vault mit Azure-AD-Service-Principal für die Zertifikatsverwaltung.

Empfohlene Reihenfolge

Betriebsmodell auswählen: On-Premises oder Azure Container Instance.
Container-Image aus der Registry bereitstellen und den Service starten.
Zertifikat und Kennwörter konfigurieren.
Das BE-terna Barcode Service-Setup in Business Central pflegen und die Verbindung prüfen.

Einrichtungsbausteine

Bereitstellungsmodell wählen

On-Premises: Eignet sich, wenn Sie bereits eine Windows-Server-Infrastruktur betreiben und den Container dort selbst hosten möchten. Details unter On-Premise-Container einrichten.
Azure Container Instance: Eignet sich, wenn der Service ohne eigene Serverinfrastruktur in der Cloud laufen soll. Details unter Azure Container Instance einrichten.

Authentifizierung und Kennwörter

Verwenden Sie ein ACR-Token pro Kunde anstelle des Administratorkontos der Registry.
Legen Sie ein starkes Benutzerkennwort für den BE-terna Barcode Service fest und hinterlegen Sie denselben Wert im BE-terna Barcode Service-Setup in Business Central.
Schützen Sie den Zertifikatspfad und das Zertifikatskennwort; das Zertifikat muss im Container unter C:\certs\cert.pfx erreichbar sein.

Verbindung in Business Central prüfen

Hinterlegen Sie im BE-terna Barcode Service-Setup die Service-URL (z. B. https://<fqdn>:1880/becode) sowie die Basic-Authentication.
Nutzen Sie die Aktion Verbindung prüfen, um eine Test-Anfrage an den Container zu senden.

Process Hinweise zum sicheren Betrieb Wichtige Leitplanken für Zertifikate, Kennwörter und Registry-Zugriff. +

Zertifikatsdatei zwingend cert.pfx benennen und im auf dem Host gemappten Volume ablegen.
Das Standard-Demo-Kennwort ausschließlich für Tests verwenden; produktiv immer ein individuelles Kennwort setzen.
ACR-Token nicht in Repositories oder unverschlüsselten Skripten ablegen; stattdessen Key Vault oder sichere Variablenverwaltung nutzen.
Bei Azure Container Instance den Container nie ohne HTTPS bzw. Reverse-Proxy öffentlich exponieren.

On-Premise-Container einrichten

Mon, 01 Jan 0001 00:00:00 +0000

Zweck

Diese Seite beschreibt die empfohlene Vorgehensweise, um BE-Code als lokale On-Premise-Installation auf einem Windows-Server per Docker Compose zu betreiben.

Voraussetzungen

Windows-Server ab Build 22H2, mindestens 1 CPU-Kern, 1 GB RAM und 10 GB freier Festplattenspeicher.
Installierte und konfigurierte Docker Engine und Docker Compose.
Zugriff auf die BE-terna Azure Container Registry becode.azurecr.io; die Authentifizierung erfolgt über ACR-Tokens, ein Token je Kunde.
Gültiges SSL-Zertifikat als cert.pfx in einem Hostverzeichnis (z. B. C:\certs).

Empfohlene Reihenfolge

Anwendungsordner anlegen, z. B. C:\be.code.
Dateien docker-compose.yml und .env in diesem Ordner anlegen.
docker-compose.yml befüllen.
.env befüllen und Kennwörter setzen.
Container starten und Erreichbarkeit prüfen.

Einrichtungsbausteine

Docker-Compose-Datei pflegen

Legen Sie im Anwendungsordner die Datei docker-compose.yml mit folgendem Inhalt an:

Azure Container Instance einrichten

Mon, 01 Jan 0001 00:00:00 +0000

Zweck

Diese Seite beschreibt den empfohlenen Weg, um BE-Code als Azure Container Instance (ACI) ohne eigene Serverinfrastruktur zu betreiben. Optional binden Sie den Dienst an Azure Key Vault an, um Zertifikate zentral zu verwalten.

Voraussetzungen

Aktives Azure-Abonnement mit ausreichenden Rechten zum Anlegen von Ressourcengruppen und Container Instances.
Azure CLI auf dem Arbeitsplatz installiert oder Zugriff auf das Azure-Portal.
Zugriff auf die BE-terna Azure Container Registry becode.azurecr.io; Authentifizierung über ein ACR-Token je Kunde.
Optional: Azure-AD-Service-Principal mit Zugriff auf das Key Vault und ein gültiges SSL-Zertifikat im Key Vault.

Empfohlene Reihenfolge

Anmeldung an Azure und Container Registry.
Ressourcengruppe anlegen.
Azure Container Instance erstellen.
Container verifizieren und DNS-Weiterleitung einrichten.
Erreichbarkeit testen und Service-URL im BE-Code-Setup in Business Central pflegen.

Einrichtungsbausteine

Anmeldung

Melden Sie sich an Azure und an der Container Registry an: