SXAccessSXAccessDoku
Dashboard öffnen

Netzwerke und Ressourcen

Einen Standort als internes Netzwerk abbilden, die Ressourcen darin auflisten, die erreichbar sein sollen, und sie in Zugriffsregeln nennen. Der wichtigste Weg in private Netze.

Ein internes Netzwerk ist ein benannter Ort - ein Büro, eine VPC, ein Rechenzentrum. Darin listen Sie Ressourcen auf, also die Adressen, die tatsächlich erreichbar sein sollen, und Routing-Geräte, also Geräte mit installiertem SXAccess, die den Verkehr in das Netzwerk leiten. Was hinter einem Routing-Gerät liegt, braucht kein SXAccess.

Das ist der wichtigste Weg in private Netze. Eine Ressource ist ein Objekt, das eine Zugriffsregel nennen kann. Sie können also „Support darf den Host des Ticketsystems auf Port 443 erreichen“ schreiben, statt ein ganzes Subnetz zu öffnen. Wenn Sie tatsächlich einen ganzen CIDR-Bereich freigeben wollen, verwenden Sie stattdessen eine Route.

Die Seite „Networks“ mit Zählern für interne Netzwerke, laufende Routen, Routing-Geräte und erreichbare Ressourcen.
Alles an einem Ort: die Netzwerke hinter Ihren Geräten, die Routen dorthin und die Geräte, die den Verkehr weiterleiten.

Ressourcentypen

Den Typ wählen Sie nicht: Er ergibt sich aus dem, was Sie als Address eingeben.

TypAdresseBeispielGeeignet für
hostEine einzelne IP-Adresse10.20.0.15Ein einzelner Server, eine Appliance oder ein Drucker
subnetEin CIDR-Bereich10.20.4.0/24Ein ganzes Segment, wenn es unpraktisch ist, jeden Host einzeln anzugeben
domainEin DNS-Name, optional mit *. am Anfang*.internal.example.comDienste mit wechselnder Adresse - Cloud-Endpunkte, Load Balancer
Der Ressourcen-Editor mit Namen, Adresse und den Zielgruppen, denen die Ressource angehört.
Eine Ressource ist eine Adresse mitsamt den Gruppen, denen sie angehört; eine Zugriffsregel nennt die Ressource oder eine dieser Gruppen.

Routing-Geräte

Ein Routing-Gerät ist ein gewöhnliches Gerät, das zusätzlich Verkehr in das Netzwerk weiterleitet. Sie fügen es im Netzwerk mit Add Routing Device hinzu. Wählen Sie im ersten Schritt ein einzelnes Gerät im Reiter Routing Devices oder alle Geräte einer Gruppe im Reiter Device group und dann Continue. Der zweite Schritt enthält die Einstellungen, und Add Routing Device speichert sie:

  • Enable Routing Device - damit schalten Sie es ab, ohne es zu entfernen.
  • Masquerade - standardmäßig an. Das Routing-Gerät schreibt Verkehr, der in das Netzwerk geht, so um, dass er von seiner eigenen LAN-Adresse kommt (Source-NAT). Das LAN braucht dann keine Route zurück in den Overlay-Bereich, also den Adressbereich Ihrer Geräte in SXAccess. Schalten Sie es nur aus, wenn das LAN diesen Bereich tatsächlich zum Routing-Gerät zurückroutet; ohne diesen Rückweg kommen Antworten nie an.
  • Metric - 1 bis 9999, Standard 9999. Hat ein Netzwerk mehrere Routing-Geräte, wird das mit der niedrigeren Metrik bevorzugt.

Eine Gerätegruppe teilt sich eine Metrik, die Geräte darin sind also gleichrangig. Wenn Sie ein Gerät bevorzugen wollen, fügen Sie jedes Gerät als eigenes Routing-Gerät hinzu und geben Sie dem bevorzugten die niedrigere Metrik. Wie jedes Gerät seine Wahl trifft, steht unter Redundanz.

Ein Routing-Gerät muss nicht unter Linux laufen. Unter Linux schaltet der Agent die IP-Weiterleitung (net.ipv4.ip_forward=1) selbst ein, sobald das Gerät zu routen beginnt; Sie müssen also nichts konfigurieren. Er schaltet sie nicht wieder ab, wenn das Gerät nicht mehr routet; der Host leitet also weiter, bis er neu startet oder Sie die Einstellung zurücksetzen. Auf anderen Systemen leitet der Agent den Verkehr selbst weiter, und das Dashboard lässt Masquerade für ein solches Gerät eingeschaltet. Zwei Agent-Optionen verhindern, dass ein Gerät routet: --disable-server-routes und --block-inbound. Lassen Sie auf einem Routing-Gerät beide ausgeschaltet.

In der API liegen Routing-Geräte unter /api/networks/{networkId}/connectors.

Ein einzelnes Netzwerk mit seinen Ressourcen und seinen Routing-Geräten, je mit einem Aktiv-Schalter.
Im Netzwerk: die Ressourcen darin und die Geräte, die dorthin routen.

