# Konfiguration aBServer-Dienst

# Allgemeine Informationen

Mit diesem Modul kann der **aBServer-Dienst** konfiguriert werden. Dieses Modul kann nur lokal auf dem Rechner ausgeführt werden, auf dem das Programm installiert ist.

![Konfiguration_Dienst_2.PNG](https://portal.artbase-software.de/userdata/Documentation/Dienst/Konfiguration_Dienst_2.PNG)

- ##### Windows-Dienst installieren bzw. deinstallieren
- ##### Dienst starten/beenden
    
    Starten bzw. beenden des aBServer-Dienstes. Wenn Sie den Dienst beenden, ist kein Zugriff von außen mehr möglich
- ##### Einstellungen
    
    Aufrufen der [Einstellungen](https://doku.artbase-software.de/link/548)
- ##### Aktive Anmeldungen abfragen
    
    Anzeige der momentan aktiven Anmeldungen am aBServer-Dienst

### Voraussetzungen

Damit Ihre Mitarbeiter oder Filialen über das Internet auf Ihre Daten zugreifen können, müssen folgende Voraussetzungen erfüllt sein:

1. Auf dem Server-Rechner muss als Betriebssystem Windows 10 / Server 2016 oder höher installiert sein.
2. Auf dem Server, der die Daten extern zur Verfügung stellen soll, müssen eine Installation von aB-Agenta und der entsprechende Daten-Ordner vorhanden sein.
3. Dieser Server muss über das Internet erreichbar sein. Das bedeutet, man muss eine statische öffentliche IP- oder www-Adresse besitzen, die auf diesen Server verweist. Sollten Sie keine statische IP-Adresse haben, kann man das künstlich über verschiedene Anbieter wie beispielsweise [TwoDNS](https://www.twodns.de/) erreichen.
4. Wenn Sie eine Firewall einsetzen, muss der entsprechende Port, an dem die Anfragen eingehen, an den Server weitergeleitet werden. Die korrekte Konfiguration der Firewall wird von uns vorausgesetzt. Wir stellen anhand der FRITZ!Box 7590 die [Konfiguration](https://doku.artbase-software.de/link/552) einer Portweiterleitung vor.
5. Damit der Zugriff über das Internet erfolgen kann, muss der **aBServer-Dienst** auf dem Server installiert und gestartet sein. Ebenso müssen die korrekten [Einstellungen](https://doku.artbase-software.de/link/548) für den Zugriff getroffen worden sein.
6. Für den Windows-Benutzer, der für den Remote-Zugriff eingesetzt wird, muss zwingend ein Kennwort definiert werden.

### aBServer-Dienst in Betrieb nehmen  


<div id="bkmrk-abserver-dienst-in-b"></div><div id="bkmrk-um-den-abserver-dien">Um den aBServer-Dienst erstmalig in Betrieb zu nehmen führen Sie folgende Schritte aus:</div><div id="bkmrk-pr%C3%BCfen-und-erf%C3%BCllen-">1. Prüfen und erfüllen Sie die oben genannten Voraussetzungen.
2. Installieren Sie den Windows-Dienst, indem Sie auf die Schaltfläche Dienst installieren klicken.
3. Klicken Sie auf Einstellungen und konfigurieren Sie den Dienst Ihren Gegebenheiten entsprechend. Siehe [aBServer-Dienst - Einstellungen](https://doku.artbase-software.de/link/548)

</div>

# Einstellungen

In diesem Dialog können Sie die Einstellungen für den Remote-Zugriff und den Zugriff über unsere [API](https://artbase-software.de/ab-agenta-api-version-2-0/) konfigurieren.

Sie erreichen diesen Dialog über Konfiguration aBServer-Dienst.

![uJvcnD6iBatf8mop-8e92937d-33dd-4f1a-99a9-e5e5b466d70f.png](https://doku.artbase-software.de/uploads/images/gallery/2026-08/uJvcnD6iBatf8mop-8e92937d-33dd-4f1a-99a9-e5e5b466d70f.png)

### Optionen Remote-Zugriff

<div id="bkmrk-dienst-nameder-name-"><div>- ##### Dienst-Name
    
    Der Name des Windows-Dienstes. Dieser ist vorgegeben und kann nicht geändert werden.
- ##### <span style="color: #4d82b8;">Modul-Kennwort  
    </span>
    
    <span style="color: rgb(0,0,0);">Das Modul-Kennwort muss bei Verbindungen von außen angegeben werden und stellt eine zusätzliche Sicherheitsmaßnahme dar. Durch einen Klick auf den Knopf [![eye.png](https://doku.artbase-software.de/uploads/images/gallery/2026-08/scaled-1680-/YlMhX3EowpnHB8Nx-eye.png)](https://doku.artbase-software.de/uploads/images/gallery/2026-08/YlMhX3EowpnHB8Nx-eye.png) können Sie sich das Modul-Kennwort anzeigen lassen.</span>
- ##### <span style="color: #4d82b8;">Ordner-Freigabe  
    </span>
    
    <span style="color: rgb(0,0,0);">Tragen Sie hier Ihren Datenordner ein. Dadurch geben Sie externen Nutzern die Erlaubnis, auf diesen Datenordner zuzugreifen. Falls Sie mehrere Pfade angeben möchten, tragen Sie diese hintereinander ein und trennen sie mit einem Semikolon ";".</span>
- ##### <span style="color: #4d82b8;">SQL-Server-Freigabe  
    </span>
    
    <span style="color: rgb(0,0,0);">Tragen Sie hier die SQL-Server-Instanz Ihres Datenordners ein (standardmäßig "*\\ARTBASE2019*"). Dadurch geben Sie externen Nutzern die Erlaubnis, auf diesen SQL-Server zuzugreifen. Falls Sie mehrere Instanzen angeben möchten, tragen Sie diese hintereinander ein und trennen sie mit einem Semikolon ";".</span>
- ##### <span style="color: #4d82b8;">Anzahl Verbindungen  
    </span>
    
    <span style="color: rgb(0,0,0);">Die maximale Anzahl gleichzeitig verbundener Clients.</span>
- ##### <span style="color: #4d82b8;">Port  
    </span>
    
    <span style="color: rgb(0,0,0);">Der TCP-Port, der für Remote-Sitzungen verwendet wird. Der Standardwert ist 50000.</span>

</div></div>### Optionen Kalender-Synchronisation

<div id="bkmrk-zeitintervall-%28in-mi"><div><div><div><div>- ##### Zeitintervall (in Min.)
    
    <span style="color: rgb(0,0,0);">Hier stellen Sie das Intervall ein, in dem der Online-Kalender synchronisiert werden soll. Das System startet dann automatisch eine Synchronisation der hinterlegten Kalender.</span>
- ##### <span style="color: #4d82b8;">Datenordner  
    </span>
    
    <span style="color: rgb(0,0,0);">An dieser Stelle können Sie den Datenordner einstellen, dessen Kalender automatisch synchronisiert werden soll.</span>

</div></div></div></div></div>
### Optionen API

<div id="bkmrk-porthier-stellen-sie"><div><div><div><div><div><div><div>- ##### Port
    
    <span style="color: rgb(0,0,0);">Hier stellen Sie das Intervall ein, in dem der Online-Kalender synchronisiert werden soll. Das System startet dann automatisch eine Synchronisation der hinterlegten Kalender.</span>
- ##### <span style="color: #4d82b8;">Domain</span>
    
    <span style="color: rgb(0,0,0);">Das ist die Domain, mit der auf die API zugegriffen wird. Diese Domain wird nur benötigt, wenn TLS/SSL eingeschaltet wird. Das System sucht dann täglich anhand dieser Domain nach einem Zertifikat im Zertifikatsspeicher, dass an den entsprechenden Port gebunden wird.</span>  
    <span style="color: rgb(0,0,0);">Die Angabe ist notwendig, falls die Verschlüsselung per TLS/SSL eingeschaltet wird.</span>
- ##### <span style="color: #4d82b8;">TLS/SSL  
    </span>
    
    <span style="color: rgb(0,0,0);">Hier können Sie festlegen, ob der API-Zugriff verschlüsselt stattfinden soll.</span>  
    <span style="color: rgb(0,0,0);">Wenn Sie den Zugriff von außen über das Internet freigeben, sollten Sie diese Option zwingend setzen, weil ansonsten Daten und Kennwörter unverschlüsselt übertragen werden.</span>  
    <span style="color: rgb(0,0,0);">Findet der Zugriff z.B. immer über eine VPN-Verbindung statt, ist eine Verschlüsselung nicht zwingend notwendig.</span>
- ##### <span style="color: #4d82b8;">Zertifikatseinstellungen  
    </span>
    
    <span style="color: rgb(0,0,0);">Die Zertifikatseinstellungen sind notwendig, wenn der Zugriff auf die API über TLS/SSL verschlüsselt stattfinden soll. Öffnen des Dialogs für die</span> [Zertifikatseinstellungen](https://doku.artbase-software.de/link/549).
- ##### <span style="color: #4d82b8;">Dokumentation API 2.1</span>**<span style="color: #4d82b8;">  
    </span>**
    
    <span style="color: rgb(0,0,0);">Link zum Aufruf der API 2.1 Dokumentation von diesem Dienst. So können Sie eine API-Implementierung mit Ihren eigenen Daten testen.</span>
- ##### <span style="color: #4d82b8;">Dokumentation API 2.0</span>
    
    <span style="color: rgb(0,0,0);">Link zum Aufruf der API 2.0 Dokumentation von diesem Dienst. So können Sie eine API-Implementierung mit Ihren eigenen Daten testen.</span>
- ##### <span style="color: #4d82b8;">CORS</span>
    
    <span style="color: rgb(0,0,0);">Einschalten der CORS-Funktion für die API. Dadurch können auch an anderer Stelle gehostete Webseiten auf unsere API zugreifen.</span>
- ##### <span style="color: #4d82b8;">CORS Origins</span>
    
    <span style="color: rgb(0,0,0);">Wenn CORS eingeschaltet ist, kann man hier einschränken, von welchen Webseiten der Zugriff erlaubt ist. Ist das Feld leer, gilt CORS für alle, ansonsten kann man IP-Adressen oder Domain-Namen eintragen, für die CORS erlaubt sein soll. Einzelne Einträge werden dabei durch eine Pipe "|" getrennt. Die Angabe ist optional.</span>
- ##### <span style="color: #4d82b8;">Debug Log-Dateipfad</span>
    
    <span style="color: rgb(0,0,0);">In diesem Ordner werden gegebenenfalls Log-Dateien gespeichert.</span>

</div></div></div></div></div></div></div></div>### Vorgehensweise für die Inbetriebnahme des Dienstes

<div id="bkmrk--3"><div><div>  
</div></div></div>Definieren Sie als erstes ein **Modul-Kennwort** für den externen Zugriff. Dieses Kennwort muss keine besonderen Richtlinien erfüllen. Da es sich aber um eine zusätzliche Sicherheit für den Zugriff von außen darstellt, sollte dieses Kennwort eine ausreichende Komplexität erfüllen.

Legen Sie nun unter **Ordner-Freigabe** das Verzeichnis fest, das für den Zugriff von außen freigegeben werden soll. Typischerweise ist das der **aB-Agenta Datenordner**. Auf diesen und untergeordnete Ordner können die externen Versionen zugreifen. Alle Ordner in den Ebenen darüber werden durch den **aBServer-Dienst** gesperrt.

Bei der **SQL-Server-Freigabe** wird der SQL-Server-Name eingetragen, an dem die aB-Agenta-Datenbank angebunden ist. Hierbei handelt es sich standardmäßig um '\\ARTBASE2019'. Sollten Sie nicht genau wissen, wie der SQL-Server-Name lautet, können Sie diesen auch in der **SQL-Datenbank-Verwaltung** von aB-Agenta nachschauen. Rufen Sie diese über die **Zusatzmodule** innerhalb von aB-Agenta auf.

Zuletzt wählen Sie noch einen **Port**, an dem der **aBServer-Dienst** auf Anfragen wartet. Der Port-Bereich bei einem Windows-Betriebssystem reicht von 1 bis 65535. Dabei sind zwischen 1 und 49151 einige Ports durch Standards belegt, wie beispielsweise Port 80 für Internet-Verkehr über das http-Protokoll. Die benutzerdefinierten Ports beginnen ab 49152. Wir geben standardmäßig den Port 50000 vor. Sollte dieser bereits durch eine andere Anwendung benutzt werden, definieren Sie einfach einen anderen. Der gewählte Port muss noch an der externen Firewall freigeschaltet und weitergeleitet werden. Wir haben die Portweiterleitung am [Beispiel einer FritzBox](https://doku.artbase-software.de/link/552) beschrieben. Die Freigabe der Ports (Remote-Zugriff und API) in der Windows Firewall kann durch einen Klick auf den Knopf Ports in der Windows-Firewall freigeben automatisch gemacht werden.

# Zertifikatseinstellungen

Um den Zugriff auf die API von außen abzusichern, benötigt man eine Internet-Domain und ein Zertifikat zur Verschlüsselung.  
Die Domain muss auf Ihren Internet-Anschluss verweisen, damit Anfragen aus z.B. einem Webbrowser auch an den aBServer-Dienst weitergeleitet werden können.

<div id="bkmrk-haben-sie-bereits-ei">Haben Sie bereits ein gekauftes Zertifikat für die entsprechende Domain, können Sie dieses hier importieren. Haben sie kein Zertifikat für die Domain, kann der aBServer-Dienst automatisch ein LetsEncrypt-Zertifikat erzeugen und aktualisieren.</div><div id="bkmrk-letsencrypt-zertifik">LetsEncrypt-Zertifikate sind kostenlos, haben dafür aber nur eine Gültigkeit von 3 Monaten. Der aBServer-Dienst versucht ab 30 Tage vor Ablauf der Gültigkeit das LetsEncrypt-Zertifikat zu erneuern.</div><div id="bkmrk-damit-der-abruf-eine">Damit der Abruf eines LetsEncrypt-Zertifikats funktioniert, muss der externe Port 80 an den internen hier eingestellten Port weitergeleitet werden.</div><div id="bkmrk-zus%C3%A4tzlich-schaut-de">Zusätzlich schaut der Dienst jeden Tag im Windows-Zertifikatsspeicher nach, ob dort ein aktuelles Zertifikat für die in den Einstellungen hinterlegte Domain gibt. Wenn dem so ist, wird dieses für die Verschlüsselung der API-Zugriffe genommen. So können Sie die Erzeugung eines LetsEncrypt-Zertifikats auch außerhalb unseres Dienstes realisieren bzw. ein gültiges gekauftes Zertifikat im Zertifikatsspeicher importieren.</div><div id="bkmrk-im-dialog-f%C3%BCr-die-ze">Im Dialog für die Zertifikatseinstellungen kann man zwischen zwei Optionen wählen:</div>### Eigenes Zertifikat

<div id="bkmrk-hier-kann-man-beispi">Hier kann man beispielsweise ein gekauftes Zertifikat in den Zertifikatsspeicher importieren und für den Service nutzen oder ein bereits im Zertifikatsspeicher vorhandenes Zertifikat auswählen.  
![szTDFwOxFJbdO0uO-802743d0-032d-41f7-b429-0f6daad16cf1.png](https://doku.artbase-software.de/uploads/images/gallery/2026-08/szTDFwOxFJbdO0uO-802743d0-032d-41f7-b429-0f6daad16cf1.png)- ##### Zertifikat von Festplatte importieren
    
    Durch einen Klick auf diesen Knopf können Sie ein Zertifikat auf der Festplatte auswählen. Dieses Zertifikat wird in den Windows-Zertifikatsspeicher importiert und an den API-Port gebunden, damit ein verschlüsselter Zugriff stattfinden kann.
- ##### Zertifikat aus Zertifikatsspeicher auswählen
    
    Durch einen Klick auf diesen Knopf können Sie ein Zertifikat aus dem Windows Zertifikatsspeicher auswählen. Dieses Zertifikat wird an den API-Port gebunden, damit ein verschlüsselter Zugriff stattfinden kann.

</div>### LetsEncrypt Zertifikat

<div id="bkmrk-eigenes-zertifikathi">Wählt man diese Option, kann man die für LetsEncrypt benötigten Informationen hinterlegen, damit der Service selbständig ein Zertifikat anfordern und aktualisieren kann.  
![jySCRCucfq4LPQ0o-61efa1d8-23a2-4312-8021-b0de558f0a5d.png](https://doku.artbase-software.de/uploads/images/gallery/2026-08/jySCRCucfq4LPQ0o-61efa1d8-23a2-4312-8021-b0de558f0a5d.png)  
- ##### E-Mail
    
    Diese Mailadresse für benötigt, um bei LetsEncrypt einen Account für die Zertifikatserstellung anzulegen. An diese Mailadresse werden hin und wieder Benachrichtigungen von LetsEncrypt versandt.
- ##### Zertifikatspasswort
    
    Dieses Passwort wird später für die Verbindung von privatem und öffentlichem Schlüssel des Zertifikats benötigt. Wählen Sie hier ein sicheres Kennwort.
- ##### Account-Key
    
    Dieser Key wird von LetsEncrypt automatisch vergeben und dient später zur Wiedererkennung des LetsEncrypt Accounts in deren Produktivumgebung.
- ##### Account-Key Staging
    
    Dieser Key wird von LetsEncrypt automatisch vergeben und dient später zur Wiedererkennung des LetsEncrypt Accounts in deren Testumgebung.
- ##### Domains
    
    Für die hier eingetragenen Domains gilt das später ausgestellte Zertifikat. Sie können ein LetsEncrypt-Zertifikat für mehrere Domains erstellen, die API läuft aber immer nur für eine dieser Domains.  
    Rechts neben der Auflistung sind zwei Knöpfe zum Einfügen bzw. Löschen von Domains. Die Domain der API wird schon aus dem Einstellungsfenster übernommen und sollte nicht gelöscht werden, da das später erzeugte Zertifikat sonst nicht für diese Domain gilt.
- ##### Port HTTP-Listener
    
    An diesem Port horcht unser Service bei der Neuerstellung bzw. Aktualisierung des LetsEncrypt Zertifikats. Von außen muss der Port 80 am Router/der Firewall auf diesen Port weitergeleitet werden.  
    Der kleine Knopf neben der Einstellung sorgt für eine Freigabe des Ports in der lokalen Windows-Firewall. Sollten Sie eine andere Software als Firewall nutzen, müssen Sie dort diesen Port manuell freigeben für eingehende TCP-Verbindungen.
- ##### LetsEncrypt Zertifikat abrufen
    
    Durch einen Klick auf diesen Knopf wird der Zertifikatsabruf direkt gestartet und man kann sehen, ob der Abruf mit den getätigten Einstellungen erfolgreich durchläuft.

</div>

# Aktive Anmeldungen am Web-Service

In diesem Dialog können Sie sehen, welche Rechner aktuell am aBServer-Dienst angemeldet sind.

[![aktive_Anmeldungen.png](https://doku.artbase-software.de/uploads/images/gallery/2026-09/scaled-1680-/XhAcdy27TWuSlVeV-aktive-anmeldungen.png)](https://doku.artbase-software.de/uploads/images/gallery/2026-09/XhAcdy27TWuSlVeV-aktive-anmeldungen.png)

- <span style="color: #4d82b8;">**Aktualisieren** </span><span style="color: rgb(0, 0, 0);">Hier können Sie die Prüfung nach aktiven Anmeldungen erneut anstoßen und danach erhalten Sie die aktualisierte Liste der aktiven Anmeldungen.</span>