C# API を使用して Mac で IronSecureDoc をホストする

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

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

1. Docker Desktop のダウンロード ページにアクセスします。
2. Mac用のDocker Desktopインストーラをダウンロードします。
3. インストーラーを実行し、画面の指示に従います。
4. インストール後、Docker Desktop を起動し、実行されていることを確認します。

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

コマンドライン インターフェイスを開き、Docker Hub から最新の IronSecureDoc イメージをプルします。

# Pull the latest IronSecureDoc image
docker pull ironsoftwareofficial/ironsecuredoc:latest

# Pull the latest IronSecureDoc image
docker pull ironsoftwareofficial/ironsecuredoc:latest

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

必要な環境変数を使用して Docker コンテナを実行します。

# Run the Docker container with environment variables
docker container run --rm -p 8080:8080 \
  -e IronSecureDoc_LicenseKey=<IRONSECUREDOC_LICENSE_KEY> \
  -e ENVIRONMENT=Development \
  -e HTTP_PORTS=8080 \
  ironsoftwareofficial/ironsecuredoc:latest

# Run the Docker container with environment variables
docker container run --rm -p 8080:8080 \
  -e IronSecureDoc_LicenseKey=<IRONSECUREDOC_LICENSE_KEY> \
  -e ENVIRONMENT=Development \
  -e HTTP_PORTS=8080 \
  ironsoftwareofficial/ironsecuredoc:latest

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

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

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

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

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

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

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

1.証明書を生成する:

  # Generate and trust HTTPS development certificate
  dotnet dev-certs https -ep $HOME/.aspnet/https/ironsecuredoc.pfx -p <CREDENTIAL_PLACEHOLDER>
  dotnet dev-certs https --trust

  # Generate and trust HTTPS development certificate
  dotnet dev-certs https -ep $HOME/.aspnet/https/ironsecuredoc.pfx -p <CREDENTIAL_PLACEHOLDER>
  dotnet dev-certs https --trust

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

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

   # Run the container with HTTPS support
   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 $HOME/.aspnet/https:/https:ro \
   -e CERTIFICATE_PATH=$HOME/.aspnet/https/ironsecuredoc.pfx \
   -e CERTIFICATE_PASSWORD=<CERTIFICATE_PASSWORD> \
   ironsoftwareofficial/ironsecuredoc:latest

   # Run the container with HTTPS support
   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 $HOME/.aspnet/https:/https:ro \
   -e CERTIFICATE_PATH=$HOME/.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_or_name>

  docker stop <container_id_or_name>

• コンテナを開始する:

  docker start <container_id_or_name>

  docker start <container_id_or_name>

  SHELL

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

  docker rm -f <container_id_or_name>

  docker rm -f <container_id_or_name>

テキストを編集

# Redact specific words in a PDF document
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'

# Redact specific words in a PDF document
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編集する単語に置き換えます。

正規表現を編集する

# Redact text based on a regular expression in a PDF document
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'

# Redact text based on a regular expression in a PDF document
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 リファレンスを参照してください。