Ja—Sie können einen sicheren, pluginfreien Online‑Dateibetrachter in jede ASP.NET Core-, MVC- oder WebForms‑Anwendung in nur wenigen Minuten einbetten, und Doconut App übernimmt die gesamte Arbeit.
Enterprises, die Verträge, Zeichnungen oder Design‑Assets bereitstellen, benötigen einen Betrachter, der Unternehmens‑Sicherheitsrichtlinien respektiert und Benutzer niemals zwingt, veraltete Browser‑Plugins zu installieren. Doconut bietet ein .NET‑Dokumentenbetrachter‑SDK für browserbasierte PDF-, Office-, CAD-, E‑Mail‑ und Bild‑Workflows. Dieser Beitrag beschreibt die Integrationsentscheidungen, ohne sich auf versionsspezifischen Beispielcode zu stützen.
1. Warum Sicherheit und pluginfreie Darstellung für .NET‑Web‑Apps wichtig sind
Moderne Unternehmen behandeln jedes Dokument als potenziellen Datenverlust. Wenn Sie einen Betrachter einbetten, der auf ActiveX, Flash oder einem nativen Client basiert, übernehmen Sie drei Risiken:
| Risiko | Auswirkung auf Ihre .NET‑Anwendung | Wie Doconut App es eliminiert |
|---|---|---|
| Plugin‑Abhängigkeit | Benutzer müssen ein Browser‑Plugin installieren oder aktivieren, was zu Support‑Tickets und Compliance‑Problemen führt. | Doconut läuft vollständig in HTML5/Canvas und erfordert keine Plugins. |
| Unverschlüsselter Transfer | Dateien werden über HTTP übertragen oder im Klartext gespeichert, was gegen DSGVO, HIPAA oder interne Richtlinien verstößt. | Alle Uploads erfolgen über SSL und werden mit AES‑256‑Verschlüsselung gespeichert. |
| Unkontrollierter Lebenszyklus | Dateien können auf dem Server verweilen und die Angriffsfläche erhöhen. | Doconut löscht Dateien automatisch nach dem Anzeigen, wodurch ein kurzer Aufbewahrungszeitraum gewährleistet wird. |
Da der Betrachter als JavaScript‑Komponente bereitgestellt wird, die mit Doconut’s sicherem Rendering‑Service kommuniziert, bleibt Ihr .NET‑Stack sauber — keine zusätzlichen nativen Bibliotheken, keine Drittanbieter‑Binärdateien und keine zusätzlichen Compliance‑Audits.
2. .NET‑Projekt vorbereiten
Verwenden Sie das Paket, die Dokumentation und die Beispiele, die zur gewählten Doconut‑Version passen. Die offizielle Doconut‑Download‑Seite ist der verlässliche Ausgangspunkt.
Vor der Integration prüfen Sie die Ziel‑.NET‑Runtime, notieren die Paket‑Version, halten Lizenz‑Konfigurationen außerhalb der Versionskontrolle und beginnen mit repräsentativen Dokumenten. ASP.NET Core, MVC und WebForms besitzen unterschiedliche Anwendungs‑Lebenszyklen, sodass ihre Einrichtung nicht als identisch behandelt werden sollte.
3. Aufbau eines sicheren Upload‑Endpunkts – AES‑256, SSL und automatisches Löschen
Der Betrachter greift niemals direkt auf Dateien im Dateisystem zu. Stattdessen laden Sie das Dokument in einen temporären, verschlüsselten Speicherort hoch, den Doconut bei Bedarf ausliest. Nachfolgend eine grobe Beschreibung der erforderlichen Schritte für ASP.NET Core; dieselben Prinzipien gelten für MVC und WebForms.
Server‑seitiger Workflow
- Akzeptieren der hochgeladenen Datei – Verwenden Sie das Standard‑
IFormFile(bzw.HttpPostedFilein WebForms), um das Dokument vom Client zu empfangen. - Verschlüsseln der Datei mit AES‑256 – Bevor Sie den Stream speichern, verschlüsseln Sie ihn mit einer bewährten Bibliothek wie
System.Security.Cryptography.Aes. Speichern Sie das verschlüsselte Blob an einem sicheren Ort (z. B. Azure Blob Storage mit aktivierter serverseitiger Verschlüsselung oder ein S3‑Bucket mit SSE‑AES256). - Erzeugen einer kurzlebigen signierten URL – Erstellen Sie eine URL, die für einige Minuten gültig ist (z. B. 5 Minuten). Die URL muss HTTPS sein und ein kryptografisches Token enthalten, das Doconut validieren kann. Die meisten Cloud‑Storage‑Anbieter bieten eine „pre‑signed URL“-Funktion, die diesen Bedarf deckt.
- Rückgabe der signierten URL an den Client – Senden Sie eine JSON‑Antwort, die die URL enthält. Der Client übergibt diese URL an den Doconut‑Betrachter.
- Planen der automatischen Löschung – Nach Ablauf der signierten URL entfernt ein Hintergrundjob (Hangfire, Azure Functions usw.) das verschlüsselte Blob und stellt sicher, dass die Datei nicht mehr auf dem Server verbleibt.
MVC / WebForms‑Entsprechungen
- MVC – Platzieren Sie dieselbe Logik in einer regulären Controller‑Action und geben Sie ein
JsonResultzurück. - WebForms – Implementieren Sie einen
.ashx‑Handler oder eine Page‑Methode, die dieselben Schritte ausführt:Request.Files[0]empfangen, verschlüsseln, eine pre‑signed URL erzeugen und die JSON‑Antwort schreiben.
Der einzige Unterschied liegt in der Routing‑Syntax; der Sicherheits‑Workflow bleibt identisch.
4. Rendern des Dokuments über das installierte SDK
Halten Sie den Dokumentenzugriff auf dem Server und erzwingen Sie die Autorisierung, bevor Sie eine Datei oder einen Stream verarbeiten. Die genaue Rendering‑ und UI‑Initialisierungssequenz ist versionsspezifisch; folgen Sie der offiziellen Dokumentation, die mit dem installierten Build geliefert wird, anstatt eine nicht verifizierte globale JavaScript‑API zu kopieren.
Warum das für jede .NET‑Variante funktioniert
- ASP.NET Core Razor – Das Skript befindet sich in derselben View, die das Upload‑Formular hostet, sodass der Ablauf nahtlos ist.
- MVC – Verwenden Sie
@section Scripts, um denselben Snippet einzufügen; der Controller liefert JSON, das MVC’s$.ajaxverarbeiten kann. - WebForms – Registrieren Sie das Skript mit
ClientScript.RegisterStartupScriptnach Abschluss des Uploads und rufen Sie dannlaunchViewerauf dieselbe Weise auf.
Da Doconut das Dokument direkt aus der signierten URL streamt, berührt der Server die Datei nach dem Upload‑Schritt nie wieder. Der Betrachter rendert PDFs, Word‑Dateien, CAD‑Zeichnungen und alle anderen im Produkt‑Fact‑Sheet aufgeführten Formate — ohne zusätzliche serverseitige Konvertierung.
5. Anpassung des Betrachters an Ihre Marke – Feinabstimmung des Online‑Dateibetrachters
Unternehmen benötigen häufig einen Betrachter, der wie ein nativer Teil ihres Portals wirkt. Doconut App’s vollständig anpassbare UI ermöglicht Ihnen:
| Anpassung | Wie in .NET anzuwenden |
|---|---|
| Toolbar‑Layout | Setzen Sie toolbar: false und bauen Sie eigene Buttons, die die JavaScript‑API des Betrachters aufrufen (z. B. zoomIn(), print()). |
| Farbschema | Setzen Sie theme: "dark" oder stellen Sie eine eigene CSS‑Datei bereit, die die Standard‑Klassen überschreibt. |
| Sprache & Barrierefreiheit | Doconut respektiert das lang‑Attribut im Container; Sie können außerdem ARIA‑Labels über die accessibility‑Option einfügen. |
| Ereignis‑Hooks | Callbacks wie onPageChange, onError und onDownload ermöglichen das Protokollieren von Nutzungsmetriken in Ihrer bestehenden Telemetrie‑Pipeline. |
All diese Hooks werden im gleichen JavaScript‑Objekt konfiguriert, das im vorherigen Abschnitt gezeigt wurde. Da der Betrachter vollständig clientseitig läuft, gibt es keine zusätzliche Server‑Last — Ihr .NET‑Backend bleibt auf Authentifizierung, Verschlüsselung und Geschäftslogik fokussiert.
6. Leistung und Skalierbarkeit – die Erfahrung flink halten
Das Einbetten eines Betrachters in ein stark frequentiertes Portal wirft zwei praktische Fragen auf: Ladezeit und gleichzeitiges Rendering. Doconut App adressiert beide sofort, Sie können die Performance jedoch mit einigen .NET‑spezifischen Tricks weiter optimieren.
| Problem | Doconut‑Vorteil | Zusätzlicher .NET‑Tipp |
|---|---|---|
| Erster Download | Viewer‑Skript ist nur ~150 KB, gzip‑komprimiert. | Aktivieren Sie statische Dateikompression (app.UseResponseCompression()) und Caching (Cache‑Control: public, max‑age=31536000). |
| Datei‑Streaming | Doconut streamt nur die benötigten Seiten mittels HTTP‑Range‑Requests. | Speichern Sie verschlüsselte Blobs in einem regionalen CDN (Azure Front Door, Amazon CloudFront), um die Latenz zu reduzieren. |
| Gleichzeitige Benutzer | Rendering erfolgt auf dem Client; der Server liefert die verschlüsselte Datei nur einmal pro Ansicht. | Drosseln Sie den Upload‑Endpunkt mit IApplicationRateLimiter, um Spitzen abzufangen. |
| Speicherverbrauch | Keine serverseitigen PDF‑Konvertierungsbibliotheken, sodass der ASP.NET‑Prozess schlank bleibt. | Führen Sie den Upload‑Service in einem separaten Microservice aus, falls Sie bereits eine schwere Hintergrund‑Job‑Queue haben. |
Wenn Sie diese Richtlinien befolgen, können Sie Tausende gleichzeitiger Betrachter unterstützen, ohne die .NET‑Web‑Schicht über das bereits Vorhandene hinaus zu skalieren.
Wesentliche Erkenntnisse
- Doconut App liefert einen plugin‑freien, 100 % sicheren Betrachter, der mit ASP.NET Core, MVC und WebForms funktioniert.
- Uploads erfolgen nur über SSL, werden mit AES‑256‑Verschlüsselung gespeichert und nach Ablauf der signierten URL automatisch gelöscht.
- Die Integration benötigt lediglich ein CDN‑Skript, ein Container‑
<div>und einen kleinen serverseitigen Endpunkt, der eine signierte URL zurückgibt. - Der Betrachter unterstützt PDF, Office, CAD und über 50 Bildformate — keine serverseitige Konvertierung nötig.
- Die UI kann vollständig angepasst werden, um dem Corporate Branding zu entsprechen, und der Betrachter bietet integrierte Zoom‑, Mess‑ und Ebenen‑Werkzeuge für CAD‑Dateien.
- Die Performance wird clientseitig gehandhabt; .NET‑Entwickler müssen nur statische Dateikompression und optionales CDN‑Caching sicherstellen.
- Der gesamte Workflow — vom sicheren Upload bis zum In‑Browser‑Rendering — passt nahtlos in bestehende .NET‑Authentifizierungs‑ und Autorisierungspipelines.
Häufige Fragen
F1: Muss ich NuGet‑Pakete installieren, um Doconut zu verwenden?
A: Nein. Der Betrachter wird als clientseitiges JavaScript‑Bundle vom Doconut‑CDN bereitgestellt. Ihr Server benötigt lediglich die üblichen ASP.NET‑Core‑Middleware für Datei‑Uploads und Verschlüsselung, die Sie wahrscheinlich bereits haben.
F2: Wie stellt Doconut sicher, dass die Datei nach dem Anzeigen gelöscht wird?
A: Doconut erzeugt eine kurzlebige signierte URL, die nach einem konfigurierbaren Zeitraum (typischerweise fünf Minuten) abläuft. Nach Ablauf der URL löschen Sie (oder ein Hintergrund‑Cleanup‑Job) das verschlüsselte Blob. Dadurch wird garantiert, dass das Dokument nicht länger als nötig aufbewahrt wird und strenge Daten‑Aufbewahrungsrichtlinien erfüllt werden.
F3: Kann ich den Betrachter zum Drucken oder Exportieren des Dokuments verwenden?
A: Ja. Doconut’s integrierte Toolbar enthält Druck‑ und Export‑Optionen, die die ursprüngliche Qualität und das Layout der Quelldatei beibehalten.
Bereit, einen sicheren, pluginfreien Dokumentenbetrachter in Ihre .NET‑Anwendung einzubetten? Starten Sie noch heute mit Doconut App und liefern Sie PDF, Office, CAD und Dutzende weiterer Formate sicher und sofort.