PDFファイルを暗号化/パスワードとアクセス許可を追加する方法
PDFファイルをパスワードと特定の権限で保護することは、機密文書を不正アクセスや不正操作から守るために不可欠です。 について[ポスト]IronSecure Doc の Encrypt/Add Password & Permissions API は、PDF ファイルをユーザーと所有者のパスワードで暗号化し、印刷、フォーム入力、注釈などの権限を設定する効率的な方法を提供します。 このAPIは、PDFが完全に保護され、アクセスが制御されることを保証するため、法律、金融、または個人的な文書に最適です。
PDFファイルを暗号化/パスワードとアクセス許可を追加する方法
- IronSecureDoc Docker Imageをプルして起動します。
- Swaggerを使用したAPIのテスト
- パスワードとパーミッションのパラメータの指定
- APIコールを実行して変更を適用する
- 暗号化されたPDF文書をエクスポート
IronSecureDocをプルして開始する
IronSecureDocをまだお使いでない場合は、以下のリンクからセットアップしてください:
地元での開催 | クラウドへのデプロイ |
---|---|
POST]暗号化/パスワードとアクセス許可の追加API
について[ポスト]Encrypt/Add Password & Permissions APIは、PDF文書をパスワードで暗号化したり、さまざまな操作に特定の権限を設定したりすることで、PDF文書にセキュリティ層を追加することを可能にします。 読み取りアクセスの許可、フォーム入力の許可、印刷の無効化など、このAPIはPDFファイルへのアクセスや変更方法を制御することができます。
スワッガー
Swaggerは、このAPIをインタラクティブにテストするためのユーザーフレンドリーなインターフェイスを提供します。 コードを書かずにテストリクエストを送信し、応答を受信するために使用することができ、開発者にとって最適なツールです。
Swaggerでテキストを再編集する手順
-
Swagger UIにアクセス:。
APIサーバーがローカルで実行されている場合、Webブラウザでhttp://localhost:8080/swagger/index.html にナビゲートすることでSwaggerにアクセスできます。
-
**APIを探す
翻訳者を探す[ポスト]/v1/document-services/pdfs/encryptのAPIは、Encrypt/Add Password & Permissionsに対応しています。
-
**入力パラメータ
APIに必要なパラメータを提供してください。 サンプルPDFファイルをアップロードし、必要なパーミッションを指定することができます。
-
**PDFファイルのアップロード
リクエスト本文では、PDFファイルをpdf_fileとしてアップロードし、印刷、フォーム入力、コンテンツ抽出の許可または制限など、必要なパーミッションを定義してください。
-
**リクエストの実行
すべてのパラメータを設定したら、"Execute "をクリックしてリクエストを送信します。応答は、指定されたセキュリティ設定で暗号化されたPDFを返します。
-
**出力された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.')
**説明するステップ
- PDFを読み込む:暗号化されるPDFファイルは、ローカルファイルシステムからロードされます。
- 暗号化パラメータの設定:印刷、フォーム入力、コンテンツ抽出の許可、新しいパスワードの設定などの権限を定義します。
- APIを呼び出す:その[ポスト]Encrypt/Add Password & Permissions APIを呼び出し、必要なパラメータを渡す。
-
結果を保存:暗号化されたPDFは、新しいファイルとして保存されます。
PDFファイルは以下のように暗号化されています。 PDFコンテンツを表示するには、「password」と入力してください。