公的個人認証サービス

利用者クライアントソフト API 仕様書【個人認証サービス AP C 言語インターフェース編】

第 4.6 版

地方公共団体情報システム機構

変更履歴
版数
1.0 版
1.1 版

2.0 版

2.1 版
2.2 版

2.3 版

2.4 版

変更日付
平成 16 年 1 月 16 日

変更内容

新規作成
Windows XP SP2 対応に伴い表 ３-１のプラットフォーム
平成 16 年 10 月 14 日
を追加
・ 公的個人認証サービス利用者ソフト Ver2.0 のリリースに伴い、動作環境、ソフトウェア構成図を変更
・ 表 ４-１ 実現可能な処理の一覧に自分の電子証明書の有効性確認機能を追加
・ 第５章 第１節 サポート API 一覧の表 ５-１ サ
ポート API 一覧に JPKIConfirm を追加
・ 第５章 第２節 サポート API 仕様詳細に（５）JPKIConfirm を追加
平成 18 年 5 月 2 日・ 第５章 第４節 コーリングシーケンスに（４）有効性確認処理 を追加
・ 表 ６-１ 画面一覧に[有効性確認]ボタンおよび[ファイル出力]ボタンを押下した場合の動作を追加
・ 第６章 第２節 画面仕様詳細の画面レイアウトを変更
・ 表 ６-４ 表示項目と証明書領域の対応（認証局の自己署名証明書）から MD5 に関する記述を削除
・ MacOS 対応に伴い、第２章 ドキュメント体系、第平成 18 年 11 月 1 日
３章 動作環境、第４章 第１節 ソフトウェア構
成図を変更
平成 19 年 4 月 10 日 ・ 表 ３-１ 動作環境を変更
・ 表 ３-１ 動作環境 プラットフォームにWindowsVista, MacOS X 10.4.10, MacOS X 10.4.9
平成 19 年 10 月 4 日を追加
・ 表 ３ - １ 動 作 環 境 Web ブ ラ ウ ザ に Internet
Explorer7.0 を追加
・ 表 ３-１ 動作環境 プラットフォームにWindowsVista
ServicePack1,
WindowsXP
ServicePack3, MacOS X 10.5.4, MacOS X 10.5.3,
平成 20 年 10 月 10 日
MacOS X 10.5.2, MacOS X 10.5.1, MacOS X 10.5,
MacOS X 10.4.11 を追加。
・ 表 ３ - １ 動 作 環 境 Web ブ ラ ウ ザ に Internet
Explorer6.0 ServicePack3 を追加。

版数

2.5 版

2.6 版

3.0 版

変更日付

変更内容
・ 図 ２-１ ドキュメント体系図エラー! 参照元が見つかりません。に「JavaDoc JPKICryptJNI(64bit)」を追加。
・ 表 ３-１ 動作環境を表 ３-１ 動作環境(Windows)、
表 ３-２ 動作環境(MacOS)、表 ３-３ 動作環境(ICカード)に分割し、マトリクス形式の記述に変更。
・ 表 ３ - １ 動 作 環 境 (Windows) の OS に Windows
7(32/64 bit) ，WindowsVista ServicePack2 を追加、Web ブラウザに Internet Explorer8.0 を追加。
平成 23 年 04 月 01 日
・ 表 ３-２ 動作環境(MacOS)の OS に MacOS X 10.6.4，
MacOS X 10.5.6，MacOS X 10.5.5 を追加、Web ブラ
ウザに Safari 3.2, Safari 5.0 を追加。
・ 図 ４-１ ソフトウェア構成図(Windows 対応版)を変更。
・ 第４章 第２節 実現可能な機能の一覧に使用するライブラリ名を追加。
・ 第５章 第２節 サポート API 仕様詳細（５）JPKIConfirm の誤記を修正。
第３章 動作環境
表 ３-１ 動作環境(Windows)
Windows2000 を 削 除 、 Windows8(32/64bit) 、Windows8.1(32/64bit)を追加
表 ３-２ 動作環境(MacOS)
MacOS X 10.4.X, 10.5.X, 10.6.X を削除、MacOS X
10.7.5, OS X 10.8.4 を追加
・ 第４章 第２節 実現可能な機能の一覧に MacOSXを追加。
平成 25 年 12 月 01 日 ・ 第５章 第１節 サポート API 一覧に sha-356 対応
する API の記載を追加
・ 表 ５-３ 検証結果コード（certPathStatus）にアル
ゴリズム拒否のコードを追加。
・ 第６章 第２節 （２）画面項目説明 ⑧に sha256の表示を追加。
・ 第６章 第２節 （４）画面項目説明 ⑥に sha256の表示を追加。
・ 表 ６-８ 証明書検証結果「無効」の場合のエラーコ
ード一覧にアルゴリズム拒否のコードを追加。
・ 全体 「地方公共団体情報システム機構」への事業承継により、組織名称を変更する。
平成 26 年 04 月 01 日 ・ 全体 「公的個人認証サービス共通基盤事業運用会議」への事業承継により、「公的個人認証サービス都
道府県協議会」の組織名称を変更する。

版数

3.1 版

4.0 版

4.0.1 版

4.1 版

変更日付

変更内容

・ 第３章 動作環境
表 ３-１ 動作環境(Windows)
Windows XP を削除、Windows7(32/64bit)の Web ブラ
ウ ザ を IE10.0 か ら IE11.0 に 変 更 、 Windows
8(32/64bit) を 削 除 、 Windows 8.1 を Windows 8.1
update に変更
平成 26 年 07 月 01 日
表 ３-２ 動作環境(MacOS)
OS X 10.7.5 の Web ブラウザを Safari6.0 から
Safari6.1 に変更、OS X 10.8.4 を OS X 10.8.5 に変
更し、Web ブラウザを Safari6.0 から Safari6.1 に変更、OS X 10.9.3(64bit)、Web ブラウザに Safari7.0
を追加
番号制度対応に伴い、以下を修正。
・第１章 第１節 用語の定義を追加。
・第２章 ドキュメント体系を修正。
・第３章 動作環境を修正。
平成 27 年 6 月 30 日 ・第４章 機能仕様を修正。
・第５章 API 仕様を修正。
・第６章 画面仕様を修正。
・第４章 第１節 ソフトウェア構成図(MacOS 対応版)を修正。
・第３章システム概要 動作環境 更新プログラムに係る注釈※3、4 の追加
・第６章 第２節 画面仕様詳細 表 6-10 エラーコ
平成 28 年 10 月 26 日
ード一覧 No11-17 を追加
・文末 注意事項の利用用途の文言修正
その他、図の整形及び誤記等の文言修正
PC 接続機能追加対応に伴い、以下を修正。
・第１章 第１節の「用語の定義」に以下を追加。
 PC/SC IC カードリーダライタ
 挿入
 NFC
 Bluetooth
・第２章 ドキュメント体系図に Android 版を追加。
平成 28 年 11 月 30 日
・第３章 表 3-1 および表 3-2 に PC 接続機能対応可否追加。
・第３章 表 3-1 に Windows 10(32/64bit)を追加。
・第３章 表 3-3 動作環境(共通)を表 3-3 動作環境(ICカード)、第 1 節 PC/SC 対応 IC カードリーダライタ、第2 節 Android 端末に分割。
・第４章 第１節 ソフトウェア構成図に Bluetooth 通信
を追加。

版数

4.2 版

4.3 版

変更日付

変更内容
Java9 対応に伴い、以下を修正。
・第２章 ドキュメント体系図を改訂。
・第３章 表 ３-１の OS から Windows Vista(32bit)を削除。
・第３章 表 ３-１の OS から Windows 8(32bit)を削除。
・第３章 表 ３-１の OS から Windows 8(64bit)を削除。
・第３章 表 ３-１の JavaVM に JRE9 を追加。
・第３章 表 ３-２の OS から OS X 10.8, 10.9 を削除。
平成 29 年 07 月 31 日
・第３章 表 ３-２の OS に OS X 10.11, macOS v10.12を追加。
・第３章 表 ３-２の JavaVM に JRE9 を追加。
・※２に説明文を追記。
・第３章 表 ３-５の【PC 接続の場合】に Android 6.0.1、7.0 を追加。
・第３章 表 ３-５の【Android 単体で利用する場合】にAndroid 6.0.1、7.0 を追加。
・第３章 表 ３-２の OS から OS X 10.11 を削除。
・第３章 表 ３-２の OS に macOS v10.13 を追加。
・第３章 表 ３-５の【PC 接続の場合】、【Android 単体で利用する場合】に Android 8.0 を追加。
新元号対応に伴い、以下を修正。
・第５章 第３節 構造体仕様の生年月日の設定ルールに新元号を追加。
令和元年 5 月 1 日・第６章 第２節 画面仕様詳細の※2 生年月日の設定
ルールに新元号を追加。
旧氏対応に伴い、以下を修正。
・第５章 第３節 構造体仕様に旧氏に関する記述を追加。
・第６章 第２節 画面仕様詳細に旧氏に関する記述
を追加。

版数

4.4 版

変更日付

令和 2 年 3 月 31 日

変更内容
MacOS 版における開発言語(Java)変更対応に伴い、以下を修正。
・第３章 表３-２を修正。
macOS v10.12、v10.13 を削除。
macOS v10.14、macOS v10.15（Web ブラウザは Safari 13）を追加。
・第４章 第１節 図４-２ ソフトウェア構成図(MacOS対応版)から個人認証サービス AP C 言語 I/F から個人認証サービス AP JavaI/F の呼び出しを削除。
・第６章 第２節（６） 表６-９エラーコード 300100 の「環境設定ファイルのプロキシ情報の指定」を「シス
テムのプロキシ情報の指定」に修正。
Mac 版における住基カードサポート廃止に伴い、以下を修正。
・第２章 ドキュメント体系図から「API 仕様書 Mac OS
X C 言語インターフェース編」を削除。
・第３章 表３-２ ※２の注釈を削除。
・第３章 表３-３ MacOS 版を使用する場合は個人番号
カードのみ対応である旨を追加。
・第４章 第１節 図４-２ ソフトウェア構成図(MacOS対応版)から Keychain Services 及び CSSM を削除。
・第５章 第２節（３）表５-２
JPKI̲CVS̲FALSE̲CL̲GETCERT に MacOS 版の場合は住基カードが利用されている場合に本エラーが発生する旨の注釈を追加。
・第５章 第２節（５）表５-５
JPKI̲CLIENT̲ICCARD̲NOT̲READY に MacOS 版の場合は住基カードが利用されている場合に本エラーが発生する旨の注釈を追加。
・第６章 第２節（６） 表６-９エラーコード 300400 にMacOS 版の場合は IC カードリーダライタに住基カードが設定されている場合に本エラーが発生する旨の注釈を追加。
・第６章 第２節（７）表６-１０エラーコード 300704に MacOS 版の場合は住基カードが利用されている場合に本エラーが発生する旨の注釈を追加。
ブラウザ対応版、iOS 版のリリースに伴い、以下を修正。
・第２章 ドキュメント体系 「利用者クライアントソ
フト 機能概要説明書 ブラウザ対応編」を追加。
・第２章 ドキュメント体系 「API 仕様書 カード AP
ライブラリ ブラウザインターフェース編」を追加。
・第２章 ドキュメント体系 「利用者クライアントソ
フト 機能概要説明書(iOS 版)」を追加。
・ 第 ２ 章 ド キ ュ メ ン ト 体 系 「 API 仕 様 書 iOS
Framework 編」を追加。
・第３章 第２節 動作環境に Android9.0、10.0 を追加。
Windows 7 サポート終了に伴い、以下を修正。
・第３章 表３-１を修正。
Windows 7(32bit)、Windows 7(64bit)および※3 を削
除。

