Doconut se registra de la misma manera que todo lo demás en ASP.NET Core: como un servicio en el contenedor y middleware en el pipeline. Hereda tu autenticación, tu registro, tu grafo de DI y tu historia de despliegue, porque se ejecuta dentro de ellos en lugar de al lado.
El problema
La mayoría de los visores de documentos llegan como un servicio separado. Eso significa una segunda unidad de despliegue, un segundo conjunto de credenciales, un salto de red por el que ahora viajan tus documentos, y una segunda cosa por la que llamar a alguien a las 2 am.
Doconut es una biblioteca. AddDoconut() lo coloca en tu colección de servicios; UseDoconut() lo coloca en tu pipeline. Se ejecuta bajo la identidad de tu proceso, ve tu configuración, escribe en tu registrador y es desplegado por lo que ya despliega tu aplicación.
La consecuencia práctica es que la autorización permanece donde corresponde. Llamas a OpenDocumentAsync() después de tu propia verificación de permisos, y el visor solo podrá renderizar lo que hayas decidido entregarle.
Capacidades
El visor no está ligado a un estilo de hosting. Renderiza el div de montaje desde una vista Razor o una página estática y abre el documento desde una acción de controlador, un manejador de página o un endpoint mapeado.
Porque los endpoints viven en tu pipeline, [Authorize] funciona como siempre. No hay un segundo sistema de identidad con el que federar.
La seguridad de documentos se basa en el estado de sesión de ASP.NET, por lo que UseSession() debe registrarse antes de UseDoconut(). Significa que la noción del visor de quién eres es la misma que la de la aplicación.
Múltiples nodos detrás de un balanceador de carga comparten la caché de renderizado, de modo que una sesión abierta en un nodo sigue funcionando cuando la siguiente solicitud llega a otro.
IIS, Kestrel o una imagen de contenedor que construyas tú mismo. Nada de la integración cambia entre ellos, excepto dónde se monta el archivo de licencia.
Con el plugin Converter, DocumentConverter.ConvertAsync() se ejecuta en el mismo proceso — sin segundo servicio, sin carga temporal, sin ida y vuelta.
Integración
UserMayRead y ResolvePath son tu propio código. Ese es el punto: Doconut nunca sabe qué documentos existen o quién tiene permiso para verlos.
Plataformas compatibles
// 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();Detalles
Sí. Ambos son compatibles y usan la misma arquitectura DI más middleware. Hay páginas dedicadas para cada uno si necesitas detalles específicos de la versión.
No, y eso es intencional. La integración es siempre middleware más el widget JavaScript, lo que mantiene la misma integración válida en Razor Pages, MVC, Web Forms y Blazor en lugar de fragmentarse en cuatro.
La granja web y el despliegue distribuido son compatibles mediante una caché de renderizado compartida. Un documento abierto en un nodo sigue siendo legible cuando solicitudes posteriores llegan a otro.
No. El renderizado es nativo — no hay interop de Office, no hay Word sin cabeza, y no hay automatización COM que supervisar.
Blazor
Renderizado del lado del servidor con un widget que se monta limpiamente en el ciclo de vida de interop de Blazor — Server y WebAssembly ambos compatibles.
BlazorWord
Renderizado nativo de DOC/DOCX/RTF/ODT sin instalación de Office, sin interop COM y sin automatización del lado del servidor.
WordUna licencia temporal tarda unos minutos en solicitarse y se ejecuta completamente en tu propia máquina. Los archivos que importan son los que ya están rompiendo tu visor actual.