Administration & Konfiguration
Endpoint-Freigaben verwalten
Diese Seite erklärt die Endpoint-Freigaben (Netzfreigaben, Egress-Freigaben, freigegebene Domains): warum jede LLM-Adresse eine braucht, warum sie je Produkt zählen und wie Sie auf der Seite Endpoint-Freigaben Adressen freigeben, prüfen, erneuern, ersetzen und entziehen.
Zweck
AnyLLM erreicht keine externe Adresse, die Sie nicht selbst freigegeben haben — auch die bekannten Anbieter nicht. Es gibt keine vorab freigegebene Anbieterliste: Der Abschnitt Ohne Freigabe erreichbar am Fuß der Seite ist absichtlich leer und sagt Kein LLM-Endpoint ist vorab freigegeben — jeder Endpoint, den Sie einrichten, braucht Ihre Freigabe, auch die bekannten Provider. sowie Das App-Manifest deklariert überhaupt keine externe Adresse. Jedes Ziel — LLM-Endpoints wie Ihr Such-Dienst — ist ausschließlich nach Ihrer Freigabe hier erreichbar. Damit ist jederzeit sichtbar und belegbar, wohin Anfragen fließen können.
Freigaben werden über den Bestätigungsdialog von Atlassian erteilt. Zum Anlegen brauchen Sie diese Seite normalerweise nicht: Das Speichern einer Verbindung (oder eines Such-Dienstes) mit neuer Adresse öffnet den Dialog automatisch. Die Seite brauchen Sie, um die Freigabe im anderen Produkt zu erteilen, den Stand zu prüfen und Adressen zu ersetzen, zu entziehen oder zu erneuern.
Berechtigung
Endpoint-Freigaben sollen von Jira-Administrator:innen verwaltet werden:
- Auf der Jira-Einstellungsseite sind alle Aktionen verfügbar.
- Auf der Confluence-Einstellungsseite prüft die App, ob die angemeldete Person auch Jira-Administration hat. Ohne sie zeigt die Seite Endpoint-Freigaben dürfen nur Jira-Administrator:innen ändern. Ihr Konto hat keine Jira-Admin-Berechtigung — die Aktionen auf dieser Seite sind deaktiviert. — das Formular, die Knöpfe in den Tabellen und der Knopf Jetzt freigeben des gelben Hinweises sind deaktiviert.
- Schlägt diese Prüfung selbst fehl, zeigt die Seite Ihre Jira-Admin-Berechtigung ließ sich aus Confluence nicht prüfen — die Aktionen bleiben nutzbar. Beachten Sie: Endpoint-Freigaben sollen von Jira-Administrator:innen verwaltet werden., und die Aktionen bleiben nutzbar.
Unabhängig davon verlangt der Bestätigungsdialog von Atlassian die Administration des Produkts, in dem die Einstellungsseite geöffnet ist.
Voraussetzungen
- Die Adresse ist eine
https-Adresse. Nur Schema, Host und Port zählen —https://llm.meine-firma.de/v1undhttps://llm.meine-firma.desind dieselbe Freigabe. - Öffnen Sie Einstellungen → Endpoint-Freigaben in dem Produkt, für das Sie Freigaben erteilen, prüfen oder ändern wollen (Weg: Einstellungen öffnen und Ersteinrichtung).
So wirken Freigaben je Produkt
AnyLLM ist eine Installation für Jira und Confluence, und die Liste der freigegebenen Domains wird einmal für die gesamte Installation geführt — sie sieht auf beiden Einstellungsseiten gleich aus. Die Zustimmung der Administration im Atlassian-Dialog zählt jedoch je Produkt: Eine auf der Jira-Seite freigegebene Adresse kann für Anfragen aus Confluence weiterhin blockiert sein, bis der Dialog auch dort bestätigt wurde. Der Einleitungstext der Seite sagt es in einem Satz: Freigaben gelten je Produkt: einmal in Jira und einmal in Confluence erteilen.
Die Tabelle Freigabe-Status je Produkt zeigt beide Stände nebeneinander, mit den Spalten Domain, Jira und Confluence:
| Zelle | Bedeutung |
|---|---|
| freigegeben | der Dialog wurde in diesem Produkt bestätigt |
| nicht freigegeben | für dieses Produkt ist keine Zustimmung hinterlegt |
| blockiert {date} | in diesem Produkt ist zuletzt eine Anfrage an der fehlenden Freigabe gescheitert — die Blockade ist jünger als die letzte Freigabe dort |
In der Spalte des Produkts, dessen Seite Sie geöffnet haben, trägt eine Zelle mit Handlungsbedarf den Knopf Jetzt freigeben; er öffnet den Atlassian-Dialog für dieses Produkt. In der Spalte des anderen Produkts steht In Jira freigeben ↗ bzw. In Confluence freigeben ↗ und führt zur Einstellungsseite dieses Produkts. Unter der Tabelle: Freigaben für {p} lassen sich nur auf der {p}-Admin-Seite erteilen. und der Link Freigaben in {p} öffnen ↗. Die Tabelle listet auch Domains, die bisher nur im anderen Produkt freigegeben wurden.
Eine Adresse freigeben
Zweck — der Installation erlauben, mit einer Adresse zu sprechen, die noch keine gespeicherte Verbindung nutzt, zum Beispiel vor dem Umzug eines Servers. Adressen gespeicherter Verbindungen und des Such-Dienstes werden beim Speichern freigegeben — die müssen Sie hier nicht eintragen.
Schritte
- Tragen Sie unter Endpoint-URL freigeben die Adresse in das Feld Endpoint-URL (https) ein, z. B.
https://llm.meine-firma.de. Der Hinweis unter dem Feld lautet Relevant sind nur Schema, Host und Port — der Pfad wird ignoriert. Die Freigabe öffnet einen Bestätigungsdialog von Atlassian. - Klicken Sie auf Jetzt freigeben (während der Arbeit steht dort Freigabe läuft …).
- Bestätigen Sie den Atlassian-Dialog AnyLLM: selbst gehostete LLM-Endpoints (…) — er listet alle Domains der Freigabe-Gruppe der App auf, nicht nur die neue.
Ergebnis — die Meldung Endpoint-Domains freigegeben.; die Adresse erscheint in der Tabelle Freigegebene Endpoint-URLs und als freigegeben in der Spalte dieses Produkts von Freigabe-Status je Produkt.
Hinweise
- Höchstens 10 Domains lassen sich je Installation freigeben; die Kopfzeile der Liste zeigt {count} von 10 Domains. Ist das Limit erreicht, sagt die Seite Das Limit von 10 freigegebenen Domains ist erreicht. Entziehen Sie unten eine, um eine weitere freizugeben — Ersetzen funktioniert weiterhin., und Jetzt freigeben ist deaktiviert; ein Versuch, es zu überschreiten, meldet Atlassian erlaubt höchstens 10 freigegebene Domains pro Installation. Entziehen Sie eine nicht mehr benötigte und versuchen Sie es erneut.
- Wird der Dialog abgelehnt, meldet die Seite Freigabe wurde abgelehnt oder ist fehlgeschlagen — diese Domains bleiben blockiert. Die Konfiguration ist unverändert.
Freigaben prüfen
Die Tabelle Freigegebene Endpoint-URLs ({count} von 10 Domains) hat die Spalten Domain, Status und Aktionen und zeigt je Eintrag einen Status:
| Status | Bedeutung |
|---|---|
| wird von einer gespeicherten Verbindung genutzt | eine gespeicherte Verbindung oder der Such-Dienst zeigt auf diese Adresse |
| keine Verbindung nutzt sie — Entzug unbedenklich | nichts nutzt die Adresse — zum Beispiel von Hand freigegeben und nie verwendet |
Ist noch nichts freigegeben, sagt die Tabelle Noch nichts freigegeben. Erreichbar sind nur die mitgelieferten Provider-Domains unten. — und weil die mitgelieferte Liste leer ist, ist dann gar nichts erreichbar.
Freigabe-Status je Produkt (siehe oben) zeigt, wo die Zustimmung noch fehlt. Eine Zelle blockiert {date} verschwindet nur auf zwei Wegen: durch einen erfolgreichen Verbindungstest (Verbindung testen) auf der Seite Verbindungen in diesem Produkt oder durch Freigabe in diesem Produkt erneuern bzw. Jetzt freigeben dort — die neue Freigabe ist dann jünger als die Blockade. Gewöhnliche Chat-Anfragen räumen den Eintrag nicht ab, auch wenn sie gelingen.
Freigabe in diesem Produkt erneuern
Zweck — die Zustimmung für das Produkt, in dem Sie sind, erneuern, ohne die Liste zu ändern. Nutzen Sie es, wenn Anfragen in einem Produkt geblockt werden, obwohl die Adresse als freigegeben erscheint — typischerweise, weil die Zustimmung in diesem Produkt nie erteilt wurde, etwa nach einer Neuinstallation.
Wo Sie es finden
- als Warnhinweis oben auf der Seite, der automatisch erscheint, wenn eine Blockade jünger ist als die Freigabe des Produkts: Anfragen an {host} wurden in {p} geblockt, obwohl die Adresse als freigegeben erscheint. Die Domain-Liste wird installationsweit angezeigt, die Admin-Zustimmung zählt aber je Produkt — in {p} wurde sie womöglich nie erteilt. „Freigabe in diesem Produkt erneuern" öffnet hier den Atlassian-Bestätigungsdialog. mit dem Knopf Freigabe in diesem Produkt erneuern;
- als Jetzt freigeben in einer Zelle der Tabelle Freigabe-Status je Produkt;
- als Link-Zeile unter dem Formular, sichtbar, sobald mindestens eine Domain freigegeben ist: Anfragen werden geblockt, obwohl die Adresse hier als freigegeben erscheint? Dann fehlt womöglich die Zustimmung für dieses Produkt: Freigabe in diesem Produkt erneuern.
Schritte
- Klicken Sie auf Freigabe in diesem Produkt erneuern. Die Seite zeigt Freigabe wird angefragt ….
- Bestätigen Sie den Atlassian-Dialog.
Ergebnis — Freigabe für dieses Produkt bestätigt.; eine Zelle blockiert dieses Produkts verschwindet. Wird der Dialog abgelehnt: Erneuern fehlgeschlagen oder abgelehnt — nichts geändert.
Freigabe ersetzen oder entziehen
Ersetzen — für den Umzug eines Servers ohne Lücke:
- Klicken Sie in der Zeile auf Ersetzen. Der Formulartitel wechselt zu Endpoint-URL ersetzen, das Feld ist vorbelegt; Abbrechen bricht ab.
- Tragen Sie die neue Adresse ein und klicken Sie auf Jetzt freigeben; bestätigen Sie den Dialog.
Die neue Adresse wird freigegeben, die alte anschließend aus der Liste entfernt. Ersetzen funktioniert auch, wenn das Limit von 10 Domains erreicht ist. Stellen Sie danach die Verbindung auf Verbindungen um und wiederholen Sie die Zustimmung im anderen Produkt.
Entziehen — für Adressen, die nicht mehr gebraucht werden:
- Klicken Sie in der Zeile auf Entziehen. Der Knopf wechselt zu Wirklich entziehen? — oder, wenn eine gespeicherte Verbindung die Adresse nutzt, zu Trotzdem entziehen — eine Verbindung fällt aus.
- Klicken Sie ihn zur Bestätigung erneut. Die Seite zeigt Entziehe ….
Ergebnis — Freigabe entzogen.; die Zeile verschwindet. Schlägt es fehl: Entziehen fehlgeschlagen — die Freigabe besteht weiter.
⚠️ Warnung: Nach dem Entzug scheitern alle Anfragen an diese Adresse sofort, in beiden Produkten. Die Verbindung samt Key bleibt gespeichert und arbeitet nach einer neuen Freigabe wieder.
Automatischer Entzug nach dem Speichern von Verbindungen
Für einen Umzug brauchen Sie Entziehen selten: Nach jedem erfolgreichen Verbindungen speichern (und nach Speichern auf Module oder Allgemein, das dieselbe Konfiguration speichert) entzieht die App automatisch freigegebene Adressen, die keine gespeicherte Verbindung und kein Such-Dienst mehr nutzt. Lehnt der Server das Speichern ab, werden die in diesem Speichervorgang erteilten Freigaben wieder zurückgenommen. Der übliche Ablauf ist deshalb: Endpoint der Verbindung ändern, speichern, Dialog bestätigen — und dann die Zustimmung im anderen Produkt erteilen.
Der Hinweis auf ausstehende Freigaben
Fehlt gespeicherten Adressen im aktuellen Produkt die Freigabe — typischerweise nach einem Konfigurations-Import —, erscheint oberhalb der Reiter auf jeder Einstellungsseite ein gelber Hinweis: Diese Endpoint-Domains sind konfiguriert, aber für diese Installation noch nicht freigegeben: … Bis zur Freigabe werden Aufrufe dorthin blockiert — das passiert typischerweise nach einem Konfigurations-Import. Klicken Sie auf Jetzt freigeben (dann Freigabe läuft …) und bestätigen Sie den Dialog. Ergebnis: Endpoint-Domains freigegeben.; bei Ablehnung: Freigabe wurde abgelehnt oder ist fehlgeschlagen — diese Domains bleiben blockiert. Die Konfiguration ist unverändert. Der Hinweis fragt die Freigabe für die gespeicherten Adressen an, ohne die Konfiguration zu verändern.
Wenn Freigaben nicht verfügbar sind
Ist die Freigabefunktion von Atlassian für Ihre Site nicht aktiv, ersetzt Customer-managed Egress ist für diese Installation nicht verfügbar — diese Domains bleiben blockiert, bis es freigeschaltet ist. den Abschnitt Freigegebene Endpoint-URLs, und es erscheint kein Hinweis auf ausstehende Freigaben. Das Speichern von Verbindungen meldet dann in Rot Gespeichert, aber die Netzfreigabe konnte nicht angefragt werden — Customer-managed Egress ist für diese Installation nicht verfügbar. Aufrufe an den selbst gehosteten Endpoint werden blockiert, bis es freigeschaltet ist., obwohl die Konfiguration gespeichert wurde. In diesem Zustand bleibt jede Adresse blockiert, und der Chat ist nicht benutzbar. Wenden Sie sich an Ihren Anbieter (maplee).
Häufige Probleme
| Meldung | Ursache | Lösung |
|---|---|---|
| Keine gültige URL. | Tippfehler oder unvollständige Adresse | vollständige Adresse eingeben; https:// wird ergänzt, wenn Sie es weglassen |
| Nur https ist erlaubt — über diese Verbindung gehen API-Keys. | http:// eingegeben | https verwenden |
| Diese Domain ist bereits freigegeben. | der Eintrag existiert schon | nichts zu tun — stattdessen die Tabelle Freigabe-Status je Produkt prüfen |
| Diese Domain ist bereits ohne Freigabe erreichbar. | die Adresse steht auf der mitgelieferten Liste vorab freigegebener Domains | kommt in der ausgelieferten Version nicht vor, weil diese Liste leer ist |
| Atlassian erlaubt höchstens 10 freigegebene Domains pro Installation. … | Limit erreicht | eine ungenutzte Adresse entziehen oder Ersetzen verwenden |
| Freigabe wurde abgelehnt oder ist fehlgeschlagen — diese Domains bleiben blockiert. Die Konfiguration ist unverändert. | Dialog abgelehnt oder fehlgeschlagen | erneut versuchen und den Dialog bestätigen |
| Customer-managed Egress ist für diese Installation nicht verfügbar — … | die Freigabefunktion von Atlassian fehlt | Anbieter (maplee) kontaktieren |
| Der Chat meldet Der Endpoint {host} ist in {p} noch nicht freigegeben — Endpoint-Freigaben gelten je Produkt. … | Zustimmung in diesem Produkt fehlt | die Einstellungen in diesem Produkt öffnen und auf Jetzt freigeben klicken |
| Eine Adresse zeigt freigegeben, Anfragen werden aber geblockt | Zustimmung in diesem Produkt nie erteilt | Freigabe in diesem Produkt erneuern |
| blockiert {date} verschwindet nach einem erfolgreichen Chat nicht | Chat-Anfragen räumen den Eintrag nie ab | Verbindung testen in diesem Produkt ausführen oder Freigabe erneuern |
| Die Aktionen auf der Confluence-Seite sind deaktiviert | keine Jira-Administration | eine Jira-Administratorin oder einen Jira-Administrator bitten |
| Entziehen fehlgeschlagen — die Freigabe besteht weiter. | Atlassian hat den Entzug abgelehnt | Seite neu laden und erneut versuchen |
Verwandte Themen
Aufnahmen der App-Oberfläche mit Beispieldaten; der umgebende Jira-/Confluence-Rahmen ist nicht abgebildet.
Dokumentationsstand: App-Version 0.2.0 · 2026-08-30