-
IronSecureDoc
-
チュートリアル
-
Windowsホスト
Windowsでのホスティング
View the article in
English
IronSecureDocはDockerコンテナで、オンラインSaaSサービスのような手間やオーバーヘッドなしに、シンプルなREST APIを使った強力なPDF操作を提供するように設計されています。 このガイドでは、あなたのマシンでIronSecureDocをホストする手順について、環境変数の設定やREST APIの基本的な使用例を含めて説明します。 完全なAPIについてはREST APIリファレンス
docker pull ironsoftwareofficial/ironsecuredoc:latest
前提条件
-
**ウィンドウズ・オペレーティング・システム
- Windowsサーバー(2016, 2019, 2022) *注：余分なステップが必要な場合がある申し訳ありませんが、翻訳を行うための具体的なコンテンツが提供されていません。翻訳したい英語のテキストを入力してください。
-
**プログラム
ステップ・バイ・ステップ・ガイド
1.Dockerデスクトップをインストールする
まだDocker Desktopをインストールしていない場合は、以下の手順に従ってください：
-
に移動しますDocker Desktopダウンロードページ.
-
Windows用のDocker Desktopインストーラをダウンロードする。
-
インストーラーを実行し、画面の指示に従ってください。
- インストール後、Docker Desktopを起動し、起動していることを確認する。
2.IronSecureDoc "Dockerイメージをプルする
コマンドプロンプトを開き、Docker Hubから最新のIronSecureDocイメージを取り出します：
docker pull ironsoftwareofficial/ironsecuredoc:latest
3.証明書なしでコンテナを実行する
必要な環境変数を指定してDockerコンテナを実行する：
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にウォーターマークが適用されます。
4.コンテナへのアクセス
コンテナが起動したら、ウェブブラウザを開いてIronSecureDocにアクセスする：
もちろんです！翻訳したいコンテンツを提供してください。それに従って正確な日本語訳を提供いたします。
http://localhost:8080/swagger/index.html
もちろんです！翻訳したいコンテンツを提供してください。それに従って正確な日本語訳を提供いたします。
IronSecureDocインターフェイスが表示され、コンテナが正常に実行されていることがわかるはずだ。
5.証明書付きIronSecureDocコンテナの実行
証明書を使用してコンテナを実行する必要がある場合は、以下の手順に従って証明書を生成し、ローカル・マシンを構成する：
- 証明書の生成：
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/).
