Installing and getting started with AudhiveAudhive installieren und loslegen

Two ways to use AudhiveZwei Wege zu Audhive

System requirements (self-hosted)Systemvoraussetzungen (selbst gehostet)

The setup wizard lists these prerequisites on its first page. For the cloud subscription you only need a current browser.

Diese Voraussetzungen zeigt der Setup-Assistent auf seiner ersten Seite. Für das Cloud-Abo brauchen Sie nur einen aktuellen Browser.

Installation step by stepInstallation Schritt für Schritt

The installation takes place in the browser. The pictures show the setup wizard of Audhive 2.6.9 with a fictitious licence (“Muster AG”).

Die Installation läuft im Browser. Die Bilder zeigen den Setup-Assistenten von Audhive 2.6.9 mit einer erfundenen Lizenz („Muster AG“).

PreparationVorbereitung

1. Buy a licence: choose a package under Pricing and pay online. The licence key and the download link arrive by e-mail; the link checks your key and can be used again as long as the licence is valid.
2. Prepare the server: web server with HTTPS and PHP, an empty database with its own user (see requirements).
3. Unpack: extract the ZIP into the web folder of your (sub)domain.
4. Start the setup: open https://your-address/setup/setup.php in the browser.

1. Lizenz kaufen: Paket unter Preise wählen und online bezahlen. Lizenzschlüssel und Download-Link kommen per E-Mail; der Link prüft Ihren Schlüssel und lässt sich wieder verwenden, solange die Lizenz gültig ist.
2. Server vorbereiten: Webserver mit HTTPS und PHP, eine leere Datenbank mit eigenem Benutzer (siehe Voraussetzungen).
3. Entpacken: das ZIP in den Web-Ordner Ihrer (Sub-)Domain entpacken.
4. Setup starten: im Browser https://ihre-adresse/setup/setup.php aufrufen.

Setup wizardSetup-Assistent

1. Welcome: prerequisites, setup token, licence agreementWillkommen: Voraussetzungen, Setup-Token, Lizenzvertrag

   Choose the language at the top right (EN/DE). The page lists the prerequisites. To continue, the wizard needs a one-time setup token: it has generated it and saved it in the file setup/.setup_token.php on your server – open it via SSH, FTP or the file manager of your hosting and paste the value. This way nobody else can take over the installation. Read and accept the end user licence agreement, then click “Start Setup”.

   Oben rechts die Sprache wählen (EN/DE). Die Seite listet die Voraussetzungen. Zum Weiterfahren verlangt der Assistent ein einmaliges Setup-Token: Er hat es erzeugt und in der Datei setup/.setup_token.php auf Ihrem Server abgelegt – öffnen Sie sie per SSH, FTP oder mit dem Datei-Manager Ihres Hostings und fügen Sie den Wert ein. So kann niemand sonst die Installation übernehmen. Den Endbenutzer-Lizenzvertrag lesen und akzeptieren, dann „Setup starten“.

   

   

2. Licence keyLizenzschlüssel

   Enter the key from your order e-mail and click “Check licence”. Audhive checks it with the IT SB licence server, activates it for this installation and sets the mode (SEC, ICS or FULL) automatically – you do not choose anything. Older offline licence keys (eyJ…) are still accepted. If the setup was interrupted after the check, the wizard offers “Continue with this licence” without activating it again.

   Den Schlüssel aus der Bestell-Mail eingeben und „Lizenz prüfen“ klicken. Audhive prüft ihn beim Lizenzserver von IT SB, aktiviert ihn für diese Installation und stellt den Modus (SEC, ICS oder FULL) automatisch ein – Sie wählen nichts aus. Ältere Offline-Lizenzschlüssel (eyJ…) werden weiterhin angenommen. Wurde das Setup nach der Prüfung unterbrochen, bietet der Assistent „Mit dieser Lizenz weiterfahren“ an, ohne erneut zu aktivieren.

   

   