版数

変更日付

4.5 版

令和 3 年 3 月 31 日

4.5.1 版

令和 3 年 3 月 31 日

4.6 版

令和 6 年 4 月 15 日

変更内容
ブラウザ対応版(Android)のリリースに伴い、以下を修
正・第２章 ドキュメント体系 「利用者クライアントソ
フト 機能概要説明書(Android 版) ブラウザ対応編」を追加。
・第２章 ドキュメント体系 「API 仕様書 Android イ
ンテント ブラウザインターフェース編」を追加。
InstallShield2022 対応に伴い、第３章 動作環境の記載を修正。
Mac OS 版 Ver3.7 のリリースに伴い、以下を修正
・第１章 第 1 節 用語の定義の記載を修正。
・第３章 動作環境の記載を修正。

API 仕様書【個人認証サービス AP C 言語インターフェース編】第 4.6 版
−

目次

−

第１章 はじめに ......................................................... １
第１節 用語の定義 ............................................................................................................ ２

第２章 ドキュメント体系 ................................................. ３
第３章 動作環境 ......................................................... ５
第１節 PC/SC 対応 IC カードリーダライタ..................................................................... ７
第２節 Android 端末......................................................................................................... ８

第４章 機能仕様 ......................................................... ９
第１節 ソフトウェア構成図 .............................................................................................. ９
第２節 実現可能な機能の一覧 ...................................................................................... １１

第５章 API 仕様 ........................................................ １２
第１節 サポート API 一覧 ............................................................................................ １２
第２節 サポート API 仕様詳細 ..................................................................................... １３
第３節 構造体仕様 ........................................................................................................ １９
第４節 コーリングシーケンス ...................................................................................... ２１

第６章 画面仕様 ....................................................... ２３
第１節 画面一覧 ............................................................................................................ ２３
第２節 画面仕様詳細..................................................................................................... ２４iAPI 仕様書【個人認証サービス AP C 言語インターフェース編】第 4.6 版

第１章 はじめに
公的個人認証サービス 利用者クライアントソフト(以下、JPKI 利用者ソフト)における個人
認証サービス AP は、以下の機能を実現するための Application Program Interface(以下、API)を提供する。


証明書表示機能

基本 4 情報取得機能



官職証明書検証機能



自分の電子証明書の有効性確認機能IC カード種別取得機能

以降、本書では個人認証サービス AP のうち、C 言語インターフェースの API 仕様について説明する。

１

API 仕様書【個人認証サービス AP C 言語インターフェース編】第 4.6 版

第１節 用語の定義
表 １-１ 用語の定義
項番
用語・略号
1
IC カード

2

3
4

5

6

7

8

9
10

説明
以下のカードを指す総称。
・住基カード・個人番号カード
電子証明書
公開鍵及び発行対象を識別する情報を含むデータに、認証局が発行対象の正当性を保証する電子署名を付与して、発行されるデータをいう。
データは、ISO/IEC 8825-1 の識別符号化規則により符号化された形式で利用される。
証明書
電子証明書と同義。
署 名 用 電 子 証 公的個人認証サービスで発行した署名用途の利用者の電子証明書。
明書
本書では以下の電子証明書を指す。
・住基カードに格納された署名用電子証明書
・個人番号カードに格納された署名用電子証明書
利 用 者 証 明 用 公的個人認証サービスで発行した利用者証明用途の利用者の電子証明電子証明書書。
本書では以下の電子証明書を指す。
・個人番号カードに格納された利用者証明用電子証明書
利用者証明書
公的個人認証サービスで発行した利用者の証明書。
本書では以下の電子証明書を指す。
・住基カードに格納された署名用電子証明書
・個人番号カードに格納された署名用電子証明書
・個人番号カードに格納された利用者証明用電子証明書
利用者秘密鍵
公開鍵暗号方式において用いられる鍵ペアの一方。公開鍵に対する、利用者のみが保有する鍵。
本書では以下の秘密鍵を指す。
・住基カードに格納された署名用利用者秘密鍵
・個人番号カードに格納された署名用利用者秘密鍵
・個人番号カードに格納された利用者証明用利用者秘密鍵
認 証 局 の 自 己 自認証局の公開鍵に対して、自認証局の秘密鍵で署名した証明書。
署名証明書
本書では以下の電子証明書を指す。
・住基カードに格納された都道府県知事の自己署名証明書
・個人番号カードに格納された署名用認証局の自己署名証明書
・個人番号カードに格納された利用者証明用認証局の自己署名証明書
PC/SC
Personal Computer/Smart Card の略。

12

IC カードリー 以下の機器を指す総称
ダライタ
・PC/SC 対応 IC カードリーダライタ
・Android 端末
挿入IC カードリーダライタが IC カードを読み込める状態にすること。
具体的には以下の状態にすることを指す。
・PC/SC 対応 IC カードリーダライタに IC カードをセットすること・Android 端末に IC カードをセットすること
NFC
Near Field Communication (近距離無線通信)の略。

13

Bluetooth11

機器間の近距離無線通信 IEEE 802.15.1 の規格名称。

２

API 仕様書【個人認証サービス AP C 言語インターフェース編】第 4.6 版

第２章 ドキュメント体系
JPKI 利用者ソフトのドキュメント体系図を以下に示す。本書は以下の体系図の網掛け部分に該当する。
利用者クライアントソフト 機能概要説明書
利用者クライアントソフトの機能概要について説明しています。

API 仕様書 カード AP ライブラリ CryptoAPI 編
カード AP ライブラリ(CryptoAPI)の API 仕様について説明しています。

