TSV ツール 操作手順書
第 1.7 版

ネットワーク応用通信研究所
2022 年 2 月 11 日

改定履歴
版数

改定内容

改訂日

1.0

初版

2016/02/09

1.1

3.1.1 想定するセットアップ環境: sudoers の設定について追記

3.1.1.4 Ruby のインストール: Ruby のインストール先を指定する手順に変更

2016/03/10

3.1.1.6 Phusion Passenger のインストール:

パッケージのインストール手順を追記、Ruby のパスの変更に伴う差分を反映

1.2

1.3

3.1.1.7 Apache の設定ファイルの追加: Ruby のパスの変更に伴う差分を反映

3.1.1.4 Ruby のインストール: 再ログインが必要な旨について追記
3.1.1.7 Apache の設定ファイルの追加:

ドキュメントルート以外で TSV ツールを動作させる例を追記「2.2.4 利用管理者情報更新申請」を追加「2.3 作成済み TSV 編集」を追加

2016/03/30

2017/01/30

その他機能改修に伴う文言の修正、およびスクリーンショットの更新

1.4

レコード編集画面への作成済み TSV 読込機能実装に関する記述の追加

レコード編集画面で「発行方法」を変更可能にしたことに関連する記述の追加

2018/03/20

利用管理者情報一括更新機能に関する記述の追加「ダウンロード」ボタンの表示位置を変更したためスクリーンショットを更新
1.5
1.6
1.7

P12 一括生成画面に「都道府県名(英語)」と「市町村名(英語)」の入力欄を追加「TSV 作成ツール」から「TSV ツール」に文言を変更。

2018/07/11

2019/12/11

2022/03/01

コード署名用証明書に関する記述を削除。
ruby3.0.3 に情報を更新。

2

内容
1. 本資料の概要 ................................................................................................................................... 4
2. 利用者向け情報 .............................................................................................................................. 4
2.1. TSV ビューア機能................................................................................................................. 4
2.1.1. TSV ファイル読込 ........................................................................................................ 4
2.1.2. キーワード検索 ............................................................................................................. 6
2.1.3. 詳細表示 ............................................................................................................................ 6
2.2. TSV 新規作成機能................................................................................................................. 8
2.2.1. サーバ証明書 .................................................................................................................. 9
2.2.2. クライアント証明書 ................................................................................................ 22
2.2.3. 利用管理者情報更新申請用 TSV........................................................................ 34
2.3. 作成済み TSV 編集 ............................................................................................................ 37
2.3.1. TSV ファイル読込 ..................................................................................................... 38
2.4. エラーが発生した場合には .......................................................................................... 39
3. 管理者向け情報 ........................................................................................................................... 41
3.1. セットアップ手順 .............................................................................................................. 41
3.1.1. 想定するセットアップ環境.................................................................................. 41
3.2. ディレクトリ構成 .............................................................................................................. 47
3.3. カスタマイズ CSS の配置............................................................................................... 49

3

1. 本資料の概要
本資料は国立情報学研究所の運営する電子証明書発行支援システムにて利用す
る TSV ファイルの作成を支援する Web アプリケーション（以下、TSV ツール）の操作・利用手順を記載したものである。

2. 利用者向け情報
本章では TSV ツールの利用者向けの手順や説明を記載する。TSV ビューア機能、TSV 作成機能について説明を行う。

2.1. TSV ビューア機能

TSV ビューア機能では、UPKI 電子証明書自動発行支援システムからダウンロー
ドした以下のファイルを閲覧することができる。
 全証明書ダウンロードファイル
 サーバ証明書ダウンロードファイル
 クライアント証明書ダウンロードファイル

2.1.1. TSV ファイル読込
トップメニュー画面の「TSV ビューア」をクリックする。

4

図1

トップメニュー - TSV ビューア選択「ファイル選択」をクリックし、読み込む TSV ファイルを選択する。

図2

TSV ビューア - ファイル選択

ファイルを選択後、「読込」をクリックすることで選択した TSV ファイルの情報が表示される。

5

図3

TSV ビューア - ファイル読込

2.1.2. キーワード検索
キーワード検索入力欄にキーワードを入力後、「絞り込む」をクリックすることでレコードの絞り込みを行うことが出来る。 この時、検索キーワードにマッ
チした文字列がハイライト表示される。

図4

TSV ビューア - キーワード検索

2.1.3. 詳細表示
レコード行をクリックすることで、当該レコードの詳細な情報を見ることが出
来る。

6

図5

TSV ビューア - レコード選択

図6

TSV ビューア - レコード詳細

2.1.3.1. 終了「ビューア終了」をクリックすることで TSV ビューアを終了する。

7

図7

TSV ビューア - 終了

2.2. TSV 新規作成機能
トップメニュー画面の「作成開始」をクリックする。

図8

トップメニュー - TSV 作成開始

種別選択画面に遷移後、新規作成タブが選択状態であることを確認する。

8

図 9

種別選択 – 新規作成タブ

2.2.1. サーバ証明書「証明書種別」のセレクトボックスが「サーバ証明書」を選択していることを確認する（図 10 番号 1）。 その後、「証明書プロファイル」を選択する（図10 番号 2）。

図 10

サーバ証明書9

2.2.1.1. 新規発行申請用 TSV ファイルの作成「TSV ファイル種別」のセレクトボックスが「新規発行申請用 TSV」を選択していることを確認する（図 11 番号 1）。 「この内容で作成を開始」をクリックすることで TSV の作成を開始する（図 11 番号 2）。