3. Your licenceIhre Lizenz

   The overview shows what is licensed: licensee, mode with a short explanation, tenants, users per tenant, additional users, users in total, term and installations (1 – this installation). The values are for information only; Audhive is set up exactly as licensed. Wrong key? “Enter a different key”. Otherwise “Continue to the database”.

   Die Übersicht zeigt, was lizenziert ist: Lizenznehmer, Modus mit kurzer Erklärung, Mandanten, Benutzer je Mandant, Zusatzbenutzer, Benutzer insgesamt, Laufzeit und Installationen (1 – diese Installation). Die Angaben dienen nur zur Information; Audhive wird genau so eingerichtet, wie lizenziert. Falscher Schlüssel? „Anderen Schlüssel eingeben“. Sonst „Weiter zur Datenbank“.

   

   

4. DatabaseDatenbank

   Host, database name, user name and password of the empty database. “Test & Continue” checks the connection and writes the .env file.

   Host, Datenbankname, Benutzername und Passwort der leeren Datenbank. „Testen & Weiter“ prüft die Verbindung und schreibt die Datei .env.

   

   

5. Import DBDB importieren

   Fresh install creates all tables (existing tables are deleted first – use it only on an empty database). Restore backup takes a full backup made by Audhive (.sql), checks it for completeness, replaces the database contents and updates the schema if needed. The box shows the mode according to your licence; when restoring, SEC/ICS stay fixed and FULL keeps the mode of the backup. Then “Run Setup”.

   Neuinstallation legt alle Tabellen an (bestehende Tabellen werden zuerst gelöscht – nur auf einer leeren Datenbank verwenden). Backup wiederherstellen nimmt eine vollständige Sicherung von Audhive (.sql), prüft sie auf Vollständigkeit, ersetzt den Inhalt der Datenbank und bringt das Schema bei Bedarf auf den neuesten Stand. Der Kasten zeigt den Modus gemäss Ihrer Lizenz; beim Wiederherstellen bleiben SEC/ICS fest, FULL behält den Modus der Sicherung. Dann „Setup ausführen“.

   

   

6. AuthenticationAuthentifizierung

   Choose how users sign in:

   • Microsoft Entra ID (Azure AD): enter the tenant ID and choose single- or multi-tenant. “Sign in with Microsoft” creates the app registration automatically (account with the Application Administrator role); alternatively enter client ID and secret manually.
   • Native sign-in: Audhive's own accounts. Enter the e-mail address and password of the first administrator; the second factor (TOTP) is enforced per user in the admin area.

   Wählen Sie, wie sich die Benutzer anmelden:

   • Microsoft Entra ID (Azure AD): Mandanten-ID eingeben und Single- oder Multi-Tenant wählen. „Mit Microsoft anmelden“ legt die App-Registrierung automatisch an (Konto mit der Rolle Application Administrator); alternativ Client-ID und Secret von Hand eintragen.
   • Native Anmeldung: eigene Audhive-Konten. E-Mail-Adresse und Passwort des ersten Administrators eingeben; der zweite Faktor (TOTP) wird je Benutzer im Adminbereich erzwungen.

   

   

7. ReviewÜberprüfen

   With Entra ID, the wizard shows the values of the app registration – check them and save. After restoring a backup it shows a summary of the restore. With native sign-in there is nothing to check; the wizard continues directly.

   Bei Entra ID zeigt der Assistent die Werte der App-Registrierung – prüfen und speichern. Nach dem Wiederherstellen einer Sicherung zeigt er eine Übersicht der Wiederherstellung. Bei der nativen Anmeldung gibt es nichts zu prüfen; der Assistent fährt direkt weiter.

8. MailMail

   Optional: sending method SMTP (e.g. Office 365 smart host, port 587) or Microsoft Graph API, with sender address and name. You can also skip this and set it up later in the admin settings.

   Optional: Versandmethode SMTP (z. B. Office-365-Smarthost, Port 587) oder Microsoft Graph API, mit Absenderadresse und -name. Sie können den Schritt auch überspringen und den Versand später in den Admin-Einstellungen einrichten.

   

   

