Macでのホスティング

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

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

docker pull ironsoftwareofficial/ironsecuredoc:latest

前提条件

[{私はあなたが提供するテキスト内容を日本語に翻訳いたします。よろしければ、翻訳したい内容をこちらに入力してください。(DockerはmacOSの最新バージョンでDocker Desktopをサポートしています。 つまり、macOSの現行リリースと過去2つのリリースだ。 macOSの新しいメジャーバージョンが一般的に利用可能になると、Dockerは最も古いバージョンのサポートを停止し、macOSの最新バージョンをサポートします。(前2作に加え).)}]

**インテル・チップを搭載したマック

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

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

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

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

  2. Windows用の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/).