図 11

サーバ証明書 - 新規発行申請書用 TSV

2.2.1.1.1. 作成済み TSV ファイル読込「作成済み TSV ファイル」の「ファイル選択」をクリックし、読み込む TSV フ
ァイルを選択する。

図 12

サーバ証明書 - 新規発行申請用 TSV – 作成済み TSV 選択

ファイルを選択後、「読込」をクリックすることで、選択した TSV ファイルの全レコードが、作成中の TSV の末尾に連結される。また同一画面で複数の TSV
ファイルを読み込んだ場合、後から読み込んだ TSV ファイルのレコードが末尾になるように順次連結される。

10

2.2.1.1.2. CSR ファイル読込「CSR ファイル読込」の「ファイル選択」をクリックし、読み込む CSR ファイ
ルを選択する。

図 13

サーバ証明書 - 新規発行申請用 TSV - CSR ファイル選択

ファイルを選択後、「読込」をクリックすることで、選択した CSR ファイルの情報から「CSR」、「主体者 DN」、「サーバ FQDN」を自動判別し、CSR 入力
欄、主体者 DN 入力欄、サーバ FQDN 入力欄にそれぞれ設定される。

図 14

サーバ証明書 - 新規発行申請用 TSV - CSR ファイル読込完了
11

2.2.1.1.3. データ入力「CSR」、「主体者 DN」、「サーバ FQDN」、「利用管理者 E-mail」、「利用管理者所属」、「Web サーバソフトウェア名等」をそれぞれ入力する。 「利用管理者氏名」、「dNSName」は必須入力ではないので必要があれば入力する（図15 番号 1）。データ入力後、「完了」をクリックすることで TSV が作成される（図 15 番号 2）。

図 15

サーバ証明書 - 新規発行申請用 TSV - データ入力

2.2.1.1.4. TSV ファイル出力
TSV 作成後、「ダウンロード」をクリックすることで、TSV ファイルがダウンロードされる。

12

図 16

サーバ証明書 - 新規発行申請用 TSV - TSV ファイル出力

2.2.1.1.5. 終了「終了」をクリックすることで TSV の作成を終了する。

図 17

サーバ証明書 - 新規発行申請用 TSV - 終了

2.2.1.2. 更新申請用 TSV ファイルの作成「TSV ファイル種別」のセレクトボックスが「更新申請用 TSV」を選択していることを確認する（図 18 番号 1）。 「この内容で作成を開始」をクリックすることで TSV の作成を開始する（図 18 番号 2）。

13

図 18

サーバ証明書 - 更新申請用 TSV

2.2.1.2.1. 作成済み TSV ファイル読込「作成済み TSV ファイル」の「ファイル選択」をクリックし、読み込む TSV フ
ァイルを選択する。

図 19

サーバ証明書 – 更新申請用 TSV – 作成済み TSV 読込

ファイルを選択後、「読込」をクリックすることで、選択した TSV ファイルの全レコードが、作成中の TSV の末尾に連結される。また同一画面で複数の TSV
ファイルを読み込んだ場合、後から読み込んだ TSV ファイルのレコードが末尾になるように順次連結される。
2.2.1.2.2. CSR ファイル読込「CSR ファイル読込」の「ファイル選択」をクリックし、読み込む CSR ファイ
ルを選択する。

14

図 20

サーバ証明書 - 更新申請用 TSV - CSR ファイル選択

ファイルを選択後、「読込」をクリックすることで、選択した CSR ファイルの情報から「CSR」、「主体者 DN」、「サーバ FQDN」を自動判別し、CSR 入力
欄、主体者 DN 入力欄、サーバ FQDN 入力欄にそれぞれ設定される。

図 21

サーバ証明書 - 更新申請用 TSV - CSR ファイル読込完了

2.2.1.2.3. 証明書ファイル読込「証明書ファイル読込」の「ファイル選択」をクリックし、読み込む証明書フ
ァイルを選択する。

15

図 22

サーバ証明書 - 更新申請用 TSV - 証明書ファイル選択

ファイルを選択後、「読込」をクリックすることで、選択した証明書ファイルの情報から「主体者 DN」、「失効対象証明書シリアル番号」、「サーバ FQDN」
を自動判別し、主体者 DN 入力欄、失効対象証明書シリアル番号入力欄、サーバ
FQDN 入力欄にそれぞれ設定される。

図 23

サーバ証明書 - 更新申請用 TSV - 証明書ファイル読込完了

2.2.1.2.4. データ入力「CSR」、「主体者 DN」、「失効対象証明書シリアル番号」、「サーバ FQDN」、「利用管理者 E-mail」、「利用管理者所属」、「Web サーバソフトウェア名等」
をそれぞれ入力する。 「利用管理者氏名」、「dNSName」は必須入力ではない
16ので必要があれば入力する（図 24 番号 1）。 データ入力後、「完了」をクリックすることで TSV が作成される（図 24 番号 2）。

図 24

サーバ証明書 - 更新申請用 TSV - データ入力

2.2.1.2.5. TSV ファイル出力
TSV 作成後、「ダウンロード」をクリックすることで、TSV ファイルがダウンロードされる。

図 25

サーバ証明書 - 更新申請用 TSV - TSV ファイル出力

2.2.1.2.6. 終了「終了」をクリックすることで TSV の作成を終了する。