9. Initial dataInitiale Daten

   Load a supplied control catalogue to start right away – IKT minimum standard 2023 or ISO/IEC 27001:2022 + Amd. 1:2024, each in German or English – or import your own catalogue as a combined CSV (same format). You can skip this step; the import is also available later under Admin › Import / Export as long as no control data exists.

   Einen mitgelieferten Kontrollkatalog laden und sofort loslegen – IKT-Minimalstandard 2023 oder ISO/IEC 27001:2022 + Amd. 1:2024, je auf Deutsch oder Englisch – oder einen eigenen Katalog als kombinierte CSV-Datei (gleiches Format) importieren. Der Schritt lässt sich überspringen; der Import steht später unter Admin › Import / Export zur Verfügung, solange noch keine Kontrolldaten vorhanden sind.

   

   

10. DoneFertig

    The application is configured. Delete or protect setup/setup.php immediately, then “Go to Application” and sign in with the administrator account.

    Die Anwendung ist eingerichtet. setup/setup.php sofort löschen oder schützen, dann „Zur Anwendung“ und mit dem Administratorkonto anmelden.

    

    

Messages when checking the licenceMeldungen bei der Lizenzprüfung

After the setupNach dem Setup

• Delete setup/setup.php (or protect the folder) if you have not done so yet.
• Entra ID: grant admin consent in the Azure portal for the application permissions User.Read.All, Group.Read.All, Application.Read.All and AppRoleAssignment.ReadWrite.All.
• Native sign-in: create further accounts under Admin › Users & Permissions; the second factor (TOTP) is enforced per user.
• Daily update check: Admin › Update › “Set up daily check”. If your hosting does not accept jobs from PHP, Audhive shows schedule and command to enter in the hosting panel.
• Backups: set up a scheduled backup under Admin › Backup and include the server in your own backup.
• AI (optional): enter your own API key under Admin › Settings › AI.

• setup/setup.php löschen (oder den Ordner schützen), falls noch nicht geschehen.
• Entra ID: im Azure-Portal den Admin Consent für die Anwendungsberechtigungen User.Read.All, Group.Read.All, Application.Read.All und AppRoleAssignment.ReadWrite.All erteilen.
• Native Anmeldung: weitere Konten unter Admin › Benutzer & Berechtigungen anlegen; den zweiten Faktor (TOTP) erzwingen Sie je Benutzer.
• Tägliche Update-Prüfung: Admin › Update › „Tägliche Prüfung einrichten“. Nimmt Ihr Hosting keine Jobs aus PHP an, zeigt Audhive Zeitplan und Befehl zum Eintragen im Hosting-Panel.
• Sicherung: unter Admin › Backup eine geplante Sicherung einrichten und den Server in Ihre eigene Sicherung aufnehmen.
• KI (optional): eigenen API-Schlüssel unter Admin › Einstellungen › KI hinterlegen.

First steps in AudhiveErste Schritte in Audhive

The same in the cloud and self-hosted. The pictures show the demo instance with fictitious companies and data.

Gleich in der Cloud und selbst gehostet. Die Bilder zeigen die Demo-Instanz mit erfundenen Firmen und Daten.

1. Create tenantsMandanten anlegen

   Admin › Tenants & Groups › “New Tenant”: one tenant per company, business unit or client, with logo and location. Company groups bundle several tenants on the dashboard. The number of tenants depends on your licence or subscription.

   Admin › Mandanten & Gruppen › „Neuer Mandant“: ein Mandant je Firma, Geschäftsbereich oder Kunde, mit Logo und Standort. Unternehmensgruppen fassen mehrere Mandanten auf dem Dashboard zusammen. Wie viele Mandanten möglich sind, bestimmt Ihre Lizenz bzw. Ihr Abo.

   

   