API 仕様書 カード AP ライブラリ PKCS#11 編
カード AP ライブラリ(PKCS#11)の API 仕様について説明しています。

API 仕様書 カード AP ライブラリ Java インターフェース編
カード AP ライブラリ(Java インターフェース)の API 仕様について説明しています。

JavaDoc JPKICryptJNI
カード AP ライブラリ(Java インターフェース(住基カード署名用))の JavaDoc です。

JavaDoc JPKICryptJNI(64bit)
カード AP ライブラリ(Java インターフェース(住基カード署名用) 64bit)の JavaDoc です。

JavaDoc JPKICryptSignJNI
カード AP ライブラリ(Java インターフェース(個人番号カード署名用))の JavaDoc です。

JavaDoc JPKICryptSignJNI(64bit)
カード AP ライブラリ(Java インターフェース(個人番号カード署名用) 64bit)の JavaDoc です。

JavaDoc JPKICryptAuthJNI
カード AP ライブラリ(Java インターフェース(個人番号カード利用者証明用))の JavaDoc です。

JavaDoc JPKICryptAuthJNI(64bit)
カード AP ライブラリ(Java インターフェース(個人番号カード利用者証明用) 64bit)の JavaDoc です。

API 仕様書 個人認証サービス AP C 言語インターフェース編
個人認証サービス AP(C 言語インターフェース)の API 仕様について説明しています。

API 仕様書 個人認証サービス AP Java インターフェース編
個人認証サービス AP(Java インターフェース)の API 仕様について説明しています。

JavaDoc JPKIUserCertService
個人認証サービス AP(Java インターフェース)の JavaDoc です。

Jar ファイル利用手引き
利用者クライアントソフトの Jar ファイルを利用する方法について説明しています。

利用者クライアントソフト 機能概要説明書 ブラウザ対応編
ブラウザ対応版利用者クライアントソフトの機能概要について説明しています。

API 仕様書 カード AP ライブラリ ブラウザインターフェース編
カード AP ライブラリ(ブラウザインターフェース)の API 仕様について説明しています。

図 ２-１ ドキュメント体系図(PC 版)
３

API 仕様書【個人認証サービス AP C 言語インターフェース編】第 4.6 版

利用者クライアントソフト 機能概要説明書(Android 版)
Android 版 JPKI 利用者ソフトの機能概要について説明しています。

API 仕様書 Android インテント編
インテントによる外部インターフェース仕様について説明しています。

利用者クライアントソフト 機能概要説明書(Android 版) ブラウザ対応編
ブラウザ対応版 Android 版 JPKI 利用者ソフトの機能概要について説明しています。

API 仕様書 Android インテント ブラウザインターフェース編
インテントによる外部インターフェース仕様(ブラウザ対応用)について説明しています。

図 ２-１ ドキュメント体系図(Android 版)

利用者クライアントソフト 機能概要説明書(iOS 版)
iOS 版 JPKI 利用者ソフトの機能概要について説明しています。

API 仕様書 iOS Framework 編
Framework による外部インターフェース仕様について説明しています。

図 ２-２ ドキュメント体系図(iOS 版)

４

API 仕様書【個人認証サービス AP C 言語インターフェース編】第 4.6 版

第３章 動作環境
個人認証サービス AP(C 言語インターフェース)の動作環境は以下の通りとする。
表 ３-１ 動作環境(Windows)
OS(※1)
Windows 10 Home/Pro (32bit/64bit)
Windows 11 Home/Pro

Web ブラウザ(※1, ※2)
Edge
Edge

JavaVM(※1)
JRE8.0○○PC 接続機能対応
可否(※3)○○※1 本仕様書で定めるバージョンの開発時点の環境。最新の動作環境の情報は、JPKI ポータル
サイトに掲載するものとする。
また、最新の動作環境に掲載された OS、Web ブラウザ、JavaVM 以外を使用した場合の不具合等に関するお問い合わせは、サポート対象外とする。
※2 プラットフォームが Windows の場合、暗号機能等の利用のために Microsoft Edge(カード AP
ライブラリ（Java インタフェース編）の場合、IE モード)が必要。
※3 PC 接続機能については「利用者クライアントソフト 機能概要説明書 第３章 第３節 PC 接
続機能について」を参照。

５

API 仕様書【個人認証サービス AP C 言語インターフェース編】第 4.6 版

表 ３-２ 動作環境(MacOS)
Web ブラウザ(※1)
Safari 16
Safari 17

OS(※1)
macOS 13 Ventura
macOS 14 Sonoma

JavaVM(※1)
JRE8.0〇〇PC 接続機能対応可否
(※2)
×
×

※1 本仕様書で定めるバージョンの開発時点の環境。最新の動作環境の情報は、JPKI ポータル
サイトに掲載するものとする。
また、最新の動作環境に掲載された OS、Web ブラウザ、JavaVM 以外を使用した場合の不具合等に関するお問い合わせは、サポート対象外とする。
※2 PC 接続機能については「利用者クライアントソフト 機能概要説明書 第３章 第３節 PC 接
続機能について」を参照。
IC カードの動作環境は以下の通りとする。

表 ３-３ 動作環境(IC カード)項目
IC カード条件
住基カードまたは個人番号カードであること。
※PC 接続機能を使用する場合は個人番号カードのみ対応。
※MacOS 版を使用する場合は個人番号カードのみ対応。

６

API 仕様書【個人認証サービス AP C 言語インターフェース編】第 4.6 版

第１節

PC/SC 対応 IC カードリーダライタ

PC/SC 対応 IC カードリーダライタの動作環境は以下の通りとする。

表 ３-４ 動作環境(PC/SC 対応 IC カードリーダライタ)
項目

条件

PC/SC 対応 IC カード 以下の条件を満たす PC/SC 対応 IC カードリーダライタとする。(「個人リーダライタ
番号カード対応適合性検証済み IC カードリーダーライタ一覧」「住基カード対応適合性検証済み IC カードリーダーライタ一覧」(※1)を参照のこと。)
・ IC カードのインターフェース(非接触型、接触非接触両対応型)に対応していること。
・ PC/SC 対応 IC カードリーダライタであること。
・ USB など、パソコンに接続するためのインターフェースを有すること。
・ PC/SC 対応 IC カードリーダライタと通信するためのドライバソフト
ウェアが提供されていること。
・ IC カードの搬送方式が手動挿入/手動排出タイプまたは自動挿入/自動排出タイプであること。
・ IC カードを挿入するスロットの数は 1 つとし、1 度に挿入できる IC
カードは 1 枚であること。
※1 最新の「個人番号カード対応適合性検証済み IC カードリーダーライタ一覧」「住基カード対応適合性検証済み IC カードリーダーライタ一覧」の情報は、JPKI ポータルサイトに掲載す
るものとする。

７

API 仕様書【個人認証サービス AP C 言語インターフェース編】第 4.6 版

第２節

Android 端末

Android 端末の動作環境は以下の通りとする。

表 ３-５ 動作環境(Android 端末)
項目
Android 端末※条件
以下の条件を満たす Android 端末とする。
（「個人番号カード対応適合性検証済み Android 端末一覧」(※)を参照のこと。
）
・Android 8.0、9.0、10.0、11.0 または 12.0 を搭載していること。
・Bluetooth 4.2 を搭載していること。
・ISO/IEC 14443 Type B に対応している NFC を搭載していること。

最新の「個人番号カード対応適合性検証済み Android 端末一覧」の情報は、JPKI ポータル
サイトに掲載するものとする。
また、最新の動作環境に掲載された OS 以外を使用した場合の不具合等に関するお問い合わ
せは、サポート対象外とする。

８

API 仕様書【個人認証サービス AP C 言語インターフェース編】第 4.6 版

第４章 機能仕様
第１節 ソフトウェア構成図
本仕様書では、JPKI 利用者ソフトのうち、下図の太枠に示す個人認証サービス AP(C 言語インターフェース)の仕様をまとめる。
＜Windows 対応版＞
上位アプリケーション
PKCS#11 API

CryptoAPI

JavaI/F

JPKI 利用者ソフト

JavaI/F

C 言語 I/F

個人認証サービス AP
JavaI/F
個人認証サービス AP
C 言語 I/F
カード AP ライブリ
Java I/F
カード AP ライブリ
CryptoAPI

カード AP ライブリ
PKCS#11

カード AP ライブラリ
カード I/F
SmartCardAPI※

Windows Sockets API

SmartCardAPI※

Windows Sockets API

PC/SC リーダライタドライバ

Bluetooth ドライバ

カードコマンド
PC/SC リーダライタ

証明書
検証要求

オンライン窓口
処理要求

カードコマンド
Android 端末

カードコマンド

カードコマンド

公的個人認証サービスカードアプリケーション

官職証明書検証サービス※ Smart Card Resource Manager API の略

図 ４-１ ソフトウェア構成図(Windows 対応版)

９

オンライン窓口
サービス

API 仕様書【個人認証サービス AP C 言語インターフェース編】第 4.6 版＜MacOS 対応版＞
上位アプリケーション
PKCS#11 API

JavaI/F

JavaI/F

C 言語 I/F

JPKI 利用者ソフト
個人認証サービス AP
C 言語 I/F
個人認証サービス AP
JavaI/F
カード AP ライブラリ
カード AP ライブラリ
JavaI/F
PKCS#11
カード AP ライブラリ
カード I/F
証明書
検証要求

Smart Card Services API

オンライン窓口
処理要求

Smart Card Services (PC/SC)
PC/SC リーダライタドライバ
カードコマンド
PC/SC リーダライタ
カードコマンド
公的個人認証サービスカードアプリケーション

官職証明書検証サービス

図 ４-２ ソフトウェア構成図 (MacOS 対応版)

１０

オンライン窓口
サービス

API 仕様書【個人認証サービス AP C 言語インターフェース編】第 4.6 版

第２節 実現可能な機能の一覧
個人認証サービス AP(C 言語インターフェース)で実現可能な機能の一覧を表 ４-１に示す。
表 ４-１ 実現可能な処理の一覧
NO
機能
1 証明書表示
2 基本 4 情報取得
3

官職証明書検証4

自分の電子証明書の有効性確認

5

IC カード種別取得

概要
電子証明書を証明書 Viewer で表示する。
署名用電子証明書から基本 4 情報(氏名、住所、性別、生年月日)を取得する。
官職証明書や職責証明書の証明書検証を行うため、公的個人認証サービスセンターにある官職証
明書検証サービスに対して証明書検証要求を発行する。
IC カード内の自分の電子証明書(利用者証明書)の有効性を確認するために、公的個人認証サービ
スセンターにあるオンライン窓口サービスに対して有効性確認要求を発行する。
IC カードリーダライタに挿入されている IC カー
ドの種別を取得する。

個人認証サービス AP(C 言語インターフェース)の機能は、以下のライブラリで提供する。
＜Windows 対応版＞
32bit 版：(インストールフォルダ)\JPKIServiceAPI.dll
64bit 版：(インストールフォルダ)\JPKIServiceAPI64.dll＜Mac OS 対応版＞
64bit 版：/usr/local/lib/JPKIServiceAPI.dylib

１１API 仕様書【個人認証サービス AP C 言語インターフェース編】第 4.6 版

第５章 API 仕様
第１節 サポート API 一覧
サポート API 一覧を表 ５-１に示す。
表 ５-１ サポート API 一覧
NO
1
2
3
4
5

API 名
JPKICertViewDialog
JPKIGetBasicData
JPKICertValid
JPKIFreeBasicData
JPKIConfirm

6

JPKIGetCardType

概要
電子証明書を表示する。
署名用電子証明書から基本 4 情報を取得する。
官職証明書の証明書検証を行う。
基本 4 情報の格納領域を解放する。
自分の電子証明書(利用者証明書)の有効性確認を行う。
IC カードリーダライタに挿入されている IC カー
ドの種別を取得する。

※住基カード利用時は NO.1,3 について sha-256 の官職証明書・職責証明書の表示・検証に対応済み。
※個人番号カード利用時は NO.1,3,5 について sha-256 の官職証明書・職責証明書の表示・
検証、sha256 の利用者証明書の有効性確認に対応済み。

１２

API 仕様書【個人認証サービス AP C 言語インターフェース編】第 4.6 版

第２節 サポート API 仕様詳細
（１）JPKICertViewDialog
API 名
概要
関数インタ
ーフェース

戻り値

引数

JPKICertViewDialog
電子証明書を表示する。
int JPKICertViewDialog (JPKI̲CertBinaryData*certData);
値
内容
JPKI̲USER̲TRUE
正常終了。
JPKI̲USER̲FALSE̲INVALID̲PARAM 引数に不正な値が設定されていた。
JPKI̲USER̲FALSE̲MEMORY
メモリが不足している。
JPKI̲USER̲FALSE̲DECODE̲CERT
証明書のデータの解析に失敗した。
JPKI̲USER̲FALSE̲SHOW̲VIEWER
ダイアログの表示に失敗した。
JPKI̲USER̲FALSE̲OTHER
その他システムエラーが発生した。
型
I/O
内容
JPKI̲CertBinaryData *IN
電子証明書データ(DER 形式)（２）JPKIGetBasicData
API 名
概要
関数インタ
ーフェース

戻り値

引数

JPKIGetBasicData
署名用電子証明書から基本 4 情報を取得する。
int JPKIGetBasicData (JPKI̲CertBinaryData*certData,
JPKI̲BasicData*basicData);
値
内容
JPKI̲USER̲TRUE
正常終了。
JPKI̲USER̲FALSE̲INVALID̲PARAM 引数に不正な値が設定されていた。
JPKI̲USER̲FALSE̲MEMORY
メモリが不足している。
JPKI̲USER̲FALSE̲DECODE̲CERT
証明書のデータの解析に失敗した。
JPKI̲USER̲FALSE̲OTHER
その他システムエラーが発生した。
型
I/O
内容
JPKI̲CertBinaryData *IN
署名用電子証明書データ(DER 形
式)
JPKI̲BasicData *OUT
基本 4 情報１３

API 仕様書【個人認証サービス AP C 言語インターフェース編】第 4.6 版（３）JPKICertValid
API 名
概要
関数インタ
ーフェース

戻り値
引数

JPKICertValid
官職証明書の証明書検証を行う。
int JPKICertValid (JPKI̲CertBinaryData*certData,
int*certPathStatus,
int*responseStatus);
int（表 ５-２ 検証結果コード（戻り値）参照）
型
I/O
内容
JPKI̲CertBinaryData *IN
検証対象証明書データ(DER 形式)
int *
OUT
証明書検証（認証パスの構築および検証）の結果コード(表 ５-３ 検証結果コード（certPathStatus）参照)
int *
OUT
OCSP レスポンスステータス(表 ５-４ 検証結果コード（responseStatus）参照)

表 ５-２ 検証結果コード（戻り値）
#
1

2

3
4
5
6
7
8
9

区分※1
意味
証明書検証に成功した。
この戻り値を返却する場合、以下の値が設定される。
certPathStatus … 0（有効）responseStatus … 0（OCSP Request が正しく処理された）
JPKI̲CVS̲NG
証明書検証に失敗した。
この戻り値が返却された場合、certPathStatus に官
職証明書検証サーバ(CVS)が返却した検証結果コードが設定される。
JPKI̲CVS̲FALSE̲CL̲MEMORY
C
メモリの確保に失敗した。
JPKI̲CVS̲FALSE̲CL̲INVALID C
引数に設定した値が間違っている。
̲PARAM
JPKI̲CVS̲FALSE̲CL̲OTHER
C
システム関数起因によるエラーが発生。
JPKI̲CVS̲FALSE̲CL̲CREATE̲ COCSP Request および拡張情報の生成に失敗した。まREQUEST
たは、リクエスト署名の生成に失敗した。
JPKI̲CVS̲FALSE̲CL̲HTTP
C
HTTP または HTTPS 通信で失敗した。
JPKI̲CVS̲FALSE̲SV̲DECODESOCSP Response(ASN.1 エンコード形式)のデコードに失敗した。
JPKI̲CVS̲FALSE̲SV̲RESPONS S
官職証明書検証サーバ(CVS)で例外が発生した。
E̲EXCEPTION
この戻り値が返却された場合、responseStatus に官
職証明書検証サーバ(CVS)が返却したステータスが設定される。
Define シンボル(定義名)
JPKI̲CVS̲OK

１４

API 仕様書【個人認証サービス AP C 言語インターフェース編】第 4.6 版#
Define シンボル(定義名)
区分※1
意味
10 JPKI̲CVS̲FALSE̲SV̲SIGN̲VE S
官 職 証 明 書 検 証 サ ー バ (CVS) か ら 受 信 し た OCSPRIFY̲SIGNATURE
Response(ASN.1 エンコード形式)の署名検証に失敗した。
11 JPKI̲CVS̲FALSE̲SV̲NONCE
S
Request 送信時に付与した nonce と Response に含まれる nonce※2 が一致しない場合に返却する。
12 JPKI̲CVS̲FALSE̲SV̲CERT̲VE S
CVS 証明書の証明書検証に失敗した。
RYFY
13 JPKI̲CVS̲FALSE̲SV̲ANALYZE S
証明書検証結果の解析に失敗した。
14 JPKI̲CVS̲FALSE̲CL̲CVSURL
C
官職証明書検証サーバ(CVS)の URL が不正の場合に返却する。
15 JPKI̲CVS̲FALSE̲CL̲GETCERT C
IC カードから証明書(利用者証明書または認証局の自己署名証明書)の取得に失敗した。※3(※1) 区分

C:クライアント側エラー

S:サーバ側エラー（※2）nonce
官職証明書検証サーバ(CVS)に検証を依頼するために送信した Request とその結果として返ってきた Response が真に対応しているかどうかを確認する為に、送信時に Request に付与する 1 から 33 バイトの乱数。Request に付与した nonce と、
Response に含まれる nonce が一致すれば送信した Request に対する Response であると確認される。
（※3）MacOS 版の場合、住基カードが利用されている場合にも本エラーが発生する。

表 ５-３ 検証結果コード（certPathStatus）#

Define シンボル(定義名)値

1

JPKI̲CVS̲GOOD

0

2

JPKI̲CVS̲INTERNAL̲PATH̲CONSTRU
CTION̲ERROR
JPKI̲CVS̲SIGNATURE̲VERIFICATION̲FAILURE

101

203

5

JPKI̲CVS̲ONE̲OR̲MORE̲CERTIFICATES̲ARE̲REVOKED
JPKI̲CVS̲POLICY̲MAPPING̲ERROR

6

JPKI̲CVS̲CONSTRAINTS̲ERROR

205

7

JPKI̲CVS̲CERTSTATUS̲OF̲OCSP̲RE
SPONSE̲IS̲UNKNOWN

206

8JPKI̲CVS̲REJECTED̲BY̲ALGORITHM
̲EE

301

3
4

内容

解説

有効

202

204

認証パスの構築が成功し検証結果が正しい
認証パス構築不 認証パス構築ができない
可
署名不正
認証パスに署名が不正である証明書が含まれる失効証明書を含 認証パスに失効した証明書
むが含まれる
ポリシー不一致 認証パスにポリシーが一致しない証明書が含まれる
制約違反
認証パスに制約に違反している証明書が含まれる
OCSP での証明書 認 証 パ ス に OCSP で の検証確認不正certStatus が unknown と応答される証明書が含まれる
アルゴリズム拒 官職証明書検証サーバ(CVS)否側で検証対象証明書の受け付けを拒否した

１５

API 仕様書【個人認証サービス AP C 言語インターフェース編】第 4.6 版#

Define シンボル(定義名)値

9JPKI̲CVS̲REJECTED̲BY̲ALGORITHM
̲CA

302

10 JPKI̲CVS̲REJECTED̲A̲REQUEST

901

11 JPKI̲CVS̲VALIDATION̲TIMEOUT

902

内容

解説

アルゴリズム拒 官職証明書検証サーバ(CVS)
否
側で中間証明書または認証局の自己署名証明書の受け付けを拒否した
要求受付け拒否 官職証明書検証サーバ(CVS)
側で要求の受け付けを拒否した
タイムアウト
要求がタイムアウトとなった

表 ５-４ 検証結果コード（responseStatus）#

Define シンボル(定義名)値

1

JPKI̲CVS̲RESSTATUS̲SUCCESSFUL

0

成功

2

JPKI̲CVS̲RESSTATUS̲MALFORMEDREQUESTJPKI̲CVS̲RESSTATUS̲INTERNALERROR
JPKI̲CVS̲RESSTATUS̲TRYLATER
JPKI̲CVS̲RESSTATUS̲SIGREQUIREDJPKI̲CVS̲RESSTATUS̲UNAUTHORIZED

1

エラー

2

エラー

3
5
6

エラー
エラー
エラー

3
4
5
6

内容

解説
OCSP Request が正しく処理された
OCSP Request のフォーマット
エラー
内部エラー
一時的な解答不能
OCSP Request への署名が必要
クライアントが認証されていない（４）JPKIFreeBasicData
API 名
概要
関数インタ
ーフェース

戻り値

引数

JPKIFreeBasicData
基本 4 情報の格納領域を解放する。
int JPKIFreeBasicData (JPKI̲BasicData*basicData);
値
内容
JPKI̲USER̲TRUE
正常終了。
JPKI̲USER̲FALSE̲INVALID̲PARAM
引数に不正な値が設定されていた。
型
I/O
内容
JPKI̲BasicData *IN
基本 4 情報１６

API 仕様書【個人認証サービス AP C 言語インターフェース編】第 4.6 版（５）JPKIConfirm
API 名
概要
関数インタ
ーフェース

戻り値

引数

JPKIConfirm
自分の電子証明書(利用者証明書)の有効性確認を行う。
int JPKIConfirm (JPKI̲CertBinaryData*certData);
値
内容
JPKI̲USER̲FALSE̲INVALID̲PARAM
引数に不正な値が設定されていた。
JPKI̲USER̲FALSE̲MEMORY
メモリが不足している。
JPKI̲USER̲FALSE̲OTHER
その他システムエラーが発生した。
int(表 ５-５ 有効性確認結果コード(戻り値)参照)
型
I/O
内容
JPKI̲CertBinaryData *IN
利用者証明書データ(DER 形式)

表 ５-５ 有効性確認結果コード(戻り値)#

Define シンボル(定義名)

値

解説

1
2

JPKI̲CONFIRM̲OK
JPKI̲SERVER̲VERIFY̲ERROR

200
600

3

JPKI̲SERVER̲APPLY̲ERROR

601

4

JPKI̲SERVER̲EXPIRED̲ERROR

602

5

JPKI̲SERVER̲DATA̲ERROR

603

6

JPKI̲SERVER̲ISSUER̲ERROR

604

7

JPKI̲SERVER̲VALIDITY̲ERROR

605

8

JPKI̲SERVER̲OCSP̲ERROR

606

9 JPKI̲SERVER̲REVOKED̲ERROR
10 JPKI̲SERVER̲APPLYED̲ERROR

607
608

11 JPKI̲SERVER̲DB̲ERROR

609

12 JPKI̲SERVER̲JAM̲ERROR

611

13 JPKI̲SERVER̲OTHER̲ERROR

612

有効性確認結果が有効である。
申請書の電子証明書検証エラーが発生した。
オンライン窓口サーバで「申請情報取込エラー」が発生した。
オンライン窓口サーバで「対象とする証明書の有効期限切れエラー」が発生した。
オンライン窓口サーバで「受信データ
形式エラー」が発生した。
オンライン窓口サーバで「対象とする証明書の認証局の電子署名検証エラー」が発生した。
オンライン窓口サーバで「対象とする証明書の有効性確認エラー」が発生した。
オンライン窓口サーバで「対象とする証明書のオンライン窓口エラー(OCSP)」が発生した。
対象とする証明書が失効済みである。
対象とする証明書が失効申請済みである。
オンライン窓口サーバで「オンライン
窓口エラー(DB)」が発生した。
オンライン窓口サーバが混雑している。
オンライン窓口サーバでエラーが発
生した。

１７

API 仕様書【個人認証サービス AP C 言語インターフェース編】第 4.6 版#

Define シンボル(定義名)値

解説

14 JPKI̲SERVER̲HOLD̲ERROR

613

15 JPKI̲SERVER̲CERT̲UNMATCH̲ER
ROR

622

16
17
18
19
20

700
701
702
703
704

対象とする証明書が一時保留状態である。
オンライン窓口サーバで「対象とする証明書と署名実施証明書の不一致エラー」が発生した。
ログインのキャンセル。
メモリ不足が発生した。
予期せぬエラーが発生した。
IC カードがロックされている。
IC カードに接続できない。※1705

対象とする証明書の解析失敗。

JPKI̲CLIENT̲LOGIN̲CANCEL
JPKI̲CLIENT̲NOMEMORY
JPKI̲CLIENT̲UNEXPECTED̲ERR
JPKI̲CLIENT̲ICCARD̲BLOCKED
JPKI̲CLIENT̲ICCARD̲NOT̲READ
Y
21 JPKI̲CLIENT̲FALSE̲DECODE̲CERT
22 JPKI̲CLIENT̲ONLINE̲TIME
23 JPKI̲CLIENT̲HTTP̲NOT̲ACCESS
24 JPKI̲CLIENT̲EXPIRED̲ERROR
25 JPKI̲CLIENT̲NOT̲YET̲VALID
26 その他

706
707

サーバ時刻の取得に失敗。
オンライン窓口サーバへのアクセスに失敗。
708
対象とする証明書の有効期限切れ。
709
対象とする証明書の有効期限開始の日付が未来の日時。
100〜500
HTTP1.1 ステータスコード(100〜500(200 を除く) 番台)。

（※1）MacOS 版の場合、住基カードが利用されている場合にも本エラーが発生する。
（６）JPKIGetCardType
API 名
概要
関数インタ
ーフェース

戻り値

引数

JPKIGetCardType
IC カードリーダライタに挿入されている IC カードの種別を取得する。
int JPKIGetCardType(
JPKI̲CardType *cardType);値
内容JPKI̲USER̲TRUE
正常終了
JPKI̲USER̲FALSE̲INVALID̲PARAM
引数に不正な値が設定されていた。
JPKI̲USER̲FALSE̲ICCARD̲NOT̲READ R/W 接続不備、IC カード未挿入等のY
ため IC カードに接続できない。
JPKI̲USER̲FALSE̲OTHER
その他システムエラーが発生した。
型
I/O
内容
JPKI̲CardType *
OUT
カード種別

１８

API 仕様書【個人認証サービス AP C 言語インターフェース編】第 4.6 版

第３節 構造体仕様（１）JPKI̲CertBinaryData
構造体名
概要
NO
変数名
1 len
2

data

JPKI̲CertBinaryData
電子証明書情報を格納する構造体。
型
値
備考
unsigned long
電子証明書データ長
unsigned char *電子証明書データ DER 形式とする。
の格納先ポインタ（２）JPKI̲BasicData
構造体名
概要
NO

JPKI̲BasicData
基本 4 情報を格納する構造体。

変数名

型

1

name

wchar̲t *2
3

address
genderwchar̲t *4

dateOfBirthchar *

5

substituteCharacterO
fName
substituteCharacterO
fAddresschar *

6char *

char *値
氏名

備考

UNICODE
大括弧「［ ］」内は旧氏を示す。
括弧「（ ）」内は通称を示す。
住所
UNICODE
性別
性別コード。
1:男 2:女 3:不明
生年月日
9 桁のコード（EYYYYMMDD）。
E：年号コード。
（1:明治 2:大正
3:昭和 4:平成
5:令和）
YYYY：西暦年
MM ：月（01〜12:1 月〜12 月
00:不明 A1:春
A2:夏 A3:秋 A4:冬）
DD ：日（01〜31:1 日〜31 日
00:不明 A1:上旬
A2:中旬 A3:下旬）
代 替 文 字 の 使 用 name と 同 じ 文 字 数 の 文 字（氏名）列。代替文字と同じ位置に
1、その他に 0 が入る。
代 替 文 字 の 使 用 address と同じ文字数の文（住所）字列。代替文字と同じ位置に
1、その他に 0 が入る。

１９

API 仕様書【個人認証サービス AP C 言語インターフェース編】第 4.6 版（３）JPKI̲CardType
構造体名
概要
NO
変数名
1 id

2

tokenInfo

JPKI̲CardType
IC カード種別情報を格納する構造体。
型
値
備考
int
カード種別
カード種別コード
0:不明
1:住基カード
2:個人番号カード
unsigned
TOKEN 情報TOKEN 情報char[32](サイズ 32byte、null 終端無し)
住基カードの場合："JPKIAPICCTOKEN △ △ △ △ △ △△△△△△△△△△△△△"
個人番号カードの場合："JPKIAPICCTOKEN2△△△△△△△△△△△△△△△△△"※△は半角スペースを表す

２０

API 仕様書【個人認証サービス AP C 言語インターフェース編】第 4.6 版

第４節 コーリングシーケンス
｢第４章

第２節

実現可能な機能の一覧｣を実現するためのコーリングシーケンスを以下に示す。上位アプリケーションは、このコーリングシーケンスに沿って実装すること。
（１）証明書表示処理
電子証明書を DER 形式で取得↓
電子証明書の表示
certData: 電子証明書格納領域アドレス

JPKICertViewDialog（２）基本 4 情報取得処理
署名用電子証明書を DER 形式で取得↓
基本 4 情報の取得
certData: 署名用電子証明書格納領域アドレス
basicData: 基本 4 情報格納領域アドレス↓
basicData から必要情報の取得↓
基本 4 情報格納領域の解放
basicData: 基本 4 情報格納領域アドレス

JPKIGetBasicData

JPKIFreeBasicData（３）官職証明書検証処理

JPKICertValid

官職証明書や職責証明書を DER 形式で取得↓
官職証明書や職責証明書の証明書検証
certData: 電子証明書格納領域アドレス
certPathStatus: 証明書検証（認証パスの構築および検証）の結果コード格納領域アドレス
responseStatus: OCSP レスポンスステータス格納領域ア
ドレス↓
結果コードの解析（４）有効性確認処理

JPKIConfirm

利用者証明書を DER 形式で取得↓
自分の電子証明書(利用者証明書)の有効性確認
certData: 利用者証明書格納領域アドレス↓
結果コードの解析

２１

API 仕様書【個人認証サービス AP C 言語インターフェース編】第 4.6 版（５）IC カード種別取得処理

JPKIGetCardType

IC カード種別を取得↓
IC カード種別取得
cardType: IC カード種別格納領域アドレス↓
Yes
cardType.id = 1
住基カード
↓ No
cardType.id = 2
↓ No
不明

２２

Yes

個人番号
カード

API 仕様書【個人認証サービス AP C 言語インターフェース編】第 4.6 版

第６章 画面仕様
第１節 画面一覧
表 ６-１ 画面一覧
NO
1

2

3

4

5

6

7

機能名
証明書表示
機能

画面名
概要
基本画面 署名用電子証 署名用電子証明書の基本情報を表示する。
明書[有効性確認]ボタンの押下により、自分の電子証
明書の有効性確認を行う。
[ファイル出力]ボタンの押下により、電子証明書の内容をファイルに出力する。
利用者証明用 利用者証明用電子証明書の基本情報を表示する。
電子証明書[有効性確認]ボタンの押下により、自分の電子証
明書の有効性確認を行う。
[ファイル出力]ボタンの押下により、電子証明書の内容をファイルに出力する。
認証局の自己 認証局の自己署名証明書(ルート認証局の自己署
署名証明書
名証明書,リンク証明書,下位認証局の自己署名
証明書,相互認証証明書,自己署名証明書等)の基
本情報を表示する。
[ファイル出力]ボタンの押下により、電子証明書の内容をファイルに出力する。
その他の電子 上記以外の証明書（官職証明書,職責証明書,その証明書
他の証明書）の基本情報を表示する。
[証明書検証]ボタン押下により、証明書の検証を行う。
[ファイル出力]ボタンの押下により、電子証明書の内容をファイルに出力する。
詳細画面
電子証明書内の全ての記載事項を表示する。
署名用電子証明書または利用者証明用電子証明書の場合、[有効性確認]ボタンの押下により、自分の電子証明書の有効性確認を行う。
その他の電子証明書の場合、[証明書検証]ボタン
押下により、証明書の検証を行う。
[ファイル出力]ボタンの押下により、電子証明書の内容をファイルに出力する。
官職証明書・職責証明書 その他の電子証明書（基本／詳細）画面にて、[証検証画面
明書検証]ボタンを押下し、証明書検証を行い、証明書検証結果を表示する。
利用者証明書有効性確認 署名用電子証明書（基本／詳細）画面または利用
画面
者証明用電子証明書（基本／詳細）画面にて、[有効性確認]ボタンを押下して有効性確認を行い、有効性確認結果を表示する。

２３

API 仕様書【個人認証サービス AP C 言語インターフェース編】第 4.6 版

第２節 画面仕様詳細（１）署名用電子証明書基本画面
画面名
概要

署名用電子証明書基本画面
署名用電子証明書の基本情報を表示する。
画面レイアウト

①
②
③
④
⑤
⑥
⑦
⑧
⑨
⑩
⑪
⑫

⑬

⑭

⑮
表示項目と証明書領域の対応は、表 ６-２を参照。
画面項目説明NO
項目名① 終了ボタン② タイトル

③
④

タブ
氏名*1

⑤

代替文字の使用（氏名）*1
生年月日
性別

⑥
⑦

概要
証明書 Viewer を閉じる。
表示する電子証明書の種類を表示する。
表示テキストは以下の通りとする。
「公的個人認証サービス 利用者の署名用電子証明書」
基本画面と詳細画面を切り替える。
利用者の氏名を表示する。大括弧「［ ］」内は旧氏を示す。括弧「（ ）」内は通称を示す。最大 100 文字まで表示可能。画面上に表示しきれない場合は、カーソルを移動することにより、表示欄のスクロールを可能とする。
氏名の代替文字を表示する。最大 100 文字まで表示可能。代替
文字がない場合は、表示しない。
利用者の生年月日を和暦で表示する。
利用者の性別（男/女/不明）を表示する。

２４

API 仕様書【個人認証サービス AP C 言語インターフェース編】第 4.6 版

NO
項目名⑧ 住所*1

⑨
⑩
⑪
⑫
⑬

⑭

⑮

概要
利用者の住所を表示する。最大 200 文字まで表示可能。画面上に表示しきれない場合は、カーソルを移動することにより、表示欄のスクロールを可能とする。
代替文字の使用
住所の代替文字を表示する。最大 200 文字まで表示可能。代替*1（住所）
文字がない場合は、表示しない。
発行年月日
電子証明書の発行年月日を和暦で表示する。
有効期間の満了日 電子証明書の有効期間の満了日を和暦で表示する。
発行者
電子証明書の発行者を表示する。
ファイル出力ボタ [ファイル出力]ボタンを押下することによって電子証明書の内ン
容をファイルに出力する。出力様式は以下の 2 通り。
・電子証明書を DER 形式のファイルとして出力する。拡張子は*.cer とする。
・画面表示内容をテキスト形式のファイルとして出力する。拡
張子は*.txt とする。
有効性確認ボタン [有効性確認]ボタンを押下することによって、公的個人認証サービス AP の自分の電子証明書の有効性確認機能を呼び出し、オンライン窓口サービスに有効性確認の問い合わせを行う。
自分の電子証明書の有効性確認機能の戻り値を判断して有効性確認結果ダイアログを表示する。
ステータスバー
有効性確認状態を以下のように表示する。
確認前：電子証明書の有効性確認は行われていません。
確認後：有効性確認結果：「有効」
有効性確認結果：「有効期限切れ」
有効性確認結果：「失効済み」
有効性確認結果：「失効申請受理済み」
有効性確認結果：「一時保留」
有効性確認結果：「確認失敗(xxxxxx)」「xxxxxx」は原因を示すエラーコード。詳細は、表 ６-１０を参照。

２５API 仕様書【個人認証サービス AP C 言語インターフェース編】第 4.6 版

表 ６-２ 表示項目と証明書領域の対応（署名用電子証明書）
項
項目名
番
1 氏名

2

代替文字の
使用(氏名)

3
4
5
6

生年月日
性別
住所
代替文字の
使用(住所)

7
8

発行年月日
有効期間の
満了日
発行者

9

証明書の項目名
上位項目名
項目名
SubjectAlt- CommonName
Name

Validity

IssuerAltName

表示方法

設定値をそのまま表示。
大括弧「［ ］」内は旧氏を示す。
括弧「（ ）」内は通称を示す。
Substitute・代替文字を「鍵括弧」付で表示。
CharacterOf・代替文字が複数ある場合は代替文字※1
CommonName
を続けて表示。
例) 「吉」「郎」は代替文字です。
・同じ代替文字が続いた場合は、繰り返し表示。
例）「吉」「吉」は代替文字です。
※2
dateOfBirth
設定値を和暦に変換して表示。
gender※3
設定値を日本語表記に変換して表示。
address
設定値をそのまま表示。
Substitute・代替文字を「鍵括弧」付で表示。
CharacterOf・代替文字が複数ある場合は代替文字
Address※1
を続けて表示。
例) 「葛」「飾」は代替文字です。
・代替文字が続いた場合は、繰り返し表示。
例）「葛」「葛」は代替文字です。
NotBefore
設定値を和暦(日本標準時)に変換して表示。書式は「ＧＧ YY 年 MM 月 DD 日」
notAfter(ＧＧは元号、時分秒は表示せず。)
Organizational- 設定値をそのまま表示。
UnitName