17

図 26

サーバ証明書 - 更新申請用 TSV - 終了

2.2.1.3. 失効申請用 TSV ファイルの作成「TSV ファイル種別」のセレクトボックスが「失効申請用 TSV」を選択していることを確認する（図 27 番号 1）。 「この内容で作成を開始」をクリックすることで TSV の作成を開始する（図 27 番号 2）。

図 27

サーバ証明書 - 失効申請用 TSVTSV を作成するための情報を CSV ファイルからインポートすることで、複数レ
コードの一括作成が出来る。 オプションエリア「CSV ファイル」の「ファイル選択」をクリックし、読み込む CSV ファイルを選択する。CSV に記述した内容
がレコードの「主体者 DN」、「失効対象証明書シリアル番号」、「利用管理者
E-mail」にそれぞれ設定される。 上記に加えてオプション欄の「失効理由」を選択、「失効理由コメント」を入力後、「CSV から作成を開始」をクリックする
ことで、TSV の作成を開始する。
18

図 28

サーバ証明書 - 失効申請用 TSV - CSV 取込

2.2.1.3.1. 作成済み TSV ファイル読込「作成済み TSV ファイル」の「ファイル選択」をクリックし、読み込む TSV フ
ァイルを選択する。

図 29

サーバ証明書 – 失効申請用 TSV – 作成済み TSV 読込

ファイルを選択後、「読込」をクリックすることで、選択した TSV ファイルの全レコードが、作成中の TSV の末尾に連結される。また同一画面で複数の TSV
ファイルを読み込んだ場合、後から読み込んだ TSV ファイルのレコードが末尾になるように順次連結される。
2.2.1.3.2. 証明書ファイル読込「証明書ファイル読込」の「ファイル選択」をクリックし、読み込む証明書フ
ァイルを選択する。

19

図 30

サーバ証明書 - 失効申請用 TSV - 証明書ファイル選択

ファイルを選択後、「読込」をクリックすることで、選択した証明書ファイルの情報から「主体者 DN」、「失効対象証明書シリアル番号」を自動判別し、主体者 DN 入力欄、失効対象証明書シリアル番号入力欄にそれぞれ設定される。

図 31

サーバ証明書 - 失効申請用 TSV - 証明書ファイル読込完了

2.2.1.3.3. データ入力「主体者 DN」、「失効対象証明書シリアル番号」、「利用管理者 E-mail」をそれぞれ入力、「失効理由」の選択を行う。「失効理由コメント」は必須入力ではないので必要があれば入力する（図 32 番号 1）。 データ入力後、「完了」をクリックすることで TSV が作成される（図 32 番号 2）。

20

図 32

サーバ証明書 - 失効申請用 TSV - データ入力

2.2.1.3.4. TSV ファイル出力
TSV 作成後、「ダウンロード」をクリックすることで、TSV ファイルがダウンロードされる。

図 33

サーバ証明書 - 失効申請用 TSV - TSV ファイル出力

2.2.1.3.5. 終了「終了」をクリックすることで TSV の作成を終了する。

図 34

サーバ証明書 - 失効申請用 TSV - 終了

21

2.2.2. クライアント証明書「証明書種別」のセレクトボックスが「クライアント証明書」を選択していることを確認する（図 35 番号 1）。 その後、「証明書プロファイル」と「発行方法」をそれぞれ選択する（図 35 番号 2、番号 3）。

図 35

クライアント証明書

2.2.2.1. 新規発行申請用 TSV ファイルの作成「TSV ファイル種別」のセレクトボックスが「新規発行申請用 TSV」を選択していることを確認する。 「この内容で作成を開始」をクリックすることで TSV の作成を開始する。

22

図 36

クライアント証明書 - 新規発行申請用 TSV「発行方法」に「2:P12 一括」を選択した場合（図 37 番号 1）、TSV を作成するための情報を CSV ファイルからインポートすることで、複数レコードの一括作成が出来る。
オプションエリア「CSV ファイル」の「ファイル選択」をクリックし、読み込む
CSV ファイルを選択する。CSV に記述した内容がレコードの「主体者 DN」、「利用管理者 E-mail」、「利用管理者氏名」、「利用管理者所属」、「利用者氏名」、「利用者所属」、「利用者 E-mail」、「P12 ダウンロードファイル名」にそれぞれ設定される。 上記に加えてオプション欄の「登録機関名(英語)」、「都道府県名(英語)」、「市町村名(英語)」を入力後、「CSV から作成を開始」をクリックすることで、TSV の作成を開始する（図 37 番号 2）。

23

図 37

クライアント証明書 - 新規発行申請用 TSV - CSV 取込

2.2.2.1.1. 作成済み TSV 読込「作成済み TSV ファイル」の「ファイル選択」をクリックし、読み込む TSV フ
ァイルを選択する。

図 38

クライアント証明書 – 新規発行申請用 TSV – 作成済み TSV 読込

ファイルを選択後、「読込」をクリックすることで、選択した TSV ファイルの全レコードが、作成中の TSV の末尾に連結される。また同一画面で複数の TSV
ファイルを読み込んだ場合、後から読み込んだ TSV ファイルのレコードが末尾になるように順次連結される。
2.2.2.1.2. データ入力「発行方法」を選択、「主体者 DN」、「利用管理者 E-mail」、「利用者 E-mail」、「利用管理者所属」、「P12 ダウンロードファイル名」をそれぞれ入力する。「利用管理者氏名」、「利用者氏名」、「利用者所属」、「アクセス PIN」は必須入力ではないので必要があれば入力する。 また「発行方法」に「2:P12 一括」を選択した場合は、「利用者 E-mail」の入力は任意となる（図 39 番号 1）。 データ入力後、「完了」をクリックすることで TSV が作成される。（図 39 番号 2）
24