2. Define rolesRollen festlegen

   Admin › Permissions › “New Role”: a role defines which areas may be viewed or edited – overview, controls, audit, documents, questionnaire, control set, change log, executive board, admin. Typical roles: administrator, auditor, process owner, management, read-only.

   Admin › Berechtigungen › „Neue Rolle“: Eine Rolle legt fest, welche Bereiche jemand sehen oder bearbeiten darf – Übersicht, Kontrollen, Audit, Dokumente, Fragebogen, Kontrollset, Änderungsprotokoll, Executive Board, Admin. Typische Rollen: Administrator, Auditor, Prozessverantwortliche, Geschäftsleitung, nur lesen.

   

   

3. Add usersBenutzer hinzufügen

   Admin › Users & Permissions › “Add Access”: give a person access to one or more tenants with a role, or make them a global admin. The list shows tenant access, last sign-in and status.

   Admin › Benutzer & Berechtigungen › „Zugang hinzufügen“: einer Person Zugang zu einem oder mehreren Mandanten mit einer Rolle geben oder sie zum globalen Admin machen. Die Liste zeigt Mandanten-Zugang, letzten Login und Status.

   

   

4. Controls and control setControls und Control-Set

   The catalogue (e.g. IKT minimum standard or ISO 27001) is loaded in the setup or under Admin › Import / Export; own frameworks come in as CSV in the same format. Under Control set you decide per tenant which controls apply; every control shows its policy, control objective, control text and the expected documentation.

   Der Katalog (z. B. IKT-Minimalstandard oder ISO 27001) kommt im Setup oder über Admin › Import / Export; eigene Frameworks kommen als CSV im selben Format dazu. Unter Control-Set legen Sie je Mandant fest, welche Controls gelten; jedes Control zeigt Richtlinie, Kontrollziel, Kontrolltext und die erwartete Dokumentation.

   

   

5. Carry out the auditAudit durchführen

   Under Audit you assess each control: status, test of design, risk, priority, effort, sample and test of effectiveness, findings in German and English. Evidence, documentation, ISO reference and requests are in tabs of the same view. Missing documents are requested as a data request with a delivery date – the audit dashboard lists open and overdue requests, sends reminders and lets you accept or reject what was delivered.

   Unter Audit bewerten Sie jedes Control: Status, Ausgestaltungstest, Risiko, Priorität, Aufwand, Stichprobe und Wirksamkeitstest, Feststellungen auf Deutsch und Englisch. Nachweise, Dokumentation, ISO-Referenz und Anfragen liegen in Reitern derselben Ansicht. Fehlende Unterlagen fordern Sie als Datenanfrage mit Liefertermin an – das Audit-Dashboard listet offene und überfällige Anfragen, verschickt Erinnerungen und lässt Gelieferte annehmen oder ablehnen.

   

   

   

   

6. ReportBericht

   On the audit dashboard, “Generate report” creates a PDF of the current audit status for the tenant, in German or English. With the Report Builder (Admin) you assemble your own reports from blocks – cover page, table of contents, achievement level chart, statement of applicability, accepted risks and more – and save them as templates. The Executive Board compares all tenants and is also available as PDF.

   Auf dem Audit-Dashboard erzeugt „Bericht erstellen“ ein PDF zum aktuellen Auditstand des Mandanten, auf Deutsch oder Englisch. Mit dem Report Builder (Admin) stellen Sie eigene Berichte aus Bausteinen zusammen – Titelseite, Inhaltsverzeichnis, Erfüllungsgrad-Diagramm, Statement of Applicability, akzeptierte Risiken und mehr – und speichern sie als Vorlage. Das Executive Board vergleicht alle Mandanten und steht ebenfalls als PDF bereit.

   

   

   

   

Cloud subscription: after your orderCloud-Abo: nach der Bestellung