２６API 仕様書【個人認証サービス AP C 言語インターフェース編】第 4.6 版※1 代替文字の設定ルール(ⅰ) 表記ルール
1.

代替文字を”1”、それ以外を”0”で表現する。

2.

スペースも 1 文字として捉え、ルール 1 を適用する。

(ⅱ)表記例
項目名 設定値

代替文字使用位置の値 説明

氏名

吉田△太郎

10000

住所

東 京 都 葛 飾 区 ｘ ｘ 000100000
ｘ

氏名の長さは 5 文字
1 文字目の「吉」が代替文字
住所の長さは 9 文字
4 文字目の「葛」が代替文字△は全角スペース※2 生年月日の設定ルール(ⅰ) コード体系
英数字型
E

9桁

EYYYYMMDD：年号コード

1 桁（1:明治

2:大正

3:昭和

4:平成

5:令和）

YYYY ：西暦年

4桁

MM

：月

2 桁（01〜12:1 月〜12 月

00:不明

A1:春

A2:夏

DD

：日

2 桁（01〜31:1 日〜31 日

00:不明

A1:上旬

例

生年月日の値

表

記

通常

420030401

平成 15 年 4 月 1 日

年号のはざまの日

219261225

大正 15 年 12 月 25 日

319261225

昭和元年 12 月 25 日(ⅱ) 表記例