図 39

クライアント証明書 - 新規発行申請用 TSV - データ入力

2.2.2.1.3. TSV ファイル出力
TSV 作成後、「ダウンロード」をクリックすることで、TSV ファイルがダウンロードされる。

図 40

クライアント証明書 - 新規発行申請用 TSV - TSV ファイル出力

2.2.2.1.4. 終了「終了」をクリックすることで TSV の作成を終了する。

図 41

クライアント証明書 - 新規発行申請用 TSV - 終了

25

2.2.2.2. 更新申請用 TSV ファイルの作成「TSV ファイル種別」のセレクトボックスが「更新申請用 TSV」を選択していることを確認する。 「この内容で作成を開始」をクリックすることで TSV の作成を開始する。

図 42

クライアント証明書 - 更新申請用 TSV「発行方法」に「2:P12 一括」を選択した場合（図 43 番号 1）、TSV を作成するための情報を CSV ファイルからインポートすることで、複数レコードの一括作成が出来る。 オプションエリア「CSV ファイル」の「ファイル選択」をクリックし、読み込む CSV ファイルを選択する。CSV に記述した内容がレコードの「主体者 DN」、「失効対象証明書シリアル番号」、「利用管理者 E-mail」、「利用管理者氏名」、「利用管理者所属」、「利用者氏名」、「利用者所属」、「利用者 E-mail」、「P12 ダウンロードファイル名」にそれぞれ設定される。
上記に加えてオプション欄の「登録機関名(英語)」、「都道府県名(英語)」、「市
町村名(英語)」を入力後、「CSV から作成を開始」をクリックすることで、TSVの作成を開始する（図 43 番号 2）。

26

図 43

クライアント証明書 - 更新申請用 TSV - CSV 取込

2.2.2.2.1. 作成済み TSV ファイル読込
作成済み TSV ファイル」の「ファイル選択」をクリックし、読み込む TSV ファ
イルを選択する。

図 44 クライアント証明書 - 更新申請用 TSV - 作成済み TSV 読込
ファイルを選択後、「読込」をクリックすることで、選択した TSV ファイルの全レコードが、作成中の TSV の末尾に連結される。また同一画面で複数の TSV
ファイルを読み込んだ場合、後から読み込んだ TSV ファイルのレコードが末尾になるように順次連結される。
2.2.2.2.2. 証明書ファイル読込「証明書ファイル読込」の「ファイル選択」をクリックし、読み込む証明書フ
ァイルを選択する。

27

図 45

クライアント証明書 - 更新申請用 TSV - 証明書ファイル選択

ファイルを選択後、「読込」をクリックすることで、選択した証明書ファイルの情報から「主体者 DN」、「失効対象証明書シリアル番号」を自動判別し、主体者 DN 入力欄、失効対象証明書シリアル番号入力欄にそれぞれ設定される。

図 46

クライアント証明書 - 更新申請用 TSV - 証明書ファイル読込完了

2.2.2.2.3. データ入力「発行方法」を選択（図 47 番号 1）、「主体者 DN」、「失効対象証明書シリ
アル番号」、「利用管理者 E-mail」、「利用者 E-mail」、「利用管理者所属」、「P12 ダウンロードファイル名」をそれぞれ入力する。 「利用管理者氏名」、「利用者氏名」、「利用者所属」、「アクセス PIN」は必須入力ではないので必要があれば入力する。 「発行方法」に「2:P12 一括」を選択した場合は、「利用者 E-mail」の入力は任意となる（図 47 番号 2）。
データ入力後、「完了」をクリックすることで TSV が作成される（図 47 番号 3）。
28

図 47

クライアント証明書 - 更新申請用 TSV - データ入力

2.2.2.2.4. TSV ファイル出力
TSV 作成後、「ダウンロード」をクリックすることで、TSV ファイルがダウンロードされる。

図 48

クライアント証明書 - 更新申請用 TSV - TSV ファイル出力

2.2.2.2.5. 終了「終了」をクリックすることで TSV の作成を終了する。

図 49

クライアント証明書 - 更新申請用 TSV - 終了

29

2.2.2.3. 失効申請用 TSV ファイルの作成「TSV ファイル種別」のセレクトボックスが「失効申請用 TSV」を選択していることを確認する。 「この内容で作成を開始」をクリックすることで TSV の作成を開始する。

図 50

クライアント証明書 - 失効申請用 TSVTSV を作成するための情報を CSV ファイルからインポートすることで、複数レ
コードの一括作成が出来る。 オプションエリア「CSV ファイル」の「ファイル選択」をクリックし、読み込む CSV ファイルを選択する。CSV に記述した内容
がレコードの「主体者 DN」、「失効対象証明書シリアル番号」、「利用管理者
E-mail」にそれぞれ設定される。 上記に加えてオプション欄の「失効理由」を選択、「失効理由コメント」を入力後、「CSV から作成を開始」をクリックする
ことで、TSV の作成を開始する。

30

図 51

クライアント証明書 - 失効申請用 TSV - CSV 取込

