Hallo!
Brauchen Sie Hilfe? Wir sind hier!
Brauchen Sie Hilfe? Wir sind hier!
Search Results:
×Eine Schritt-für-Schritt-Anleitung zur Installation und Konfiguration des miniOrange Access Gateway (MAG) für sicheren Zugriff und Authentifizierung.
Der miniOrange Access Gateway-Server hat die folgenden Systemanforderungen.
Befolgen Sie die Schritte, um den miniOrange Access-Gateway-Server auf Ihrem Betriebssystem bereitzustellen:
C:\Program Files (x86)\miniOrange Access Gateway\conf\application.properties/opt/miniOrangeAccessGateway/conf/application.properties| Eigenschaft | Werte |
|---|---|
| Datenbank | Zu verwendender Datenbanktyp:
|
| Datenbankhost | IP-Adresse oder Hostname des Computers, auf dem Ihre Datenbank ausgeführt wird |
| Datenbankname | Name der Datenbank, mit der eine Verbindung hergestellt werden soll. Hinweis: Stellen Sie bei PostgreSQL und SQL Server sicher, dass die Datenbank bereits erstellt wurde. |
| Datenbankport | Standardport:
|
| Benutzername | Benutzername, der zur Authentifizierung bei der Datenbank verwendet wird. |
| Passwort | Kennwort zur Authentifizierung bei der Datenbank. |
systemctl restart mo-access-gateway(Sie haben noch kein Konto? Kein Problem! Klicken Sie auf werden auf dieser Seite erläutert um ein neues Konto zu erstellen.)
| Feld | Werte |
|---|---|
| Benutzername | Geben Sie den Benutzernamen ein, mit dem Sie sich anmelden miniOrange Cloud / Vor Ort. |
| Passwort | Geben Sie das Passwort ein, mit dem Sie sich anmelden miniOrange Cloud / Vor Ort. |
| miniOrange IAM Branding | Geben Sie Ihre miniOrange ein IAM Marken-URL –
|
| Datenbankport | Standardport:
|
| Benutzername | Benutzername, der zur Authentifizierung bei der Datenbank verwendet wird. |
| Passwort | Kennwort zur Authentifizierung bei der Datenbank. |
Hinweis: Upstream-Gruppe enthält die Details der Server, auf denen Ihre Anwendung bereitgestellt wird.
| Gruppenname | Geben Sie einen eindeutigen Namen für die Gruppe der Upstream-Server ein. |
| Load Balancing |
|
| Schema | Wählen Sie das Schema/Protokoll für den Zugriff auf Ihr AnwendungsserverDieses Feld kann nur einen Wert haben. HTTP or HTTPS. |
| Gastgeber | Das FQDN or IP Address Ihrer Anwendungsserver. |
| Hafen | Das Hafen auf dem die Ihre Anwendungsserver hört zu. |
Hinweis: Load Balancing kann nur aktiviert werden, wenn mindestens 2 Server aktiviert sind.
Hinweis: Authentifizierungsanbieter enthalten IDP-Konfigurationen, die zur Benutzerauthentifizierung verwendet werden.
Wenn SAML ausgewählt ist:
Hinweis: Metadaten zum miniOrange Access Gateway werden pro Anwendung bereitgestellt.
Wenn OAuth ausgewählt ist:
Hinweis: Interceptors sind Komponenten, die wie Filter agieren und eingehende Anfragen verarbeiten, bevor sie an den Upstream-Server.
Das Header-Interceptor fügt Anforderungsheader hinzu oder ändert sie, bevor sie an die Upstream-Anwendung weitergeleitet werden.
Dies ist nützlich, um Identitätsdetails oder zusätzliche Metadaten an Backend-Dienste zu senden, ohne dass Änderungen an der Upstream-Anwendung erforderlich sind.
| Interceptor-Typ | Funktion |
|---|---|
| Interceptor-Name | Name zur Identifizierung des Header-Interceptors unter allen Interceptors. |
| Kopfzeilenname |
TEST_HEADER: (NameId / Unterwert vom IdP) |
| Header-Wertpräfix | Präfixwert, der zum Wert des Headers hinzugefügt werden muss |
| Header-Wert | Fester Wert der Kopfzeile. |
| SAML-Header senden | Aktivieren Sie diesen Schalter, um alle SAML-Attribute als Header zu senden. |
| Schaltfläche „Kopfzeile hinzufügen“ | Klicken Sie hier, um eine benutzerdefinierte Kopfzeile hinzuzufügen. |
| Benutzerdefinierte Headerfelder | Definieren Sie feste Headernamen und die entsprechenden Werte. |
Das Umleitungs-Interceptor sendet eine Umleitungsantwort an den Client, anstatt die Anfrage an die Upstream-Anwendung weiterzuleiten.
Dies geschieht, bevor die Anfrage die vorgelagerte Anwendung erreicht.
| Feld | Werte |
|---|---|
| Interceptor-Name | Name zur Identifizierung des Redirect-Interceptors. |
| URL umleiten | Geben Sie die URL an, zu der umgeleitet werden soll. |
Das Interceptor zur Anforderungsüberprüfung wertet eingehende Anfragen anhand konfigurierter Prüfer aus (z. B. Header, Abfrageparameter, IP-Adresse usw.).
Dies ist nützlich, um benutzerdefinierte Sicherheitsregeln durchzusetzen, Anfragen zu filtern oder das Verhalten basierend auf dem Anfrageinhalt dynamisch zu ändern.
Der Plug-and-Play-Betrieb Geben Sie auf der Registerkarte „Verbinden“ die folgenden Details an:
| Feld | Werte |
|---|---|
| Interceptor-Name | Name zur Identifizierung des Request Verification Interceptor. |
| Prüfertyp |
Wählen Sie den zu überprüfenden Teil der Anfrage aus -
|
| Benutzerdefinierter Prüfername | Logische Bezeichnung für diesen Prüfer; wird im Bedingungsausdruck verwendet. |
| Parametername / Zu überprüfender Pfad / Cookie-Name |
Geben Sie den genauen Namen des zu überprüfenden Feldes ein -
|
| Übereinstimmungstyp |
Wählen Sie, wie der Wert abgeglichen werden soll -
|
| Parameterwert | Geben Sie den erwarteten Wert ein, mit dem abgeglichen werden soll. |
| Prüfbedingung | Verwenden Sie logische Ausdrücke, um Prüfer zu kombinieren. |
| Prüftyp: IP-Adresse | |
| Protokolltyp |
Protokolltyp auswählen -
|
| Start-IP / End-IP | Definieren Sie den IP-Bereich, um eingehende Anfragen abzugleichen. |
In Aktionsdetails, geben Sie die folgenden Details an:
| Anfragetyp |
Wählen Sie die HTTP-Methode aus, auf die die Aktion angewendet werden soll -
|
| Aktionstyp |
Wählen Sie die Aktion aus, die ausgeführt werden soll, wenn die Anfrage mit dem Prüferbedingung. Siehe unten für Aktionsoptionen. |
| Strenger Überprüfungsmodus | Aktivieren Sie diese Option, um die Anfrage zu blockieren, wenn die Überprüfung fehlschlägt. |
| Aktionsparameter hinzufügen | Ermöglicht die Konfiguration zusätzlicher anforderungsspezifischer Änderungen. |
| Regel hinzufügen | Fügt dem Interceptor die konfigurierte Regel hinzu. |
Aktionstypoptionen
| Aktionstyp | Beschreibung |
|---|---|
| passieren | Leitet die Anfrage ohne Änderungen weiter. |
| Schutzmassnahmen bei | Stoppt die Anfrage und gibt eine blockierte Antwort zurück. |
| umleiten | Sendet eine Umleitungsantwort an eine angegebene URL. |
| ändern |
Ändert Anforderungskomponenten -
|
| injizieren |
Fügt der Anfrage neue Komponenten hinzu -
|
| verzögern | Fügt der Antwort eine Verzögerung hinzu, bevor geantwortet wird. |
| Log | Protokolliert Anforderungsdetails zu Überwachungs- oder Debugzwecken. |
Das JWT-Abfangjäger generiert nach erfolgreicher Authentifizierung ein JWT-Token und hängt es an den URL-Pfad an.
Nützlich für die Integration mit Anwendungen, die JWTs im Anforderungspfad für den Zugriff oder die Sitzungsvalidierung erwarten.
| Feld | Werte |
|---|---|
| Interceptor-Name | Name zur Identifizierung des JWT-Interceptors. |
| Abfrageparametername | Der Name des Abfrageparameters, an den das JWT in der URL angehängt wird. Der Standardwert ist Zugangstoken wenn leer gelassen. |
| Attributname | JWT-Anspruch, der den NameId- (SAML) / Sub- (OAuth) Wert enthält. Standardmäßig unten wenn leer gelassen. |
| Attributwert | Ein fester Wert, der anstelle des Benutzernamens verwendet wird. Falls angegeben, wird der NameId- (SAML) / Sub- (OAuth) Wert ignoriert. |
| JWT-Wertpräfix | Ein Präfix, das vor dem Attributwert oder dem NameId- (SAML) / Sub- (OAuth) Wert im JWT hinzugefügt wird. Wird nur angewendet, wenn der entsprechende Wert vorhanden ist. |
| SAML-Attribute senden | Wenn aktiviert, werden alle SAML-Attribute als Ansprüche in das JWT aufgenommen. |
| Benutzerdefiniertes Attribut hinzufügen | Ermöglicht das Hinzufügen benutzerdefinierter fester Schlüssel-Wert-Paare zum JWT. |
| Benutzerdefinierter Attributname | Name des benutzerdefinierten JWT-Anspruchs, der hinzugefügt werden soll. |
| Benutzerdefinierter Attributwert | Dem entsprechenden benutzerdefinierten Anspruch zugewiesener Wert. |
Das Antwort-Rewrite-Interceptor dient dazu, die Antwort der Upstream-Anwendung (Endbenutzer) zu prüfen und zu ändern, bevor sie den Client erreicht. Es ermöglicht Ihnen, Elemente wie Header, Cookies oder sogar Teile des Antworttexts (HTML, JSON usw.) zu aktualisieren. Dies ist nützlich für:
Änderungen werden dynamisch und transparent angewendet, ohne dass Änderungen in der Upstream-Anwendung selbst erforderlich sind.
| Feld | Werte |
|---|---|
| HTTP | Aktivieren Sie diese Schaltfläche, wenn Sie Access Gateway auf HTTP. |
| Hafen | Geben Sie die Hafen Nummer, auf die das Access Gateway lauscht HTTP Anfragen. |
| HTTPS | Aktivieren Sie diese Schaltfläche, wenn Sie Access Gateway auf HTTPS. |
| SSL-Anschluss | Geben Sie die SSL-Anschluss Nummer, auf die das Access Gateway lauscht HTTPS Anfragen. |
| Keystore-Typ | Typ des Schlüsselspeichers, der verwendet wird, um SSL-Zertifikate (JKS, PKCS12, PEM). |
| Keystore hochladen | Wenn der Schlüsselspeichertyp JKS / PKCS12, laden Sie dann Keystore-Dateien mit den Erweiterungen hoch .jks, .p12, .pfx. |
| PEM-Zertifikat hochladen | Wenn der Schlüsselspeichertyp PEM, dann laden Sie die Datei mit .pem Erweiterung |
| Privaten Schlüssel hochladen | Wenn der Schlüsselspeichertyp PEM, dann laden Sie den privaten Schlüssel hoch mit .pem Erweiterung |
| Domäne hinzufügen | Geben Sie die Domänen an, die dieser Server verwalten soll. Geben Sie die Domäne ein und klicken Sie auf + Hinzufügen. |
| Domains | Konfigurierte Domänen für den aktuellen Server. |
Hinweis: Nachdem Sie einen Server erstellt haben, gehen Sie zu Anwendungen Abschnitt, klicken Sie auf Bearbeiten Klicken Sie auf die gewünschte Anwendung und wählen Sie den Server aus, auf dem die Anwendung bereitgestellt werden soll.
Geben Sie die Plug-and-Play-Betrieb details:
| Feld | Werte |
|---|---|
| Anwendungsname | Geben Sie einen eindeutigen Namen zur Identifizierung der Anwendung ein. |
| Server | Wähle aus Zugriffsgatewayserver aus der Dropdown-Liste, wo Sie die Anwendung bereitstellen möchten. |
| Domain | Wählen Sie aus der Liste der auf dem Server konfigurierten Domänen die für diese Anwendung zu verwendende Domäne aus. |
| Routing-Typ |
Subdomänenbasiertes Routing: Leitet Anfragen basierend auf Subdomänen weiter (z. B. app1.example.com, app2.example.com). Jede Subdomäne ist einer anderen internen Anwendung zugeordnet. Pfadbasiertes Routing: Leitet Anfragen basierend auf URL-Pfaden weiter (z. B. example.com/app1, example.com/app2). Verschiedene Pfade innerhalb derselben Domäne verweisen auf unterschiedliche interne Anwendungen. Die Kontextpfadwert muss immer mit einem / ( beginnenSchrägstrich). |
| Subdomäne/Kontextpfad | Geben Sie die Subdomäne oder den Kontextpfad ein. |
| Gruppen zuweisen |
Weisen Sie der Anwendung Benutzergruppen zu (synchronisiert in Echtzeit mit MiniOrange IAM). Nachdem Sie eine Gruppe ausgewählt haben, klicken Sie auf + Hinzufügen es zuzuweisen. Hinweis: Wenn Gruppen zugewiesen werden, muss die Anwendung auf allen Routen über Authentifizierungs-Interceptoren (SAMLAuth/OAuth) verfügen. Der Authentifizierungsanbieter muss außerdem das folgende Attribut senden:
|
| Anforderungs-Caching aktivieren | Aktivieren oder deaktivieren Sie das Request-Caching. Wenn aktiviert, geben Sie die URL-Pfade an, für die Antworten browserseitig zwischengespeichert werden sollen. |
Das Hostname Die oben eingegebenen Daten müssen einen DNS-Eintrag haben, der auf den Server verweist, auf dem miniOrange Access Gateway bereitgestellt wird.
Gruppenzuordnung funktioniert nur, wenn SAML/OAuth ist für die Anwendung konfiguriert und ein Attribut MAG_USER_GROUPS wird gesendet von der IdP.
Wechseln Sie zu Routen hinzufügen Registerkarte und geben Sie die folgenden Details ein:
| Feld | Wert |
|---|---|
| Path | Definiert das Anforderungs-URL-Muster (z. B. /jde/owhtml, /*), das diese Route verarbeiten soll. Unterstützt exakte Pfade oder Platzhalter. |
| Abfangjäger | Eine Liste von Interceptors, die die Anfrage vor der Weiterleitung verarbeiten. Sie können sie hinzufügen, entfernen oder neu anordnen. |
| Name des Authentifizierungsanbieters | Wählen Sie den Namen aus der Liste der konfigurierten Authentifizierungsanbieter aus. Diese Option wird aktiviert nur wenn SAML/OAuth Interceptor vorhanden ist. |
| Upstream-Gruppe | Wählen Sie aus der Liste der konfigurierten Upstream-Gruppen den Namen aus, an den die Anfrage weitergeleitet werden soll. |
| Vordefinierter Interceptor-Typ | Funktion |
|---|---|
| SAML | Erzwingt die SAML-Authentifizierung, bevor die Anforderung an den Upstream-Server weitergeleitet wird. |
| OAuth | Erzwingt die OAuth-Authentifizierung, bevor die Anfrage an den Upstream-Server weitergeleitet wird. |
| Kekse fangen | Holen Sie sich Cookies aus der Anfrage und fügen Sie diese der entsprechenden Antwort vom Upstream-Server hinzu. |
| Sitzungsabmeldung | Zerstört die Sitzung des Benutzers im Access Gateway. |
| Cache löschen | Caching deaktivieren |
Auf dem Admin-Dashboard können Sie Konfigurationszusammenfassungen anzeigen, den Serverzustand überwachen und den Live-Anforderungsverkehr überprüfen.
Hinweis: Zunächst wird eine Testlizenz für 15 Tage bereitgestellt. Um die Lizenz zu aktualisieren, Kontakt.
