C# を使って Windows 上で IronSecureDoc をホストする方法

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

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

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

SHELL

透かしを削除するには試用版またはライセンスキーを適用します

ヒント置換<IRONSECUREDOC_LICENSE_KEY>実際の IronSecureDoc ライセンス キーを入力します。 それ以外の場合、エンタープライズ機能に透かしが適用されます。

4. コンテナにアクセスする

コンテナが実行されると、Web ブラウザを開いて次の場所に移動し、IronSecureDoc にアクセスできます。

http://localhost:8080/swagger/index.html

コンテナが正常に実行されていることを示す IronSecureDoc インターフェースが表示されます。

5. 証明書を使用してIronSecureDocコンテナを実行する

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

1.証明書を生成する:

   dotnet dev-certs https -ep %USERPROFILE%\.aspnet\https\ironsecuredoc.pfx -p <CREDENTIAL_PLACEHOLDER>
   dotnet dev-certs https --trust

   dotnet dev-certs https -ep %USERPROFILE%\.aspnet\https\ironsecuredoc.pfx -p <CREDENTIAL_PLACEHOLDER>
   dotnet dev-certs https --trust

<CREDENTIAL_PLACEHOLDER>をパスワードに置き換えます。

2. Dockerコンテナを実行します。

   docker container run -d -p 8081:8081 -p 8080:8080 -e HTTP_PORTS=8080 -e HTTPS_PORTS=8081 -e IronSecureDoc_LicenseKey=<IRONSECUREDOC_LICENSE_KEY> -e ENVIRONMENT=Production -v %USERPROFILE%\.aspnet\https:/https:ro -e CERTIFICATE_PATH=%USERPROFILE%\.aspnet\https\ironsecuredoc.pfx -e CERTIFICATE_PASSWORD=<CERTIFICATE_PASSWORD> ironsoftwareofficial/ironsecuredoc:latest

   docker container run -d -p 8081:8081 -p 8080:8080 -e HTTP_PORTS=8080 -e HTTPS_PORTS=8081 -e IronSecureDoc_LicenseKey=<IRONSECUREDOC_LICENSE_KEY> -e ENVIRONMENT=Production -v %USERPROFILE%\.aspnet\https:/https:ro -e CERTIFICATE_PATH=%USERPROFILE%\.aspnet\https\ironsecuredoc.pfx -e CERTIFICATE_PASSWORD=<CERTIFICATE_PASSWORD> ironsoftwareofficial/ironsecuredoc:latest

   SHELL

   交換する<IRONSECUREDOC_LICENSE_KEY>そして<CERTIFICATE_PASSWORD>実際の IronSecureDoc ライセンス キーと証明書パスワードをそれぞれ入力します。

6. コンテナの管理

Docker コマンドを使用して実行中のコンテナを管理できます。 以下に、役立つコマンドをいくつか示します。

-コンテナを停止します:

  docker stop <container-id>

  docker stop <container-id>

• コンテナを開始する:

  docker start <container-id>

  docker start <container-id>

  SHELL

-コンテナを削除します:

  docker rm -f <container-id>

  docker rm -f <container-id>

交換する<container-id>実際のコンテナ ID または名前を使用します。

テキストを編集

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'

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編集する単語に置き換えます。

正規表現を編集する

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'

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 、編集するドキュメントへの実際のパスに置き換え、 [0-9]を、一致させて編集する正規表現に置き換えます。

結論

マシン上で IronSecureDoc をホストし、必要な環境変数を設定しました。 また、基本操作と高度な操作の両方で cURL を使用して IronSecureDoc REST API と対話する方法も学習しました。 さらなる構成と使用方法の詳細については、完全なREST API リファレンスを参照してください。