2.2.2.3.1. 作成済み TSV ファイル読込
作成済み TSV ファイル」の「ファイル選択」をクリックし、読み込む TSV ファ
イルを選択する。

図 52

クライアント証明書 - 失効申請用 TSV – 作成済み TSV 読込

ファイルを選択後、「読込」をクリックすることで、選択した TSV ファイルの全レコードが、作成中の TSV の末尾に連結される。また同一画面で複数の TSV
ファイルを読み込んだ場合、後から読み込んだ TSV ファイルのレコードが末尾になるように順次連結される。
2.2.2.3.2. 証明書ファイル読込「証明書ファイル読込」の「ファイル選択」をクリックし、読み込む証明書フ
ァイルを選択する。

31

図 53

クライアント証明書 - 失効申請用 TSV - 証明書ファイル選択

ファイルを選択後、「読込」をクリックすることで、選択した証明書ファイルの情報から「主体者 DN」、「失効対象証明書シリアル番号」を自動判別し、主体者 DN 入力欄、失効対象証明書シリアル番号入力欄にそれぞれ設定される。

図 54

クライアント証明書 - 失効申請用 TSV - 証明書ファイル読込完了

2.2.2.3.3. データ入力「主体者 DN」、「失効対象証明書シリアル番号」、「利用管理者 E-mail」をそれぞれ入力、「失効理由」の選択を行う。
「失効理由コメント」、「利用者 E-mail」
は必須入力ではないので必要があれば入力する（図 55 番号 1）。 データ入力
後、「完了」をクリックすることで TSV が作成される（図 55 番号 2）。

32

図 55

クライアント証明書 - 失効申請用 TSV - データ入力

2.2.2.3.4. TSV ファイル出力
TSV 作成後、「ダウンロード」をクリックすることで、TSV ファイルがダウンロードされる。

図 56

クライアント証明書 - 失効申請用 TSV - TSV ファイル出力

2.2.2.3.5. 終了「終了」をクリックすることで TSV の作成を終了する。

33

図 57

クライアント証明書 - 失効申請用 TSV - 終了

2.2.3. 利用管理者情報更新申請用 TSV「TSV ファイル種別」のセレクトボックスが「利用管理者情報更新申請用 TSV」
を選択していることを確認する。「この内容で作成を開始」をクリックすることで TSV の作成を開始する。

図 58

利用管理者情報更新申請用 TSV

発行済み証明書一覧の TSV を読込、現在有効な全ての証明書について利用管理者情報更新申請を行う TSV ファイルの作成が出来る。オプションエリア「発行済み証明書一覧 TSV ファイル」の「ファイル選択」をクリックし、読み込む
TSV ファイルを選択する。TSV に記述した内容がレコードの「申請 ID」、「サーバ FQDN」、「利用管理者 E-mail」、「利用管理者氏名」、「利用管理者所属」にそれぞれ設定される。
また「利用管理者氏名」、「利用管理者 E-mail」に入力した内容と、「有効34期限切れ」、「失効済み」ラジオボタン選択状態により、利用管理者情報更新
申請対象の証明書の絞り込みが出来る。
上記内容をそれぞれ入力後、「発行済み証明書一覧 TSV から作成を開始」をクリックすることで、TSV の作成を開始する。

図 59

利用管理者情報更新申請用 TSV – TSV 取込

2.2.3.1. 作成済み TSV ファイル読込
作成済み TSV ファイル」の「ファイル選択」をクリックし、読み込む TSV ファ
イルを選択する。

図 60

利用管理者情報更新申請用 TSV – 作成済み TSV 読込

ファイルを選択後、「読込」をクリックすることで、選択した TSV ファイルの全レコードが、作成中の TSV の末尾に連結される。また同一画面で複数の TSV
ファイルを読み込んだ場合、後から読み込んだ TSV ファイルのレコードが末尾になるように順次連結される。
2.2.3.2. データ入力「申請 ID」の入力を行う。「サーバ FQDN」、「利用管理者 E-mail」、「利用管理者氏名」、「利用管理者所属」は必須入力ではないので必要があれば入力する（図 61 番号 1）。データ入力後、「完了」をクリックすることで TSV が作成される（図 61 番号 2）。
35

図 61

利用管理者情報更新申請用 TSV – データ入力

2.2.3.3. 利用管理者情報一括更新
利用管理者情報一括更新を行う場合、図 59 で示した TSV 取込の際に検索条件を指定し、更新対象の利用管理者を抽出する必要がある。
上記を行いレコード編集画面に遷移した場合、「抽出したレコードを一括編集」が表示される。

図 62

利用管理者情報更新申請用 TSV - 抽出したレコードを一括編集「抽出したレコードを一括編集」をクリックすると、レコード一括編集画面に遷移する。
上記画面で更新後の利用管理者情報を入力（図 63 番号 1）し、完了をクリックすると（図 63 番号 2）、抽出した利用管理者情報を入力内容で更新した TSV が作成される。

36

図 63

利用管理者情報更新申請用 TSV – レコード一括編集

2.2.3.4. TSV ファイル出力
TSV 作成後、「ダウンロード」をクリックすることで、TSV ファイルがダウンロードされる。

図 64

利用管理者情報更新申請用 TSV – TSV ファイル出力

2.2.3.5. 終了「終了」をクリックすることで TSV の作成を終了する。

図 65

利用管理者情報更新申請用 TSV – 終了

