1.2.5 アクセシビリティのための内容の抽出の制限
狙い・効果
オーナーパスワードによりPDF文書のアクセシビリティのための内容の抽出に関する制限を設定します。
処理の概要
オーナーパスワードで、アクセシビリティを目的としたPDF文書からテキストの抽出と画像の抽出の許可を設定します。これにより例えばコピーが禁止されている文書であっても、視覚障がい者向けのスクリーンリーダーから内容を読み取ることが可能になります。
権限設定にはタイプ1とタイプ2があります（表1･6 権限設定のタイプを参照）。ただし、『PDF Tool API V7.0』以降では40ビットRC4を用いた暗号化は禁止されているため、タイプ1の権限設定を指定することはできません。
- タイプ2の権限設定では、内容のコピーを許可した場合はこの項目は強制的に許可に設定されます。内容のコピーを制限した場合はこの項目を個別に設定できます（falseをセットした場合、権限フラグの10bit目がオフとなります）。
本プログラム例では指定されたPDF文書のアクセシビリティを目的としたテキストの抽出と画像の抽出の可否を設定します。
- PDF文書が既に暗号化されているかどうかを判定して、暗号化されていないPDF文書の場合はプログラム実行時に暗号化形式を選択します。
- タイプ2の権限設定で暗号化されたPDF文書の場合、アクセシビリティを目的とした読み取りを許可する場合はコピーの可否設定が保持されます。読み取りを制限する場合は内容のコピーについても制限するよう設定されます。
- タイプ1の権限設定で暗号化されていた場合は128bit RC4で新規に暗号化されます。テキスト抽出可否以外のセキュリティ情報は破棄されます。
『PDF Tool API』の主な機能
- PtlEncryptPermissionType2.APIsetAccesibility() :スクリーンリーダーデバイスのテキストアクセスを有効にするかどうかの設定
- PtlEncryptStandard.APIsetPermission() :ユーザアクセス許可フラグの設定
プログラム例
package cookbook;
import java.io.*;
import jp.co.antenna.ptl.*;
public class EncryptSetAccessibility {
public static void printUsage() {
System.out.print("usage: java EncryptSetAccessibility in-pdf-file out-pdf-file ");
System.out.println("アクセシビリティ有効の可否 out-pdf-ownerpass [in-pdf-password]");
System.out.print("アクセシビリティ（スクリーンリーダーデバイスのテキストアクセス）を");
System.out.println("有効にするか");
System.out.println("0 : 有効にしない 1 : 有効にする");
}
/**
* @param args the command line arguments
*/
public static void main(String[] args) {
if (args.length < 4) {
printUsage(); // usageメッセージの表示
return;
}
// コマンドライン引数の取得
boolean permAccessibility = false;
try {
switch (Integer.parseInt(args[2])) {
case 0:
permAccessibility = false;
System.out.println("この文書のアクセシビリティ（スクリーンリーダーデバイスのテキストアクセス）を有効にしません。");
break;
case 1:
permAccessibility = true;
System.out.println("この文書のアクセシビリティ（スクリーンリーダーデバイスのテキストアクセス）を有効にします。");
break;
default:
System.out.println("アクセシビリティ有効の可否は、0か1の数値で指定してください。");
printUsage(); // usageメッセージの表示
return;
}
}
catch(NumberFormatException numfe) {
System.out.println("アクセシビリティ有効の可否は、0か1の数値で指定してください。");
printUsage(); // usageメッセージの表示
return;
}
String outOwnerPass = args[3];
...【EncryptSetEncComponent.javaと同じ処理のため省略
・PtlParamInputを用いてPtlPDFDocument docに入力PDFをロード
・PtlParamOutputを用いて出力PDF名を指定
・BufferedReader brを設定してキー入力読み取りを準備する
・入力PDF用パスワードが指定されていればそれをセットした上でPDFをロードする】...
// 暗号化の有無判定
if (doc.isEncrypted()) {
// 暗号化情報の取得
setPermAccessibility(doc, outOwnerPass, permAccessibility);
}
else {
System.out.println("暗号化されていないファイルです。\n");
System.out.println("アクセシビリティ有効の可否を設定して暗号化します。");
System.out.println("暗号化種類の設定をします。0から3の数値を指定してください。");
System.out.println("それ以外の数値が設定された場合は 3 が選択されたものとして扱います。");
System.out.println("暗号化種類\n0 : 128 bit RC4 1 : 128 bit AES 2 : 256 bit AES");
int kind;
try {
kind = Integer.parseInt(br.readLine());
// セキュリティ設定
switch (kind) {
case 0:
// 128 bit RC4
encrypt128RC4setAccessibility(doc, outOwnerPass, permAccessibility);
break;
case 1:
// 128 bit AES
encrypt128AESsetAccessibility(doc, outOwnerPass, permAccessibility);
break;
case 2:
default:
// 256 bit AES
encrypt256AESsetAccessibility(doc, outOwnerPass, permAccessibility);
break;
}
}
catch (NumberFormatException numfe) {
System.out.println("暗号化の種類指定は整数を用いてください。");
numfe.printStackTrace();
}
}
...【EncryptWithUserPass.javaと同じ処理のため省略
・PtlParamOutputを用いてPtlPDFDocument docの内容を出力
・PtlException, Exception, Error を catchするエラー処理
・finally文で"--完了--"と表示する処理】...
}
public static void encrypt128RC4setAccessibility(PtlPDFDocument doc, String outOwnerPass,
boolean permAccessibility)
throws PtlException, IOException, Exception, Error {
// 128 bit RC4
System.out.println("128 bit RC4暗号化が選択されました。");
try (PtlEncryptStandard128RC4 enc128r = new PtlEncryptStandard128RC4()) {
setAccessibilityWithDefaultPermission(doc, outOwnerPass, permAccessibility, enc128r);
}
}
public static void encrypt128AESsetAccessibility(PtlPDFDocument doc, String outOwnerPass,
boolean permAccessibility)
throws PtlException, IOException, Exception, Error {
// 128 bit AES
System.out.println("128 bit AES暗号化が選択されました。");
try (PtlEncryptStandard128AES enc128a = new PtlEncryptStandard128AES()) {
setAccessibilityWithDefaultPermission(doc, outOwnerPass, permAccessibility, enc128a);
}
}
public static void encrypt256AESsetAccessibility(PtlPDFDocument doc, String outOwnerPass,
boolean permAccessibility)
throws PtlException, IOException, Exception, Error {
// 256 bit AES
System.out.println("256 bit AES暗号化が選択されました。");
try (PtlEncryptStandard256AES enc256 = new PtlEncryptStandard256AES()) {
setAccessibilityWithDefaultPermission(doc, outOwnerPass, permAccessibility, enc256);
}
}
public static void setPermAccessibility(PtlPDFDocument doc, String outOwnerPass,
boolean permAccessibility)
throws PtlException, IOException, Exception, Error {
...【EncryptSetPrint.javaのsetPrintWithDefaultPermission()と同じ処理のため省略。
・暗号化の範囲を全てのコンテンツに設定。
・オーナーパスワードを設定。】...
// PtlEncryptPermissionType2で権限設定を行う
try (PtlEncryptPermissionType2 perms2 = new PtlEncryptPermissionType2()) {
// 印刷権限の設定
// PERM_PRINT_HIGH : 高解像度での印刷を許可
perms2.setPrint(PtlEncryptPermissionType2.PERMISSION_PRINT.PERM_PRINT_HIGH);
// 変更権限の設定
// ページ抽出を除く全ての動作を許可
perms2.setModify(PtlEncryptPermissionType2.PERMISSION_MODIFY.PERM_MODIFY_MODYFYDOC);
// 内容のコピーを有効にするかどうかの設定
perms2.setCopy(false);
// スクリーンリーダーデバイスのテキストアクセスを有効にするかどうかの設定
// true: 有効にする
perms2.setAccessibility(permAccessibility);
// ユーザアクセス許可フラグの設定
enc.setPermission(perms2);
}
// 暗号化情報の設定
doc.setEncrypt(enc);
}
public static void setPermAccessibility(PtlPDFDocument doc, String outOwnerPass,
boolean permAccessibility)
throws PtlException, IOException, Exception, Error {
...【EncryptSetPrint.javaと同じ処理のため省略。
・PtlPDFDocument docが保持している暗号化情報PtlEncrypt encryptの取得。
・標準セキュリティハンドラであることを確認し、encryptをPtlEncryptStandardにダウンキャスト。
・出力用オーナーパスワードの設定。
・ユーザーアクセス許可フラグPtlEncryptPermission permsの取得】...
// タイプ取得
switch (perms.getType()) {
case PERM_TYPE1:
// Type 1は40bit RC4なので、128bit RC4で新規に権限を設定する。
System.out.println("入力ファイルは40 bit RC4暗号で暗号化されています。");
System.out.println("新規に暗号化します。");
encrypt128RC4setAccessibility(doc, outOwnerPass, permAccessibility);
break;
case PERM_TYPE2:
// getType()で判定されたのでpermsをダウンキャストできる。
try(PtlEncryptPermissionType2 perms2 = (PtlEncryptPermissionType2)perms) {
// スクリーンリーダーデバイスのテキストアクセスを有効にするかどうかの設定
if(permAccessibility){
//有効にする場合：コピー禁止設定の有無はそのまま引き継ぐ
perms2.setAccessibility(permAccessibility);
encryptStandard.setPermission(perms2);
break;
}else {
//無効にする場合：コピー禁止の設定を行う
perms2.setCopy(false);
perms2.setAccessibility(permAccessibility);
encryptStandard.setPermission(perms2);
}
}
encryptStandard.setOwnerPassword(outOwnerPass);
doc.setEncrypt(encryptStandard);
break;
}
...【EncryptSetPrint.javaと同じ処理のため省略。
・PtlPDFDocument docに変更したセキュリティ情報を設定。
・標準セキュリティハンドラ以外が与えられた際の例外処理。】...
}
}
}
プログラムファイル名
EncryptSetAccessibility.java
入出力操作の例