年月日不明

000000000

月日不明

319260000

昭和元年

31926A100

昭和元年春319261200

昭和元年 12 月

3192612A2

昭和元年 12 月中旬

日不明※3 性別の設定ルール(ⅰ) コード体系
英数字型
X

1桁

X

：性別コード 1 桁

（1:男

2:女

２７

3:不明）

A3:秋

A2:中旬

A4:冬）

A3:下旬）

API 仕様書【個人認証サービス AP C 言語インターフェース編】第 4.6 版（２）利用者証明用電子証明書基本画面
画面名
概要

利用者証明用電子証明書基本画面
利用者証明用電子証明書の基本情報を表示する。
画面レイアウト
①
②
③
④

⑤
⑥
⑦

⑧

⑨

⑩

表示項目証明書領域の対応は、表 ６-３を参照。
画面項目説明NO
項目名① 終了ボタン② タイトル③ タブ④ 主体者⑤ 発行年月日⑥ 有効期間の満了日
⑦ 発行者

概要
証明書 Viewer を閉じる。
表示する電子証明書の種類を表示する。
表示テキストは以下の通りとする。
「公的個人認証サービス 利用者の利用者証明用電子証明書」
基本画面と詳細画面を切り替える。
主体者を表示する。
設定値が 1 行で収まらない場合は、折り返して表示する。
電子証明書の発行年月日を和暦で表示する。
電子証明書の有効期間の満了日を和暦で表示する。
電子証明書の発行者を表示する。
設定値が 1 行で収まらない場合は、折り返して表示する。

