Anleitung zur Quellcode-Vorschau · 0.1.0

Quell- und Clientberechtigungen

Verstehe die getrennten Entscheidungen, die Clients Arbeitsaufträge und Scannern Quellzugriff erlauben.

Die API-Referenz ist auf Englisch.

Editorverbindung, autorisierte Quellwurzel und genehmigtes geschütztes Repository beantworten unterschiedliche Fragen. CodeSecurity prüft sie jeweils an der relevanten Grenze. Ein Projektname oder vom Client übermittelter Pfad autorisiert allein keinen Quellzugriff.

Trenne Eigentümerentscheidungen

Browser- und Editorberechtigungen sind unabhängig widerrufbar. IDE-Anfragen werden gegen genaue Routenscopes und aktive Capability-Generation geprüft. Die Control-API ist kein allgemeiner API-Schlüsseldienst. Die Authentifizierungsanleitung erklärt den unterstützten Clientablauf.

Die Anfragegrenze validiert auch Host und Origin und lehnt Zugangsmaterial in URLs ab. Authentifizierung ersetzt keine routenspezifischen Eigentumsprüfungen. Siehe Sicherheitsmiddleware und IDE-Autorisierung.

Gemountete Quellen sind eine ausdrückliche Hostgrenze

Bei unterstützten POSIX- und Remote-WSL-Abläufen wählt der Eigentümer bestehende enge Quellwurzeln. Der Hosthelfer kanonisiert Pfade und lehnt breite Wurzeln, unsichere Formen und Werte ab, die nicht wörtlich in die Compose-Umgebung serialisiert werden können. Höchstens 32 verschiedene konfigurierte Wurzeln sind erlaubt. Compose erzeugt keine fehlende Bind-Quelle, um einen Auftrag erfolgreich zu machen.

Die API hat keinen Projektquellmount. Ihre Vorschau prüft, ob der angeforderte Pfad innerhalb konfigurierter Berechtigung liegt, und entscheidet ohne Projekt- oder Joberstellung. Projekterstellung erfasst die Quellidentität. Bei Ausführung prüft der Scanner den tatsächlichen Pfad unabhängig und verwendet eingeschränkte Leseoperationen; die lexikalische API-Pfadprüfung gilt nicht als Beweis sicheren Zugriffs.

Scans ausgewählter Dateien und Verzeichnisse bleiben innerhalb des autorisierten Repositorys. Der Scanner validiert das Ziel und erfasst seine Quellansicht für die Werkzeuge. Eine Anfrage macht aus einem gewählten Verzeichnis keine Erlaubnis zum Lesen außerhalb der Wurzel.

Implementierungseinstiege sind Quellwurzelvalidierung, Quellvorschau und Projekterstellung und deskriptorrelatives Quelllesen.

Momentaufnahmen transportieren Quellen statt breiterer Mounts

Unterstützte native Windows-Abläufe und unveränderliche Git-Baumprüfungen verwenden den eigenen Momentaufnahmespeicher. Die API validiert Dateipfade, Anzahl, Größe und Inhaltsidentität vor Veröffentlichung einer versiegelten Generation. Ein Momentaufnahmescan muss den genauen erwarteten Digest nennen; ein Projekt mit gemounteten Quellen kann nicht stillschweigend einen Upload einsetzen.

Veröffentlichung und ausdrückliches Löschen teilen eine private No-follow-Sperre. Gleichzeitige Schreiber erhalten snapshot_storage_busy; unsicherer oder unlesbarer Speicher liefert snapshot_storage_unavailable; Kapazitätsablehnung liefert snapshot_storage_full. Diese Ablehnungen planen weder versteckte Wiederholungen noch löschen sie ältere Nachweise automatisch.

Eine identische versiegelte Generation wird ohne weitere Kopie validiert und wiederverwendet, auch bei voller Neuschreibzulassung. Unterbrochene Veröffentlichung verbraucht weiterhin Speicherbudget. Nur ausdrücklich geprüfte passende Quellgenerationen dürfen gelöscht werden. Andere Prozesse können Hostplatz verbrauchen; lokale Grenzen versprechen daher keinen dauerhaft freien Gesamtdatenträger.

Siehe Momentaufnahmezulassung und Speichervertrag. Erfassungsgrenzen unterscheiden sich von der kleineren Scannergrenze für geeignete Textanalyse unter Scannen.

Binde Quellnavigation an aktuelle Nachweise

Ein Befunddateipfad ist ein Nachweis, keine Anweisung zum Öffnen beliebiger Dateien. Quellöffnungsbefehle binden gewählte IDE-Capability-Generation, Befundrevision und Sammlungsrevision. Veraltete oder mehrdeutige Empfänger verlangen Abgleich.

Befunde festgehaltener Bäume haben eine strengere Grenze: Die API verweigert das Öffnen einer vermeintlich passenden aktuellen Arbeitsbereichsdatei. Der aktuelle Arbeitsbaum kann von der historischen Befundquelle abweichen. Prüfe stattdessen erfasste Details. Diese Ablehnung steht ausdrücklich in IDE-Quellbefehlen.

Erhalte die Grenze bei Integrationen

Nutze das unterstützte Browser- oder IDE-Berechtigungsmodell und zusätzliche Eigentumsprüfungen der Ressource. Erweitere keine Quellwurzeln wegen veralteter Capabilities, behandle Pfadvorschau nicht als Scannerabschluss und leite native Plattformqualifikation nicht aus vorhandener Momentaufnahmeimplementierung ab. Tatsächliches Plattformverhalten benötigt Nachweise für die genauen verwendeten Quellen, Images und Clients.