2.3. 作成済み TSV 編集
トップメニュー画面の「作成開始」をクリックする（図 8 参照）。
種別選択画面に遷移後、「作成済み TSV の編集」タブリンクをクリックし、種別選択画面作成済み TSV 編集画面に遷移することを確認する。

37

図 66

種別選択 – 作成済み TSV 編集

2.3.1. TSV ファイル読込「ファイル選択」（図 67 番号 1）をクリックし、読み込む TSV ファイル選択後、「作成済み TSV の編集を開始」（図 67 番号 2）をクリックすることで、選択した TSV のレコード編集画面に遷移する。

図 67

作成済み TSV 編集 – TSV ファイル読込38

作成済み TSV 編集画面で読込可能な TSV ファイル種別と読込後に遷移する編
集画面の対応を表 1 に示す。
表 1

作成済み TSV 編集 – 読込可能 TSV 種別

TSV ファイル種別

該当する TSV 編集画面（当マニュアルの項目番）

サーバ証明書発行申請ファイル

2.2.1.1

サーバ証明書更新申請ファイル

2.2.1.2

サーバ証明書失効申請ファイル

2.2.1.3

クライアント証明書発行申請ファイル

2.2.2.1

クライアント証明書更新申請ファイル

2.2.2.2

クライアント証明書失効申請ファイル

2.2.2.3

利用管理者情報更新申請ファイル

2.2.4

レコード編集画面の操作については TSV 新規作成機能で説明した内容と同様であるため割愛する。

2.4. エラーが発生した場合にはTSV ツールを利用中にエラーが発生した場合、図 68 のようにエラーメッセージが赤色で表示される。

図 68

エラーメッセージ

TSV ツール利用時によく目にすると思われるエラーメッセージ、またその原因・解決方法をまとめた表を以下に示す。
表 2

主なエラーメッセージ39

エラーメッセージ

原因・解決方法...は必須項目です。入力してくだ入力が必要な項目が空の場合に表示される。当該項目の入力を行う。

...は不要な情報です。

入力が不要な項目に入力がある場合に表示される。当該項目の内容を削除する。

さい。

...のフォーマットが不正です。

使用不可な文字が使用されている場合などに表示される。当該項目のフォーマットを「主体者 DN」の属性 O が空で主体者 DN の必須属性が空の場合に表示される。特に属性 O は、クライアント証明書

す。

確認し、入力内容を修正する。

の P12 一括発行の際に「登録機関名(英語)」の入力がされていない場合に空になり得るため注意が必要。

...のドメイン...の有効性が確認で入力されたメールアドレスが無効だった場合に表示される。アドレスが正しいか確認

きませんでした。

し修正する。

選択されたファイルにはデータ

アップロードされた CSV/TSV ファイルが空の場合に表示される。

が存在しません。
選択されたファイルは...ファイ
ルではありません。
選択された...ファイルのフォー

アップロードされたファイルが CSV/TSV ファイルでない場合に表示される。
アップロードされた CSV/TSV ファイルのフィールド数が適当でない場合などに表示

マットが正しくありません。

される。

選択されたファイルにはサポー

アップロードされた CSV/TSV ファイルの文字コードが適切でない場合に表示されト外の文字コードが使われています。
選択されたファイルの行数が多る。文字コードが Shift-JIS であることを確認する。

アップロードされた CSV/TSV ファイルが設定された行数制限を越える場合に表示さすぎます。

れる。ファイルを分割する必要がある。

セッションタイムアウト等によ

無操作の状態で一定時間経過した場合に表示される。

り一時データが消失しました。

40

3. 管理者向け情報
本章では TSV ツールの管理者向けの手順や説明を記載する。

3.1. セットアップ手順

ここでは TSV ツールを特定のサーバにセットアップする手順を記載する。最低限の手順のみを記述するため、必要に応じて追加手順を実施されたい。

3.1.1. 想定するセットアップ環境
本手順では CentOS 6 系 OS 環境下に TSV ツールをセットアップする前提とする。
また、OS は既にインストール済み、sudo が利用可能なユーザ（operator とする）
が登録済みであるものとする。
また、予め以下のように sudo 実行時に環境変数 PATH が引き継がれるよう設定
しておくこと。
$ {echo ‘Defaults !secure_path’echo ‘Defaults env_keep += “PATH”’
echo ‘operator ALL=(ALL) ALL’} | sudo tee -a /etc/sudoers.d/operator

3.1.1.1. SELinux の無効化、iptables の設定
SELinux の無効化を行う。

$ sudo cp /etc/sysconfig/selinux{,.orig}$ sudo vim /etc/sysconfig/selinux$ sudo diff -u /etc/sysconfig/selinux{.orig,}--- /etc/sysconfig/selinux.orig

2016-01-18 18:19:31.057356294 +0900+++ /etc/sysconfig/selinux

2016-01-18 18:19:44.116354782 +0900@@ -4,7 +4,7 @@#enforcing - SELinux security policy is enforced.

#

permissive - SELinux prints warnings instead of enforcing.

#disabled - No SELinux policy is loaded.

-SELINUX=enforcing

41

+SELINUX=disabled# SELINUXTYPE= can take one of these two values:#

targeted - Targeted processes are protected,#

mls - Multi Level Security protection.