２８

API 仕様書【個人認証サービス AP C 言語インターフェース編】第 4.6 版

NO
項目名
概要
⑧ ファイル出力ボタ [ファイル出力]ボタンを押下することによって電子証明書
ンの内容をファイルに出力する。出力様式は以下の 2 通り。
・電子証明書を DER 形式のファイルとして出力する。拡張子は*.cer とする。
・画面表示内容をテキスト形式のファイルとして出力する。
拡張子は*.txt とする。
⑨ 有効性確認ボタン [有効性確認]ボタンを押下することによって、公的個人認証サービス AP の自分の電子証明書の有効性確認機能を呼び出し、オンライン窓口サービスに有効性確認の問い合わせを行う。
自分の電子証明書の有効性確認機能の戻り値を判断して有効性確認結果ダイアログを表示する。
⑩ ステータスバー
有効性確認状態を以下のように表示する。
確認前：電子証明書の有効性確認は行われていません。
確認後：有効性確認結果：「有効」
有効性確認結果：「有効期限切れ」
有効性確認結果：「失効済み」
有効性確認結果：「失効申請受理済み」
有効性確認結果：「一時保留」
有効性確認結果：「確認失敗(xxxxxx)」「xxxxxx」は原因を示すエラーコード。詳細は、表 ６-１０
を参照。

表 ６-３ 表示項目と証明書領域の対応（利用者証明用電子証明書）
項
番

項目名

証明書の項目名
上位項目名
項目名
SubjectAltCountryName
Name
OrganizationalUnitName
または例) 利用者証明用電子証
Subject
明書の場合

1

主体者

2
3

発行年月日
有効期間の
満了日

Validity

4

発行者

IssuerAltName
またはIssuer

表示方法

SubjectAltName の DN を全て表示。
DN は属性毎に改行して表示し、｢(属性名の略語)＝(設定値)｣にて表記。
subjectAltName に記述がない場
合は subject を表示。
notBefore
設定値を和暦(日本標準時)に変換して表示。書式は「ＧＧ YY 年
notAfterMM 月 DD 日」(ＧＧは元号、時分秒は表示せず。)
CountryName
IssuerAltName の DN を全て表示。
OrganizationName
DN は属性毎に改行して表示し、OrganizationalUnitName ｢(属性名の略語)＝(設定値)｣にOrganizationalUnitName て表記。
例) 利用者証明用電子証 issuerAltName に記述がない場合
明書の場合
は issuer を表示。

２９

API 仕様書【個人認証サービス AP C 言語インターフェース編】第 4.6 版（３）認証局の自己署名証明書基本画面
画面名
概要

認証局の自己署名証明書基本画面
認証局の自己署名証明書の基本情報を表示する。
画面レイアウト
①
②
③
④

⑤
⑥
⑦

⑧

⑨
⑩

表示項目証明書領域の対応は、表 ６-４を参照。
画面項目説明
NO
①
②

項目名
終了ボタン
タイトル

③
④

タブ
主体者

⑤
⑥

発行年月日
有効期間の満了日

概要
証明書 Viewer を閉じる。
表示する電子証明書の種類を表示する。
表示テキストは以下の通りとする。
・都道府県知事の自己署名証明書および署名用認証局の自己署
名証明書の場合「公的個人認証サービス 署名用認証局の電子証明書」
・利用者証明用認証局の自己署名証明書の場合「公的個人認証サービス 利用者証明用認証局の電子証明書」
・上記以外の認証局の自己署名証明書の場合「認証局の電子証明書」
基本画面と詳細画面を切り替える。
主体者を表示する。
設定値が 1 行で収まらない場合は、折り返して表示する。
電子証明書の発行年月日を和暦で表示する。
電子証明書の有効期間の満了日を和暦で表示する。
３０

API 仕様書【個人認証サービス AP C 言語インターフェース編】第 4.6 版

NO
⑦
⑧
⑨

⑩

項目名
発行者

概要
電子証明書の発行者を表示する。
設定値が 1 行で収まらない場合は、折り返して表示する。
sha1 ま た は 、 電 子 証 明 書 の 署 名ア ルゴ リ ズ ム に よ っ て「 sha1 」 ま た は 、sha256「sha256」ハッシュ値を表示する。
ファイル出力ボタ [ファイル出力]ボタンを押下することによって電子証明書の内ン
容をファイルに出力する。出力様式は以下の 2 通り。
・電子証明書を DER 形式のファイルとして出力する。拡張子は*.cer とする。
・画面表示内容をテキスト形式のファイルとして出力する。拡
張子は*.txt とする。
ステータスバー
使用せず。

表 ６-４ 表示項目と証明書領域の対応（認証局の自己署名証明書）
項
番

項目名

証明書の項目名
上位項目名
SubjectAltName
またはSubject

1

主体者

2

発行年月
日
有効期間
の満了日
発行者

Validity

フィンガ
ープリン
ト

−

3
4

5

IssuerAltName
またはIssuer

項目名CountryName
OrganizationName
OrganizationalUnitName
OrganizationalUnitName
例) 署名用認証局の自己署
名証明書の場合
notBefore

表示方法

SubjectAltName の DN を全て表示。
DN は属性毎に改行して表示し、｢(属性名の略語)＝(設定値)｣にて表記。
subjectAltName に記述がない場合
は subject を表示。
設定値を和暦(日本標準時)に変換して表示。書式は「ＧＧ YY 年 MM
月 DD 日」(ＧＧは元号、時分秒はnotAfter
表示せず。)CountryName
IssuerAltName の DN を全て表示。
OrganizationName
DN は属性毎に改行して表示し、OrganizationalUnitName｢(属性名の略語)＝(設定値)｣にて
OrganizationalUnitName
表記。
例) 署名用認証局の自己署 issuerAltName に記述がない場合
名証明書の場合は issuer を表示。
−
電子証明書のハッシュ値を計算して表示。ハッシュ関数は電子証明書の署名アルゴリズムによって「sha1」または「sha256」を使用する。

３１

API 仕様書【個人認証サービス AP C 言語インターフェース編】第 4.6 版（４）その他の電子証明書基本画面
画面名
概要

その他の電子証明書基本画面
利用者証明書、認証局の自己署名証明書以外の電子証明書の基本情報を表示する。
画面レイアウト

①
②
③
④

⑤
⑥
⑦

⑧

⑨

⑩

表示項目と証明書領域の対応は、表 ６-５を参照。
画面項目説明NO
項目名① 終了ボタン② タイトル

③
④

タブ
主体者

⑤
⑥
⑦

発行年月日
有効期間の満了日
発行者

概要
証明書 Viewer を閉じる。
表示する電子証明書の種類を表示する。
表示テキストは以下の通りとする。
「電子証明書」
基本画面と詳細画面を切り替える。
主体者を表示する。
設定値が 1 行で収まらない場合は、折り返して表示する。
（単語
途中であっても折り返しを行う仕様とする。
）
電子証明書の発行年月日を和暦で表示する。
電子証明書の有効期間の満了日を和暦で表示する。
電子証明書の発行者を表示する。
設定値が 1 行で収まらない場合は、折り返して表示する。
（単語
途中であっても折り返しを行う仕様とする。
）
３２

API 仕様書【個人認証サービス AP C 言語インターフェース編】第 4.6 版

NO
⑧

⑨

⑩

項目名
概要
ファイル出力ボタ [ファイル出力]ボタンを押下することによって電子証明書の内ン
容をファイルに出力する。出力様式は以下の 2 通り。
・電子証明書を DER 形式のファイルとして出力する。拡張子は*.cer とする。
・画面表示内容をテキスト形式のファイルとして出力する。拡
張子は*.txt とする。
証明書検証ボタン [証明書検証]ボタンを押下することによって、公的個人認証サービス AP の官職証明書検証機能を呼び出し、官職証明書検証サービスに証明書検証の問い合わせを行う。
官職証明書検証機能の戻り値を判断して官職証明書・職責証明書検証ダイアログを表示する。
ステータスバー
証明書検証状態を以下のように表示する。
検証前：電子証明書の検証は行われていません。
検証後：証明書検証結果「有効」
証明書検証結果「無効（xxxxxx）」
証明書検証結果「検証失敗（xxxxxx）」「xxxxxx」は原因を示すエラーコード。詳細は、表 ６-８、表６-９を参照。

表 ６-５ 表示項目と証明書領域の対応（官職証明書／職責証明書／その他の証明書）
項
項目名
番
1 主体者

証明書の項目名
上位項目名
項目名
SubjectAlt- CountryName
Name
OrganizationName
またはOrganizationalUnitName
Subject
CommonName
例)官職証明書の場合

2
3

発行年月日
有効期間の
満了日

Validity

notBefore
notAfter4

発行者

IssuerAltName
またはIssuer

5

フィンガー
プリント

−

CountryName
OrganizationName
OrganizationalUnitName
OrganizationalUnitName
例)官職証明書の場合
−

３３

表示方法
SubjectAltName の DN を全て表示。
DN は属性毎に改行して表示し、｢(属性名の略語)＝(設定値)｣にて表記。subjectAltName に記述がない場合は subject を表示。
設定値を和暦(日本標準時)に変換して表示。書式は「ＧＧ YY 年
MM 月 DD 日」(ＧＧは元号、時分秒は表示せず。)
IssuerAltName の DN を全て表示。
DN は属性毎に改行して表示し、｢(属性名の略語)＝(設定値)｣にて表記。issuerAltName に記述がない場合は issuer を表示。
認証局の自己署名証明書の場合のみ表示。
電子証明書のハッシュ値を計算して表示。ハッシュ関数は電子証
明書の署名アルゴリズムによって「sha1」または「sha256」を使用する。

API 仕様書【個人認証サービス AP C 言語インターフェース編】第 4.6 版（５）詳細画面
画面名
概要

詳細画面
電子証明書内の全ての記載事項を表示する。
画面レイアウト

①
②
③

④

⑤

⑥

⑦

⑧

⑨

表示項目と証明書領域の対応は、表 ６-６、表 ６-７を参照。
画面項目説明NO
項目名① 終了ボタン概要
証明書 Viewer を閉じる。

