PDFファイルを暗号化/パスワードとアクセス許可を追加する方法

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

メヘル・ムハンマド・ハムザによって

PDFファイルをパスワードと特定の権限で保護することは、機密文書を不正アクセスや不正操作から守るために不可欠です。 について[ポスト]IronSecure Doc の Encrypt/Add Password & Permissions API は、PDF ファイルをユーザーと所有者のパスワードで暗号化し、印刷、フォーム入力、注釈などの権限を設定する効率的な方法を提供します。 このAPIは、PDFが完全に保護され、アクセスが制御されることを保証するため、法律、金融、または個人的な文書に最適です。

IronSecureDocをプルして開始する

IronSecureDocをまだお使いでない場合は、以下のリンクからセットアップしてください:

地元での開催 クラウドへのデプロイ

POST]暗号化/パスワードとアクセス許可の追加API

について[ポスト]Encrypt/Add Password & Permissions APIは、PDF文書をパスワードで暗号化したり、さまざまな操作に特定の権限を設定したりすることで、PDF文書にセキュリティ層を追加することを可能にします。 読み取りアクセスの許可、フォーム入力の許可、印刷の無効化など、このAPIはPDFファイルへのアクセスや変更方法を制御することができます。

スワッガー

Swaggerは、このAPIをインタラクティブにテストするためのユーザーフレンドリーなインターフェイスを提供します。 コードを書かずにテストリクエストを送信し、応答を受信するために使用することができ、開発者にとって最適なツールです。

Swaggerでテキストを再編集する手順

  1. Swagger UIにアクセス:

    APIサーバーがローカルで実行されている場合、Webブラウザでhttp://localhost:8080/swagger/index.html にナビゲートすることでSwaggerにアクセスできます。

    Swaggerドキュメント

  2. **APIを探す

    翻訳者を探す[ポスト]/v1/document-services/pdfs/encryptのAPIは、Encrypt/Add Password & Permissionsに対応しています。

    テキストの再編集

  3. **入力パラメータ

    APIに必要なパラメータを提供してください。 サンプルPDFファイルをアップロードし、必要なパーミッションを指定することができます。

  4. **PDFファイルのアップロード

    リクエスト本文では、PDFファイルをpdf_fileとしてアップロードし、印刷、フォーム入力、コンテンツ抽出の許可または制限など、必要なパーミッションを定義してください。

  5. **リクエストの実行

    すべてのパラメータを設定したら、"Execute "をクリックしてリクエストを送信します。応答は、指定されたセキュリティ設定で暗号化されたPDFを返します。

  6. **出力されたPDFを確認する

    PDFコンテンツを表示するには、「password」と入力してください。


入力パラメータの理解

APIは、PDFを暗号化し、権限を割り当てるために特定のパラメータを必要とします。 以下は、必須パラメータとオプションパラメータの内訳です:

**必須パラメータ

名前 データ型 説明
pdf_file アプリケーション/pdf 暗号化したいPDFファイル
コンテンツの抽出を許可 ブーリアン コンテンツの抽出が許可されているかどうかを示してください。
フォーム入力を許可 ブーリアン フォーム入力の可否を明記してください。
アノテーションを許可する ブーリアン 注釈の有無を明記してください。
印刷を許可 ブーリアン 印刷の可否を明記してください。
変更を許可する ブーリアン 修正の可否を明記してください。
new_owner_password 文字列 PDFの新しい所有者のパスワードは、フルアクセスと権限の変更能力を付与します。

**オプションのパラメータ

名前 データ型 説明
ユーザー_パスワード 文字列 PDF に読み取 り ア ク セ ス を許可す る ためのユーザーパス ワー ド があ る 場合に必要です。
オーナーパスワード 文字列 現在の所有者パスワー ド 。 PDF に完全ア ク セ ス を許可す る 所有者パ ス ワ ー ド があ る 場合に必要です。
new_user_password 読み取りアクセス用の新しいユーザーパスワード。
PDF/Aとして保存 ブーリアン PDFはPDF/A-3準拠で保存してください。
save_as_pdfua ブーリアン PDFはPDF/UA準拠で保存してください。
著者 文字列 PDFメタデータのAuthorプロパティを設定します。
タイトル 文字列 PDFメタデータのTitleプロパティを設定します。
件名 文字列 PDFメタデータのSubjectプロパティを設定します。

APIの統合:Pythonの例

入力パラメータに慣れれば、Pythonやその他の言語を使用してAPIを呼び出すことができます。 以下は、Pythonを使用してこのAPIを統合する方法の例です。

import requests

url = 'http://localhost:8080/v1/document-services/pdfs/encrypt'
headers = {
    'accept': '*/*',
    'author': 'IronSoftware',
    'title': 'ENCRYPTION DEMO 2024',
    'subject': 'DEMO EXAMPLE'
}

files = {
    'pdf_file': ('sample.pdf', open('sample.pdf', 'rb'), 'application/pdf')
}

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'
}

response = requests.post(url, headers=headers, files=files, data=data)

# Save the encrypted PDF
with open('sample.pdf', 'wb') as f:
    f.write(response.content)

print('PDF encrypted successfully.')
PYTHON

**説明するステップ

  • PDFを読み込む:暗号化されるPDFファイルは、ローカルファイルシステムからロードされます。
  • 暗号化パラメータの設定:印刷、フォーム入力、コンテンツ抽出の許可、新しいパスワードの設定などの権限を定義します。
  • APIを呼び出す:その[ポスト]Encrypt/Add Password & Permissions APIを呼び出し、必要なパラメータを渡す。
  • 結果を保存:暗号化されたPDFは、新しいファイルとして保存されます。

    PDFファイルは以下のように暗号化されています。 PDFコンテンツを表示するには、「password」と入力してください。