PDFファイルへの暗号化・パスワード設定および権限の付与方法 in C

IronSecureDoc をプルして起動する

IronSecureDocをまだ実行していない場合は、以下のリンクからセットアップを行ってください：

[POST] 暗号化/パスワードおよび権限の追加 API

[POST] 暗号化/パスワード設定および権限設定 API を使用すると、PDF 文書をパスワードで暗号化し、各種操作に対する具体的な権限を設定することで、セキュリティ層を追加することができます。 読み取りアクセス権の付与、フォームへの自動入力、印刷の無効化など、このAPIを使用すれば、PDFファイルへのアクセスや変更方法を細かく制御できます。

Swagger

Swaggerは、このAPIを対話形式でテストするための使いやすいインターフェースを提供しています。 これを使えば、コードを書かずにテストリクエストを送信し、レスポンスを受け取ることができるため、開発者にとって非常に便利なツールです。

入力パラメータの理解

このAPIでは、PDFの暗号化および権限の割り当てを行うために特定のパラメータが必要です。 以下に、必須パラメータとオプションパラメータの内訳を示します：

必須パラメータ

オプションのパラメータ

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.co/ntent)

print('PDF encrypted successfully.')

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.co/ntent)

print('PDF encrypted successfully.')

手順の説明：

• PDFの読み込み: 暗号化するPDFファイルをローカルファイルシステムから読み込みます。
• 暗号化パラメータの設定: PRINT、フォーム入力、コンテンツ抽出の許可といった権限の定義や、新しいパスワードの設定を行います。
• APIの呼び出し: [POST] 暗号化/パスワードおよび権限の追加 API を呼び出し、必要なパラメータを渡します。
• 結果の保存: 暗号化されたPDFは新しいファイルとして保存されます。

PDFファイルは、以下に示すように暗号化されています。 PDFの内容を表示するには、"password"と入力してください。