３４

API 仕様書【個人認証サービス AP C 言語インターフェース編】第 4.6 版

NO
②

③
④

⑤

⑥

⑦

⑧

項目名
タイトルバー

概要
表示する電子証明書の種類を表示する。
表示テキストは以下の通りとする。
・住基カードに格納された署名用電子証明書および個人番号カードに格納された署名用電子証明書の場合「公的個人認証サービス 利用者の署名用電子証明書」
・個人番号カードに格納された利用者証明用電子証明書の場合「公的個人認証サービス 利用者の利用者証明用電子証明書」
・都道府県知事の自己署名証明書および署名用認証局の自己署
名証明書の場合「公的個人認証サービス 署名用認証局の電子証明書」
・利用者証明用認証局の自己署名証明書の場合「公的個人認証サービス 利用者証明用認証局の電子証明書」
・上記以外の認証局の自己署名証明書の場合「認証局の電子証明書」
・上記以外の証明書の場合「電子証明書」
タブ
基本画面と詳細画面を切り替える。
設定値の簡易表記 電子証明書内の記載事項を表示する。
フィールドにて、表示しきれないものは、縦スクロールバー、
横スクロールバーを移動することによって表示する。
フィールド名と値の詳細は、｢表 ６-６ 項目名と証明書基本領域との対応｣と｢表 ６-７ 項目名と証明書標準拡張領域との対応｣の簡易表記を参照。
設定値の詳細表記 選択したフィールドの設定値を表示する。
折り返し表示とし、横スクロールバーは表示しない。
フィールド名と値の詳細は、｢表 ６-６ 項目名と証明書基本領域との対応｣と｢表 ６-７ 項目名と証明書標準拡張領域との対応｣の詳細表記を参照。
sha1 ま た は 、 電 子 証明 書 の署 名 アルゴ リ ズム に よっ て 「sha1 」 ま たは 、sha256「sha256」ハッシュ値を表示する。
ファイル出力ボタ [ファイル出力]ボタンを押下することによって電子証明書の内ン
容をファイルに出力する。出力様式は以下の 2 通り。
・電子証明書を DER 形式のファイルとして出力する。拡張子は*.cer とする。
・画面表示内容をテキスト形式のファイルとして出力する。拡
張子は*.txt とする。
有効性確認ボタン 利用者証明書の場合は有効性確認ボタンを表示する。
（有効性確／証明書検証ボタ 認機能については、（１）署名用電子証明書の画面項目説明を参ン
照。）
官職証明書／職責証明書の場合は証明書検証ボタンを表示する。（証明書検証機能については、（４）その他の電子証明書の画面項目説明を参照。）

３５

API 仕様書【個人認証サービス AP C 言語インターフェース編】第 4.6 版

NO
⑨

項目名
ステータスバー

概要
利用者証明書の場合は有効性確認結果を表示する。
（ステータスバーの概要については、（１）署名用電子証明書の画面項目説明を参照。）
官職証明書／職責証明書の場合は証明書確認結果を表示する。
（ステータスバーの概要については、（４）その他の電子証明書の画面項目説明を参照。
）

表 ６-６ 項目名と証明書基本領域との対応
NO

項目名

1
2

バージョン
シリアル番
号
署名アルゴ
リズム
発行者

3
4

5
6
7

発行年月日
有効期間の
満了日
主体者*1

証明書の項目名
上位項目名
項目名
versionserialNumber

表示方法
簡易表記
詳細表記
Version 表記。Version3 は“V3”とする。
設定値をそのまま表示。

signaturealgorithm
parameterscountryNameorganizationNameorganizationalUni
tName等

algorithm の OID を RFC の規定値に変換した値。
DN をカンマ区切り DN を属性毎に改行。各表示。「（設定値）, 行は「（属性の略語）=（設定値),･･･」。
（設定値）」にて表記。
<属性の略語>「countryName」→C「organizationName」→O「organizationalUnit
Name」
→OU

Validity

notBefore
notAfter

設定値を西暦（日本標準時）で表示。書式は「YYYY 年 MM 月 DD 日 hh 時 mm 分 ss 秒」。

subject

countryName
localityName
commonName
等

DN をカンマ区切り表示。「（設定値）,（設定値）,･･･」。
commonName が発行要求発生時刻の場合は、設定値をそのまま表示。

issuer

３６

DN を属性毎に改行。各行は「（属性の略語）=（設定値）」にて表記。
<属性の略語>「countryName」→C「localityName」→L「commonName」→CN
commonName が発行要求発生時刻の場
合は、設定値をそのまま表示。

API 仕様書【個人認証サービス AP C 言語インターフェース編】第 4.6 版
NO
8
9
10
11
12
13
14
15

証明書の項目名
上位項目名
項目名
発 行 申 請 送 subject
commonName
信時刻*2
のみが表示対象
受付端末識
別記号*2
発 行 申 請 送 subject
commonName*3
信時刻のみが表示対象
シーケンス
番号*3
受付端末識
別記号*3
ラ ン ダ ム 文 subject
commonName
字列*4のみが表示対象
受付端末識
別記号*4
主体者の公 subjectPub algorithm
開鍵情報
licKeyInfo subjectPublicKey
項目名

16 発行者ユニ
ーク識別子
17 主体者ユニ
ーク識別子

表示方法

issuerUniqueID

簡易表記
詳細表記
commonName から発行申請送信時刻を抜き出して表示。
commonName から受付端末識別記号を抜き出して表示。
commonName から発行申請送信時刻を抜き出して表示。
commonName からシーケンス番号を抜き出して表示。
commonName から受付端末識別記号を抜き出して表示。
commonName からランダム文字列を抜き出して表示。
commonName から受付端末識別記号を抜き出して表示。
暗号アルゴリズムと SubjectPublicKey の鍵長を表示。書式は 設定値（１６進数）を「(algorithm の OID そのまま表示。
を RFC の規定値に変換した値)＋(鍵長)Bits」。
設定値をそのまま表示。

subjectUniqueID

設定値をそのまま表示。

*1：利用者証明書以外の場合*2：住基カードに格納された署名用電子証明書の場合*3：個人番号カードに格納された署名用電子証明書の場合*4：個人番号カードに格納された利用者証明用電子証明書の場合

３７

API 仕様書【個人認証サービス AP C 言語インターフェース編】第 4.6 版

表 ６-７ 項目名と証明書標準拡張領域との対応

NO
1

2

3

4

項目名

証明書の項目名

表示方法

上位項目名
項目名
認証局鍵識 AuthorityK keyIdentifier
別子
eyIdentifi authorityCertIssueerrauthorityCertSeria
lNumber

簡易表記
詳細表記
AuthorityKeyIdenti AuthorityKeyIdentifi
fier の情報を項目
er の情報を項目毎に毎にカンマ区切り表 階層表示。なお、表示示。なお、表示の際 の際は以下のルールをは以下のルールを適 適用する。
用する。
・項目名は英語のま・項目名は英語のまま。
ま。
・OID は RFC の規定値
・OID は RFC の規定
に変換。
値に変換。
・DN は属性毎に改行。
鍵用途
KeyUsage
digitalSignature
KeyUsage の情報を
KeyUsage の情報を項
nonRepudiation
項目毎にカンマ区切 目毎に階層表示。なお、
keyEncipherment
り表示。なお、表示 表示の際は以下のルー
dataEnciphermentの際は以下のルール ルを適用する。
keyAgreementを適用する。
・項目名は英語のまkeyCertSign
・項目名は英語のまま。
cRLSign
ま。
・OID は RFC の規定値
encipherOnly
・OID は RFC の規定に変換。
decipherOnly
値に変換。
・KeyUsage のビット
・KeyUsage のビッ
列は、鍵用途の英語名
ト列は、鍵用途の に変換してカンマ区
英語名に変換して 切り表示。
カンマ区切り表示。
主体者代替 SubjectAlt countryName
SubjectAltName のSubjectAltName の情
名NameorganizationName
情報を項目毎にカン 報を項目毎に階層表
organizationalUnit マ区切り表示。なお、 示。なお、表示の際はName
表示の際は以下のル 以下のルールを適用す
等
ールを適用する。
る。
・項目名は英語のま ・項目名は英語のまま。
ま。
・OID は RFC の規定 ・OID は RFC の規定値
値に変換。
に変換。
発行者代替 issuerAltN countryName
issuerAltName の情 issuerAltName の情報
名
ameorganizationName
報を項目毎にカンマ を項目毎に階層表示。
organizationalUnit 区切り表示。なお、 なお、表示の際は以下Name
表示の際は以下のル のルールを適用する。
等ールを適用する。
・項目名は英語のま・項目名は英語のまま。
ま。
・OID は RFC の規定値
・OID は RFC の規定 に変換。
値に変換。

３８

API 仕様書【個人認証サービス AP C 言語インターフェース編】第 4.6 版

NO

項目名

5

基本制約

6

CRL 分配点

7

証明書ポ
リシー

8

主体者鍵
識別子

証明書の項目名

表示方法

上位項目名
項目名
BasicConst cA
rains
pathLenConstraint

簡易表記
詳細表記
BasicConstrains の BasicConstrains の情報を項目毎にカン 情報を項目毎に階層
マ区切り表示。なお、 表示。なお、表示の際表示の際は以下のル は以下のルールを適ールを適用する。
用する。
・項目名は英語のま ・項目名は英語のまま。
ま。
・OID は RFC の規定 ・OID は RFC の規定値
値に変換。
に変換。
CRLDistrib countryName
CRLDistributionPoi CRLDistributionPoin
utionPoint organizationName
nts の情報を項目毎 ts の情報を項目毎に
sorganizationalUnit にカンマ区切り表
階層表示。なお、表示Name示。なお、表示の際 の際は以下のルール
等は以下のルールを適 を適用する。
用する。
・項目名は英語のま・項目名は英語のまま。
ま。
・OID は RFC の規定値
・OID は RFC の規定
に変換。
値に変換。
・DN は属性毎に改行。
Certificat policyIdentifier
CertificatePolicie CertificatePolicies
ePolicies policyQualifierss の情報を項目毎に の情報を項目毎に階層
カンマ区切り表示。 表示。なお、表示の際
なお、表示の際は以 は以下のルールを適用
下のルールを適用す する。
る。
・項目名は英語のま・項目名は英語のまま。
ま。
・OID は RFC の規定値
・OID は RFC の規定
に変換。
値に変換。
SubjectKey keyIdentifier
SubjectKeyIdentifi SubjectKeyIdentifier
Identifierer の情報を項目毎の情報を項目毎に階層にカンマ区切り表表示。なお、表示の際示。なお、表示の際 は以下のルールを適用
は以下のルールを適 する。
用する。
・項目名は英語のま・項目名は英語のまま。
ま。
・OID は RFC の規定値
・OID は RFC の規定 に変換。
値に変換。

３９

API 仕様書【個人認証サービス AP C 言語インターフェース編】第 4.6 版

NO
9

項目名

証明書の項目名

表示方法

上位項目名
項目名
拡張鍵用途 ExtKeyUsag serverAutheclientAuth
codeSigningemailProtection
ipsecEndSystem
ipsecTunnel
ipsecUser
timeStamping

４０

簡易表記
ExtKeyUsage の情報を項目毎にカンマ区
切り表示。なお、表示の際は以下のルールを適用する。
・項目名は英語のまま。
・OID は RFC の規定
値に変換。

