Doconut è registrato nello stesso modo in cui tutto il resto in ASP.NET Core è registrato: un servizio nel contenitore e middleware nella pipeline. Eredita la tua autenticazione, il tuo logging, il tuo grafo DI e la tua storia di distribuzione, perché viene eseguito all'interno di essi piuttosto che accanto a essi.
Il problema
La maggior parte dei visualizzatori di documenti arriva come servizio separato. Ciò significa una seconda unità di distribuzione, un secondo set di credenziali, un salto di rete attraverso il quale i tuoi documenti ora viaggiano, e una seconda cosa di cui svegliare qualcuno alle 2 del mattino.
Doconut è una libreria. AddDoconut() la inserisce nella tua collezione di servizi; UseDoconut() la inserisce nella tua pipeline. Funziona sotto l'identità del tuo processo, legge la tua configurazione, scrive nel tuo logger e viene distribuita da ciò che già distribuisce la tua applicazione.
La conseguenza pratica è che l'autorizzazione rimane dove deve essere. Chiami OpenDocumentAsync() dopo il tuo controllo dei permessi, e il visualizzatore può rendere solo ciò che hai deciso di fornirgli.
Funzionalità
Il visualizzatore non è legato a uno stile di hosting. Renderizza il div di montaggio da una vista Razor o da una pagina statica e apri il documento da un'azione del controller, da un gestore di pagina o da un endpoint mappato.
Poiché gli endpoint vivono nella tua pipeline, [Authorize] funziona come sempre. Non c'è un secondo sistema di identità con cui federarsi.
La sicurezza dei documenti si basa sullo stato di sessione di ASP.NET, motivo per cui UseSession() deve essere registrato prima di UseDoconut(). Significa che la nozione di chi sei del visualizzatore è la stessa dell'applicazione.
Più nodi dietro un bilanciatore di carico condividono la cache di rendering, così una sessione aperta su un nodo continua a funzionare quando la richiesta successiva arriva altrove.
IIS, Kestrel o un'immagine container che costruisci tu stesso. Nulla dell'integrazione cambia tra loro, tranne dove il file di licenza è montato.
Con il plugin Converter, DocumentConverter.ConvertAsync() viene eseguito nello stesso processo — nessun secondo servizio, nessun upload temporaneo, nessun round trip.
Integrazione
UserMayRead e ResolvePath sono il tuo codice. Questo è il punto: Doconut non scopre mai quali documenti esistono o chi è autorizzato a vederli.
Piattaforme supportate
// Program.cs
builder.Services.AddDoconut(options =>
{
options.LicensePath = "Doconut.Viewer.lic";
});
builder.Services.AddSession(); // document security rides on session state
var app = builder.Build();
app.UseSession(); // call UseSession() before UseDoconut()
app.UseDoconutResources(); // must be registered before UseDoconut()
app.UseDoconut();
// Open the document server-side, behind your own authorization
app.MapPost("/api/open", async (Viewer viewer, HttpContext ctx, string documentId) =>
{
if (!await ctx.UserMayRead(documentId))
return Results.Forbid();
// The token is opaque — hand it to the widget, never log or persist it.
string token = await viewer.OpenDocumentAsync(ResolvePath(documentId));
return Results.Ok(new { token });
}).RequireAuthorization();Dettagli
Sì. Entrambi sono supportati e utilizzano la stessa architettura DI più middleware. Ci sono pagine dedicate per ciascuno se hai bisogno di dettagli specifici per versione.
No, ed è intenzionale. L'integrazione è sempre middleware più il widget JavaScript, il che mantiene la stessa integrazione valida su Razor Pages, MVC, Web Forms e Blazor invece di frammentarsi in quattro.
Il web farm e la distribuzione distribuita sono supportati tramite una cache di rendering condivisa. Un documento aperto su un nodo rimane leggibile quando le richieste successive arrivano su un altro.
No. Il rendering è nativo — non c'è interop con Office, nessun Word headless e nessuna automazione COM da gestire.
Blazor
Rendering lato server con un widget che si monta pulitamente nel ciclo di vita dell'interoperabilità di Blazor — supportati sia Server che WebAssembly.
BlazorWord
Rendering nativo di DOC/DOCX/RTF/ODT senza installazione di Office, senza interop COM e senza automazione lato server.
WordUna licenza temporanea richiede pochi minuti per essere richiesta e funziona interamente sul tuo computer. I file che contano sono quelli che già interrompono il tuo visualizzatore corrente.