Einen Standort erreichbar machen

  1. 1

    Einen Rechner am Standort registrieren

    Er muss ständig eingeschaltet sein und im selben LAN stehen wie das, was Sie erreichen wollen. Ideal ist ein kleiner Linux-Host, der rund um die Uhr läuft. Die IP-Weiterleitung müssen Sie nicht einrichten: Das übernimmt der Agent, wie oben unter Routing-Geräte beschrieben. Führen Sie den Befehl als root aus, damit er die Schlüsseldatei lesen kann.

    shell
    sxaccess start --enrollment-key-file /run/secrets/sxaccess-key --hostname office-fra1
  2. 2

    Das interne Netzwerk anlegen

    Networks → Internal networks → Add internal network. Benennen Sie es nach dem Ort und wählen Sie Add Network. Das Dashboard führt Sie danach in dieser Reihenfolge durch die nächsten drei Schritte.

  3. 3

    Ressourcen hinzufügen

    Add Resource: ein Name, die Address und eine oder mehrere Destination Groups. Eine Zielgruppe ist eine Gruppe, in die die Ressource aufgenommen wird, damit Zugriffsregeln sie als Ziel nennen können; sie legt nicht fest, wer die Ressource erreichen darf. Enable Resource ist standardmäßig an. Wählen Sie Add Resource.

  4. 4

    Die Zugriffsregel anlegen

    Eine Ressource wird erst verteilt, wenn eine Zugriffsregel sie nennt: Bis dahin erhält kein Gerät eine Route dorthin. Die Regel öffnet sich mit der Ressource als festem Ziel. Wählen Sie die Quelle: die Gruppe der Personen, die sie brauchen. Protokoll und Ports: nur, was der Dienst nutzt. Eine Regel mit einer Ressource als Ziel ist immer One-way. Wählen Sie Create access rule. Für eine Ressource, die Sie später hinzufügen, nutzen Sie Add Access rule in ihrer Zeile auf der Seite des Netzwerks. Eine Regel unter Access → Access rules kann stattdessen eine der Zielgruppen der Ressource nennen und umfasst dann jede Ressource dieser Gruppe. Siehe Zugriffsregeln.

  5. 5

    Das Routing-Gerät hinzufügen

    Wählen Sie Add Routing Device, dann den registrierten Rechner und Continue. Lassen Sie Masquerade eingeschaltet und wählen Sie Add Routing Device. Solange das Netzwerk kein Routing-Gerät hat, ist darin nichts erreichbar.

  6. 6

    Von einem Gerät der Quellgruppe prüfen

    Die Ressource sollte mit state: Selected aufgeführt sein, die Zeile Reaches des Routing-Geräts in sxaccess info -d sollte ihre Adresse zeigen, und sie sollte antworten.

    shell
    sxaccess reach listsxaccess info -d
Das Panel „Add Resource“ mit Feldern für Name, Beschreibung, Adresse und Zielgruppen.
Eine Ressource anlegen: eine Adresse und die Zielgruppen, die Zugriffsregeln als Ziel nennen können.

Was Geräte sehen

Ein Gerät aus der Quellgruppe einer Zugriffsregel, die eine Ressource nennt, erhält eine Route dorthin, die über die Routing-Geräte des Netzwerks führt. Die Route ist Teil der Netzwerkbeschreibung des Geräts, der Liste der Geräte und Routen, die der Management-Dienst auf jedem Gerät aktuell hält. Für die Routing-Geräte braucht das Gerät keine weitere Regel, und es muss die Route auch nicht erst annehmen.

Wer zu Hause ein LAN hat, das mit einer Subnetz-Ressource kollidiert, kann diese Ressource auf dem eigenen Gerät abschalten. In den Apps geht das mit ihrem Schalter auf dem Bildschirm Resources. In der CLI dient dazu sxaccess reach remove <Name> mit dem Namen, den sxaccess reach list zeigt, bei einer Ressource also dem Wert im Feld Name; sxaccess reach add -a <Name> schaltet sie wieder ein. Alles Weitere zum Befehl reach steht unter Was Geräte mit einer Route tun.

Wenn eine Ressource nicht antwortet

  • Die Ressource fehlt in sxaccess reach list. Das Gerät hat keine Route dorthin. Prüfen Sie die Zugriffsregel: Sie muss aktiv sein, ihre Quelle muss eine Gruppe dieses Geräts enthalten, und ihr Ziel muss die Ressource oder eine ihrer Zielgruppen sein. Das Gerät muss außerdem jede Geräteanforderung dieser Regel erfüllen. Prüfen Sie dann, ob Enable Resource eingeschaltet ist und ob das Netzwerk ein Routing-Gerät mit eingeschaltetem Enable Routing Device hat.
  • Sie steht mit state: Not Selected in der Liste. Sie wurde auf diesem Gerät abgeschaltet. Führen Sie sxaccess reach add -a <Name> mit dem Namen aus, den reach list zeigt, oder schalten Sie sie in der App unter Resources wieder ein.
  • Sie ist ausgewählt und antwortet trotzdem nicht. Testen Sie mit dem Protokoll und dem Port, die die Regel erlaubt: Eine Regel für TCP 443 lässt kein ping durch. Prüfen Sie unter Devices, ob das Routing-Gerät online ist und ob sein Agent ohne --disable-server-routes und --block-inbound läuft. Ist Masquerade aus, braucht das LAN eine Route zurück in den Overlay-Bereich.
  • Eine Wildcard-Domain wird nicht aufgelöst. Resolve wildcard domains muss unter Organization settings eingeschaltet sein; siehe den Hinweis zu Domain-Ressourcen oben.