1. IronSecureDoc
  2. チュートリアル
  3. Azureホストとセットアップ

Linuxでのホスティング

This article was translated from English: Does it need improvement?
Translated
View the article in English

Docker上のIronSecureDoc IronSecureDocはDockerコンテナで、オンラインSaaSサービスのような手間やオーバーヘッドなしに、シンプルなREST APIを使った強力なPDF操作を提供するように設計されています。 このガイドでは、あなたのマシンでIronSecureDocをホストする手順について、環境変数の設定やREST APIの基本的な使用例を含めて説明します。 完全なAPIについては REST APIリファレンス

docker pull ironsoftwareofficial/ironsecuredoc:latest

前提条件

[{私はあなたが提供するテキスト内容を日本語に翻訳いたします。よろしければ、翻訳したい内容をこちらに入力してください。(

Linux上のDocker Desktopが仮想マシンを動かす (VM) これは起動時にカスタム docker コンテキスト desktop-linux を作成して使用する。

これは、Linux Docker Engine上にデプロイされたイメージとコンテナを意味する。 (設置前) はDocker Desktop for Linuxでは利用できない。)}]

**プラットフォーム

ステップ・バイ・ステップ・ガイド

1.Dockerデスクトップをインストールする

まだDocker Desktopをインストールしていない場合は、以下の手順に従ってください：

  1. に移動します Docker Desktopダウンロードページ.

  2. Linux用のDocker Desktopインストーラをダウンロードする。

  3. インストーラーを実行し、画面の指示に従ってください。

  4. インストール後、Docker Desktopを起動し、起動していることを確認する。

2.IronSecureDoc "Dockerイメージをプルする

コマンドプロンプトを開き、Docker Hubから最新のIronSecureDocイメージを取り出します：

docker pull ironsoftwareofficial/ironsecuredoc:latest

3.証明書なしでコンテナを実行する

必要な環境変数を指定してDockerコンテナを実行する： ブラウザでのSwagger UI

docker container run --rm -p 8080:8080 -e IronSecureDoc_LicenseKey=<IRONSECUREDOC_LICENSE_KEY> -e ENVIRONMENT=Development -e HTTP_PORTS=8080 ironsoftwareofficial/ironsecuredoc:latest

試用版またはライセンスキーを適用して透かしを消す

ヒント
`を実際のIronSecureDocライセンスキーに置き換えてください。 そうでない場合は、Enterprise Featuresにウォーターマークが適用されます。 ブラウザでのSwagger UI

4.コンテナへのアクセス

コンテナが起動したら、ウェブブラウザを開いてIronSecureDocにアクセスする： もちろんです！翻訳したいコンテンツを提供してください。それに従って正確な日本語訳を提供いたします。

http://localhost:8080/swagger/index.html もちろんです！翻訳したいコンテンツを提供してください。それに従って正確な日本語訳を提供いたします。 ブラウザでのSwagger UI IronSecureDocインターフェイスが表示され、コンテナが正常に実行されていることがわかるはずだ。

5.証明書付きIronSecureDocコンテナの実行

証明書を使用してコンテナを実行する必要がある場合は、以下の手順に従って証明書を生成し、ローカル・マシンを構成する：

  1. 証明書の生成：
   dotnet dev-certs https -ep %USERPROFILE%\.aspnet\https\ironsecuredoc.pfx -p <CREDENTIAL_PLACEHOLDER>
   dotnet dev-certs https --trust
`をパスワードに置き換える。 2. **Dockerコンテナを実行します： ```sh docker container run -d -p 8081:8081 -p 8080:8080 -e HTTP_PORTS=8080 -e HTTPS_PORTS=8081 -e IronSecureDoc_LicenseKey= -e ENVIRONMENT=Production -v %USERPROFILE%\.aspnet\https:/https:ro -e CERTIFICATE_PATH=%USERPROFILE%\.aspnet\https\ironsecuredoc.pfx -e CERTIFICATE_PASSWORD= ironsoftwareofficial/ironsecuredoc:latest ``` `と``をそれぞれ実際のIronSecureDocライセンスキーと証明書パスワードに置き換えてください。 ### 6.コンテナの管理 実行中のコンテナは、Dockerコマンドを使って管理できる。 便利なコマンドをいくつか紹介しよう： - **コンテナを止めてください： ```sh docker stop ironsecuredoc ``` - **コンテナをスタートさせる： ```sh docker start ironsecuredoc ``` - **コンテナを取り外してください： ```sh docker rm -f ironsecuredoc ``` ## 環境変数 コンテナは、以下の環境変数を使って設定できる： - pdf_max_size_mb`。 (デフォルト：30):PDFアップロードの最大許容ファイルサイズをメガバイト単位で設定します。 - request_timeout_seconds`。 (デフォルト：5):APIリクエストのタイムアウト時間を秒単位で設定します。 値を-1にすると、リクエストは無期限に実行される。 - `allowed_origins`：クロスオリジンリソース共有を設定する (CORS) 許可されたオリジンURLを指定する。 複数のURLはカンマで区切ってください。 またはallを使用して、どのオリジンからのリクエストでも許可します。 - HTTP_PORTS`：コンテナが公開する HTTP ポートを定義する。 これは、-pフラグを使用したポートマッピングと一致するはずです。 (例：8080). 複数のポートをセミコロンで区切る (;). - HTTPS_PORTS`：コンテナが公開する HTTPS ポートを定義する。 これは、-pフラグを使用したポートマッピングと一致するはずです。 (例：8081). 複数のポートをセミコロンで区切る (;). - IronSecureDoc_LicenseKey`。 (必須):IronSecureDocのライセンスキーを設定します。 重要：この値を公開しないでください。 ## 基本的な例文書内のテキストを再編集する APIエンドポイントの完全なリストについては、完全な [**REST APIリファレンス**](/enterprise/securedoc/tutorials/use-rest-api/). ### テキストの再編集 ```sh curl -X POST 'http://localhost:8080/v1/document-services/pdfs/redact-text' -H 'accept: */*' -H 'Content-Type: multipart/form-data' -F 'pdf_file=@/path/to/your/document.pdf;type=application/pdf' -F 'words_to_redact="sensitiveWord"' -F 'draw_black_box=true' -F 'match_whole_word=true' -F 'match_case=true' ``` path/to/your/document.pdf`を朱書きにしたい文書の実際のパスに、`sensitiveWord`を朱書きにしたい単語に置き換えてください。 ### 正規表現の再編集 ```sh curl -X POST 'http://localhost:8080/v1/document-services/pdfs/redact-regular-expression' -H 'accept: */*' -H 'Content-Type: multipart/form-data' -F 'pdf_file=@/path/to/your/document.pdf;type=application/pdf' -F 'regular_expression="[0-9]"' -F 'draw_black_box=true' ``` /path/to/your/document.pdf`を朱書きにしたい文書の実際のパスに、`/path/to/your/document.pdf`を朱書きにしたい文書の実際のパスに置き換えてください。[0-9]マッチさせたい正規表現を入力し、再編集する。 ### 結論 IronSecureDocのホスティングが完了し、必要な環境変数が設定されました。 また、基本的な操作と高度な操作の両方でcURLを使用してIronSecureDoc REST APIと対話する方法を学びました。 詳細な設定と使用方法については、以下のページを参照してください。 [**REST APIリファレンス**](/enterprise/securedoc/tutorials/use-rest-api/).