C#でPDFファイルを暗号化し、パスワードと権限を追加する方法
機密文書を不正アクセスや改ざんから保護するには、パスワードと特定の権限を使用して PDF ファイルを保護することが不可欠です。 IronSecure Doc の [POST] Encrypt/Add Password & Permissions API は、印刷、フォーム入力、注釈などの権限を構成しながら、ユーザーと所有者のパスワードを使用して PDF ファイルを暗号化する効率的な方法を提供します。 この API により、PDF が完全に保護され、アクセスが制御されるため、法律、財務、または個人の文書に最適です。
PDFファイルを暗号化/パスワードと権限を追加する方法
- IronSecureDoc Dockerイメージをプルして開始する
- Swaggerを使用してAPIをテスト
- パスワードと権限のパラメータを指定する
- 変更を適用するためにAPIコールを実行
- 暗号化されたPDFドキュメントをエクスポート
IronSecureDoc をプルして起動する
IronSecureDoc をまだ実行していない場合は、以下のリンクに従ってセットアップしてください。
| ローカルでホスト | クラウドへのデプロイ |
|---|---|
[POST] 暗号化/パスワードと権限の追加 API
[POST] 認証/パスワードと権限の追加APIは、パスワードで暗号化し、さまざまな操作の特定の権限を設定することによってPDFドキュメントにセキュリティ層を追加します。 読み取りアクセスの許可、フォームへの入力の許可、印刷の無効化など、この API を使用すると、PDF ファイルへのアクセス方法や変更方法を制御できます。
威勢のいい
Swagger は、この API をインタラクティブにテストするためのユーザーフレンドリーなインターフェースを提供します。 コードを書かずにテストリクエストを送信し、応答を受信できるため、開発者にとって優れたツールとなります。
Swaggerでテキストを編集する手順
- Swagger UI にアクセスします。
APIサーバーがローカルで実行されている場合、Swaggerにアクセスするにはウェブブラウザでhttp://localhost:8080/swagger/index.htmlに移動してください。

- APIを見つけます。
[POST] /v1/document-services/pdfs/encrypt APIを探し、暗号化/パスワードと権限の追加に対応しています。

