ステップバイステップチュートリアル:開発者が ASP.NET Core、MVC、または WebForms アプリケーションに安全なプラグイン不要のドキュメントビューアを埋め込む方法
7/24/2026

ステップバイステップチュートリアル:開発者が ASP.NET Core、MVC、または WebForms アプリケーションに安全なプラグイン不要のドキュメントビューアを埋め込む方法

Doconut App の安全なプラグイン不要ドキュメントビューアを ASP.NET Core、MVC、または WebForms プロジェクトに簡単な手順で統合する方法を学びましょう。PDF、Office、CAD、50 以上の形式に対応しています。

多くの開発者は、Web アプリケーションでドキュメントを表示する必要があるときに UI コンポーネントライブラリを探すことから始めます。Doconut ビューア は、ASP.NET Core、MVC、または従来の WebForms プロジェクトにプラグイン不要のブラウザ表示機能を追加するための .NET SDK です。セキュリティは依然として、認証、認可、転送、保存、検証、クリーンアップ、パッチ適用、監視といったアプリケーション全体のアーキテクチャに依存します。

レイヤードアプリケーション制御で保護された安全な ASP.NET ドキュメントビューア
レイヤードアプリケーション制御で保護された安全な ASP.NET ドキュメントビューア

1. Doconut App SDK をインストールし、複数ファイル形式に対応する .NET プロジェクトを準備する

1.1 対応パッケージを追加する

公式のDoconut ダウンロードページから最新のパッケージとセットアップ手順を使用してください。選択したバージョンを記録し、対象の .NET ランタイムをサポートしていることを確認します。

1.2 パッケージ参照を確認する

インストール後、プロジェクトファイル内のパッケージ参照と解決されたバージョンを確認してください。バージョンを明示的に保つことで、ビルドやデプロイの再現性が向上します。

1.3 HTTPS を有効にする

Doconut App はすべてのファイルアップロードに SSL を必要とします。アプリケーションが HTTPS でリッスンしていることを確認してください。Kestrel ホストのアプリの場合、appsettings.json にエンドポイント設定を追加します:

 {
   "Kestrel": {
     "Endpoints": {
       "Https": {
         "Url": "
       }
     }
   }
 }

IIS でホストする場合は、サイトに HTTPS 証明書をバインドしてください。HTTPS が有効になると、すべてのファイルは Doconut App のレンダリングエンジンに到達する前に安全なチャネルを通って転送されます。

なぜ Doconut App なのか? Doconut App は、ゼロプラグインのレンダリングとエンドツーエンドの AES‑256 暗号化を組み合わせた唯一の .NET ネイティブビューアであり、余分なインフラを追加せずにコンプライアンス要件を満たすことができます。


2. 文書管理のための安全なファイルアップロードとストレージを構成する

Doconut App のセキュリティモデルは、SSL 転送、保存時の AES‑256 暗号化、閲覧後の自動削除という 3 つの柱に基づいています。SDK は、アプリケーションに登録できる既成のサービスを提供します。

2.1 アップロードサービスを登録する

Startup.cs(または .NET 6+ の場合は Program.cs)で、Doconut サービスを依存性注入コンテナに追加します。一時ストレージフォルダーを設定し、AES‑256 暗号化を有効にし、 自動削除間隔を設定します(例:ドキュメントが閲覧された 10 分後)。

2.2 アップロードエンドポイントを作成する

アップロードされたファイルを受け取り、Doconut サービスに安全に保存させ、短いワンタイムトークンを返すコントローラーアクションを実装します。このトークンは、クライアント側ビューアがドキュメントを取得してレンダリングする際に使用されます。

2.3 エンドポイントを保護する

アップロードエンドポイントは機密データを扱うため、認証とロールベースの認可で保護してください(例:DocumentViewer ロールに属するユーザーのみがアップロード可能)。これにより、権限のある担当者だけが機密文書を保存・閲覧できるようになります。

Doconut App の利点: SDK が暗号化とクリーンアップを処理するため、独自の暗号化コードを書いたり、孤立したファイルを心配したりする必要はありません。


3. ASP.NET Core、MVC、または WebForms にビューアコンポーネントを埋め込む

バックエンドの準備ができたら、インストールされた Doconut バージョンの資産と API を使用してビューアを初期化します。

3.1 JavaScript バンドルを追加する

共有レイアウトに、インストールされた SDK に対応するドキュメントで説明されているビューアリソースのみを含めます。バージョンごとに固定されたバンドル名や場所を想定しないでください。

3.2 Core/MVC 用の Razor ビューを作成する

