Ein GitHub-Repository einrichten

In diesem Tutorial lernen Sie, wie Sie ein GitHub-Repository erstellen und die grundlegende Einrichtung durchführen.

Dieses Tutorial wurde für ArcGIS Enterprise 11.5 im Dezember 2025 getestet.

Voraussetzungen

Überprüfen Sie die Voraussetzungen für dieses Tutorial:

  • VS Code ist auf Ihrem lokalen Computer installiert.

  • Git ist auf Ihrem lokalen Computer installiert.

  • Sie haben ein GitHub-Konto. Dieses ist mit VS Code verbunden.

Ein neues Repository erstellen

Erstellen Sie ein neues GitHub-Repository für diese Tutorials.

  1. Melden Sie sich bei GitHub mit Ihren Kontodaten an.

  2. Klicken Sie auf das + Symbol in der oberen rechten Ecke und wählen Sie New repository.

  3. Benennen Sie Ihr Repository security-manager-policies.

  4. Fügen Sie eine Beschreibung hinzu: Policy configurations for security.manager NEXT.

  5. Wählen Sie Private für sensible Zugriffsrecht-Konfigurationen.

  6. Markieren Sie Add a README file.

  7. Klicken Sie Create repository.

  8. Kopieren Sie die Repository-URL (HTTPS-Format).

Das Repository in VS Code klonen

Als nächstes benötigen Sie einen lokalen Klon dieses Repositories.

  1. Öffnen Sie VS Code auf Ihrem lokalen Computer.

  2. Drücken Sie Ctrl+Shift+P, um die Command Palette zu öffnen.

  3. Geben Sie Git: Clone ein und wählen Sie es aus.

  4. Fügen Sie die zuvor kopierte Repository-URL ein.

  5. Wählen Sie einen lokalen Ordner für das Repository.

  6. Wenn Sie dazu aufgefordert werden, wählen Sie Open, um das geklonte Repository zu öffnen.

Die Zugriffsrecht-Verzeichnisstruktur erstellen

security.manager NEXT CLI erfordert eine feste Ordnerstruktur.

  1. Um die Dateien für security.manager NEXT von anderen Dateien zu trennen, erstellen Sie einen Ordner policies.

    1. In VS Code Explorer klicken Sie mit der rechten Maustaste in das Repository-Root.

    2. Wählen Sie New Folder.

    3. Geben Sie den Namen policies ein.

    Dieser Ordner ist das Arbeitsverzeichnis von security.manager NEXT.

  2. Um die erforderliche Ordnerstruktur zu erfüllen, erstellen Sie einen Unterordner namens services innerhalb von policies.

Ihre Verzeichnisstruktur sollte so aussehen:

security-manager-policies/
├── README.md
└── policies/
    └── services/

Die Zugriffsrechte hinzufügen

Aktuell hat Ihr lokales Setup keine Zugriffsrechte. Erstellen Sie ein neues Zugriffsrecht für den SampleWorldCities Service.

  1. Fügen Sie eine neue Datei zum services Ordner mit dem Namen SampleWorldCities.json hinzu.

  2. Öffnen Sie die Datei und fügen Sie das Zugriffsrecht aus dem vorherigen Tutorial hinzu.

{
    "fallbackPolicies": [{
        "layers": [
            "0"
        ],
        "restrictions": ["cities_only_names", "cities_username_filter"]
    },{
        "layers": [
            "1"
        ],
        "restrictions": ["country_username_filter"]
    }],
    "restrictions": {
        "country_username_filter": {
            "type": "spatial",
            "featuretypeurl": "https://services.conterra.de/server/rest/services/security_demos/World_Countries/FeatureServer/0",
            "featurequery": "NAME LIKE UPPER(SUBSTRING('${user.username}', 1, 1)) || '%'",
            "imageoperation": "arcgis-clipping"
        },
        "cities_username_filter":{
            "type": "feature",
            "query": "CITY_NAME LIKE UPPER(SUBSTRING('${user.username}', 1, 1)) || '%'"
        },
        "cities_only_names":{
            "type": "field",
            "allowedfields": [
                "CITY_NAME"
            ]
        }
    }
}

Änderungen committen und pushen

Committen und pushen Sie Ihre Änderungen zu GitHub.

  1. In VS Code gehen Sie zur Source Control-Ansicht, indem Sie Ctrl+Shift+G drücken.

  2. Überprüfen Sie alle geänderten und hinzugefügten Dateien, z.B. policies/services/SampleWorldCities.json.

  3. Geben Sie eine Commit-Nachricht ein: Add SampleWorldCities policy.

  4. Klicken Sie Commit, um Änderungen zu einem Commit hinzuzufügen und zu committen.

  5. Klicken Sie Sync Changes oder verwenden Sie Ctrl+Shift+P und wählen Sie Git: Push, um zu GitHub zu pushen.

Überprüfen Sie die Repository-Updates im Webbrowser.

  1. Gehen Sie zu Ihrem GitHub-Repository im Webbrowser.

  2. Navigieren Sie zum policies/services/ Ordner.

  3. Überprüfen Sie, dass SampleWorldCities.json vorhanden ist.

Zugriffsrechte von ArcGIS Enterprise sichern

Falls Sie dieses Projekt nach der Benutzung der security.manager Manager UI einrichten, möchten Sie möglicherweise alle bestehenden Zugriffsrechte aus der ArcGIS Enterprise Instanz erhalten, um mit diesen weiterzuarbeiten. Um das manuelle Kopieren aller Zugriffsrechte zu vermeiden, können Sie die security.manager CLI verwenden, um alle Dateien zu erhalten. Beachten Sie, dass der Befehl Ihre lokalen Dateien mit dem gleichen Namen überschreibt.

Installieren Sie security.manager CLI und folgen Sie der Anleitung Definieren und synchronisieren, verwenden Sie aber das --reverse Flag in Schritt 3, um vom ArcGIS Server zu Ihrem lokalen Computer zu synchronisieren. Diese Option wird in Zugriffsrechte sichern erklärt.

Commiten und Pushen Sie gegebenenfalls die gesicherten Zugriffsrechte zu GitHub, damit sie in diesem Repository verfügbar sind.

Zusammenfassung

In diesem Tutorial haben Sie gelernt, ein GitHub-Repository zu erstellen, um die Zugriffsrecht-Konfiguration zu speichern. Sie können mit anderen zusammenarbeiten und die Versionskontrolle verwenden.

Folgen Sie JSON Schema, um Autocompletion zu aktivieren und VS Code IntelliSense zu verwenden.