1. Choose plan and addressAbo und Adresse wählen

   Under Pricing choose the mode and monthly or yearly billing. On www.it-sb.ch you choose the address of your instance, e.g. yourcompany.audhive.io, add extra tenants or users if needed and pay via PayPal or by card.

   Unter Preise Modus und monatliche oder jährliche Abrechnung wählen. Auf www.it-sb.ch legen Sie die Adresse Ihrer Instanz fest, zum Beispiel ihrefirma.audhive.io, wählen bei Bedarf zusätzliche Mandanten oder Benutzer und bezahlen über PayPal oder mit Karte.

2. Set-up e-mailEinrichtungsmail

   As soon as the payment is confirmed, your instance is set up automatically – with its own database. A few minutes later the welcome e-mail with your set-up link arrives. The link is valid for 72 hours; if it has expired, we send you a new one on request.

   Sobald die Zahlung bestätigt ist, wird Ihre Instanz automatisch eingerichtet – mit eigener Datenbank. Nach wenigen Minuten kommt die Willkommensmail mit Ihrem Einrichtungslink. Der Link ist 72 Stunden gültig; ist er abgelaufen, schicken wir Ihnen auf Anfrage einen neuen.

3. Password, second factor, first tenantKennwort, zweiter Faktor, erster Mandant

   Via the link you set your password, set up an authenticator app (TOTP) or a passkey as the second factor and create the first tenant – then you are signed in and work directly in Audhive. Continue with the first steps.

   Über den Link legen Sie Ihr Kennwort fest, richten eine Authenticator-App (TOTP) oder einen Passkey als zweiten Faktor ein und legen den ersten Mandanten an – danach sind Sie angemeldet und arbeiten direkt in Audhive. Weiter mit den ersten Schritten.

4. Account and subscriptionKonto und Abo

   Global admins find Admin › Account and subscription: plan, status and paid-until date, cancel or resume, buy more tenants or users, and a time-limited support code if you want us to look at something. Updates and backups are our job; mail is sent centrally unless you enter your own mail access.

   Globale Admins finden Admin › Konto und Abo: Abo, Status und „bezahlt bis“, kündigen oder fortsetzen, Mandanten oder Benutzer dazukaufen und einen befristeten Support-Code, falls wir etwas ansehen sollen. Updates und Sicherungen übernehmen wir; Mails gehen zentral hinaus, solange Sie keinen eigenen Mail-Zugang eintragen.

In operation (self-hosted)Im Betrieb (selbst gehostet)

• Licence: Audhive verifies the licence online every 7 days and keeps working for up to 30 days without a connection; after that it is read-only until the verification succeeds again. Status and “Verify now” under Admin › Settings › License.
• Updates: Admin › Update › “Check for updates” – signed packages, with a backup before installing.
• Moving to another server: “Release licence (move)” in the old installation, then install as described above and enter the key again (or restore a backup in step 3).
• More tenants or users: button “Buy tenants/users” under Admin › Settings › License, then “Verify now”. Details in the FAQ.

• Lizenz: Audhive gleicht die Lizenz alle 7 Tage online ab und arbeitet bis zu 30 Tage ohne Verbindung weiter; danach nur noch lesend, bis der Abgleich wieder gelingt. Status und „Jetzt abgleichen“ unter Admin › Einstellungen › Lizenz.
• Updates: Admin › Update › „Nach Updates suchen“ – signierte Pakete, mit Sicherung vor dem Einspielen.
• Umzug auf einen anderen Server: in der alten Installation „Lizenz freigeben (Umzug)“, dann wie oben installieren und den Schlüssel erneut eingeben (oder in Schritt 3 eine Sicherung wiederherstellen).
• Mehr Mandanten oder Benutzer: Knopf „Mandanten/Benutzer dazukaufen“ unter Admin › Einstellungen › Lizenz, danach „Jetzt abgleichen“. Einzelheiten in den häufigen Fragen.