詳細表記
ExtKeyUsage の情報を項目毎に階層表示。な
お、表示の際は以下のルールを適用する。
・項目名は英語のまま。
・OID は RFC の規定値に変換。

API 仕様書【個人認証サービス AP C 言語インターフェース編】第 4.6 版（６）官職証明書・職責証明書検証画面
画面名
概要

官職証明書・職責証明書検証画面
その他の電子証明書（基本／詳細）画面にて、[証明書検証]ボタンを押下し、証明書検証を行い、証明書検証結果を表示する。
画面レイアウト②①③④

画面項目説明
NO

項目名

①
②
③

タイトルバー
終了ボタン
証明書検証結果

④

ＯＫボタン

概要
表示テキストは「検証結果：官職証明書検証」とする。
官職証明書・職責証明書検証画面を閉じる。
証明書検証が終了した場合、以下のメッセージを表示する。
証明書が有効の場合：証明書検証結果「有効」
証明書が無効の場合：証明書検証結果「無効（xxxxxx）」（無効の場合とは、証明書検証結果が失敗した場合を示す。
）
証明書検証処理が失敗した場合：証明書検証結果「検証失敗（xxxxxx）」（検証失敗とは、証明書検証が行えなかった場合を示す。）「xxxxxx」は原因を示すエラーコード。詳細は、表 ６-８、表６-９を参照。
官職証明書・職責証明書検証画面を閉じる。

４１

API 仕様書【個人認証サービス AP C 言語インターフェース編】第 4.6 版＜メッセージの詳細＞
表 ６-８ 証明書検証結果「無効」の場合のエラーコード一覧
内容

意味

1
2

エラー
コード
100101100202

認証パス構築不可(101)
署名不正(202)

3

100203

失効証明書を含む(203)4100204

ポリシー不一致(204)5100205

制約違反(205)

61002067100301OCSP での証明書検証確
認不正(206)
アルゴリズム拒否(301)8100302

アルゴリズム拒否(302)9100901

要求受付け拒否(901)認証パス構築ができないこと。
認証パスに署名が不正である証明書が含まれていること。
認証パスに失効した証明書が含まれていること。
認証パスにポリシーが一致しない証明書が含まれていること。
認証パスに制約に違反している証明書が含まれていること。
認証パスに OCSP での certStatus が unknownと応答される証明書が含まれていること。
官職証明書検証サーバ(CVS)側で検証対象証
明書の受け付けを拒否されたこと。
官職証明書検証サーバ(CVS)側で中間証明書
または都道府県知事の自己署名証明書の受け付けを拒否されたこと。
官職証明書検証サーバ(CVS)側で要求の受け付が拒否されたこと。

NO

注：( )中のコードは certPathStatus を示す。
表 ６-９ 証明書検証結果「検証失敗」の場合のエラーコード一覧

1

エラー
コード
100902

タイムアウト(902)2200100

署名検証失敗3

2002004300100証明書が改竄または、有
効期限切れ
接続失敗

5

300200拡張領域の解析に失敗

6300300その他のエラー発生のため証明書検証の確認
不可

NO

内容

意味
要求がタイムアウトとなったこと。( )中のコ
ードは certPathStatus を示す。

４２

受信した OCSP レスポンスデータが改竄されていること。
OCSP レスポンスに付与されている電子証明書が改竄または有効期限切れである。
ネットワークの問題で通信できなかった。
LAN 環境からプロキシサーバを使用している
場合は、Internet Explorer の LAN の設定又は、システムのプロキシ情報の指定に誤りがある。
官職証明書検証サーバ(CVS)に接続していな
い。環境設定ファイルの CVS 接続先 URL をもう一度見直してください。
・ 環境設定ファイルに CVS 接続先 URL が指定されていない又は、環境設定ファイルが存在しない。
・ その他の内部エラーが発生。

API 仕様書【個人認証サービス AP C 言語インターフェース編】第 4.6 版

7

エラー
コード
30040084000019101140000240000340000512400006

NO内容

意味

証明書の取得失敗

OCSP Request のフォーマットエラー(1)
内部エラー (2)
一時的な解答不能(3)OCSP Request への署名が必要(5)クライアントが認証されていない(6)・ IC カードの PIN 入力でキャンセルされた
場合。
・ IC カードリーダライタに IC カードがセッ
トされていない場合。
・ IC カードリーダライタが PC に接続されていない場合。※1
官職証明書検証サーバ(CVS）で例外が発生
・ 検証要求を行う官職証明書検証サーバ(CVS）の検証依頼者認証が必要であるか確認してください。
・ 署名に使用した電子証明書が X.509 バー
ジョン 3 の電子証明書であるかを確認してください。

注：( )中のコードは responseStatus を示す。
（※1）MacOS 版の場合、住基カードが利用されている場合にも本エラーが発生する。

４３

API 仕様書【個人認証サービス AP C 言語インターフェース編】第 4.6 版（７）利用者証明書有効性確認画面
画面名
概要

利用者証明書有効性確認画面
電子証明書（基本／詳細）画面にて、[有効性確認]ボタンを押下し、有効性確認を行い、有効性確認結果を表示する。
画面レイアウト②①③④

画面項目説明
NO

項目名

①
②
③

タイトルバー
終了ボタン
有効性確認結果

④

ＯＫボタン

概要
表示テキストは「確認結果：有効性確認」とする。
利用者証明書有効性確認画面を閉じる。
有効性確認結果が終了した場合、以下のメッセージを表示する。
対象とする証明書が有効の場合：有効性確認結果「有効」
対象とする証明書の有効期限が切れている場合：有効性確認結果「有効期限切れ」
対象とする証明書が失効済みの場合：有効性確認結果「失効済み」
対象とする証明書のオンライン失効申請を行った場合：有効性確認結果「失効申請受理済み」
対象とする証明書が一時保留状態の場合：有効性確認結果「一時保留」
有効性確認処理が失敗した場合：有効性確認結果「確認失敗（xxxxxx）」（確認失敗とは、有効性確認が行えなかった場合を示す。）「xxxxxx」は原因を示すエラーコード。詳細は、表 ６-１０を参照。
利用者証明書有効性確認画面を閉じる。

４４

API 仕様書【個人認証サービス AP C 言語インターフェース編】第 4.6 版＜メッセージの詳細＞
表 ６-１０ 有効性確認結果「確認失敗」のエラーコード一覧

1

エラー
コード
1006002100604

対象とする証明書の認証局の電子署名検証エラー

3100605

対象とする証明書の有効性確認エラー

4200601

申請情報取込エラー

5

200602

対象とする証明書の有効期限
切れエラー

6

200603

受信データ形式エラー

7

200609オンライン窓口エラー（DB）

8

200611

オンライン窓口混雑

9200612

オンライン窓口エラー

10

200622

対象とする証明書と署名実施証明書の不一致エラー

11200652

署名実施証明書の有効期間外
エラー

12200654

署名実施証明書の認証局の電子署名検証エラー13

200655

署名実施証明書の有効性確認
エラー

14200656

オンライン窓口エラー(OCSP)

15

20065716

200658

署名実施証明書の失効済みエラー
署名実施証明書の失効申請受
理済みエラー17

200663

NO

内容

意味

申請書の電子署名検証エラー

オンライン窓口サーバで「申請書の電子署名検証エラー」が発生した。
オンライン窓口サーバで「対象とする証明書の認証局の電子署名検証エラー」が発生した。
オンライン窓口サーバで「対象とする証明書の有効性確認エラー」が発生した。
オンライン窓口サーバで「申請情報取込エラー」が発生した。
オンライン窓口サーバで「対象とする証明書の有効期限切れエラー」が発生した。
オンライン窓口サーバで「受信データ
形式エラー」が発生した。
オンライン窓口サーバで「オンライン
窓口エラー(DB)」が発生した。
オンライン窓口サーバが混雑している。
オンライン窓口サーバでエラーが発生した。
オンライン窓口サーバで「対象とする証明書と署名実施証明書の不一致エラー」が発生した。
オンライン窓口サーバで「署名実施証
明書の有効期間外エラー」が発生した。

署名実施証明書の一時保留状
態エラー

４５

オンライン窓口サーバで「署名実施証
明書の認証局の電子署名検証エラー」が発生した。
オンライン窓口サーバで「署名実施証
明書の有効性確認エラー」が発生した。
オンライン窓口サーバで「オンライン
窓口エラー(OCSP)」が発生した。
オンライン窓口サーバで「署名実施証
明書の失効済みエラー」が発生した。
オンライン窓口サーバで「署名実施証
明書の失効申請受理済みエラー」が発生した。
オンライン窓口サーバで「署名実施証
明書の一時保留状態エラー」が発生した。

API 仕様書【個人認証サービス AP C 言語インターフェース編】第 4.6 版

18
19
20
21
22
23
24

エラー
コード
2001xx
2002xx
2003xx
2005xx
3004xx
30070330070425
26
27

30070530070630070728

30070929400606NO

内容

意味

HTTP 通信エラー

HTTP 通信中にエラーが発生した。
1xx〜5xx は HTTP1.1 ステータスコー
ド。

IC カードがロックされている
IC カードに接続できない

IC カードは現在使用中。
カードリーダ接続不備、またはカードが接続されていない。※1
対象とする証明書の解析に失敗した。
サーバ時刻の取得に失敗した。
オンライン窓口サーバでアクセスに失敗した。
対象とする証明書の有効期限開始の日
付が未来の日時である。
オンライン窓口サーバで「対象とする証明書のオンライン窓口エラー(OCSP)」が発生した。

対象とする証明書の解析失敗
サーバ時刻の取得に失敗
オンライン窓口サーバへのア
クセスエラー
対象とする証明書の有効期間になっていない
対象とする証明書のオンライ
ン窓口エラー（OCSP）（※1）MacOS 版の場合、住基カードが利用されている場合にも本エラーが発生する。

４６

API 仕様書【個人認証サービス AP C 言語インターフェース編】第 4.6 版

禁・無断転載公的個人認証サービス
利用者クライアントソフト API 仕様書【個人認証サービス AP C 言語インターフェース編】
第 4.6 版

（注意事項）※利用者クライアントソフトの著作権は、総務省、地方公共団体情報システム機
構が保有しており、国際著作権条約及び日本国の著作権関連法令によって保護されています。
※利用者クライアントソフトの利用に当たっては、次に掲げる行為を禁止します。
（1） 利用者クライアントソフトを電子署名に係る地方公共団体情報システム
機構の認証業務に関する法律において制限されている電子証明書の用途で利用すること。
（2） 利用者クライアントソフトに対し、総務省、地方公共団体情報システム
機構に許可なく改造等を行うこと。
※総務省、地方公共団体情報システム機構は、利用者が利用者クライアントソフトを利用したことにより発生した利用者の損害及び利用者が第三者に与えた損害について、一切の責任を負いません。
※商標については次の通りです。
（1） Microsoft Windows および Internet Explorer は、米国 Microsoft
Corporation の米国およびその他の国における登録商標または商標です。
（2） Macintosh、Mac、MacOS、OS X および Safari は、米国およびその他の国で登録されている Apple Inc.の登録商標です。
（3） Android は、Google Inc.の米国およびその他の国における登録商標です。
（4） その他、記載されている会社名、製品名等は、各社の登録商標または商標です。
４７