- 入力パラメーター:
API に必要なパラメータを指定します。 サンプル PDF ファイルをアップロードし、必要な権限を指定できます。
- PDFファイルをアップロードします。
リクエストボディで、pdf_fileとしてPDFファイルをアップロードし、印刷、フォーム入力、コンテンツ抽出を許可または制限するなどの必要な権限を定義します。
- リクエストを実行:
すべてのパラメータを設定したら、「実行」をクリックしてリクエストを送信します。レスポンスとして、指定されたセキュリティ設定で暗号化されたPDFが返されます。
- 出力PDFの確認:
PDF コンテンツを表示するには、「パスワード」を入力してください。
入力パラメータの理解
API では、PDF を暗号化し、権限を割り当てるために特定のパラメータが必要です。 必須パラメータとオプションパラメータの内訳は次のとおりです。
必須パラメータ
| 名前 | データ型 | 翻訳内容 |
|---|---|---|
pdf_file | アプリケーション/pdf | 暗号化する PDF ファイル。 |
allow_extracting_content | ブール値 | コンテンツの抽出が許可されるかどうかを示します。 |
allow_form_filling | ブール値 | フォームへの入力が許可されているかどうかを示します。 |
allow_annotations | ブール値 | 注釈が許可されるかどうかを示します。 |
allow_printing | ブール値 | 印刷が許可されているかどうかを示します。 |
allow_modifications | ブール値 | 変更が許可されるかどうかを示します。 |
new_owner_password | 文字列 | PDF の新しい所有者パスワード。完全なアクセス権と権限の変更権限が付与されます。 |
オプションパラメータ
| 名前 | データ型 | 翻訳内容 |
|---|---|---|
user_password | 文字列 | 現在のユーザー パスワード。PDF に読み取りアクセスを許可するためのユーザー パスワードがある場合に必要です。 |
owner_password | 文字列 | 現在の所有者のパスワード。PDF にフルアクセスを許可するための所有者パスワードがある場合に必要です。 |
new_user_password | 文字列 | 読み取りアクセス用の新しいユーザー パスワード。 |
save_as_pdfa | ブール値 | PDF を PDF/A-3 準拠として保存します。 |
save_as_pdfua | ブール値 | PDF を PDF/UA 準拠として保存します。 |
author | 文字列 | PDF メタデータの作成者プロパティを設定します。 |
title | 文字列 | PDF メタデータのタイトル プロパティを設定します。 |
subject | 文字列 | PDF メタデータの Subject プロパティを設定します。 |
API統合: Pythonの例
入力パラメータに慣れたら、Python またはその他の好みの言語を使用して API を呼び出すことができます。 以下は、Python を使用してこの API を統合する方法の例です。
import requests
# Endpoint URL
url = 'http://localhost:8080/v1/document-services/pdfs/encrypt'
# Headers with metadata information
headers = {
'accept': '*/*',
'author': 'Iron Software',
'title': 'ENCRYPTION DEMO 2024',
'subject': 'DEMO EXAMPLE'
}
# Files to be sent in the request
files = {
'pdf_file': ('sample.pdf', open('sample.pdf', 'rb'), 'application/pdf')
}
# Parameters for encryption and permissions
data = {
'allow_extracting_content': 'true',
'allow_form_filling': 'true',
'allow_annotations': 'false',
'allow_printing': 'false',
'allow_modifications': 'true',
'new_owner_password': 'password',
'new_user_password': 'password',
'save_as_pdfa': 'false',
'save_as_pdfua': 'false'
}
# Send POST request with parameters
response = requests.post(url, headers=headers, files=files, data=data)
# Save the encrypted PDF to file system
with open('sample_encrypted.pdf', 'wb') as f:
f.write(response.content)
print('PDF encrypted successfully.')
手順の説明:
- PDFを読み込む: 暗号化するPDFファイルはローカルファイルシステムから読み込まれます。
- 暗号化パラメーターの設定: 印刷、フォーム入力、コンテンツ抽出を許可するなど、また新しいパスワードを設定する権限を定義します。
- APIを呼び出す: [POST] 暗号化/パスワードと権限の追加APIを呼び出し、必要なパラメータを渡します。
- 結果を保存する: 暗号化されたPDFを新しいファイルとして保存します。
PDF ファイルは以下のように暗号化されます。 PDF コンテンツを表示するには、「パスワード」を入力してください。
よくある質問
IronSecureDoc を使用して PDF ファイルを暗号化するにはどうすればよいですか?
IronSecureDoc を使用して PDF ファイルを暗号化するには、[POST] Encrypt/Add Password & Permissions API を利用します。これにより、ユーザーおよびオーナーのパスワードを設定し、PDF ドキュメントに対する特定の権限を構成することができます。
IronSecureDoc API ではどのような権限を構成できますか?
IronSecureDoc API を使用すると、印刷、フォーム入力、注釈、コンテンツ抽出、変更の権限を構成して、PDF ドキュメントの必要なアクセスとセキュリティのレベルを確保できます。
コードを書かずに IronSecureDoc API をテストすることは可能ですか?
はい、Swagger を使用して IronSecureDoc API をインタラクティブにテストすることができます。これにより、コードを書くことなくリクエストとレスポンスを送受信するためのユーザーフレンドリーなインターフェースが提供されます。
IronSecureDoc をクラウドプラットフォームにデプロイするにはどうすればいいですか?
IronSecureDoc は Azure や AWS などのクラウドプラットフォームにデプロイできます。これらの環境への IronSecureDoc のデプロイ方法については Iron Software のウェブサイトに記載されています。
IronSecureDoc の使用における Docker イメージの役割は何ですか?
IronSecureDoc Docker イメージは API サービスを実行するために必要です。Docker イメージをプルして起動し、IronSecureDoc をローカルまたはクラウド環境でホスティングできます。
IronSecureDoc を使用して PDF/A または PDF/UA 準拠のファイルを作成できますか?
はい、IronSecureDoc は PDF ファイルを PDF/A-3 や PDF/UA 準拠として保存するためのオプションパラメーターを提供し、特定の標準とアクセシビリティを守ることができます。
なぜ PDF 暗号化でオーナーおよびユーザーのパスワードを使用することが重要ですか?
PDF 暗号化におけるオーナーおよびユーザーのパスワードは、アクセスレベルを制御するために重要です。オーナーパスワードはドキュメントへの完全なアクセスを許可し、ユーザーパスワードはより制限されたアクセスを提供し、機密情報を保護します。
IronSecureDoc API と統合できるコーディング言語は何ですか?
IronSecureDoc API は、Python、C#、Java などの複数のプログラミング言語と統合可能です。これにより、さまざまな環境で働く開発者に柔軟性を提供します。
IronSecureDoc を使用して PDF を暗号化するために必要なパラメーターは何ですか?
必要なパラメーターには、PDF ファイル自体と、コンテンツ抽出、フォーム入力、注釈、印刷、変更を許可するような複数の権限設定、および新しいオーナーパスワードの設定が含まれます。
PDF セキュリティで IronSecureDoc を使用する利点は何ですか?
IronSecureDoc は包括的な暗号化および権限管理を可能にすることで、法的、財務的、個人的なドキュメントを不正アクセスから保護するための信頼できるソリューションを提供します。
Curtis Chauは、カールトン大学でコンピュータサイエンスの学士号を取得し、Node.js、TypeScript、JavaScript、およびReactに精通したフロントエンド開発を専門としています。直感的で美しいユーザーインターフェースを作成することに情熱を持ち、Curtisは現代のフレームワークを用いた開発や、構造の良い視覚的に魅力的なマニュアルの作成を楽しんでいます。