Windows

バージョン管理システム移行に伴うお知らせ

現在、本プロジェクトのライブラリは、バージョン管理システムへの移行作業中のため、詳細や今後のスケジュールにつきましては、別途アナウンスいたします。

概要

Windows SDKは、マイナンバーカードを利用した電子証明書の取得や署名の作成、利用者の最新基本4情報（氏名・住所・生年月日・性別）に関する同意申請など、公的個人認証に必要な機能をWindowsアプリに実装するための開発キットです。
提供されるZIPファイルを解凍し、同梱されている「PrimagestTrustServicesFramework.h」ファイルを既存のWindowsアプリ（C++プロジェクト）に追加してリンカー設定を行うことで、利用を開始できます。
これにより、マイナンバーカードをPC/SC対応のカードリーダーで読み取り、公的個人認証に必要な各種機能をWindowsアプリ上で実現できます。

Windows対応カードリーダーはこちらをご確認ください

セットアップ手順

1

PrimagestTrustServicesFrameworkのパスをコピーする

PrimagestTrustServicesFrameworkのパスをコピーする.png

ZIPファイルを解凍し、「PrimagestTrustServicesFramework」フォルダを右クリックし、「パスのコピー」をクリックします。

2

プロジェクトのプロパティを開く

プロジェクトのプロパティを開く.png

ソリューションエクスプローラーから自身のプロジェクトを選択し、上部にあるプロパティマークをクリックします。

3

C/C++のインクルードディレクトリの設定

C/C++のインクルードディレクトリの設定.png

サイドバーの「C/C++」から「全般」を選択し、「追加のインクルードディレクトリ」に先ほどコピーしたパスを貼り付けて「OK」または「適用」ボタンをクリックします。

4

PrimagestTrustServicesFrameworkフォルダを開く

PrimagestTrustServicesFrameworkフォルダを開く.png

「PrimagestTrustServicesFramework」フォルダを開きます。

5

PrimagestTrustServicesFramework.hファイルをドラッグ＆ドロップ

framework.hファイルをドラッグ＆ドロップ.png

ソリューションエクスプローラーのヘッダーファイル内に「PrimagestTrustServicesFramework.h」ファイルをドラッグ＆ドロップで追加します。

6

x64フォルダを開く

x64フォルダを開く.png

1つ前のフォルダに戻り、「x64」フォルダを開きます。

7

Releaseフォルダのパスをコピーする

Releaseフォルダのパスをコピーする.png

「Release」フォルダを右クリックし、「パスのコピー」をクリックします。

8

プロジェクトのプロパティを開く

プロジェクトのプロパティを開く.png

再度、ソリューションエクスプローラーから自身のプロジェクトを選択し、上部にあるプロパティマークをクリックします。

9

リンカーのインクルードディレクトリの設定

リンカーのインクルードディレクトリの設定.png

サイドバーの「リンカー」から「全般」を選択し、「追加のインクルードディレクトリ」に先ほどコピーしたパスを貼り付けて「OK」または「適用」ボタンをクリックします。

10

リンカーの依存ファイル設定

リンカーの依存ファイル設定.png

サイドバーの「リンカー」から「入力」を選択し、「追加のファイル依存」に「PrimagestTrustServicesFramework.lib」を入力して「OK」または「適用」ボタンをクリックします。

11

include による SDK の呼び出し

include による SDK の呼び出し.png

SDK を利用するコード内で、次のように「PrimagestTrustServicesFramework.h」をインクルードすることで、SDK 内の機能が利用可能になります。