iptables の設定を行う。 以下では TSV ツールを 80 番ポートで実行するものとして記述する。
$ sudo cp /etc/sysconfig/iptables{,.orig}$ sudo vim /etc/sysconfig/iptables$ sudo diff -u /etc/sysconfig/iptables{.orig,}--- /etc/sysconfig/iptables.orig 2016-01-18 18:20:37.038356384 +0900+++ /etc/sysconfig/iptables

2016-01-18 18:20:48.782353332 +0900@@ -8,6 +8,7 @@-A INPUT -p icmp -j ACCEPT-A INPUT -i lo -j ACCEPT-A INPUT -m state --state NEW -m tcp -p tcp --dport 22 -j ACCEPT+-A INPUT -m state --state NEW -m tcp -p tcp --dport 80 -j ACCEPT-A INPUT -j REJECT --reject-with icmp-host-prohibited-A FORWARD -j REJECT --reject-with icmp-host-prohibited
COMMIT

3.1.1.2. パッケージのインストール
3.1.1.2.1. EPEL リポジトリの追加
外部リポジトリで提供されるパッケージを利用可能にする。 環境によって利用する rpm ファイルが変わるため、以下のコマンドのうち "http://..." 以降は適宜読み替えること。
$ sudo rpm -ivh http://dl.fedoraproject.org/pub/epel/6/x86_64/epel-release-6-8.noarch.rpm

3.1.1.2.2. 開発ツールのインストール
コンパイラや Ruby や Passenger のビルドに必要なライブラリ等をインストールする。
$ sudo yum -y groupinstall "Development Tools"$ sudo yum -y install openssl-devel readline-devel zlib-devel curl-devel libcurl-devel libyaml-devel423.1.1.3. SQLite のインストール
一時データの保存に利用する SQLite をインストールする。
$ sudo yum -y install sqlite sqlite-devel

3.1.1.4. Ruby のインストール
Ruby をインストールする場合、rpm を取得してインストールする、rvm や rbenv
といったバージョン管理システムを使ってインストールする、ソースコードからコンパイルしてインストールする、などの方法があり、どれを選択しても構わない。 本資料ではソースコードからコンパイルする方法を記述する。
$ sudo mkdir /opt/src$ sudo chown operator:operator /opt/src$ cd /opt/src$ curl -O https://cache.ruby-lang.org/pub/ruby/3.0/ruby-3.0.3.tar.gz$ tar zxvf ruby-3.0.3.tar.gz$ cd /opt/src/ruby-3.0.3$ ./configure --prefix=/opt/ruby-3.0.3$ make$ sudo make install$ sudo ln –s /opt/ruby-3.0.3 /opt/ruby$ echo ‘export PATH=/opt/ruby/bin:$PATH’ >> /home/operator/.bash_profile$ echo ‘export PATH=/opt/ruby/bin:$PATH’ | sudo tee –a /etc/profile.d/ruby.sh

一度ログアウトし再ログインする。sudo で ruby コマンドと gem コマンドが利用可能であることを確認する。
$ sudo ruby -v

ruby 3.0.3p157 (2021-11-24 revision 3fb7d2cadc) [x86_64-linux]$ sudo gem -v

3.0.3.1

43

3.1.1.4.1. Bundler のインストール
gem と呼ばれる Ruby のライブラリ群を管理するためのツールである Bundler を
インストールする。
$ sudo gem install bundler -v ‘2.3.6’ --no-doc

3.1.1.5. Apache のインストール
Web サーバである Apache をインストールする。
$ sudo yum install httpd3.1.1.6. Phusion Passenger のインストール
アプリケーションサーバである Passenger をインストールする。
$ sudo gem install passenger --no-doc$ sudo yum –y install httpd-devel apr-devel apr-util-devel$ sudo passenger-install-apache2-module

インストールの途中で次のような Apache の設定ファイル用のメッセージが表示されるため、記録しておくこと。
Please edit your Apache configuration file, and add these lines:
LoadModule passenger_module /opt/ruby-3.0.3/lib/ruby/gems/3.0.0/gems/passenger-6.0.12/buildout/
apache2/mod_passenger.so<IfModule mod_passenger.c>
PassengerRoot /opt/ruby-3.0.3/lib/ruby/gems/3.0.0/gems/passenger-6.0.12
PassengerDefaultRuby /opt/ruby-3.0.3/bin/ruby</IfModule>
After you restart Apache, you are ready to deploy any number of web
applications on Apache, with a minimum amount of configuration!

3.1.1.7. Apache の設定ファイルの追加
TSV ツールを動かすための Apache 用設定ファイルを作成する。 ここでは/etc/httpd/conf.d/以下の*.conf ファイルが自動で読み込まれるものとして記述する。 また、TSV ツールのソースコードの配置場所を/var/lib 以下とするものとして記述する。
44

/etc/httpd/conf.d/passenger.conf に、Passenger のインストール時に表示された
設定内容を記述する。以下に例を示す。(環境によって異なるため、これをそのまま利用しないこと。)

LoadModule passenger_module /opt/ruby-3.0.3/lib/ruby/gems/3.0.0/gems/passenger-6.0.12/buildout/ap
ache2/mod_passenger.so<IfModule mod_passenger.c>
PassengerRoot /opt/ruby-3.0.3/lib/ruby/gems/3.0.0/gems/passenger-6.0.12
PassengerDefaultRuby /opt/ruby-3.0.3/bin/ruby</IfModule>

ここではバーチャルホストで TSV ツールを実行する例を示す。
/etc/httpd/conf.d/passenger.conf に以下を記述する。 ポート番号やログファイ
ルのパスなどは適宜変更すること。
Apache のバージョンが 2.2 系の場合の例を以下に示す。
Listen 80