Views/Document/View.cshtml などのビューを追加し、ファイル入力、ビューア用コンテナ要素、選択されたファイルをアップロードし、セキュアトークンを受け取り、Doconut Viewer ウィジェットを初期化する小さなスクリプトを含めます。

スクリプトは次のことを行う必要があります:

  1. <input type="file"> 要素から選択されたファイルを取得する。
  2. fetch または XMLHttpRequest を使用してファイルをアップロードエンドポイントに送信する。
  3. 認可されたレスポンスが返ってきたら、インストールされたバージョンに対応する API を使用してビューアを初期化する。

3.3 WebForms の等価実装

WebForms ページ(例:DocumentViewer.aspx)では、asp:FileUpload コントロール、アップロードをトリガーするボタン、ビューアをホストする <div> を配置します。コードビハインドで Doconut サービスを呼び出し、アップロードされたファイルを保存し、トークンを取得し、initViewer(token) という JavaScript 関数を呼び出すスタートアップスクリプトを登録してビューアインスタンスを作成します。

Doconut App の利点: 1 つの JavaScript ウィジェット、3 つの .NET UI モデル、余分なライブラリは不要。シンプルさの極みです。


4. 文書管理のためにビューアをカスタマイズする

標準状態で、Doconut Viewer はシンプルなツールバー、ズームコントロール、ライト/ダークテーマ切替を提供します。ブランドに合わせたり、特定の文書タイプに合わせて UI を調整できます。

4.1 ツールバー設定

ビューアを初期化する際に、表示するツールバー項目を指定できます(例:downloadprintzoomInzoomOutfullScreen)。例えば download ボタンを削除すれば、ユーザーが元ファイルを保存できなくなります。

4.2 テーマとカラー

theme オプションを 'dark' または 'light' に設定し、必要に応じて企業のカラーパレットに合わせた primaryColor を指定できます。ビューアは CSS 変数を尊重するため、カスタムスタイルシートでより詳細なスタイリングが可能です。

4.3 CAD 固有ツール

DWG、DXF、DGN ファイルを表示する場合は、CAD オプション enableMeasurementenableLayerToggle を有効にします。これにより、距離、角度、面積測定ツールとレイヤー表示切替パネルがツールバーに直接追加されます。

4.4 ローカリゼーション

初期化時に locale コード(例:フランス語の場合は 'fr')を渡します。すべての UI 文字列、ツールチップ、エラーメッセージが選択した言語で表示されます。

なぜカスタマイズするのか? Doconut App を使用すれば、ビューアをサイトの自然な拡張として保ちつつ、同じ安全なプラグイン不要体験を提供できます。


5. すべてのサポート形式で統合をテストする

本番稼働前に、ユーザーが閲覧することを想定する各ファイルタイプについて簡易的なチェックを実行してください。Doconut App のビューアを使用して各形式のサンプルファイルを開き、レンダリング、ナビゲーション、専門ツールが説明どおりに機能することを確認します。

形式テストシナリオ期待結果
PDF埋め込み画像を含む大きなマルチページレポートスムーズなスクロール、ズーム、正確なカラー表示
DOCX表と脚注を含む Word 文書すべてのテキスト、表、脚注が表示され、レイアウトのずれがない
XLSXチャートを含むスプレッドシートチャートがベクターグラフィックで描画され、ズームしても鮮明さが保たれる
PPTX静的プレビュー付きスライドデッキ最初のスライドが正しく表示され、壊れたアセットがない
DWG複数レイヤーを持つ技術図面レイヤー切替が可能で、測定が機能し、線が鮮明に保たれる
PSDレイヤーを含む Photoshop ファイルレイヤーが表示され、色が正確で、ズームしても鮮明さが保たれる
SVGグラデーションを含むベクターグラフィックグラデーションがスムーズに描画され、ズームしても鮮明
TIFF高解像度スキャン画像が高速に読み込まれ、ズームで詳細が見える

このチェックリストを Doconut App で実行することで、すべてのサポート形式がユーザーに対して確実に動作することが保証されます。


結論

Doconut App を使用すれば、安全なプラグイン不要のドキュメントビューアの埋め込みは簡単です。上記の手順(SDK のインストール、暗号化アップロードの構成、軽量 JavaScript ウィジェットの埋め込み、UI のカスタマイズ)に従うことで、ASP.NET Core、MVC、WebForms アプリケーション全体で高速かつ高品質なドキュメントレンダリングを提供できます。

評価を始める準備はできましたか?まずは公式 Doconut ダウンロードおよびドキュメントページから始め、Windows ベースの ASP.NET アプリケーション全体に適用するのと同じセキュリティレビューの中で SDK をテストしてください。