NameVirtualHost *:80

<VirtualHost *:80>
ServerName localhost
DocumentRoot /var/lib/tsv-tool/public<Directory /var/lib/tsv-tool/public>
Options FollowSymLinks
AllowOverride None</Directory>

LogLevel info
ErrorLog /var/log/httpd/tsvtool-error.log
CustomLog /var/log/httpd/tsvtool-access.log combined</VirtualHost>

Apache のバージョンが 2.4 系の場合の例を以下に示す。
45

Listen 80<VirtualHost *:80>
ServerName localhost
DocumentRoot /var/lib/tsv-tool/public<Directory /var/lib/tsv-tool/public>
Options FollowSymLinks
AllowOverride None
Require all granted</Directory>

LogLevel info
ErrorLog /var/log/httpd/tsvtool-error.log
CustomLog /var/log/httpd/tsvtool-access.log combined</VirtualHost>

また、以下にドキュメントルート以外で TSV ツールを動作させるための設定例
を Apache のバージョンが 2.2 系の場合を例にして以下に示す。
Listen 80

NameVirtualHost *:80

<VirtualHost *:80>
ServerName localhost
DocumentRoot /var/lib/my_php_app/# 既存のアプリケーション

PassengerEnabled off# サブディレクトリでのみ Passenger を有効にするため off

PassengerAppRoot /var/lib/tsv-tool# TSV ツールのルートディレクトリを設定

Alias /tsv-tool/ /var/lib/tsv-tool/public/# http://.../tsv-tool/ 上で TSV ツールを動作させる

RackBaseURI /tsv-tool# TSV ツールのベース URI を設定<Directory /var/lib/my_php_app/>
DirectoryIndex index.html index.php
Options FollowSymLinks
AllowOverride None</Directory>46

<Directory /var/lib/tsv-tool/ >PassengerEnabled on# TSV ツールのディレクトリに限り Passenger を有効にする

Options FollowSymLinks
AllowOverride None</Directory></VirtualHost>

以下のコマンドで設定内容に問題がないかを確認する。
$ sudo /etc/init.d/httpd configtest

3.1.1.8. ソースコードの配置、ライブラリのインストール、設定ファイルの作成
Apache に設定した通り、/var/lib 配下にソースコードを配置し、TSV ツール用のライブラリをインストールする。
$ cd /var/lib/tsv-tool$ bundle install

TSV ツール用の設定ファイルを作成する。
$ cp config/config.yml{.example,}

必要があれば設定を変更する。
$ vi config/config.yml

Apache を実行するユーザグループで読み書きできるようオーナーを変更する。
$ sudo chown -R apache:apache /var/lib/tsv-tool

ソースコード配置後、Apache を再起動する。
$ sudo systemctl reload httpd3.2. ディレクトリ構成
以下に TSV ツールのソースコード中、主要なディレクトリやファイルについて記載する。
ディレクトリ名/ファイル

説明

名

47

ディレクトリ名/ファイル

説明名
Gemfileアプリケーションに必要な gem ファイルを定義。

app.rbアプリケーションのメインファイル。これをロードすることで実行に必要なすべてのフ

config/アプリケーションの設定ファイルを格納。

config/config.yml.example

アプリケーションの設定ファイルの基となるファイル。

Rakefilerake コマンドで実行可能なタスクを定義。

ァイルをロードする。

config/config.yml

アプリケーションの設定ファイル。

config.ru

アプリケーションのエントリポイント。

controllers/

ユーザからの入力を受け取り models や views 配下への命令へ変換する処理を担うクラス

controllers/create.rb

TSV 作成機能に関する controller。

controllers/viewer.rb

TSV ビューア機能に関する controller。

controllers/root.rbを格納。

メインメニューやキャンセル機能に関する controller。

lib/

ライブラリファイルを格納。

lib/helpers/db_helper.rb

DB(一時データ用)操作に関するヘルパーを定義。

lib/helpers/

ヘルパー関連のファイルを格納。

lib/helpers/view_helper.rb

画面やメッセージなど見た目に関するヘルパーを定義。

log/

アプリケーションログの書き込み先。

models/record.rb

TSV ファイルのレコードに関する処理を定義。

public/

公開フォルダ。

lib/helpers.rb

上記に該当しない全体的なヘルパーなどを定義。

models/アプリケーションデータやロジックに関する処理を担うクラスを格納。

models/tsv_file.rb

TSV ファイルに関する処理を定義。

public/css/

スタイルシートを格納。

spec/

テストコードを格納。

public/js/

javascript ファイルを格納。

tmp/

一時データを格納。

48

ディレクトリ名/ファイル

説明名views/

画面表示に利用される HTML のテンプレートを格納。

views/viewer/

TSV ビューア機能関連の HTML テンプレートを格納。

views/create/

TSV 作成機能関連の HTML テンプレートを格納。

表3

TSV ツールディレクトリ構成

3.3. カスタマイズ CSS の配置
TSV ツールではユーザによるインターフェースデザインを可能とする機能を提供している。 以下のパスにカスタマイズ CSS ファイルを配置することで、スタイルシートの機能の範囲内で任意のデザイン変更が可能である。 (以下は TSV
ツールのソースコードを/var/lib 以下に配置したという前提のパスである。)/var/lib/tsv-tool/public/css/customize.css

49