【機密性２情報】

G ビズ ID 作成をご希望の方へ
本ガイドラインは行政サービス担当者向けのガイドラインであり、G ビズ ID アカウント作成に関するマニュアルではございません。
法人・個人事業主の方が G ビズ ID を作成されたい場合は、G ビズ ID | ご利用ガイド (gbiz-id.go.jp)をご覧ください。

G ビズ ID
接続システム向けガイドライン

デジタル庁
デジタル社会共通機能グループ
2.1 版
2024 年 08 月 29 日

変更履歴
版数

リリース日

章

内容

1.0

2019/2/12

全体

新規作成

1.1

2019/7/12

全体

サービス名を変更。G ビジネス ID→G ビズ ID
アカウント名称を変更。
gBiz エントリー ⇒ gBizID エントリー
gBiz メンバー⇒ gBizID メンバー

gBiz プライム ⇒ gBizID プライム
2.1 アカウント種別

G ビズ ID プライムは複数発行の可能性もある旨を追記。

2.6 保持するデータ項目

桁数を追記

2.7 委任についてメンバーへの委任について記述を追加。

2.1 アカウント種別

調達仕様上の呼称（BizAcccout など）を削除

2.6 保持するデータ項目

・法人番号、個人事業主管理番号の形式を追記
・アカウント管理番号およびその形式を追記

2.7.2 メンバーへの委任に新規追記（2019/9 月追加開発機能）

ついて
2.7.3 メンバーへの委任に新規追記（2019/9 月追加開発機能）

ついて
3.1.4 通知

通知メールがまだ G ビジネス ID というサービス名である点について補足

3.2.2 委任情報取得 API に

レスポンスコンテント No8

ついて

法人番号／個人事業主管理番号の備考欄の誤記を修正「半角英数」→「半角英数字」

3.3.1.4 属性取得リクエス

2.7.2 メンバーへの委任機能に基づき mandate というト

scope およびパラメータを追加
サンプルにも mandate のサンプルデータを追記

3.3.2 委任情報取得 API に

リクエストコンテントの説明を追記

ついてレスポンスコンテントにて以下誤記を修正
No6 アカウント管理番号（誤）必須→（正）任意No30 アカウント ID（メールアドレス）

（誤）必須

→

（正）任意

1.2

2020/10/29

4.1 各環境概要

本番環境での制限事項について追記

4.3 RP 設定依頼書

scope に mandate を追加（2019/9 月追加開発機能）

2.1.アカウント種別

gBizID メンバーの説明を追記
・gBizID プライムが許可したサービスのみ利用できる。

2.4.保証レベル「行政手続におけるオンラインによる本人確認の手法に関するガイドライン」と G ビズ ID との関係を整理し、保証レベルの実装について修正
・gBizID プライムの身元確認時
・本人確認の手法に関するガイドラインと G ビズ ID との関係

3.1.2.2 所有物認証

ワンタイムパスワード認証について追記
・SMS 送信数の上限は１日あたり同一番号に対して５０通。

3.1.4 通知

通知メールのサービス名が「G ビジネス ID」から「G ビズ
ＩＤ」に修正されたため、本ガイドラインにおいても「GビズＩＤ」に修正

また、メールタイトル及び本文の差し替えを行ったので、下記を削除※なお、サービス名は【G ビズ ID】に見直しをしている
が、メールタイトルおよび本文は今後差し替え予定。
3.1.4.2 SMS 通知

送信数の上限について追記
SMS 通知には送信数の上限（１日あたり同一電話番号に対する送信数は 50 通）があるため、上限を超えるとエラーが発生する。エラーが発生した場合は１日経過すると SMSが通知されるようになる。

3.3.1.6 各リクエスト検証方法

id_token のパラメータ「iss」に関する誤記を修正（誤）「https://認証基盤のドメイン/」→（正）「https://認証基盤のドメイン/oauth/」3.3.1.6 各リクエスト検証

Id_token のパラメータ「auth_time」は返却していない

方法

ため、パラメータ一覧の「auth_time」及び検証方法の６を削除

3.3.2. 委任情報取得 API
について
1.3

2021/11/1

委任情報取得リクエスト URL の「API パス」に下記を追記※コンテキストパス＝/api

4.3. RP 設定依頼書

RP 設定依頼書 ver0.931 の入力項目について追記

表紙

G ビズＩＤの移管に伴い修正。
経済産業省商務情報政策局総務課情報プロジェクト室→デジタル庁社会共通機能グループ

全体

OpenIDConnect→OpenID Connect に修正

全体

サービス名を変更。G ビジネス ID→G ビズＩＤ
アカウント名称を変更。
gBiz エントリー

1.3. 政府方針における記載⇒ gBizID エントリー

gBiz メンバー⇒ gBizID メンバー

gBiz プライム⇒ gBizID プライム

G ビズＩＤの移管に伴い、下記を削除。
○未来投資戦略 2018（平成 30 年 6 月 15 日閣議決定）～○デジタル・ガバメント実行計画（平成 30 年 1 月 16
日 e ガバメント閣僚会議決定）

1.3. 政府方針における記G ビズＩＤの移管に伴い、下記を追記。

載○デジタル・ガバメント実行計画（令和 2 年 12 月 25 日
閣議決定）～○デジタル社会の実現に向けた重点計画（令和 3 年 6 月
18 日閣議決定）

3.3.1 OpenID Connect にOpenID Connect について、3 ヶ所文言追加

ついて
3.3.1.4 属性取得リクエス

リクエストコンテント、リクエストサンプル→なしに修正

ト3.3.1.4 属性取得リクエス

レスポンス修正

ト・レスポンス表へプライム、メンバー、エントリーの文言追加。3 種に分けて修正
・name：任意→必須
・parent_id：データ型
・Number に整数追加
・Sub の範囲を追加

String→Number

3.3.2. 委任情報取得 API

リクエストサンプルの文言修正→レスポンスサンプルに修

について

正

3.3.2. 委任情報取得 API

レスポンスコンテントについて・プライム、メンバー、エントリーの文言追加。3 種に分けて修正

4.2. 検証の流れ

G ビズＩＤの移管に伴い修正。
経済産業省

商務情報政策局総務課→デジタル庁

情報プロジェクト室

デジタル社会共通機能グループ

G ビズＩ

Ｄ担当
4.3. RP 設定依頼書・システム上の利用可能なサービス一覧追加
・サンプル「経済産業省」→「デジタル庁」に修正

1.4

2022/06/28

2.4. 保証レベル

gbizID プライムに関する（法人の場合）の記載について、「法人番号」→「会社法人等番号」に修正

3.2.5. 再認証要求

再認証要求を追加

3.3.1. OpenID Connect

ユーザ再認証フローを追加

について
3.3.1.2. ユーザ認可リク「Prompt」「login_hint」を追加、リクエストサンプルを

エスト

修正

3.3.1.3. アクセストーク

レスポンスに関して「id_token」に関する記述を追加、レン取得リクエスト

スポンスサンプルを修正

3.3.1.4. 属性取得リクエ

レスポンス関して「email」を追加、レスポンスサンプル

スト

を修正

3.3.1.5. アクセストーク

レスポンスに関して「id_token」に関する記述を修正、レン再取得リクエスト

スポンスサンプルを修正

3.3.1.6. 各リクエスト検（2）ID トークン検証/nonce 検証「sub」「auth_time」

証方法を修正、再認証要求を行った場合の ID トークンの検証について、追記。

4.2. 検証の流れ（検証方法 No.6～7）

検証の流れについて、申請フローや関連ドキュメント名全般を修正。

4.3. サービス連携申込書

タイトルを「RP 設定書」から「サービス連携申込書」に修正。サービス連携申込書の記載内容について全般を修正。
（2）OpenID Connect 連携に関する情報 ログイン後のリダイレクト URL に関する注意点追記

4.4. テストでの確認ポイ「ユーザ認可リクエスト」に関する確認内容について注意

ント

点を追記

4.5. よくある問い合わせ

よくある問い合わせ事項を追加

事項
1.5

2022/12/1

2.7.2 メンバーへの委任にリリース予定の文言削除

ついて
2.7.3 プライム承継機能についてリリース予定の文言削除

3.3.1.4

属性取得リクエ

Scope 名の誤記「opened」を「openid」 へ修正

スト
4.1. 各環境概要

本番環境、検証環境の位置づけ、アカウント作成方法

4.2. RP 設定申込書（4）多要素認証ポリシーに関する情報プ

ライム文言修正（6）システム内の利用可能なサービス一覧追加（8）連絡先情報追記修正

4.5. 接続後の対応

接続後の対応（設定変更・削除）に関する記載を追加

4.6. よくある問い合わせ

ケース 2 追加事項
1.6

2023/4/1

3.3.1.2 ユーザ認可リクエ

Scope について文言修正

スト
4.2（2）OpenID

Scpoe 指定に関する記述を削除

Connect 連携に関する情報
1.72023/5/22

4.4. 接続後の対応

設定変更時の注意点を追加

表紙

本ガイドラインの注意点について記載

2.6

保持するデータ項目

G ビズＩＤが利用する文字コードについて記載

4.1. 各環境概要

事前申請に関する問い合わせ先を記載

4.4. 接続後の対応

ログインエラーに関する調査ヒアリング事項を記載

4.5.よくある問合せ事項

よくある問合せケース③を追加

3.3.1.2 ユーザ認可リクエ

State,Prompt,Nonce,Scope⇒全て小文字に変更

スト3.3.1.3 アクセストークン

Code⇒小文字の code に変更

取得リクエスト3.3.1.5 アクセストークン

Code⇒小文字の code 変更

再取得リクエスト3.3.1.6 各リクエスト検証

State⇒小文字の state に変更

方法1.8

2023/8/29

2.1. アカウント種別

gBizID プライムの説明について、書類郵送申請とオンライ
ン申請について記載を追加

2.4. 保証レベル

gBizID プライムの身元確認時の記載について、書類郵送申
請とオンライン申請について記載を追加

2.6. 保持するデータ項目

代表者生年月日の補足説明について生年月日が不明時の対

3.1.2.2

スマートフォンアプリの表記を修正

応について追記
所有物認証

3.2.3. ログインボタン配

新画面、新アイコンにあわせて全体を修正

置ポリシー
全体
1.9

2023/11/21

3.1.2.2

G ビズＩＤアプリアイコンの画像を変更
所有物認証

ワンタイムパスワード認証に関する廃止見込みに関する記述を追記

3.3.1.2 ユーザ認可リクエ（２）ログイン後の URL アクセスリクエストのリクエス

スト

トコンテント（正常時）、データ型部分に「最大文字数」という定義を追記

3.3.1.3 アクセストークン（１）アクセストークン取得リクエストのリクエストヘッ

取得リクエストダ

設定値部分に「～でエンコードした値」を追記、リクエストコンテント備考欄の「Authorization_code」の大文
字 A を小文字に修正、リクエストサンプルを
Authorization_code の大文字 A を小文字に修正およびサンプル注意点を補足、レスポンスのデータ型部分に「最大文字数」という定義を追記、access_token および
refresh_token、id_token のデータ型最大文字数を修正
3.3.1.4 属性取得リクエス（１）属性取得リクエストのレスポンスのデータ型部分にト「最大文字数」を追記

3.3.1.5 アクセストークン（１）アクセストークン再取得リクエストのリクエストヘ

再取得リクエストッダ

設定値部分に「でエンコードした値」を追記、リクエストサンプル注意点を補足、レスポンスのデータ型部分に「最大文字数」という定義を追記、access_token および refresh_token、id_token のデータ型最大文字数を修正
3.3.2. 委任情報取得 API（１）委任情報取得リクエストのリクエストコンテント

について（正常時）のデータ型に「最大文字数」という定義を追記

4.1. 各環境概要

各環境の定義、テストアカウントの作成方法などを追記

4.2. 審査および設定申込

4.2 章として章立てを追加。審査及び接続に関する注意点に関するフローと注意事項を記載

4.3.RP 設定申込書

冒頭および（1）連携サービスデータ概要「サービス開始予定日」欄に提出時の注意事項を追記

4.4. テストでの確認ポイ

エラー発生時の調査に関する記述を追加

ント
4.6. よくあるお問合せ事

FAQ を追加項
2.0

2024/3/28

2.1. アカウント種別

オンライン申請が法人も対象になったため、修正。

2.2. 取得方法

アドミン権限の記載を追加。

2.3. アカウントライフサ※1 gBizID メンバー（アドミン権限を持つ場合）を追加。

イクル
2.4. 保証レベル

gBiz プライムに法人オンライン申請の情報を追加。
gBizID メンバーに（アドミン権限を持つ場合）を追加。

3.1.1. ユーザ登録・管理

アドミン権限を持つ G ビズ ID メンバーの記載を追加。

3.3.2. 委任情報取得 API（１）委任情報取得リクエストの説明文を追加。リクエストについて

サンプルの２行目が「client_token」の誤記を修正。

4.2.2. ①利用申請につい

利用申請時の注意点について追加。

て
4.2.7. リリース後の設定

TOP ページコンテンツ掲載に関する注意点を追加。

変更・設定追加依頼要望について4.2.8. その他（テストア

アドミン権限を持つ G ビズ ID メンバーの記載を追加。

カウントの作成手順）
4.3. RP 設定申込書(5)部分に注意点を補足

4.6. よくあるお問合せ事

Q8 に“作成した G ビズ ID メンバーにアドミン権限を付与す

項

ることはできません。“を追加。

2.1

2024/8/29

3.1.1. ユーザ登録・管理

代表者情報変更申請の記載を追加。

3.2.3. ログインボタン配ログインボタンの変更及び文言変更。

置ポリシー
4.1. 各環境概要

軽微な文言修正

4.2. 審査および設定申込

フロー図修正に関する対応フローと注意事項
4.2.6. リリース作業

サービスリリース後の注意点追記

4.3. RP 設定申込書

備考欄内にサービスリリースの定義追記

4.6. 接続後の連携削除に

連携削除に関する文言追加

ついて全体「サービス開始」→「サービスリリース」へ変更

全体「gBizID」→「G ビズ ID」へ変更「G ビズＩＤ」→「G ビズ ID」へ変更

目次
1.

2.

G ビズ ID の概要 ................................................................................................................... 10
1.1.

G ビズ ID とは ................................................................................................................ 10

1.2.

導入の背景 ..................................................................................................................... 101.3.

政府方針における記載 ...................................................................................................... 10

G ビズ ID の提供するアカウント ............................................................................................... 10
2.1.

アカウント種別 ............................................................................................................... 10

2.2.

取得方法 ........................................................................................................................ 12

2.3.

アカウントライフサイクル ................................................................................................. 13

2.4.

保証レベル ..................................................................................................................... 14

2.5.

利用イメージ .................................................................................................................. 16

2.6.

保持するデータ項目 ......................................................................................................... 17

2.7. 委任について .................................................................................................................. 18
2.7.1. 別事業者との委任について ............................................................................................ 18
2.7.2. メンバーへの委任について ............................................................................................ 18
2.8. プライム承継機能 ............................................................................................................ 19
2.8.1. プライム承継機能について ............................................................................................ 19
3.

提供機能 .............................................................................................................................. 20
3.1. システム機能概要 ............................................................................................................ 20
3.1.1. ユーザ登録・管理 ....................................................................................................... 21
3.1.2. 認証 ........................................................................................................................ 21
3.1.3. 委任 ........................................................................................................................ 23
3.1.4. 通知 ........................................................................................................................ 24
3.1.5. 証跡機能 ................................................................................................................... 25
3.2. RP 設計のポイント .......................................................................................................... 26
3.2.1. RP 経由でのログインに関する処理概要 ........................................................................... 26
3.2.2. アカウント種別による制御 ............................................................................................ 27
3.2.3. ログインボタン配置ポリシー ......................................................................................... 30
3.2.4. Cookie およびトークンについて .................................................................................... 31
3.2.5. 再認証要求 ................................................................................................................ 32
3.3. API 詳細 ....................................................................................................................... 33
3.3.1. OpenID Connect について ......................................................................................... 33
3.3.2. 委任情報取得 API について .......................................................................................... 51

4.

リリースに向けた作業について ................................................................................................. 55
4.1.

各環境概要 ..................................................................................................................... 55

4.2. 審査および設定申込に関する対応フローと注意事項 ................................................................. 56
4.2.1. ⓪事前準備について .................................................................................................... 58
4.2.2. ①利用申請について .................................................................................................... 58
4.2.3. ②接続申込について .................................................................................................... 59
4.2.4. ③検証環境での動作確認について ................................................................................... 60
4.2.5. ④本番環境での動作確認について ................................................................................... 61
4.2.6. ⑤リリース作業 .......................................................................................................... 61
4.2.7. ⑥リリース後の設定変更・設定追加依頼要望について ......................................................... 61
4.2.8. その他（テストアカウントの作成手順） .......................................................................... 62
4.3.

RP 設定申込書 ................................................................................................................ 65

4.4.

テストでの確認ポイント .................................................................................................... 71

4.5.

接続後の対応 .................................................................................................................. 73

4.6.

接続後の連携削除について ................................................................................................. 74

4.7.
5.

よくある問い合わせ事項……………………………………………………………………………………………74

参考情報 .............................................................................................................................. 76
5.1.

参考情報：認証・認可の観点で、RP 側で実装すべきポイント（１/2） ....................................... 76

5.1.

参考情報：認証・認可の観点で、RP 側で実装すべきポイント（２/２） ...................................... 77

1.
1.1.

G ビズ ID の概要
G ビズ ID とは
電子的な行政手続きの対象者を一元的に認証する基盤である。企業の代表者や従業員、個人事業主等
が、各種電子申請システム（申請のほか、届出・報告等の業務を含む）等を利用する際の統合認証基盤として利用することができる。

1.2.

導入の背景
これまでの電子政府の取組は、紙や押印の機能を電子上で再現することを所与のものとし、また、制度・業務ごとに個別システムを構築してきたため、システム間の連携が取れておらず必ずしも利用者にとって利便であるとは言えない状況であった。
G ビズ ID は、このような従来の電子政府の手法からの脱却を目指し、添付書類の削減や同一情報の提出は一度として、１つのアカウント（ID/パスワード）で複数の行政手続を行うことができるよう、サービスデザイン発想での行政サービスを実現するために平成 31 年 2 月より導入するサービス
である。
G ビズ ID の導入により、申請時の利便性の向上だけでなく、複数システムでの申請内容や履歴等を紐付け、それを活用した質の高い行政サービスを提供することも将来的な目的としている。

1.3.

政府方針における記載○デジタル・ガバメント実行計画（令和２年 12 月 25 日閣議決定）
8.3 法人デジタルプラットフォームの整備
また、一つの ID・パスワードで複数の行政サービスにアクセスを可能とする認証システムとしてG ビズ ID を 2019 年度（令和元年度）より運用開始し、経済産業省の産業保安関係法令手続、中小企業向け補助金申請等の主要な行政手続、厚生労働省の社会保険手続、農林水産省関係の手続等における認証システムとして導入されている。引き続き、法人向け行政手続の共通認証システムとして普及を図るため、各府省や地方公共団体といった行政機関等の行政手続について横展開を行っていく。
○デジタル社会の実現に向けた重点計画（令和３年６月 18 日閣議決定）
第２部１．
（４）ID・認証② 法人共通認証基盤（G ビズ ID）の普及
法人及び事業を行う個人（個人事業主）が、様々な行政サービスにログインできる認証サービスを実現するため、法人の認証としては G ビズ ID の普及と利用の拡大を図る。特に中小企業の手続負担軽減のための取組として、令和４年度（2022 年度）中を目途に 100 万法人の取得を目指すとともに、令和７年度（2025 年度）にはほぼ全ての法人が取得する環境を目指し、中小企業施策のデジタル化に貢献する。

2.
2.1.

G ビズ ID の提供するアカウント
アカウント種別
G ビズ ID では、以下の２つの体系のアカウントを用意する。ユーザの利用用途により、いずれかのアカウントを作成する。また、代表者アカウント（G ビズ ID プライム）は、その管理の下、従業員等用のアカウントとして G ビズ ID メンバーを作成することができる。

1

アカウント種別

説明

・誰でも作成できるアカウント。
・登録内容の確認は行われない。ただし、メールアドレスの存在確認と、
G ビズ ID エントリー
法人の場合には法人番号の存在確認は行う。
・システムからの登録のみで作成可能。
2
・利用者が法人代表者又は個人事業主本人であることを確認したアカウン
ト。
・作成に当たっては、書類郵送申請もしくはオンライン申請が可能。
【書類郵送申請】システム上で必要事項を入力の上申請書を作成するとともに、これと併せて法人の場合には印鑑証明書（法務局発行）を、個人事
業主の場合には印鑑登録証明書（市町村発行）を提出し、審査を受けたの
ちアカウントが発行される。
G ビズ ID プライム
【オンライン申請】
システム上で必要事項を入力の上、事前にスマートフォンへインストール
した「G ビズ ID アプリ」によってマイナンバーカードの読み取りを行い、身元確認をし、アカウントを発行する。申請にはマイナンバーカードが必要。
法人のオンライン申請は、株式会社、有限会社、合同会社の方が対象となる。オンライン申請可能な法人一覧は、「オンライン申請」⇒対応の会社
種類はこちらを確認する。
・法人又は個人事業主の従業員等のためのアカウント。
・G ビズ ID プライムが、その管理の下、作成することができる。
・G ビズ ID プライムと同等の権限を有する。
G ビズ ID メンバー
・G ビズ ID メンバーは、承認・作成された G ビズ ID プライムに紐付いたアカウントとなる。
・G ビズ ID プライムが許可したサービスのみ利用できる。
※いずれのアカウントも、事業態様として「法人」又は「個人事業主」を用意。
※法人代表者印は登記上複数登録も可能であることから、法人によっては G ビズ ID プライムが複数存在する
こともあり得る。

2.2.

取得方法

G ビズ ID エントリーアカウントを取得するには、自身で、G ビズ ID 基盤（G ビズ ID）上で作成する。

G ビズ ID プライムアカウントは、以下 2 つのいずれかの方法により作成することができる。
①
G ビズ ID エントリーを登録した後に、G ビズ ID プライムへ変更する方法②
G ビズ ID エントリーを取得せず、最初から G ビズ ID プライムとして作成する方法

G ビズ ID メンバーアカウントは、以下 2 つのいずれかの方法により作成することができる。
① G ビズ ID エントリーを登録した者を、G ビズ ID プライム(※)の承認に基づき、G ビズ ID メンバーに変更する方法② G ビズ ID エントリーを登録せず、G ビズ ID プライム(※)により、G ビズ ID メンバーを作成する方法※アドミン権限を持つ G ビズ ID メンバーも G ビズ ID プライム同様の操作が可能。

①直接①直接
GビジネスIDのGビズIDのページへアクセスしページへアクセスしててアカウント作成
アカウント作成

GビジネスID
GビズID

2.3.

アカウントライフサイクル

各アカウント種別のライフサイクル（アカウントの状態とその遷移）を図示すると以下のとおり。

2.4.

保証レベル

G ビズ ID では以下のとおり実装している。
タイミング

身元確認時

G ビズ ID エントリー

・メールアドレスの存在を確認する。
・（法人の場合）法人番号の存在を確認するG ビズ ID プライム
【書類郵送申請時】（法人の場合）・印鑑証明書（法務局発行）と申請書に捺印した印鑑の印影を確認
・また、身元確認の証左として以下項目が記載された印鑑証明書の原本を保管－会社法人等番号－商号－本店所在地－代表者氏名－生年月日（個人事業主の場合）
・印鑑登録証明書（市町村発行）と申請書に捺印した印鑑の印影を確認
・また、身元確認の証左として以下項目が記載された印鑑登録証明書の原本を保管－個人事業主氏名－印鑑登録証明書の住所－生年月日

G ビズ ID メンバー

・G ビズ ID プライ
ムが作成する（アドミン権限を持つ場合）・マイナンバーカー
ドから生年月日を取得し既存の登録情報と確認【オンライン申請時】（共通）
・身元確認の証左として以下項目
をマイナンバーカードから取得
し、署名データとともに保管
－氏名
－住所
－生年月日
（法人の場合）マイナンバーカードの情報（氏名・住所）と法務省管轄の登記情
報を突合

当人認証時

・パスワードによる単要素
認証により、毎回のアクセスが同一の者により行われていることを確認する

・パスワードおよび所有物認証による 2 要素認証により、身元確認を経たアカウントと同一の者により行われていることを確認する

「行政手続におけるオンラインによる本人確認の手法に関するガイドライン」（2019 年 2 月 CIO 連絡会議
決定）では各ユーザモデルの保証レベルを以下のとおり定めている。G ビズ ID との関係は以下のとおり整理される。

必要な保証レベル
身元確認保証レベル

当人認証保証レベル

レベル１

レベル１

身元確認のない自己表明

単一又は複数の認証要素

レベル２

レベル２

遠隔又は対面での身元確認

複数の認証要素

レベル３
対面での身元確認

オンラインによる手法例

対応するGビズID

レベルC

gBizIDエントリー

レベルB

gBizIDプライム
gBizIDメンバー

レベル３
耐タンパ性が確保された
ハードウェアトークン

レベルA

対応なし

2.5 利用イメージ
利用イメージは以下の通り。

② ②ビ
に
ビ
ズス ID
にID
アア
クク
セセ
スス
しし
、、
Gジ
Gネ
・ス
パワ
スー
ワド
ーを
ド入
を力入力
・ID
パ
ID
GビジネスID
GビズID①

利用したいシステムのログイン画面にアクセスする。

②

G ビズ ID のサーバに遷移後、アカウント ID 及びパスワードを入力する。
※入力するアカウント ID は「メールアドレス」。法人番号（13 桁の数字）は、アカウントに紐付く属性をして保有されるものであり、法人番号がアカウント ID となるわけではない。
※また、個人事業主の管理については、個人事業主管理番号（8 桁の英数字）を G ビズ ID 内で付番する。なお、個人事業主管理番号は飽くまで G ビズ ID 内の管理番号であり、ユーザには当該番号を表示しない。
※G ビズ ID プライム及び G ビズ ID メンバーについては、２要素認証を行う必要があるため、アカウント ID（メールアドレス）及びパスワードの入力に加え、スマートフォンのアプリケーションにおけるボタン押下等、又は SMS ワンタイムパスワード認証が必要。

③

認証結果を申請システム側に返す。
※認証結果を返した後、G ビズ ID は、申請経路の通信には関知しない。

④

認証結果が正しい場合、ログインが成功する。

2.6 保持するデータ項目
G ビズ ID において保有・管理するアカウント情報の項目は以下のとおり。アカウント種別に応じて、任意／必須の項目があり、必ずしもすべてのアカウントにおいてこれら情報は保有されない。
項目
法人番号／個人事業主管理番号

法人名／屋号
都道府県
基
本
情
報

市区町村＋番地
代表者名フリガナ／個人事業主名フリガナ
代表者生年月日アカウント利用者氏名フリガナ

カ
ウ
ン
ト
利
用
者
情
報

法人の場合は必須
法人番号は半角数字 13 桁（10 進数）
個人事業主管理番号は半角英数字 8 桁（16 進数）
法人番号から取得する（国税庁法人番号公表サイト）
法人番号から取得する（国税庁法人番号公表サイト）
法人番号から取得する（国税庁法人番号公表サイト）

代表者名／個人事業主名

アカウント利用者氏名

ア

補足説明

アカウント利用者生年月日
連絡先郵便番号
都道府県
市区町村＋番地
マンション名等
会社部署名／部署名
SMS 受信用電話番号

G ビズ ID プライムの場合は、審査項目となるため必須※生年月日が不明で登録されている利用者は G ビズ ID では以
下の通り登録される。
年が不明な場合：1900
月が不明な場合：01
日が不明な場合：01
G ビズ ID プライムの場合は、「アカウント利用者＝代表者」であるため、基本情報とアカウント利用者情報における氏名・フリガナ・生年月日が一致することとなる
基本情報からコピー可。コピーしない場合は選択式
基本情報からコピー可
基本情報からコピー可
2 要素認証用（G ビズ ID プライム及び G ビズ ID メンバーのみ）連絡先電話番号
アカウント ID（メールアドレス)
パスワード

ユーザを一意に識別するための内部的な ID
桁数不定（10 進数）※G ビズ ID メンバーは、代表者（G ビズ ID プライム）に紐付くアカウントであり、当該代表者の「基本情報」を受け継ぐ。
※UserInfo で取得できる項目の詳細は 3.3.1 OpenID Connect について参照のこと。
※G ビズ ID が保持している情報以外で、利用システム側が必要とする情報は、別途利用システム側で保持する必要がある。
※G ビズ ID の文字コードは JIS X 0213:2012。
アカウント管理番号

2.7. 委任について
2.7.1 別事業者との委任について

G ビズ ID では、電子化された行政手続きの申請時に代行事業者等による代理申請ができるよう、委任関係を管理する機能を有する。委任関係については、委任者企業と受任者企業の G ビズ ID プライムアカウントを指定して登録する。
（G ビズ ID プライムアカウント以外のアカウントでは、委任関係は結べない。
）
受任者（B 社）

委任者（A 社）G ビズ ID プライム

G ビズ ID プライム

委任

また、受任者企業の G ビズ ID プライムに紐づく G ビズ ID メンバーアカウントは、委任者企業 A 社の申請を可能とする。
※委任関係は基本的に委任者・受任者両者が G ビズ ID プライムを作成した上で登録を行うが、委任者についてはアカウントがない状態で受任者に委任することも可能。その場合、申請書ベースでの申請となる。
委任者（A 社）

受任者（B 社）G ビズ ID プライム

G ビズ ID プライム

委任
G ビズ ID メンバー

X さん

G ビズ ID メンバー

Y さん

2.7.2. メンバーへの委任について
G ビズ ID では、G ビズ ID プライムが配下の G ビズ ID メンバーに対して、どの申請システムに申請ができるかを設定できる機能を有する。
ログインした G ビズ ID メンバーが申請可能なシステムは UserInfo にて取得する。

2.8. プライム承継機能
2.8.1. プライム承継機能について
G ビズ ID では、G ビズ ID プライムが変更になった場合に、旧 G ビズ ID プライムに紐づく各種情報を新G ビズ ID プライムに承継する機能を有する。
・旧 G ビズ ID プライムに紐づく情報を引き継ぐ。
（委任・受任関係およびメンバーの引き継ぎ）・承継元の旧 G ビズ ID プライムアカウントの無効化または継続かの選択が可能。

3. 提供機能
3.1.

システム機能概要

G ビズ ID のシステム概略図を以下に示します。

主に以下の機能を提供します。
機能内容
・G ビズ ID エントリー、G ビズ ID プライム及び G ビズ ID メンバーの各アカウ
ユーザ登録・管理
ントの登録機能、管理機能を提供する。
・2 種類の認証方式を提供する。
（パスワード認証、パスワード認証＋所有物認証）
・本人認証を行うための情報（パスワード、所有物）を管理する。
認証
・認証結果を OpenID Connect にて利用システムに提供する。その際 UserInfo
にて属性情報も提供する。
・G ビズ ID プライム同士で委任関係を結ぶための機能、管理機能を提供する。
委任・委任結果を REST-API にて利用システムに提供する。
・アカウント登録などユーザ操作の各種タイミングで事前に登録したメールアド
通知
レス又は電話番号（SMS）に必要な通知を行う。
証跡管理
・G ビズ ID の証跡を取得し、管理する。

3.1.1. ユーザ登録・管理
以下機能を提供する

各機能を利用可能な ID

G ビズ
ID
エント
リー

G ビズ
ID
プライ
ム

G ビズ
ID
メンバ
ー

自分のプロフィールを変更できる

〇

〇

〇

自分のパスワードを変更できる
自分のメールアドレスを変更できる。
なお、G ビズ ID メンバーは G ビズ ID プライ
ムの操作でのみ変更可能。

〇

〇

〇

〇

〇

機能

登録

自身の
アカウ
ント管
理

プロフィール変
更パスワード変更
メールアドレス変更
SMS 受信用電
話番号変更

アカウントを作成する〇

自分の SMS 受信用電話番号を変更できる

〇

〇

〇

〇

G ビズ ID エントリー側の操作で、G ビズ ID エントリーから G ビズ ID プライム〇に変更するための申請ができる
代表者情報の変更（改姓改名、代表者住所変
代表者情報変更更）ができる。
〇
申請※ 代表者住所変更は個人事業主のみ
G ビズ ID メン G ビズ ID メンバーを確認、登録、変更、退会△〇
バー管理することができる（※）
G ビズ ID エン G ビズ ID エントリーを G ビズ ID メンバーにG ビズ△
トリーからの変 変更するための申請を、当該 G ビズ ID エント
〇
ID メン
（※）
更
リー宛てにすることができる
バー管
自組織（法人番号で判別）に所属する G ビズ
理
所属 G ビズ ID ID エントリーを一覧で参照することができ△〇エントリー一覧 る。アカウント種別が「個人事業主」の場合は（※）
この機能はない。
※アドミン権限を持つ G ビズ ID メンバーは G ビズ ID プライム同様に利用可能。ただし自身が作成した
G ビズ ID メンバーのみを管理が可能。
詳細はマイページ操作マニュアルの 1.3. 操作一覧を参照。
G ビズ ID プラ
イム変更申請3.1.2. 認証

以下 2 種類の認証方式を提供する
認証方式
内容
単要素認証
パスワード認証方式
２要素認証

パスワード認証＋所有物認証方式

対象アカウントG ビズ ID エントリー
G ビズ ID プライム
G ビズ ID メンバー

3.1.2.1
パスワードポリシー
パスワードポリシーは以下のとおり。
・利用可能文字は半角英数記号。
・ブランクを許容する。
（パスフレーズを許容する。
「My name is YamadaTarou@」など）
・複数文字種は求めない。
・長さは 8 桁以上。システム的には 100 桁まで入力可能。
・G ビズ ID において設定される「NG ワード」と一致するパスワードの設定は不可。
（「password1」「1qaz2wsx」など）
・パスワードリセットのためのヒント情報（例：『飼っているペットの名前は？』など）は持たない。

・定期的な変更は求めない。
また、アカウント ID／パスワードによる認証を 10 回連続で失敗することにより、パスワードロックがかかる。この場合、自身でのパスワードリセットによる解除が必要となる。
3.1.2.2

所有物認証

以下の 2 種類の所有物認証機能を提供する。G ビズ ID プライム及び G ビズ ID メンバーは、２要素認証
により利用しなければならず、単要素認証による利用は不可。
初回はワンタイムパスワード認証を実施する必要があるが、以降はスマホアプリの利用を推奨する。
（ガラケーなどスマホアプリの利用ができない場合はワンタイムパスワード認証を継続利用する。
）
なお、2024 年以降、G ビズ ID 本番環境におけるワンタイムパスワード認証は廃止する予定であるため、ユーザにはスマホアプリ認証の切り替えを推奨している。（詳細の廃止時期は現在未定のため、決まり次第周知予定。
）
スマホアプリ認証
ボタン認証の場合

ワンタイムパスワード認証

指紋認証の場合

SMS にて受信
ワンタイムパスワード：(例)123456

・アカウント登録後、マイページからスマホアプリのダウン

・登録時に登録した SMS 受信用電話番号に、SMS にてロードが可能。

ワンタイムパスワード（6 桁数字）を送信する。

・スマホアプリ登録後は、パスワード認証後、スマホアプリ

・利用者はそのワンタイムパスワードを Web 画面上でで認証行為を行うことで、指紋認証又は顔認証（機種や設定入力することでログインできる。

により異なる）をしてログイン。

・ワンタイムパスワードの有効期限は 1 時間。

・アプリケーションは、iPhone 及び Andorid 端末に対して・SMS 送信数の上限は１日あたり同一番号に対して５０提供する。iPhone のうち、TouchID や FaceID に対応して通。

いる端末の場合には、指紋認証や顔認証を利用することができる。
・また、iOS の生体認証（TouchID/FaceID）が失敗した場合は以下のとおりとなる。
－PIN 認証が有効な場合：PIN 認証画面を表示－PIN 認証が無効な場合：ボタン認証画面を表示＜その他＞
・いずれの場合も、Cookie による端末確認を行う。未使用利用端末（新しい端末）からアクセス・ログ
インした場合、利用者に対しメールによるログイン通知を行う。
3.1.2.3
認証結果の提供
OpenID Connect の Authorization Code Flow の標準に従い提供する。
詳細は「3.3.1 OpenID Connect について」を確認のこと。

3.1.3. 委任
以下の機能を提供する。

機能

委任先一覧・委任申請

委任/受任

受任

G ビズ ID プライムが、委任先の管理、及び委任の申請ができる。
別の G ビズ ID プライムアカウン
トから依頼された委任申請について、受任の承認や、受任情報の確認等を行うことができる。ただし、G ビズ ID メンバーは一覧確
認のみを行うことができ、承認/否認などの操作は行えない。

3.1.3.1
委任結果の提供受任情報を確認できる REST-API で提供する。
詳細は「3.3.2 委任情報取得 API について」を確認のこと。

各機能を利用可能な ID
G ビズ G ビズ G ビズ
IDIDID
エント プライ メンバ
リー
ム
ー
〇

-

〇

〇
(一部)

3.1.4. 通知
各種ユーザ操作のタイミングで、以下のようなメール又は SMS を利用者に送信する。
ユーザは、送信されたメール等の内容に応じて、所要のアクションを行うこととなる。
3.1.4.1 メール通知（メール通知文面の例①：G ビズ ID プライムアカウント登録完了時）
From: support@gbiz-id.go.jp
To:＜G ビズ ID プライムとして登録した方のメールアドレス＞
Title: 【G ビズ ID】アカウント登録完了のお知らせ
山田

太郎

様

sample

こちらは G ビズ ID です。
G ビズ ID プライムアカウントの登録が完了しました。
アカウント ID：yamada.tarou@example.co.jp※本メールは自動送信されています。このメールに返信いただいても回答できません。あらかじめご了承ください。
G ビズ ID
https://gbiz-id.go.jp(c) 2019 Digital Agency, Government of Japan.

（メール通知文面の例②：G ビズ ID エントリーアカウント登録時のメールベリファイとして送信）
From: support@gbiz-id.go.jp
To:＜メールアドレス登録画面にて入力したメールアドレス＞
Title: 【G ビズ ID】アカウント情報登録手続き URL のお知らせ
sample※アカウント登録手続きはまだ完了しておりません。※
こちらは G ビズ ID です。
以下の URL より、アカウント情報を登録してください。
URL：＜※アカウント登録用の URL を記載＞

有効期限：＜※有効期限を記載＞※上記 URL は 1 度しかご利用いただけません。
※有効期限を過ぎた場合、「アカウント新規登録」画面から再度手続きを行ってください。
※本メールは自動送信されています。このメールに返信いただいても回答できませんので、あらかじめご了承ください。
G ビズ ID
https://gbiz-id.go.jp(c) 2019, Digital Agency ,Government of Japan.

このほかの主なメール通知タイミングは以下のとおり。
・アカウント登録・変更中（ログイン用 URL 通知等）
・パスワードリセット
・一度もログインしたことのない端末からログインがあったとき・委任/受任の登録中（受任の依頼があった/委任が承認された）・G ビズ ID メンバーへの承認通知
3.1.4.2 SMS 通知（SMS 通知文面）
To:＜対象のアカウントの SMS 受信用電話番号＞
G ビズＩＤ

sample

ワンタイムパスワード：＜※6 桁の数字が記載＞

上記のワンタイムパスワードが通知される主なタイミングは以下のとおり。
・２要素認証用のワンタイムパスワードを通知する場合
・G ビズ ID プライム又はメンバーアカウントのメールアドレス（アカウント ID）や SMS 受信用電話番号を変更する場合
・G ビズ ID プライムアカウント登録時
・G ビズ ID エントリーアカウントを G ビズ ID メンバーアカウントに変更する場合
SMS 通知には送信数の上限（１日あたり同一電話番号に対する送信数は 50 通）があるため、上限を超えるとエラーが発生する。エラーが発生した場合は１日経過すると SMS が通知されるようになる。
3.1.5. 証跡機能
ログイン履歴などの各種証跡ログを取得。
提供については G ビズアカウント担当と調整のこと。

3.2.

RP 設計のポイント

RP（電子申請システム）設計時の設計ポイントについて以下にまとめる。
3.2.1. RP 経由でのログインに関する処理概要⑧アクセストークン、属性情報（UserInfo）の取得をサーバ間通信で行う

電子申請システム（RP）

G ビズ ID（OP）⑤認証結果を確認⑦RP にて認証結果の検証を行う⑥ログインに成功すると、RP のログイン後の URL に
リダイレクト②RP にて G ビズ ID のログ
イン画面（OpenID Connectの認証リクエスト）を呼び出す③ログインに必要な認証画面を出力する④ログイン処理①利用者が RP にアクセス

利用者

No.
①

処理者
利用者

処理
RP にアクセス

説明・利用者はまず RP にアクセスする・RP は G ビズ ID にログインするボタンを配置すること。ボタンについては「３.2.３ログインボタン配置ポリシー」参照のこと②

RP

認証リクエスト・OpenID Connect の認証リクエストを呼び出す
詳細については「３.3.1OpenID Connect について」参照のこと

G ビズ ID③

ログインに必要な認証画面

・OpenID Connect フローに従い処理を出力する

・ID/パスワード画面を出力（2 要素が必要な場合、ID/パスワード入力後 2 要素目も求める）
・別 RP にログイン済みで G ビズ ID の認証 Cookie が有効な場合、シングルサインオンとなりこの処理はスキップされる

④
⑤

利用者

ログイン処理・G ビズ ID から出力された ID/パスワード画面に入力する（2 要素が必要な場合、そちらにも応える）

G ビズ ID

認証結果を確認・認証結果を確認する

G ビズ ID

認証レスポンス・RP に認証レスポンスを返し、リダイレクトする
・このタイミングで各種 Cookie を設置する⑥

Cookie の種別とタイムアウトについては「3.2.4Cookie およびトークンについて」参照のこと

⑦

⑧

RP

認証結果の検証

・認証レスポンスで受け取った内容を検証

RP

アクセストークン取得リク・アクセストークン取得リクエストによりアクセストークンを取得しエスト、

ID トークンを検証する

属性取得リクエスト

・必要に応じアクセストークンをもとに属性取得リクエストを実施、属性情報を取得する
詳細については「3.3.1OpenID Connect について」参照のこと

3.2.2. アカウント種別による制御
G ビズ ID では、アカウント種別に応じて 1 要素認証と、2 要素認証の 2 つのケースがある。ただし RP 側
でいずれのアカウントでも 2 要素認証を行う必要がない場合、1 要素認証のみとすることも可能。
G ビズ ID に RP 登録する際、該当 RP が 1 要素認証のみとするサイトか、2 要素認証を必要とするサイトかを選択して登録する。サイト内で混在する場合は 2 要素サイトとして登録する。
（混在とは、サイト内に 1 要素だけで対応できるメニューと 2 要素を必要とするメニューが混在する場合のこと。
）◆実装のポイント：アカウント種別に応じた処理の制御が必要な場合、OpenIDConncect の Useinfo にて返却されるアカウ
ント種別を参照し、それに応じた処理を RP 側で実装する必要がある。
具体的には、2 要素認証を必要とするサイトでは、アカウント種別が G ビズ ID エントリーで認証成功となっていても RP 側でエラーとするよう実装する必要がある。

G ビズ ID として、1 要素認証にて、認証が完了。
RP（電子申請システム A）側に対し、OenIDConnect のUserinfo により、アカウント種別を G ビズ ID エントリー
として通知

G ビズ ID として、1 要素認証にて、認証が完了。
RP（電子申請システム A）側に対し、OenIDConnectの Userinfo により、アカウント種別を G ビズ ID プラ
イム、メンバーとして通知

G ビズ ID として、1 要素認証にて、認証が完了。
RP（電子申請システム A）側に対し、OenIDConnect の Userinfo により、アカウント種別を G ビズ ID エントリーとして通知。
本来は 2 要素が必要となるため、RP 側で制御を行う。
RP 側に「権限がありません」などと表示してもらう。

G ビズ ID として、2 要素認証にて、認証が完了。
RP（電子申請システム A）側に対し、OenIDConnect のUserinfo により、アカウント種別を G ビズ ID プライム、メンバー
として通知。

3.2.3. ログインボタン配置ポリシー
各 RP においては、以下それぞれ定めるところによりデザインし、ログインボタンを設置するものとする。
 遵守事項・ G ビズ ID の ロゴカラー（※1）又は ボタンカラー（※2）を基調とすること。
※1 文字の色：#1A1A1C、地の色：#FFFFFF※2 文字の色：#0017C1、地の色：#FFFFFF 又は 文字の色：#FFFFFF、地の色：#0017C1
・ 「G ビズ ID」及び「ログイン」という２つのワードを使用すること。
 推奨事項・ アイコンを使用する。
 その他自由設定事項
・ フォント、フォントサイズ
・ 文字、アイコン等の配置

アイコン



ログインボタンのデザイン（あくまで例であり、これらに限るものではない。）

・

ロゴカラーのイメージ

・

ボタンカラーのイメージ

（参考）各行政サービス（RP）におけるログイン画面では、上述のポリシーに従うログインボタンのほか、アカウントを保有していない者に対して『アカウント取得を誘導するルート』が必要となるところ。これについて
は、いくつかのパターンが考えられ、その例を以下に示すので参考としていただきたい。
（※下図の画面はイメージ）

3.2.4. Cookie およびトークンについて項目説明

タイムアウト時間

G ビズ ID へのログイン状態を維持する Cookie。
有効な場合、ブラウザを閉じる前であれば、ログインセッションCookie

ID、PWの入力を省略してログインが可能となる。

ブラウザを閉じるまで

ブラウザを閉じた後も、1要素または2要素Cookieが有効期限内であればログインセッションCookieが生成される。
ID、PW での認証が済であることを保持する Cookie。
1要素認証Cookie

有効な場合、ブラウザを閉じた後も、8時間

ID、PWの入力を省略してログインが可能となる。
OTP またはアプリによる認証が済であることを保持する
2要素認証Cookie

Cookie。

3時間

有効な場合、2要素目の認証が省略される。
初めて利用する端末（ブラウザ）かどうか判別するための端末Cookie

Cookie。
初めて利用する端末（ブラウザ）でログインするときには、メ10年ール通知が行われる。※
アクセストークン

userinfoの取得に使用する。

1時間

IDトークン

認証と認可の情報を含むトークン。

10分

リフレッシュトークン

アクセストークンの再取得に使用する。

30日※ブラウザのCookieが維持できない環境下では、ログインの都度メール通知が行われる可能性がある。

3.2.5. 再認証要求
G ビズ ID では、OpenID Connect 標準の Authorization Code Flow に準拠したシングルサインオン機能を提供している。1 度認証を行えば（SSO 認証）、その SSO 認証情報（ログインセッション Cookie）が有効である限り、ユーザは RP 毎に ID/パスワード入力を求められることなく、各 RP が提供する Web サービスを利用できる。
一方、RP 側からの要件として「たとえユーザの SSO 認証が完了している場合であっても、重要なサイトへのアクセスについては再度ユーザの認証（再認証）を行いたい」といったケースや、「共有 PC などでログアウトし忘れたまま離席した際に、当該マシンを第三者に悪用されるリスクを排除したい」といったケースがある。このようなケースに対応するために、OpenID Connect 標準ではユーザ認証を RP 側から明示的に要求する方法が規定されている（以下、この方法を「再認証要求」と呼ぶ）。
3.2.5.1

再認証の要求G ビズ ID では、OpenID Connect 標準に準拠した下記 2 つのパラメータを実装している。明示的な再認証を要求する場合、RP は通常の認可リクエストに下記 2 つのパラメータを追加する。
(1) prompt パラメータ
RP から通常の認可リクエストを受信した際、ユーザの SSO 認証情報が有効であれば、G ビズ ID はユーザへのログイン画面表示は行わない。しかし、認可リクエストの prompt パラメータに値 login が設定されている場合は（prompt=login）、ユーザの再認証が明示的に要求されていると判断し、たとえ当該ユーザの SSO
認証情報が有効であってもログイン画面を表示し、ユーザに対して再度認証を行うよう促す。
(2) login_hint パラメータ
認可リクエストの中で login_hint パラメータが設定されている場合、G ビズ ID はログイン画面を表示する
際の ID 情報の初期値として、当該パラメータに設定された値を表示する。本パラメータに G ビズ ID のアカ
ウント ID（メールアドレス）を設定すれば、再認証時のユーザ利便性を高めることができる。
3.2.5.2

再認証の検証

再認証の実施結果として ID トークンを受信した RP は、ID トークンの検証を行わなければならない。このとき、再認証の実施結果にかかる下記 2 点についても合わせて確認する必要がある。
(1) ユーザ同一性の確認
ログアウトし忘れた共有 PC を第三者に悪用されるリスクに対する対抗策として再認証を利用するケースでは、再認証の前後の ID トークンに含まれる iss クレーム（ID トークンの発行者）と sub クレーム（ユーザ識別子）をそれぞれ比較することによって同一ユーザによる再認証であることを確認する。これにより、別ユー
ザによる再認証の突破を防止することができる。
(2) 再認証の実施確認
RP からの認可リクエストはブラウザ経由のリダイレクトにより G ビズ ID へ到達するため、厳密に言え
ば、認可リクエストのパラメータはブラウザ操作者によって改ざん・追加・削除することができる。もし、prompt=login パラメータが削除されてしまうと、G ビズ ID 側で再認証が行われず、RP もそれに気づくことができない。
ID トークンに含まれる auth_time クレームは、このような再認証の回避を防止するために利用される。
auth_time クレームにはユーザ認証時刻の UNIX タイムスタンプが設定されるため、再認証要求後に取得した ID トークンをチェックした際に、auth_time の値が妥当な範囲で現在時刻に近い時刻である（もしくは、再認証要求の送信時刻よりも後である）ことをもって、RP は確実に再認証が行われたことを確認ができる。

3.3.

API 詳細3.3.1. OpenID Connect について
G ビズ ID は、OAuth 2.0 (RFC6749)をベースとするアイデンティティ連携プロトコル「OpenID
Connect(https://openid.net/connect/)」の Authorization Code Flow に準拠した OpenID
Provider(OP)である。

全体シーケンス

3.3.1.1

OpenID Connect に関する用語は以下の通り。
用語

OpenID Provider (OP)

Relying Party (RP)ID Token
Access Token
UserInfo

説明
ユーザの認証を行う機能を有するサーバ。また、ユーザの認証時にRelying Party から要求されたアイデンティティ情報を供給することができる REST エンドポイントを有するサーバ。
※G ビズ ID のこと。
OpenID Provider に ID Token とアイデンティティ情報を要求するサーバ。シングルサインオン対象のアプリケーションを指す。
※電子申請システムのこと。
認証と認可の情報を含む JWT(JSON Web Token)形式のトークン。
UserInfo エンドポイントにアクセスするためのトークン
Access Token を提示するクライアントに対して、各種属性情報等
アイデンティティ情報を提供する。

（参考）
OpenID Connect の RP として、この認証プロセスを実装するにあたっては、OpenID Connect Foundationが認定したライブラリまたはサービスの採用を推奨する。
https://openid.net/developers/certified/― Certified Relying Party Libraries― Certified Relying Party Servers and Servicesログインフロー
赤字は RP に関連するフローG ビズ ID

ここでリダイレクトする先は、リダイレクト URL として予め G ビズ ID 側に申告いただく値のことアクセストークン再取得フロー
赤字は RP に関連するフローG ビズ IDユーザ再認証フロー
赤字は RP に関するフロー

エンドユーザサイトアクセス

サービスサイト(RP)ブラウザサイトアクセス（ログイン済）※ユーザの再認証が必要な画面

GビズＩＤ

state生成nonce生成
再認証発動

ログインセッションCookie削除
1要素認証Cookie削除
2要素認証Cookie削除(2要素認証の場合)

ＧビズＩＤにリダイレクト
認証リクエスト（state､nonce、prompt=login､login_hint送信）※ログインセッションCookieあり、1要素認証Cookieあり、2要素認証Cookieあり(2要素認証の場合)
ログイン画面表示
ID、PW入力

ログイン（ID、PW）
2要素認証の場合は、2要素のシーケンスが行われる。

code生成ログインセッションCookie生成
1要素認証Cookie生成
2要素認証Cookie生成(2要素認証の場合)

認証レスポンス、サービスサイトにリダイレクト※code、state、ログインセッションCookie、1要素認証Cookie送信、2要素Cookie送信(2要素認証の場合)
ログイン後のURLへアクセス（code、state送信）①【Codeフロー】ユーザー認可リクエスト

state検証
アクセストークン取得リクエスト（code送信）

code検証
access_token生成
refresh_token生成
id_token生成

アクセストークン取得レスポンス（access_token、refresh_token、id_token送信）
id_token検証
nonce検証※id_tokenに含まれるnonceを使用。
auth_time検証 ※id_tokenに含まれるauth_timeを使用。
iss/sub検証※id_tokenに含まれるiss/subを使用。

②【Codeフロー】アクセストークン取得リクエスト

userinfo取得リクエスト（access_token送信）

access_token検証

userinfo取得レスポンス

委任情報取得（API）リクエスト
委任情報取得（API）レスポンス
RP用のCookie生成
再認証後の画面を表示（RP用のCookie送信）③【Codeフロー】属性取得リクエストユーザ認可リクエスト

3.3.1.2（１）認証リクエスト
Authorization エンドポイント（ユーザの認可を得るためのエンドポイント）へ以下リクエストを発行することで、ユーザの認証状態・認可状態を判定し、適切なページへリダイレクトさせ、認可コードを返します。
リクエスト URL
メソッド
URL（本番）GET
https://gbiz-id.go.jp/oauth/authorize

リクエストヘッダ
ヘッダ名

-

設定値

-

備考

-

リクエストコンテント
パラメータ名

データ型

response_type
client_id
redirect_uri

StringStringStringscope

Stringnonce

Stringstate

StringpromptStringlogin_hint

String

〇
〇

必須

備考

「code」： code フロー
RP 毎に予め定義する[Client ID]
RP 毎に予め定義する[ログイン成功時にリダイレクトする
URL] ※G ビズ ID でのログイン成功時にリダイレクトす
る RP 側の URL のこと。
※デフォルトはマイページ画面
RP 毎に [scope]の中から取得したい情報を設定※指定しない場合、当該 RP で利用できる全ての scope を自動設定※１つ以上指定する場合、"openid"必須（【Code フロー】
属性取得リクエストで scope 不正エラー）
リプレイ攻撃防止用のパラメータ。クライアントのセッシ
ョンと OP が払い出す ID Token を関連付けるためのパラメータ。
リクエストとそれに対するコールバックとの間の状態を保守するために使用されるパラメータ「login」：再認証要求（ログイン済ユーザであっても再度ユーザ認証を行う場合に設定）
認証で使用する ID 情報のヒント（ログイン画面のアカウ
ント ID に表示する文字列を設定）

リクエストサンプル
https://gbiz-id.go.jp/authorize?client_id=service1&redirect_uri=http%3A%2F%2Fxxxxx%2Ftop&response_type=code&scope=openid%20email%20profile&nonce=xxx&state=whmpfk&prompt=login&login_hint=testuser@sample.com
リクエストコンテントはリクエスト URL のクエリパラメータに格納ください。

レスポンス
認証基盤のログイン画面が出力されます。

（２）ログイン後の URL アクセスリクエスト（１）の認証リクエストの結果ユーザがログイン操作を実施すると、リダイレクトにより認可コード送信リク
エストが発行されます。
リクエスト URL
メソッド
URL（本番）GET
RP 毎に予め定義する[ログイン成功時にリダイレクトする URL]

リクエストコンテント（正常時）
データ型
パラメータ名

必須

（最大文字
数）

code

String(22)stateString

〇

備考

認可コード
※半角英数字 22 桁
※有効期限：5 分
リクエスト時に保存していた値をコールバック時の値が一致するか確認してください。一致しない場合には CSRF の可能性があるため TokenF へのリクエストは実行しないでください。

リクエストサンプル（正常時）[ログイン成功時にリダイレクトする URL]?code=NFwzQ1fPsTXJCTZpZqLJ95&state=ZZZZZZ

リクエストコンテント（エラー時）
パラメータ名error
error_description
state
scope

データ型

StringStringStringString必須

備考

エラーコードエラー内容の詳細な説明
リクエスト発行時に指定した state の文字列
リクエスト発行時に指定した scope の文字列

エラーコード値

invalid_request
access_denied
invalid_scope
unsupported_response_type
invalid_grant
invalid_client

説明

パラメータ不正認可拒否
サポート外のスコープサポート外のレスポンスタイプ
redirect_uri が設定したものと異なる。
※認証基盤にてエラー画面を表示
client_id が不正※認証基盤にてエラー画面を表示

リクエストサンプル（エラー時）
RP 毎に予め定義する[ログイン成功時にリダイレクトする
URL]?error=invalid_scope&error_description=Invalid%20scope;%20requested:%5Bemail,%20op
enid%5D&state=ZZZZZZ&scope=openid%20profileアクセストークン取得リクエスト

3.3.1.3（１）アクセストークン取得リクエスト
Token エンドポイントへ以下リクエストを発行することで、アクセストークンとリフレッシュトークン（アクセストークン更新用）を返却します。
リクエスト URL
メソッド
URL（本番）POST
https://gbiz-id.go.jp/oauth/token

リクエストヘッダ
ヘッダ名

設定値

Authorization

Basic [client_id:client_secret を base64 でエンコードした値]

備考

リクエストコンテント
パラメータ名

データ型

grant_type
code

StringString〇〇redirect_uri

String〇必須

備考「authorization_code」固定【code フロー】ユーザ認可リクエストで返却された認可コード
RP 毎に予め定義する[ログイン成功時にリダイレクトする
URL]

リクエストサンプル
grant_type=authorization_code&code=OrC9jAu0qx6p9X17r51fXU&redirect_uri=http%3A%2F%2
Fxxxxx%2Ftop
リクエストコンテントはボディ部に格納ください。
レスポンス
パラメータ名

データ型（最大文字数）

必須

access_token
token_typerefresh_token

String(4096)
String(6)String(4096)〇〇

expires_in
scopeIntegerString〇〇id_token

String(4096)

説明

userinfo リクエスト発行時に必要な token「Bearer」固定
access_token の更新時に必要な token※【Code フロー】ユーザ認可リクエストの scope でoffline_access を指定した場合
access_token の有効時間(秒)※1 時間【Code フロー】ユーザ認可リクエストで指定した
scope
ID トークン（JWT（JSON Web Token）フォーマット
でエンコード）・kid：トークンの署名検証に用いる鍵 ID「rsa1」固定・alg：トークン署名の際のアルゴリズム「RS256」固定
・sub：アカウント管理番号(範囲：1〜
2,147,483,647)
・aud：ユーザ認可リクエストで指定した ClientId
・iss：トークン発行者の識別子（環境毎に異なる）[本番] https:\/\/gbiz-id.go.jp\/oauth\/[検証] https:\/\/stg.gbiz-id.go.jp\/oauth\/・exp：トークン有効期限（1970/1/1 00:00:00 からの経過秒数）
・iat：トークン発行時刻（1970/1/1 00:00:00 からの経過秒数）
・auth_time：ユーザ認証時刻（1970/1/1 00:00:00
からの経過秒数）
・nonce：ユーザ認可リクエストで指定した nonce
・jti：JWT ID（トークン毎にユニークな識別子）※【code フロー】ユーザ認可リクエストの scope で""openid""を指定した場合レスポンスサンプル{"access_token":"eyJraWQiOiJyc2ExIiwiYWxnIjoiUlMyNTYifQ.eyJzdWIiOiIyNDIiLCJhenAiOiJjbGllbnQiLCJpc3MiOiJod
HRwczpcL1wvZ2Jpei1pZC5nby5qcFwvb2F1dGhcLyIsImV4cCI6MTY1MTA1ODI5MywiaWF0IjoxNjU
xMDU0NjkzLCJqdGkiOiJjNTQwYzY1Ny0xZmRkLTQzOWItYTQ3MS1mN2Q5NzU1M2UxMzgifQ==.Ps
nYmVqgNGHPCvIDhQkWPqo4EXxv9j0nX9MpJsyignyx5hhOYG41pU_YAaPnAPrq_vmQDL4PSTTgSc
VIENdwa_krWmceA9aKHJJQ7sZSWBre54gUtl0LHTdxzYWhys_uQ8z50ax2nPFhy12URGVU6I4u_0d291K8JxraD
efF-A","token_type": "Bearer","refresh_token":"eyJhbGciOiJub25lIn0.eyJleHAiOjE2NTM2NDY2OTMsImp0aSI6ImQ1NTI4NGM5LWFkOGQtNDk5Zi
05ZDlhLTM4NTUwZTU0MWExMSJ9.","expires_in": 3599,"scope": "openid offline_access","id_token":"eyJraWQiOiJyc2ExIiwiYWxnIjoiUlMyNTYifQ.eyJzdWIiOiIyNDIiLCJhdWQiOiJjbGllbnQiLCJraWQiOiJy
c2ExIiwiaXNzIjoiaHR0cHM6XC9cL2diaXotaWQuZ28uanBcL29hdXRoXC8iLCJleHAiOjE2NTEwNTUy
OTMsImlhdCI6MTY1MTA1NDY5MywiYXV0aF90aW1lIjoxNjUxMDU0NjkxLCJub25jZSI6Inh4eHh4eH
h4IiwianRpIjoiYzEzNGQ5NjYtMjY4Yy00NmNkLWFiZjYtYjVhNTcyODI5NzFiIn0=.NLhSCctrAR7kxHV
dDk8vl-0glWXuDmzPS-8t9Ye7XG2UGE7QJBs845of0tXhSzj3TEOKsljaLb8oJlb379rbJJrZIieTCqc1rjQTkQiWZ48BmFtefg3FRf154iJVL-xDe1FF6BCZHGoBGzAzt63LqiVooWOyPT2tXUazh6VvE"}
レスポンスコンテント（エラー時）
パラメータ名error
error_description

データ型

StringString

必須

エラーコードエラー内容の詳細な説明

備考

エラーコード値

HTTP ステータスコード

unauthorizedinvalid_request
invalid_grant

401
400
400

unsupported_grant_type

400

説明

ユーザ認証不可パラメータ不正認可コードが不正、期限切れ、無効
redirect_uri が Authorization リクエスト時と異なっている
サポート外の grant_type

レスポンスサンプル（エラー時）

例）認可コード不正の場合{"error": "invalid_grant","error_description": "JpaAuthorizationCodeRepository: no Authorization code found for value
SCmPT6NE7jUIUHyi533tP4"}

3.3.1.4

属性取得リクエスト（１）属性取得リクエスト
UserInfo エンドポイントへ以下リクエストを発行することで、ユーザの属性情報を返却します。
リクエスト URL
メソッド
URL（本番）GET
https://gbiz-id.go.jp/oauth/userinfo

リクエストヘッダ
ヘッダ名

Authorization

設定値

Bearer [access_token]

備考

Token エンドポイントで返却される access_token

リクエストコンテントなし
リクエストサンプルなし
レスポンス
次ページに示す。
※○は必須項目です。○がない項目は任意項目となります。

データ型
scope

パラメータ名

（最大文字

プライム

メンバー

エントリー

○

○

○

説明

数）

openidsubStringアカウント管理番号
・内部的な ID を返却
・整数値(Sub 範囲 1～2,147,483,647)

profileaccount_type

String(1)○○○アカウント種別
1：G ビズ ID エントリー
2：G ビズ ID プライム
3：G ビズ ID メンバー

corp_type

String(1)

○

○

○

事業形態
1：法人
2：個人事業主

parent_id

Number○G ビズ ID メンバーの場合、親の G ビズ
ID プライムのアカウント管理番号を返却する。
整数値(1～2,147,483,647)

corporate_number

String(13)

○

○

○

【基本情報】法人番号/個人事業主管理
番号

name

String(150)

en_nameStringprefecture_name

String(2)○○○【基本情報】法人名/屋号

○

○

○

【基本情報】本店所在地/印鑑登録証明【基本情報】法人名/屋号（英語表記）
書住所（都道府県）※JIS X 0401 都道府県コード

address1

String(64)

○

○

○

【基本情報】本店所在地/印鑑登録証明

address2

String(300)

○

○

○

【基本情報】本店所在地/印鑑登録証明書住所（市区町村）
書住所（番地等）
rep_last_nm

String(64)

○

○

○

rep_first_nm

String(64)

○

○

○

rep_last_nm_kana

String(64)

○

○

○

rep_first_nm_kana

String(64)

○

○

○

【基本情報】代表者名/個人事業主氏名（姓）【基本情報】代表者名/個人事業主氏名（名）【基本情報】代表者名フリガナ/個人事
業主氏名フリガナ（姓）【基本情報】代表者名フリガナ/個人事
業主氏名フリガナ（名）birthday_ymd

String(8)○【基本情報】代表者生年月日/個人事業
主生年月日

user

user_last_nm

String(64)

○

○

○

yyyyMMdd【利用者情報】アカウント利用者氏名（姓）

user_first_nm

String(64)

○

○

○

【利用者情報】アカウント利用者氏名（名）

user_last_nm_kana

String(64)

○

○

○

【利用者情報】アカウント利用者氏名フリガナ（姓）

user_first_nm_kana

String(64)

○

○

○

【利用者情報】アカウント利用者氏名フリガナ（名）

user_post_code

String(7)○○○【利用者情報】連絡先郵便番号（ハイフンは含まない）user_prefecture_na

String(2)

○

○

○

me

【利用者情報】連絡先住所（都道府県）※JIS X 0401 都道府県コード

user_address1

String(64)

○

○

○

【利用者情報】連絡先住所（市区町村）

user_address2

String(300)

○

○

○

【利用者情報】連絡先住所（番地等）

user_address3

String(64)【利用者情報】連絡先住所（マンション名等）

user_department

String(64)【利用者情報】会社部署名/部署名

user_tel_no_contac

String(11)【利用者情報】連絡先電話番号（ハイフtンは含まない）user_birthday_ymd

String(8)○【利用者情報】利用者 生年月日
yyyyMMdd

mand

mandate_info

ateclient_id

String(256)user_email

String(255)

email

配列指定
該当ユーザの内部委任情報として登録されている RP の client_id○○○【利用者情報】アカウント ID（メール
アドレス）

email

email

String(255)

○

○

○

【利用者情報】アカウント ID（メールアドレス）レスポンスサンプル（アカウント種別：G ビズ ID プライムの場合の例）{}"sub": "1242 ","account_type": "1""corp_type": "2","corporate_number": "27101007182XX","name": "aaa 株式会社","en_name": "13","prefecture_name": "13","address1": "港区","address2": "〇〇〇丁目〇番〇号","rep_last_nm": "山田","rep_first_nm": "太郎","rep_last_nm_kana": "ヤマダ","rep_first_nm_kana": "タロウ","birthday_ymd": "19800101","user_last_nm": "山田","user_first_nm": "太郎","user_last_nm_kana": "ヤマダ","user_first_nm_kana": "タロウ","user_post_code": "0000000","user_prefecture_name": "13","user_address1": "港区","user_address2": "〇〇〇丁目〇番〇号","user_address3": "","user_department": "総務部","user_tel_no_contact": "11111111111","user_birthday_ymd": "19800101","mandate_info":[{"client_id": "200007app1"},{"client_id": "200017app2"}],"user_email": " yamada.tarou@example.co.jp ""email": " yamada.tarou@example.co.jp "レスポンスコンテント（エラー時）
パラメータ名error
error_description

データ型

StringString

必須

エラーコードエラー内容の詳細な説明

備考

エラーコード値

invalid_token
insufficient_scope

HTTP ステータスコード

401
403

説明

アクセストークン不正、期限切れ、無効
scope 不正レスポンスサンプル（エラー時）例）アクセストークン不正の場合{"error": "invalid_token","error_description": "Invalid access token:
eyJraWQiOiJyca2ExIiwiYWxnIjoiUlMyNTYifQ.eyJzdWIiOiJhZG1pbiIsImF6cCI6ImNsaWVudCIsImlzc
yI6Imh0dHA6XC9cL2xvY2FsaG9zdDo4MDgwXC9tZXRpLW9wZW5pZC1jb25uZWN0LXNlcnZlci13Z
WJhcHBcLyIsImV4cCI6MTUzNDUxMDk3NywiaWF0IjoxNTM0NTA3Mzc3LCJqdGkiOiJiNGY2YWE3NC
1hMDU4LTQ1YjAtYjdlMi0wNGUzYmZiNjE2ZWUifQ.iPqiQ1nnOyQG1oQZDANqW1Zp8Ah5yo_PS8jHDAhac5q8Dj3Lof71Hw9UfxxHOBw3RNZw9G8b_a0qlPy6xoVkYIxEWhwvw8oxRhoHu4BFAFL_QP5PmqRB60bDR2XGjjwCrjOjiobu14vH2H3NQPL9VfAH3yvBYNBcA5unVoQ5JT
K5X5s5yvgwcz7nuzd5D2hOQrwmrCv4SJ9JyPuWYZbPPxe0UDMOw_YN9TBTKPmYMLS8cx5hBQ0v5UhhdIP00j5MqacSJvb8JaedW-7OwvG32H_J0b4Vio8omwWxfHOaa8QmSCMBDiJtWhucWgNnFAG7GQO1uIcV-t7C9ZiPw"}

アクセストークン再取得リクエスト

3.3.1.5（１）アクセストークン再取得リクエスト
Token エンドポイントへ以下リクエストを発行することで、アクセストークンを再度返却します。
リクエスト URL
メソッド
URL（本番）POST
https://gbiz-id.go.jp/oauth/token

リクエストヘッダ
ヘッダ名

設定値

Authorization

Basic [client_id:client_secret を base64 でエンコードした値]-

備考

リクエストコンテント
パラメータ名

データ型

grant_typerefresh_token

StringStringscope

String

〇
〇

必須

備考

「refresh_token」固定【code フロー】アクセストークン取得リクエストで返却された refresh_token【code フロー】ユーザ認可リクエストで指定した scopeの中から取得したい情報を設定※指定しない場合、【code フロー】ユーザ認可リクエストで指定した全ての scope が自動設定※１つ以上指定する場合、"openid"必須（【code フロー】
属性取得リクエストで scope 不正エラー）

リクエストサンプル
grant_type=refresh_token&refresh_token=eyJhbGciOiJub25lIn0.eyJleHAiOjE1Njc1MDAwNTIsImp
0aSI6ImY0YmRhZjZlLWQ3ZjQtNGIwNC05Mjc2LTJiOGMwNGIzNDYyNiJ9.&scope=openid email
profileリクエストコンテントはボディ部に格納ください。
レスポンス
パラメータ名

データ型（最大文字数）

access_token
token_typerefresh_token
expires_in
scopeString(4096)
String(6)String(4096)
IntegerStringid_token

String(4096)

必須

〇
〇
〇
〇
〇

説明

userinfo リクエスト発行時に必要な token「Bearer」固定
access_token の更新時に必要な token
access_token の有効時間(秒)【code フロー】アクセストークン再取得リクエストで指定した scope
ID トークン（JWT（JSON Web Token）フォーマット
でエンコード）・kid：トークンの署名検証に用いる鍵 ID「rsa1」固定・alg：トークン署名の際のアルゴリズム「RS256」固定
・sub：アカウント管理番号(範囲：1〜
2,147,483,647)
・aud：ユーザ認可リクエストで指定した ClientId
・iss：トークン発行者の識別子（環境毎に異なる）

[本番] https:\/\/gbiz-id.go.jp\/oauth\/[検証] https:\/\/stg.gbiz-id.go.jp\/oauth\/・exp：トークン有効期限（1970/1/1 00:00:00 からの経過秒数）
・iat：トークン発行時刻（1970/1/1 00:00:00 からの経過秒数）
・auth_time：ユーザ認証時刻（1970/1/1 00:00:00
からの経過秒数）
・nonce：ユーザ認可リクエストで指定した nonce
・jti：JWT ID（トークン毎にユニークな識別子）※【code フロー】ユーザ認可リクエストの scope で""openid""を指定した場合レスポンスサンプル{"access_token":"eyJraWQiOiJyc2ExIiwiYWxnIjoiUlMyNTYifQ.eyJzdWIiOiIyNDIiLCJhenAiOiJjbGllbnQiLCJpc3MiOiJod
HRwczpcL1wvZ2Jpei1pZC5nby5qcFwvb2F1dGhcLyIsImV4cCI6MTY1MTA2NDQwMiwiaWF0IjoxNjU
xMDYwODAyLCJqdGkiOiJjODdmYzliMy05OTJjLTRiYjAtOGIzOC05MzFhNGMzMTdkMTQifQ==.brz2D
mhKith6aeOTIg-0vt46sqSmuaGvppO98crWeSGFWgurbmAW4hYPC103n9MhPNab-vkdMu1e96OuomrojQdod1s3wcoi64Z64hn2wpWJP3RSNUjUnCvhEx3Lb3hrWViqT0UCURAqL5OWF7dTFI
GXI-Ne5FDzGSjDHjIAIw","token_type": "Bearer","refresh_token":"eyJhbGciOiJub25lIn0.eyJleHAiOjE2NTM2NTI4MDIsImp0aSI6ImY0YmRhZjZlLWQ3ZjQtNGIwNC05
Mjc2LTJiOGMwNGIzNDYyNiJ9.","expires_in": 3599,"scope": "openid","id_token":"eyJraWQiOiJyc2ExIiwiYWxnIjoiUlMyNTYifQ.eyJzdWIiOiIyNDIiLCJhdWQiOiJjbGllbnQiLCJraWQiOiJy
c2ExIiwiaXNzIjoiaHR0cHM6XC9cL2diaXotaWQuZ28uanBcL29hdXRoXC8iLCJleHAiOjE2NTEwNjE0M
DIsImlhdCI6MTY1MTA2MDgwMiwiYXV0aF90aW1lIjoxNjUxMDU0NjkxLCJub25jZSI6Inh4eHh4eHh4
IiwianRpIjoiYTE0ZGNlMTktOGZlNS00NWE3LWI1MTMtZTAyNjA5YjU2NzY5In0=.FBz2B5DuRFcZGP
uNKpJ4gglV7BRsyJlhOMwwcxeUNqc8W7Ac5T3B9WXk5AIPbn77VvxrFafFsrqv58Sqtil_1FDjjz9Eh2_
WMYNFh5j4d8LzN1eZbqlsCxkujVMM35RFtXVwjQCm6vVHYIEdYMz7DvtwXLE8Htanu6vpV3L1R7Q"}

レスポンスコンテント（エラー時）
パラメータ名error
error_description

データ型

StringString

必須

エラーコードエラー内容の詳細な説明

備考

エラーコード値

unauthorizedinvalid_token
invalid_scope

HTTP ステータスコード

401
401
401

説明

ユーザ認証不可リフレッシュトークンが不正、期限切れ、無効
サポート外のスコープ

invalid_request
unsupported_grant_type

400
400

パラメータ不正サポート外の grant_type

レスポンスサンプル（エラー時）例）パラメータ不正の場合{"error": "invalid_token","error_description": "Invalid refresh token:
eyJhbGciOiJub25lIn0.eyJleHAiOjE1Njc1MDExNTQsImp0aSI6IjI3MWM3YzdjLWJmYWItNDA0ZC1iM
GNhLTkzYTYxOTBlODYyZSJ9."}3.3.1.6

各リクエスト検証方法（１）state 検証
state の検証は以下のように実施します。
No

1

検証方法

ユーザ認可のレスポンスで取得した state の値が、リクエストで送信した値と同じであること。

（２）ID トークン検証/nonce 検証
id_token は、JSON Web Token (JWT)形式となっており、「.」(ピリオド)区切りで、ヘッダ部、ペイロード部、署名部に分かれています。nonce はペイロード部に含まれています。
ヘッダ部、ペイロード部は Base64 でエンコードされており、以下のような値が設定されています。
※ id_token/nonce の検証で使用する主要なものを記載しています。実際には他の値も含まれています。
分類

ヘッダ部
ペイロード部

パラメータ名

alg
iss

sub
aud
exp
iat
auth_time
nonce

説明

id_token の署名に使用されるハッシュアルゴリズム。
id_token の発行者。
G ビズ ID の URL「https://認証基盤のドメイン/oauth/」となる。
認証されたユーザを示す識別子。
G ビズ ID のアカウント管理番号が設定される。
id_token の受け取り者。
RP の client_id が設定される。
id_token の有効期限。
UNIX タイム（UTC の 1970/1/1 00:00:00 からの経過秒数）となる。
id_token の発行時刻。
UNIX タイム（UTC の 1970/1/1 00:00:00 からの経過秒数）となる。
ユーザ認証時刻。
UNIX タイム（UTC の 1970/1/1 00:00:00 からの経過秒数）となる。
クライアントのセッションと ID Token を紐付ける文字列。
リプライアタックの防止に利用。
認証リクエストで指定した値が設定される。

ID トークンの検証は以下のように実施します。再認証要求を行った場合の ID トークンの検証では、下記
No.1～5 に加え、No.6～7 を検証する。
No

1
2
3

4
5
6

7

検証方法

iss(id_token の発行者)の値が「https://認証基盤のドメイン/oauth/」と一致することを確認する。
aud(id_token の受け取り者)の値が認証リクエストで送信した client_id と一致することを確認する。
id_token の値を alg のハッシュアルゴリズムで検証する。
※検証には OpenID Connect ライブラリ等を使用する。
※公開鍵は下記の jwks_uri パラメータの値で示される。
https://認証基盤のドメイン/oauth/.well-known/openid-configuration
exp(id_token の有効期限)が現在時刻より後であることを確認する。
iat(id_token の発行時刻)が現在時刻より前で、古すぎないことを確認する。
※どのくらい古い id_token を許容するかは、RP 側の判断とする。
再認証要求を行った場合には（未認証ユーザに対する再認証要求の場合を除く）、再認証後に取得したユーザの ID トークンに含まれる iss 値と sub 値が再認証前の iss 値と sub 値に一致していることを確認する。
再認証要求を行った場合には、auth_time の値が妥当な範囲で現在時刻に近いことを確認する。

nonce の検証は以下のように実施します。
No

1

検証方法

nonce の値が認証リクエストで指定したものと一致することを確認する。

3.3.2. 委任情報取得 API について
（１）委任情報取得リクエスト指定されたアカウントの受任情報を取得します。受任者のアカウント管理番号を指定すると、レスポンス情報として受任者に対し委任を行った委任者の情報（委任元情報）が取得可能です。なお、指定アカウント（アカウント管理番号）が G ビズ ID メンバーの場合、親の G ビズ ID プライムの受任情報を取得します。
リクエスト URL
メソッド
API パス

POST[コンテキストパス]/delegation※コンテキストパス＝/api

リクエストコンテント（正常時）パラメータ名

データ型（最大文字数）必須

client_key

String(255)〇client_token

String(255)〇

meti_id

String

〇

備考

半角英数字
※RP 利用申請にて委任有りとした際払い出される
client_key
半角英数字※クライアント識別子との組合わせで認証処理を行う※RP 利用申請にて委任有りとした際払い出される
client_token
アカウント管理番号
半角数字※UserInfo で取得できるアカウント管理番号（sub）を入
力

リクエストサンプル（正常時）{“client_key”:”aaaaa”,“client_token”:”76D69F8D708746AA43A65E8B29C5D9A1”,“meti_id”:”12345678”}
リクエストコンテントはボディ部に格納ください。
レスポンス
HTTP ステータス

200
400

意味

401

処理成功
リクエストパラメータエ
ラー
認証エラー

500

API 内システムエラー

処理成功
属性チェックエラーの場合

説明

client_key と client_token での認証がエラーとなった場
合
予期しないシステムエラーが発生した場合

レスポンスコンテント※○は必須項目です。○がない項目は任意項目となります。

No

項目名

1
2

委任元情報

3
4

対象サービス

委任申請番号パラメータ名delegation_info
delegation_no

データ型（最大文字数）

String(15)

プ
ラ
イ
ム

メ
ン
バ
ー

エ
ン
ト
リ
ー

備考

○
○

○
○

配列指定

○
○

○
○

半角英数字

半角数字＆半角ハイフン
0-yyMMdd-0000-0 形式

String(5)委任開始日

system_cd
delegation_start

5

委任終了日

delegation_end

String(8)6アカウント管理番号

meti_id

Number

〇

〇

半角英数字

7

事業形態

business_type

String(1)○〇8

法人番号／個人事業主管
理番号
法人名／屋号
法人名／屋号 英語表記

corp_noString(13)

○

〇

半角英数字
1：法人
2：個人事業主
半角英数字

firm_nm
firm_nm_en

String(150)
String

〇

〇

全角
半角英数字

本店所在地／印鑑登録証
明書住所 都道府県
本店所在地／印鑑登録証
明書住所 市区町村
本店所在地／印鑑登録証
明書住所 番地等
代表者名／個人事業主氏
名（姓）代表者名／個人事業主氏
名（名）代表者名フリガナ／個人
事業主氏名フリガナ（姓）
代表者名フリガナ／個人
事業主氏名フリガナ（名）
代表者生年月日／個人事
業主生年月日アカウント利用者氏名（姓）
アカウント利用者氏名（名）
アカウント利用者氏名フリガナ（姓）
アカウント利用者氏名フリガナ（名）
連絡先郵便番号

address_pref

String(5)

○

〇

全角

address_city

String(64)

○

〇

全角

address_numberlast_nmString(300)

○

〇

全角

String(64)

○

〇

全角

first_nm

String(64)

○

〇

全角

last_nm_kana

String(64)○〇

全角カタカナfirst_nm_kana

String(64)○〇

全角カタカナbirthday

String(8)〇user_last_nm

String(64)

○

〇

半角数字
yyyyMMdd
全角

user_first_nm

String(64)

○

〇

全角

user_last_nm_kanauser_first_nm_kanauser_post_cd

String(64)○〇

全角カタカナString(64)○〇

全角カタカナString(7)

○

〇

半角数字

9
10
11
12
13
14
15
16

17

18
19
20
21
22
23

String(8)半角数字
yyyyMMdd
半角数字
yyyyMMdd

24

連絡先住所 都道府県

25

連絡先住所 市区町村

26

連絡先住所 番地等

2728

連絡先住所 マンション名等
会社部署名／部署名

29

連絡先電話番号30

アカウント ID(メールアドレス)

user_address_prefuser_address_city
user_address_n
umber
user_address_bldg
user_departmentuser_tel_no_co
ntact
user_email

String(5)

○

〇

全角

String(64)

○

〇

全角

String(300)

○

〇

全角

String(64)全角String(64)全角String(11)半角数字

String(255)

レスポンスサンプル（正常時）{"delegation_info": [{"delegation_no": "1092730197","system_cd": "AAAAA","delegation_start": "20181001","delegation_end": "20190228","meti_id": "27019707","business_type": "1","corp_no": "2710100718279","firm_nm": "あああ","firm_nm_en": "aaa","address_pref": "東京都","address_city": "○○区","address_number": "××１２－３－４","last_nm": "〇〇 〇〇",
"first_nm": "〇〇 〇〇",
"last_nm_kana": "〇〇 〇〇",
"first_nm_kana": "〇〇 〇〇",
"birthday": "19700101","user_last_nm": "〇〇","user_first_nm": "〇〇","user_last_nm_kana": "〇〇","user_first_nm_kana": "〇〇","user_post_cd": "1234567","user_address_pref": "東京都","user_address_city": "○○区","user_address_number": "××１２－３－４","user_address_bldg": "○○ビル３F","user_department": "○○部","user_tel_no_contact": "01234567890","user_email": "aaa@bbb.cc"
},

〇

〇

メール形式

{

}

]

}

"delegation_no": "1092730197","system_cd": "AAAAA","delegation_start": "20181001","delegation_end": "20190228","meti_id": "27019707","business_type": "1","corp_no": "2710100718279","firm_nm": "あああ","firm_nm_en": "aaa","address_pref": "東京都","address_city": "○○区","address_number": "××１２－３－４","last_nm": "〇〇 〇〇",
"first_nm": "〇〇 〇〇",
"last_nm_kana": "〇〇 〇〇",
"first_nm_kana": "〇〇 〇〇",
"birthday": "19700101","user_last_nm": "〇〇","user_first_nm": "〇〇","user_last_nm_kana": "〇〇","user_first_nm_kana": "〇〇","user_post_cd": "1234567","user_address_pref": "東京都","user_address_city": "○○区","user_address_number": "××１２－３－４","user_address_bldg": "○○ビル３F","user_department": "○○部","user_tel_no_contact": "01234567890","user_email": "aaa@bbb.cc"

レスポンスサンプル（検索結果 0 件）
{
}

4.

リリースに向けた作業について

4.1.

各環境概要

G ビズ ID では以下環境を用意します。
項目

利用目途

G ビズ ID サービス本番環境

G ビズ ID サービスが稼働する環境。
G ビズ ID サービス本番環境は、RP
本番環境と接続することを前提としております。RP の検証環境とは接続できませんのでご注意ください。
＜基本の考え方＞

RP 本番環境の設定のスケジュール
は、RP のサービスリリース日（エンドユーザへの公開日）の原則 1 週間前となります。G ビズ ID 本番環
境は稼働中のシステムであるため、本番環境以外で稼働前のＲＰとの接続は許可しておりません。

URL のドメイン部
分※
RP 登録方法
制限事項

G ビズ ID サービス検証環境

RP 向けに提供する検証環境。

G ビズ ID サービス検証環境は、RP
検証環境と接続することを前提としております。
なお、検証環境は本番環境でのシステ
ム連携前の接続確認用としての役割だ
けでなく、G ビズ ID サービスの機能追加・変更時における先行リリースの実施に伴い、RP 側のシステムに影響がないかを確認いただく用途にもご利用いただきます。RP 側でも検証環境をご準備いただき検証環境と接続してご確認いただきますよう、お願いいたします。
＜基本の考え方＞※なお、ネットワーク疎通のため G
ビズ ID の本番環境と早く接続されたいというご要望をいただきますが、G ビズ ID 検証環境とシステム
構成、ネットワークが同一なため、検証環境でテストを行うようお願いいたします。

＜イレギュラー対応：
接続したい場合は要相談＞
RP 検証環境が準備できず、リリース直前まで本番環境しか準備ができない
場合は、RP 本番環境リリース前までであれば、RP 本番環境と G ビズ ID
検証環境とのシステム連携による検証は可能といたします。ただし原則的には検証環境をご準備ください。

gbiz-id.go.jp

stg.gbiz-id.go.jp

RP 設定申込書を G ビズ ID RP サポート窓口へ提出する。
基本的に試験実施は不可。認証連携に関する疎通確認レベルの動作確認
のみは可能ですが、その他試験、特に性能負荷試験や異常系試験などの、本番環境運用に影響を及ぼす可能性がある作業は禁止いたします。

RP 設定申込書を G ビズ ID RP サポー
ト窓口へ提出する。
性能負荷試験や異常系試験など、稼働中の検証環境での運用に影響を及ぼす可能性がある作業は禁止いたします。

Web サイトの URL はそれぞれ以下の通り
ログイン：https://（URL のドメイン部分）/oauth/authorize
エントリー新規登録：https://（URL のドメイン部分）/app/baa/reg/mailaddr/input
プライム新規作成：https:// （URL のドメイン部分）/app/rep/reg/apply/show

4.2.

審査および設定申込に関する対応フローと注意事項

注意！本ガイドラインは行政サービス担当者向けのガイドラインであり、G ビズ ID 作成に関するマニュアルではございません。
法人・個人事業主の方が G ビズ ID を作成されたい場合は、G ビズ ID | ご利用ガイド (gbiz-id.go.jp)をご覧ください。
G ビズ ID と行政サービス連携に向けた審査および接続設定の流れを示します。
以下の流れに沿って、RP 側での調整および動作確認を実施ください。

RP サポートデスクとの各手順（業務フロー）は、次ページに記載しております。

〈各手順に関する業務フロー〉【注意】※1 上記フローに関し、RP 設定申込書に記載の「サービスリリース予定日」から 1 週間以内に、
下記〈サービスリリースの定義〉に従いリリースが完了したとご連絡いただけていない場合、
G ビズ ID 本番環境上の設定を強制削除させていただきますので必ずご連絡下さい。
予期しないトラブルなどでサービスが開始できないご事情がある場合はご相談下さい。
※ RP システムサイト内で G ビズ ID との連携ができているか確認の上、1 週間以内にご連絡いただけます
ようお願い致します。
〈サービスリリースの定義〉
・行政サービス一覧に記載される URL から遷移し G ビズ ID ログインボタンによりログインができる。
・G ビズ ID でログイン後、利用できるコンテンツが準備されている。
【補足】
ただし、行政サービス一覧に掲載しない RP や一般公開していない RP については、RP から「G ビズ ID でログイン後、利用できるコンテンツが準備され利用者に展開できている。」という申告に基づきサービスリリースとさせていただきます。

4.2.1. ⓪事前準備について以下の Web サイトから各ドキュメントファイルをダウンロードいただき、各ドキュメントの内容をご確認ください。
https://gbiz-id.go.jp/top/system_guide/system_guide.html
必ず各ドキュメントをご一読の上、お申込みのフローに進んでください。
各ドキュメントの概要について以下に示します。
項目

ドキュメント名G ビズ ID サービス連携利用規約

行政サービス向けドキュメント一式

G ビズ ID 接続システム向けガイド
ライン
G ビズ ID サービス連携利用申請書

利用者向けドキュメント一式

利用規約

プライバシーポリシー

概要
G ビズ ID とシステム連携する行政サービスに、G ビ
ズ ID で認証を行う際に必要な事項および遵守していただく事項などが記載された資料。
本書を指し、接続に向けてサービス仕様や手順が記載された資料。
G ビズ ID に接続いただくための利用申請書。こちらの申請書に基づき RP サポートデスクにて申請の審査を行います。
利用者向けに G ビズ ID の利用に関する条件等を定めた利用規約。
利用者向けに G ビズ ID のプライバシーポリシーを定めたもの。

4.2.2. ①利用申請について
G ビズ ID の利用にあたり、デジタル庁にて利用内容の確認および審査を行わせていただきます。
G ビズ ID サービス連携利用申請書をご入力の上、以下のメールアドレスまでご連絡をお願いいたします。
G ビズ ID RP サポート窓口： gbizid_rp_support@ml.ntt.com※上記メールアドレスには、デジタル庁及び委託業者である NTT コミュニケーションズが含まれております。
＜注意点＞
・サービス連携申請を行う際は、申請を行う組織・団体に所属される方から申請するようにしてください。所属されていない方（例：組織・団体から委託された開発ベンダ様、NPO 法人等）
からの代理申請は受理できませんのでご注意下さい。
・G ビズ ID サービス連携利用規約第２条定義第 1 項に規定する申請を担当する部局・団体等以外のお申込みは受理できません。事前に利用規約をご確認の上、お申込みください。
また、申請書上には G ビズ ID サービス連携利用規約第２条定義第 1 項に規定する申請を担当する部局・団体に関し団体分類を選択いただきます。このうち「⑤二つ以上の①から④に掲げる団体が運営する団体」を選択された方につきましては、利用申請書上に所属する団体名すべてを記載
いただきます。記載内容により個別にヒアリングをさせていただく場合や、申告書等の別の書式の提出を申し出る場合がございますので、あらかじめご了承ください。
「⑤二つ以上の①から④に掲げる団体が運営する団体」の方につきましては、お早めに申請を行うようお願いいたします。
・審査完了後、RP サポートデスクより審査完了のご連絡と以下 2 点の関連書類を送付させいただきます。

項目

ドキュメント名
RP 設定申込書

RP 設定申込

G ビズ ID サービス RP 設定申込に伴う詳細および依頼事項

概要
G ビズ ID の連携設定のために、必要な情報をご記載いただく設定申込書
設定申込提出時の注意点や、検証環境へのアクセス手段を記載した資料

4.2.3. ②接続申込について
RP 設定申込書に必要事項をご記載いただき、以下のメールアドレスまでご連絡をお願いいたします。
G ビズ ID RP サポート窓口： gbizid_rp_support@ml.ntt.com
RP 設定申込書にご記載いただく項目については、4.2．RP 設定申込書の欄をご参照ください。また記載においての重要事項・注意点について以下に記載しますので、必ずご確認下さい。
【提出期限について（重要）】G ビズ ID の RP 設定申込書の提出期限
全ての情報をご記載いただいた上で希望するサービスリリース日（エンドユーザへの公開日）の6 週間前までに RP サポート窓口まで提出してください。
※6 週間前の該当日が祝日/土日の場合は、その前日までに提出してください。
なお、RP 設定申込書に不備があった場合や受領する時期や混雑状況により、設定が希望日より遅れる場
合、またスケジュールを調整させていただく場合などがございますので、その際はご了承ください。
サービスリリース日に間に合わせるため 6 週間より以前に、極力早めにご提出いただけますようお願いしております。何卒ご理解ご協力の程よろしくお願いいたします。
RP 設定申込書の提出後に、記載情報が変更になる場合は、再度設定日を調整させていただきます。
例：6 月 30 日 がサービスリリース日の場合の各設定日イメージ
・RP 設定申込書の提出は、遅くともサービスリリース日の 6 週間前（5 月 19 日頃）に実施いただくようお願
いさせていただいております。理由としましては検証環境設定後に接続がうまくいかないケースもあるので、検証環境設定後のエラー解析や解消に関連し、RP 設定申込書本番環境設定内容確定まで、2 週間程度のバッファを持っていただくためです。
・検証環境の設定は、RP 設定申込書受領後、2 週間前後の日程にて設定日を調整いたします。

【その他：記載における注意点】
項目

注意点
利用申請書や RP 設定申込書、メールに記載される例―

サービス名称は統一されたものをご連絡ください。

RP 名称に関する依頼事項

本番環境と検証環境のサービス名称については、区

本番：ABC システム

別できるよう記載ください。

検証：ABC システム（検証）

冒頭に識別できる言葉を入れるため、以下を参考に

悪い例：△△県電子申請システム（○○市）

ご命名ください。

良い例：○○市電子申請システム、△△県○○市電子申請システム

検証環境が複数ある場合は、各々の名称が区別でき

ABC システム（検証①）

るように命名してください。

ABC システム（検証②）

RP 設定申込

設定申込書のファイル名は、行政サービス名（RPRP 設定申込書_verXX_★RP 名★_日付_○〇環書のファイル名）を記載するようにしてください。右の記載例の

境①新規 or 変更 or 削除

命名規則

命名規則を参考にご記載ください。

RP 設定申込書の版数（バージョン）

設定変更時には、最新の RP 設定申込書（リダイレ等―

クト URL などが記載された資料）に記載してくだ
さい。RP 設定申込書の版数が上がった場合は、最新の資料に転記してください。

4.2.4. ③検証環境での動作確認について
RP 設定申込書受領後に、RP サポートデスク側にて、検証環境設定日の調整を行います。設定希望日の前週
もしくは当週に RP サポートデスクより検証環境設定日のご連絡をいたします。G ビズ ID 側で G ビズ ID
検証環境への設定が完了しましたら、RP サポートデスク側より設定完了の旨、ご連絡をいたします。設定完了時には、RP 側の設定に必要となる設定情報（ClientID と ClientSecret 等）をお送りします。
＜③検証環境設定に関する業務フロー＞

4.2.5. ④本番環境での動作確認について
検証環境設定完了後、RP サポートデスク側にて、本番環境設定日の調整を行います。本番環境の設定日は、行政サービスのリリース（エンドユーザへの公開日）の 1 週間前とさせていただきます。RP サポート
デスクから設定前週までに、設定日についてご連絡をいたします。
RP サポートデスクより、事前に設定情報（ClientID と ClientSecret 等）をお伝えいたします。
また設定日当日の作業完了後に、設定完了の旨のご連絡をさせていただきます。
＜④本番環境設定に関する業務フロー＞＜④本番環境設定に関する業務フロー＞

4.2.6. ⑤リリース作業
G ビズ ID 本番環境の設定が完了し、さらに※RP 側で動作確認等が完了しましたら、利用者向けにサービスリリースに向け準備していただきます。このフェーズの作業について G ビズ ID 側は関与いたしません。

4.2.7. ⑥リリース後の設定変更・設定追加依頼要望について
リリース後に設定内容を変更されたい場合は、RP 設定申込書に必要事項をご記載いただけましたら、変更の対応を行います。RP 設定申込書上で変更したい点を明示的にご記載いただき（赤字など変更点を明確にしていただき）、以下のメールアドレスまでご連絡をお願いいたします。
G ビズ ID RP サポート窓口： gbizid_rp_support@ml.ntt.com【提出期限について（重要）】G ビズ ID の RP 設定申込書の提出期限：
検証環境及び本番環境にかかわらず全ての情報をご記載いただいた上で遅くとも、

変更希望日（本番環境の場合はエンドユーザへの公開日）の 3 週間前までに、RP サポート窓口まで提出してください。
※3 週間前の該当日が祝日/土日の場合は、その前日までに提出してください。
なお、ＲＰ設定申込書の「G ビズ ID TOP ページコンテンツ（利用可能なサービス一覧）への登録内容に記載いただく内容については、G ビズ ID の本番環境及び検証環境設定とは別タイミングとなり
月 1 回（第一営業日）となります。
原則、新規申込時は RP 様のサービスリリース日（サービス開始日）の翌月の第一営業日に掲載されます（サービスリリース日が第一営業日の場合は同日に掲載します。
）が、サービスリリース時には掲載を希望せず、後日掲載されたい場合は、毎月 10 日までに申請いただくと翌第一営業日に掲載いたしますので、事前にご相談ください。また掲載後、サービスＵＲＬや連絡先等内容に変更が発生した場合もご連絡ください。
4.2.8 その他（テストアカウントの作成手順）
G ビズ ID では検証環境・本番環境用のテストアカウントをご用意しております。
G ビズ ID プライムの作成には、書類郵送やマイナンバーカード登録などが必要となりますが、テストアカ
ウントはそれらの対応不要でご利用できます。
アカウント種別や検証環境、本番環境によって作成手順等は異なります。詳細は以下にてご確認ください。

項目

G ビズ IDプライム

G ビズ ID サービス本番環境
テストアカウント

RP 設定申込書上にて G ビズ ID 本
番環境テストアカウント 1 アカウン
トを申請いただいた後に、RP サポ
ートデスクにて作成、テストアカウ
ントを貸与いたします。
テストアカウントは RP ごとに 1 ア
カウント限定となります。
また、本テストアカウントでは、ご自身が担当されている行政サービス
のみログインを許可します。その他
行政サービスへはログインしないよ
うお願いいたします。
原則的に作成不可G ビズ ID プライムテストアカウン
トに紐づくメンバー作成は不可となります。

G ビズ ID
メンバー

G ビズ ID
エントリー

原則的に作成不可G ビズ ID サービス検証環境
テストアカウント

行政サービス担当者が G ビズ ID 検証環境にて、G ビズ
ID 検証環境テストアカウントを作成いただき、RP サポ
ートデスク宛てに承認依頼のメールを送信してください。その後 RP サポートデスクでの承認によって、テス
トアカウントのご利用が可能となります。
G ビズ ID 検証環境については、RP 利用申請審査完了
後に、アクセス先などの詳細をご連絡いたします。

行政サービス担当者にて、G ビズ ID 検証環境テストア
カウント作成が可能です。上記 G ビズ ID プライム作成
後に、G ビズ ID プライムからのアカウント作成が可能となります。
ただし、作成した G ビズ ID メンバーにアドミン権限を付与することは検証環境ではできません。
G ビズ ID 検証環境については、RP 利用申請審査完了
後に、アクセス先など詳細をご連絡いたします。アカウントの作成方法は、G ビズ ID メンバー作成マニュア
ルを参照：https://gbizid.go.jp/top/manual/pdf/QuickManual_Member.pdf
行政サービス担当者にて検証環境で作成が可能です。
G ビズ ID 検証環境にて、ご自由に作成いただけます。

G ビズ ID 検証環境については、RP 利用申請審査完了
後にアクセス先などの詳細をご連絡いたします。アカウントの作成方法は、G ビズ ID エントリー作成マニュ
アルを参照：
https://gbizid.go.jp/top/manual/pdf/QuickManual_Entry.pdf
なお、テスト用に G ビズ ID サイトから正規のルート（書類郵送申請もしくはオンライン申請）にて、
G ビズ ID プライムや G ビズ ID メンバー、G ビズ ID エントリー作成することは禁止しております。
各環境における G ビズ ID プライムテストアカウントの作成手順については、次のスライドに示します。

<G ビズ ID サービス本番環境： G ビズ ID プライムテストアカウント作成手順>
G ビズ ID 本番環境：G ビズ ID プライムの作成手順について、以下に示します。
手順

1

―

２

概要

詳細

G ビズ ID 本番環境設定日の前日に、RP サポート窓口より、G ビズ
ID プライムテストアカウントのロ
グイン ID/Password などの設定情報を受領します。

G ビズ ID プライムテストアカウントの ID およびパスワー
ドを用いて G ビズ ID 本番環境にアクセスして、疎通確認な
どのテストを実施してください。
【注意点】
・G ビズ ID メンバーは、作成いただくことができません。

RP 設定申込書提出の際に、RP 設定 RP 設定申込書上に、G ビズ ID プライムテストアカウントの有申込書【7．本番環境疎通確認用テスト 無およびメールアドレス/SMS 受信番号を記載してくださアカウントの有無について】に必要事項 い。
を記載して提出する。
【注意点】
・テストアカウントは 1 アカウントのみとなります。
・個人事業主種別での作成はできません。
RP サポート窓口にて、本番環境用の G ビズ ID プライムテストアカウントを作成いたします。
G ビズ ID 本番環境設定前日に、ログイン ID/Password などの設定情報をお伝えいたします。

<G ビズ ID サービス検証環境： G ビズ ID プライムテストアカウントの作成手順>
G ビズ ID 検証環境： G ビズ ID プライムテストアカウントの作成手順を以下に示します。
手順
1

2

３

―
４

概要

G ビズ ID 検証環境にアクセス

詳細G ビズ ID 検証証環境にアクセスしてください。
G ビズ ID 検証環境については、RP 利用申請審査完了のご連
絡時に、アクセス先の URL などの詳細をご連絡いたします。
G ビズ ID 検証環境上にてご自身にて G ビズ ID 検証環境上にて書類郵送申請より G ビ
G ビズ ID プライムアカウントを作 ズ ID プライムの申請を登録してください。
成・法人アカウントを作成する場合は、自社の法人番号を利用してください。
（申請画面にて「その法人番号ですでに登録されています」というメッセージについては無視してください）・個人事業主のアカウントについては、特に制限事項はございません。
※なお、本環境は検証環境であるため、アカウント作成後の印鑑（登録）証明書、申請書等、郵送等は不要です。
特にアカウント数に制限はございませんが、必要なアカウン
ト数のみを申請してください。
G ビズ ID プライムのアカウント承 gbizid_rp_support@ml.ntt.com 宛てに、承認依頼（メー
認依頼を RP サポート窓口にメール ルアドレスと申請 ID）をメールでご連絡ください。
でご連絡ください。
・承認依頼時には必ず、行政サービス名（RP 名）と氏名を記載してださい。文面サンプルを本項目の下部に記載します。
・アカウントの申請が複数件ある場合は、申請 ID ごとの依頼ではなく、まとめて（複数の申請 ID を列挙し）申請依
頼をくださいますようお願いいたします。
RP サポート窓口にて、アカウント承認を行います。承認後には、アカウント承認の旨のメールが送付されます。
メールに基づき、ID 登録を完了送付されたメールに従い、G ビズ ID アカウント登録を完了させてください。その後 G ビズ ID メンバーの作成も可能になります。

検証環境では、多要素認証に関し、SMS 認証により認証を実施してください。（本番環境においては、2024 年以降ログイ
ン時の SMS を用いたワンタイムパスワード認証は廃止する
予定ですが、現状検証環境ではその予定はございません。廃止の方針などが決まった場合はご連絡させていただきます。
）（サンプル）G ビズ ID 検証環境 G ビズ ID プライムテストアカウント承認依頼メール
メールアドレスおよび申請 ID に加えて、ご所属の情報および RP 名を記載するようお願いいたします。
Title:【●●市電子申請システム】 検証環境の gBizID プライム承認依頼について
宛先：gbizid_rp_support@ml.ntt.com
RP サポート窓口宛て●●市の△です。
表記の件につきまして、検証環境での gBizID プライムアカウントの承認を依頼いたします。
メールアドレス：XXXX
申請 ID:TEST1-2308xx-0002-0

RP 名：●●市電子申請システム

以上、よろしくお願いいたします。

※申請 ID に関しまして、検証環境では画面上に表示される申請 ID は冒頭に”TEST”が付きませんが、PDF 上に表示される申請 ID は冒頭に”TEST”と付いた ID となります。いずれの ID でも構いません。

4.3.

RP 設定申込書

以下の項目を記載してください。すべての内容が揃わない場合は、申請を受理できません。
No
１
２
３
４
5
6
7
8

項目

基本情報（連携サービス概要）
OpenID Connect 連携に関する情報
委任申請に関する情報
多要素認証ポリシーに関する情報
TOP ページコンテンツ（利用可能なサービス一覧）への登録内容
システム内の「利用可能なサービス一覧への表示・非表示」について
本番環境疎通確認用テストアカウントの有無について
ご連絡先情報内容

サービスの概要および G ビズ ID のリポジトリに登録する情報
OpenID Connect 連携設定時に必要な情報
委任設定に必要となる情報※委任者からの申請を受け付けるシステムの場合
1 要素認証もしくは 2 要素認証サイトもしくは 1 要素
2 要素混在サイトかを選択
TOP ページ及びシステム内部の「利用可能なサービス
一覧」に掲載する情報システム内の「利用可能なサービス一覧」へのサービス名称の表示可否を選択
本番疎通確認用にテストアカウントが必要かの有無の旨をご連絡を下さい。
G ビズ ID 運営者・開発者向け連絡事項を受け取るための担当者のご連絡先情報について記載ください。

（１）連携サービスの概要
データ
型

必須/
任意

管理番号

数字

必須

RP 管理用の通し番号

0001

RP 名（サービ
ス名）

文字列

必須

RP の名称※全角

サンプルサービス

項目

備考

サンプル

備考
G ビズ ID 側で一意に決定（設定通知書にて通知）
本番と検証用について、それぞれ記載ください。
サービスリリース予定日が確定の上で記載をお願
いいたします。サービス
リリース予定日がまだ未確定の場合はご相談くだ

サービスリリ
ース予定日

文字列

必須

サービスの提供開始予定日（エンドユーザへのサービ
ス公開日）
なお、既存サービスの場合
は、設定変更リリース予定日。携開始

さい。原則的に、こちらに記載いただくサービス
2021/04/01

リリース予定日の 1 週間
前を本番環境の設定日として調整させていただきます。
※〈サービスリリースの定義〉4.2.6 ⑤リリース
作業参照

申込者名
関連事業者

文字列
文字列

必須
必須

サービス申込書名
開発ベンダ名デジタル庁〇〇〇株式会社

ステータス

文字列

必須

状態

有効

作成日

文字列

必須

RP 登録完了日

有効期限

文字列

任意

RP 登録有効期限

更新日

文字列

必須

登録情報更新日G ビズ ID 側で決定
（設定通知書にて通知）
G ビズ ID 側で決定
（設定通知書にて通知）
G ビズ ID 側で決定
（設定通知書にて通知）
G ビズ ID 側で決定
（設定通知書にて通知）（２）OpenID Connect 連携に関する情報
項目

データ
型

必須/
任意

Client ID

文字列
(50)

必須

文字列
(255)

必須

ClientSecret

備考

サンプル

RP の一意の識別子※半角英数字RP01

認証に使用する秘密情報※運用側で採番

xxxxxxxxxxxxxxxx
xxxxxxxxxx

備考
G ビズ ID 側で一意に決定（設定通知書にて通知）本番・検証用それぞれについてご連絡。
G ビズ ID 側で一意に決定（設定通知書にて通知）本番・検証用それぞれについてご連絡。

本番と検証用について、それぞれ
記載ください。
注意点①
正しいリダイレクト URL が記載されていなかった場合（正しくご申告いただけない場合）、リダイ
レクトが失敗しエラーとなります
ので、必ず正しい内容を記載くだ
さい。
注意点②
一つの Client_ID に対して複数のリダイレクト URL を紐づけて利用する場合は、ユーザ認可リクエ（https://gbizid.go.jp/oauth/authorize ）を送信する際に「紐づけされた複数のログイン後のリダイレクトURL

URL須

ログイン後のリダイレクト
URL

https://www.xxxx
xxx.go.jp/redirect

リダイレクト URL の何れにリダ
イレクトさせるのか」をredirect_uri パラメータにて指定いただく必要があります。
〈記載方法〉：1 環境に複数のリダイレクト URL を設定したい場
合は、1 つのセル(記入欄)に改行して列挙ください。

注意点③
リダイレクト URI の文字数の制限については、2048 桁までとなります。
・リダイレクト URL は絶対 URIである必要があるため、*（アスタリスク）や部分一致などはご利用できません。
・URL として利用が許可されている文字であれば、利用できない文
字はございません。

（３）委任申請に関する情報
項目

データ
型

必須/任
意

備考

サンプル

備考
G ビズ ID 側で一意にClientKey

文字列
(255)

必須

委任 API のリクエスト時に必要な RP の一意の識別子

決定
RP01

（設定通知書にて通知）本番・検証用それ
ぞれについてご連絡。
G ビズ ID 側で一意にClientToken

文字列
(255)

必須

認証に使用する秘密情報

xxxxxxxxxxxxxxxxxxxxxxxx※運用側で採番xx

決定（設定通知書にて通知）本番・検証用それ
ぞれについてご連絡。
委任を行うシステムで

委任有無

数字

必須

委任 API のリクエスト時の認証に使用する秘密情報

1

あるかを選択してくだ
さい。
有り：1、無し：0

委任 API を利用する際の発信元 IP アドレス
API 呼び出し

IP アド

元 IP アドレス

レス

本番と検証用につい上記委任有無が「有任意（１）」の場合、必須とな

xxx.xxx.xxx.xxx/32

るて、それぞれ記載くだ
さい。

本番：
検証：
G ビズ ID 側で一意に対象サービス

文字列

コード

(6)

委任情報取得 API にて返却必須

される委任の対象サービス

決定sampleのコード値（設定通知書にて通知）本番・検証用それ
ぞれについてご連絡。

対象サービス

文字列

名

(20)

必須

委任申請時に画面表示されるサービス名

サンプル申請サービス

（４）多要素認証ポリシーに関する情報
必
項目

データ型

須/
任

備考

サンプル

備考

意
サービスの認証ポリシーを指定してくださ
サイトとしての認証ポリシー

文字列

必

１要素認証のみ、2 要素認証

須

必須、1 要素認証＋2 要素認証

1 要素認証のみい。
本番と検証用について、それぞれ記載ください。

（５）TOP ページコンテンツ（利用可能なサービス一覧）への登録内容
項目

データ
型

必須/任
意

備考

サンプル

備考
※掲載タイミングは月
1 回（第一営業日）となります。原則、RP 様のサービスリリース日

サービス名称

文字列

必須

RP のサービス名称

サービスサンプル（サービス開始日）の翌月の第一営業日に掲載されます。
（サービス
リリース日が第一営業日の場合は同日に掲載
します。
）

サービスサイ
ト URL

URL

必須

RP のサービスサイト URL
G ビズ ID プライム、G ビ

利用可能なア
カウント種別文字列

必須

ズ ID メンバー、G ビズ ID
エントリーから利用可能な種別を記載

https://xxxx.go.jp
G ビズ ID プライム、G ビズ
ID メンバー、G ビズ ID エン
トリー
省庁様：〇〇省、〇〇庁（担当省庁名、自治体名、部

担当省庁名/自治体名（部
連絡先

文字列

必須

署名をご記入下さい）

署、部課および電話番号ま自治体様：〇〇県、〇〇市

たは電話番号が記載されて（部署名までご記入下さい）

いる URL

連絡先：電話番号、もしく
は、連絡先の記載がある URL

（6）システム内の利用可能なサービス一覧への表示・非表示について
項目

データ
型

必須/任
意

システム内の

文字列

必須

備考

サンプル

プライムがメンバーにサ「利用可能なービスの利用権限を設定すサービス一る画面に、そのサービス名

覧」へのサーを表示するか非表示とする

ビス名称の表かを選択する。

備考
非表示の場合、プライ※二択「表示する」または「非表示にする」

示可否

ムはメンバーにサービスの利用権限を付与できないため、メンバー
はサービスを利用できない。

（7）本番環境疎通用テストアカウントの有無について
項目

データ
型

必須/任
意

備考

テストアカウ

文字列

必須

テストアカウントの有無の

ント有無

選択[

サンプル

有りの場合：１、無しの場合：0
SMS 受信番号

文字列

1.の場

備考

]

SMS 受信番号記入

090 等から始まる番号

合必須
メールアドレ

文字列

ス

1.の場

メールアドレス記入

合必須（8）連絡先情報
G ビズ ID から運営者、開発者向け連絡事項（RP 登録に関する連絡、停止などの連絡、仕様などに関する調整等）を受け取りたいご担当者様の連絡先を「連絡先情報」シート（別シート）に記載。
なお、担当者が変更になった場合は、G ビズ ID RP サポート窓口： gbizid_rp_support@ml.ntt.com まで
ご連絡をお願いいたします。定期的（年 1 回程度）に RP 担当者のご連絡先を最新に更新するため、確認のご連絡をさせていただいております。何卒ご協力の程よろしくお願い致します。


Scope について
Scope は以下の通り

Scope

内容

openidアカウント管理番号

Profile

基本情報の項目を含む

user

アカウント利用者情報の項目を含む

mandateG ビズ ID メンバーへ委任する RP の情報

email
offline_accessアカウント利用者情報のうち、アカウント ID（メールアドレス）
リフレッシュトークンを取得したい場合に指定する

4.4. テストでの確認ポイント
RPの登録後の動作確認については、OpenID Connectに関する各種リクエストの動作確認を行い、RPとGビズ
IDが正常に連携されていることを確認のこと。


OpenID Connectに関連した確認ポイント
OpenID Connectリクエスト

確認内容
認可リクエストでログイン成功後に、リダイレクトURLで指定している（RP側

ユーザ認可リクエストの）URLにリダイレクトされること。※注意1
ユーザ認可のレスポンスで取得したstateの値が、リクエストで送信した値と同じであること。
ログイン成功後のリダイレクトで取得した認可コードで、アクセストークンの取得が可能なこと。

アクセストークン取得リクエスト

アクセストークン取得のレスポンスで取得した id_token に含まれる nonce の値
が、ユーザ認可リクエストで送信した値と同じであること。
id_token の検証が正常に行えること。
アクセストークンを使用して、属性情報の取得が可能なこと。

属性取得リクエスト

認可リクエストでscopeにはRPに設定したものが指定可能となっており、属性情報には指定したscopeものが取得されること。
認可リクエストのscopeに「offline_access」を指定した場合、アクセストークン
取得のレスポンスで取得したリフレッシュトークンを使用して、アクセストーク

アクセストークン再取得リクエストンの再取得が可能なこと。
アクセストークン再取得のレスポンスで取得した id_token の検証が正常に行え
ること。



その他確認ポイント
確認観点

認証実施時の挙動（1要素認証サイト）

確認内容
いずれのアカウント種別の場合も、登録した認証要素（1要素認証 ）で、認証が要求されること。
G ビズ ID プライム、G ビズ ID メンバーでアクセスした場合、登録した認証要素（2 要素認証 ）で、認証が要求されること。
※RP 仕様観点

認証実施時の挙動（2要素認証サイト）

G ビズ ID エントリーでアクセスした場合、1 要素認証後、本サイトは本来 2 要素が必要となるサイトとなるため、RP側で「権限がありません」などのエラーが表示され、ログインエラーとなること。
G ビズ ID プライム、G ビズ ID メンバーでアクセスした場合、
1 要素メニュー、2 要素メニューともに、2 要素認証 で、認証が要求されること。

認証実施時の挙動（1要素 2要素併用）※RP 仕様観点
G ビズ ID エントリーでアクセスした場合は、1 要素メニューについては、アクセスができ、2 要素メニューについては、本メニューについては本来 2 要素が必要となるサイトとなるため、RP 側で「権限がありません」などのエラーが表示され、ログインエラーとなることを確認する。
※RP 仕様観点

アカウント種別に応じたRP側での制御

G ビズ ID エントリー、G ビズ ID プライム、G ビズ ID メンバーのアカウント種
別に応じて、RP 側で想定している仕様でふるまえることを確認する。
RP 側の仕様にあわせて、必要に応じて確認ください。

委任情報に関する動作確認

委任情報が取得できていることを確認する。

 エラー発生時の調査について
G ビズ ID の検証環境・および本番接続においてエラーが発生した場合は、以下を記載の上、RP サポート窓
口までご連絡ください。
ご申告いただく内容
以下の項目情報を事前にいただきますと、エラー原因の調査がスムーズに行えます。ご協力のほどよろしくお願い致します。
・事象発生日時：・手順（ユーザ認可リクエストの情報）：
・リクエストの内容：
・利用アカウント（アカウント ID）：
・レスポンス内容：
・利用環境（検証環境、商用環境）：
・実施時間：
・ブラウザ：
・再現性有無：4.5.

接続後の対応RPの登録後に設定を変更したい場合や削除したい場合は、GビズID RPサポート窓口にお問い合わせください。
GビズIDとの接続を解除したい場合、またRPとしてサービス終了する場合は、必ず削除依頼についてご申告ください。
 設定変更等に関する対応のお願い・設定変更に関し、通常のRP変更対応の範囲で収まらない作業が予想される場合（例：短期間で複数のRPの設定を変更したい、特定のタイミングで変更を希望したい、等）は、RPご担当者様からデジタル庁に対し実施内容を説明していただいた上、対応について判断させていただきたく思います。こういったケースでは、実施を希望する3か月前までに、GビズID RPサポート窓口へご連絡いただくようお願いいたします。
 RP連携設定削除に関する対応
・RP設定申込書にて、削除する環境に関するサービス名およびClientIDについてご申告いただきます。
・GビズID RPサポート窓口にて、RP設定の削除およびTOPページコンテンツから該当サービス情報を削除いたします。 ※削除ご依頼の際はRPサポートまでご連絡下さい。

 ログインエラーに関する対応
・検証環境および本番環境にて接続ができない場合で、RPご担当者様側で検証の結果GビズID側の原因と考えられる場合は、以下の情報を添えてGビズID RPサポート窓口までお問合せください。
＜ヒアリング事項＞
・事象発生日時
・利用アカウント（アカウントID）
・利用環境
・ブラウザ
・手順
・事象調査委調査のためにリクエスト内容について記載ください。
‐ユーザ認可リクエスト-アクセストークン取得リクエスト・再現性の有無

4.6.

接続後の連携削除について①G ビズ ID との連携削除を希望の場合
RP として行政サービスの公開/展開を終了したとき（行政サービスが終了となった場合）及び行政サービスの提供が中断となった場合等、RP 設定申込書のご提出をお願いいたします。
（削除したい環境のサービス名称及びリダイレクト URL に取消線にて表記いただき、RP サポートへご送付下さい。
） 受領後、3 週間程度で連携削除させていただきます。
また、再接続を希望の場合は、サービスリリースの 3 週間前までに該当のサービス名称、リダイレクト
URL の取消線を外していただき再提出して下さい。
（注意点）
・検証環境、本番環境両環境の連携削除をおこなった場合は、G ビズ ID サイトより「G ビズ ID サービス連
携利用申請書」をダウンロードしていただき、ご提出下さい。
・本番環境の一時中断やリリースが延期になった場合は、一旦削除とし、サービスリリース日の 3 週間前までに再提出下さい。
②サービスリリース後にエンドユーザ向けにサービスを提供できない場合の削除について「4.2.6.リリース作業」参照

4.7 よくあるお問合せ事項
本番環境と検証環境の環境に関する質問
Q1

G ビズ ID の本番環境と検証環境の違いは何ですか？

A1

本書の 4.1．各環境概要をご確認ください。

Q2

G ビズ ID の本番環境は、サービスリリース日（エンドユーザへの公開日）の原則 1 週間前に接続とありま
すが、事前に（数か月前に）G ビズ ID の本番環境と動作確認のために接続することは可能ですか？

A2

原則的にできません。G ビズ ID 検証環境と G ビズ ID 本番環境は同等の構成であるため、事前の動作確認
や接続試験は G ビズ ID 検証環境と接続することにより動作確認をご対応ください。
G ビズ ID 本番環境は、稼働中のシステムであるため、試験などに利用することは想定しておりません。

Q3

GビズIDとRP連携するにあたり、本番環境以外に検証環境も準備する必要はありますか？

A3

検証環境と本番環境の両方をご準備ください。RP様の検証環境はGビズIDの検証環境、RP様の本番環境はG
ビズIDの本番環境とのみ、接続することが可能となっております。
なお、G ビズ ID の検証環境は、連携前の接続確認用としてだけでなく、G ビズ ID サービスの機能追加・変更時において先行リリースを行い、RP 側のシステムに影響がないかを確認いただく用途にもご利用いただ
けます。以上の理由により、RP 側でも必ず検証環境をご準備いただき、G ビズ ID の検証環境と接続していただきますよう、よろしくお願いいたします。

本番環境と検証環境のテストアカウントに関する質問
Q4

テスト用にGビズIDの本番環境・検証環境のGビズIDプライムのアカウントの作成方法を教えてください。

A4

本書の 4.1．各環境概要

Q5

GビズIDの本番環境のGビズIDプライムテストアカウントは、1アカウントしか作成できませんか？複数アカの G ビズ ID テストアカウント作成方法をご確認ください。

ウントが必要です。
A5

G ビズ ID の本番環境のテストアカウントは 1 アカウントのみの提供となります。ご了承ください。

Q6

GビズIDの本番環境のテストアカウントが複数ほしいのですが、自身でオンライン申請や書類審査申請により作成してもよいですか？

A6

テストを目的に G ビズ ID プライム、G ビズ ID メンバー、G ビズ ID エントリーを作成することは原則的に禁止しております。
（行政サービスへの申請が必要であるなど、正規の用途/目的のために作成いただくことは問題ありません）

Q7

GビズIDの検証環境のGビズIDプライムのアカウントはどこで作成できますか？

A7

G ビズ ID 検証環境での作成が可能です。G ビズ ID 検証環境へのアクセス手順は、ＲＰ利用申請後、審査が完了しましたら、G ビズ ID RP サポート窓口よりご連絡いたします。作成手順については、本書の 4.1．各
環境概要 の G ビズ ID テストアカウントの作成方法をご確認ください。

Q8
A8

GビズIDの検証環境のGビズIDメンバーの作成は可能ですか？
作成は可能です。G ビズ ID プライムを作成いただいた後、G ビズ ID メンバーを作成ください。
※ 実際に利用されるアカウント数のみを作成してください。
※ 作成した G ビズ ID メンバーにアドミン権限を付与することはできません。

検証接続エラーに関する質問
Q９A９

接続検証を行っているがエラーにより先に進めない。
まずは本書 3.3.1.OpenID Connect について記載情報などをご確認ください。
・各リクエスト等が、正しいメソッドおよびヘッダ名等で指定されているかをご確認ください。
・大文字小文字の違いについてご注意ください。
・各リクエストの順序性が正しいかをご確認ください。
（例：属性取得リクエスト単体でリクエストを行っても結果は返却されません。必ずユーザ認可リクエス
ト、アクセストークン取得リクエスト、属性取得リクエストの順に行ってください）。
なお、原因が不明の場合は以下項目をご記載の上、G ビズ ID RP サポート窓口までお問合せください。
＜ご記載いただく事項＞
・エラー発生日時
・利用アカウント（アカウントID）
・利用環境
・利用ブラウザ・手順について・事象調査委調査のために、リクエスト内容について記載してください。
‐ユーザ認可リクエスト-アクセストークン取得リクエスト・再現性の有無

Q10

属性取得リクエスト時に、正しく情報が返却されない。

A10

属性取得リクエストの返却にあたっては、ユーザ認可リクエスト時に正しくリクエストコンテント内で
scopeを指定してください。このケースで返却されないことが多いのでご確認ください。
エラーの原因が不明の場合は、A7のヒアリング事項を記載の上、GビズID RPサポート窓口までお問合せく
ださい。

Q11

検証環境が接続できたため、検証アカウントにてログインを試みたがログインができない。

A11

これまでの事案の場合、以下のケースが多数ございました。以下事象についてご確認ください。
・設定申込書上で、ご指定いただいたリダイレクトURLに誤りがあった。
・何度もログインを試みたため、SMS送信数の上限に達してしまい、SMSが届かなくなってしまっていた。
（SMS送信数上限は１日あたり同一番号に対して50通までとなります。）

ユーザがログインできない事象に関する質問
Q12

アカウントにてログインを試みたがログインができない。

A12

これまでの事案の場合、以下のケースが多くございました。以下事象についてご確認ください。
・何度もログインを試みたため、SMS送信数の上限に達してしまいSMSが届かなくなってしまっていた。
（SMS送信数上限は１日あたり同一番号に対して50通までとなります。）

Q13

RPにログインしたGビズIDユーザから「RPにログインしたはずなのに、RPページでなく、なぜかGビズIDのマイページが表示される」と申告がある。

A13

これまでの事案の場合では、原因はGビズIDユーザのイントラ環境に導入されたWeb無害化ツール（menlo等）などのセキュリティソフトにより、ログイン後の各電子申請システム側（RP）のリダイレクトURLがア
クセス拒否されているためと判明しています。本ケースの対策としては、リダイレクトURLを社内で除外申請していただくことで解決できます。なお、リダイレクトURLがブロックされた際に、GビズIDのマイペー
ジに遷移する理由は、GビズID側の仕様によりリダイレクト先に到達できなかった際にデフォルトのランディング先にマイページを指定しているためです。

5. 参考情報
5.1. 参考情報：認証・認可の観点で、RP 側で実装すべきポイント（１/2）

GビズIDでは、利用者に対する認証を行います。
GビズIDから、電子申請システムに対しては、認証の結果およびGビズIDで管理する情報を渡します。
電子申請システムでは、渡された情報をもとに、利用者に対する認可を行ってください。
（該当の利用者が利用できる機能などを制御していただく必要があります。
）
認可に関する実装については、RP側で検討する必要がございます。

参考：認証と認可の違い
処理者
認証

説明
相手が（何）であるか確認・特定すること（Authentication）
認可（Authorization）

特定の条件に対して、リソースアクセスの権限を与えること 。

5.1. 参考情報：認証・認可の観点で、RP 側で実装すべきポイント（２/２）

RP側では、GビズIDから渡される情報をもとに認可の実装を行っていただきます。
認可の実装例について、以下に示します。

項目

制御盤

G ビズ ID から渡される
情報

該当
アカウン
ト種別

G ビズ ID のアカウント種別により、
RP 側にアクセスさせるか、否かを制御するアカウント種別例：

G ビズ ID

G ビズ ID エントリー、G ビズ ID メン

エントリー

バーG ビズ ID プライム
アカウント種別による

実装例：

制御

G ビズ ID エントリー等には利用させな性取得リクエストにより返却される userinfo 情報のアカウント種別により確認(UserInfo.profile.account_type)いシステムの場合は、G ビズ ID エント

G ビズ ID
メンバーG
ビズ ID
プライム

リー種別である際に、RP へのアクセスを不可とする実装を行う。

G ビズ ID プライムにより許可されたサービス内
容による制御他社から委任により許可されたサービス内容に関する制御

G ビズ ID で保持する「G ビズ ID プラ
イムにより許可されたサービスであるかどうか」の情報により、RP 側にアクセスさせるか、否かを制御する。(※)

属性取得リクエストにより返却される userinfo 情報の利用可能なサービス情報（mandate）により確認(UserInfo.mandate.mandate_info.client_id)

G ビズ ID で保持する「委任者から許可されたサービスであるかどうか」の情報により、RP 側にアクセスさせる
か、否かを制御する。

G ビズ ID
メンバー

G ビズ ID
委任情報取得 API で送られる情報により確認

メンバー(委任 API RES:system_cd)

G ビズ IDプライム※ アドミン権限を持つGビズIDメンバーからも許可できますが、「GビズIDプライムにより許可されたサービスであるかどうか」の情報は保持されます。

その他：
RP側で実装すべき確認ポイント（GビズIDプライムのアカウント引継ぎに関する制御について）（１/2）

GビズIDでは、代表者交代等に伴いGビズIDプライムが変更になった場合の機能（アカウント引継ぎ機能）を実装しています
GビズIDプライムが変更となった場合は、配下のGビズIDメンバーについては、
アカウント引継ぎ機能により、新しいGビズIDプライムへ紐づけられます。

旧 G ビズ ID プライム

新 G ビズ ID プライム

G ビズ ID メンバー

X さん

G ビズ ID メンバー

Y さん

●アカウント引継ぎ時は、旧GビズIDプライムから新GビズIDプライムに対して、
旧GビズIDプライムに関する、以下の情報が引き継がれます。
①GビズIDメンバーの情報②GビズIDメンバーに許可している利用可能なサービス情報（GビズIDメンバーが利用可能な対象サービス）③委任情報（委任申請ID、委任者プライムID、受任者プライムID、対象サービス、委任期間（開始日、終了日）●GビズIDプライムが変更となった場合、GビズIDでは、以下が変更となります。
・GビズIDメンバーの属性情報として管理される親プライム情報（属性取得リクエストにより返却されるuserinfo情報の親GビズIDプライムID情報（parent_id）
・委任・受任時のAPI情報におけるGビズIDプライム情報（委任情報取得APIの委任元情報に関するアカウント管理番号（meti_id）※旧GビズIDプライムと新GビズIDプライムそれぞれが持つアカウント管理番号は変更されません。

RP 側で実装すべき確認ポイント（G ビズ ID プライムのアカウント引継ぎに関する制御について）（2/2）●新GビズIDプライムプライムは、アカウント引継ぎ時に、
旧GビズIDプライムの今後のアカウントの利用について、「アカウントの利用を停止する」か否かを選択することができます。
アカウントの利用の停止を選択した場合は、旧GビズIDプライムはアカウントが停止状態となり、GビズIDへ認証ができなくなります。
⇒現時点では、RP側に対し、GビズIDプライムのステータスを連携するAPI等は用意しておりませんので、RP側が主体的にアカウント停止状態であることを把握することはできません。
（ただし、上記のとおり、アカウント停止状態になった際には、GビズIDへ認証ができなくなります。）●電子申請システムでは、GビズIDプライムに対する該当法人の過去の申請状況の照会可否について、検討する必要がありますが、現時点では、RP側に対し、旧GビズIDプライムと新GビズIDプライムの紐づけ情報や、
新GビズIDプライム上に旧BizIDプライムの情報が含まれるAPI等は用意しておりませんので、引き継いだ際に、過去の申請状況などを紐づけることはできず、
旧GビズIDプライムおよび新GビズIDプライムそれぞれ自身の申請情報を確認することしかできません。
※なお、GビズIDプライムに紐づくGビズIDメンバーの、GビズIDプライムからの申請情報の閲覧可否についても、RP側の実装によります。
※将来的に、 GビズIDプライムと新GビズIDプライムの紐づけ情報をGビズIDにて管理し、その情報をAPI
等により電子申請システムに送れるようシステムを実装した際には、以下の実装について検討いただく形になります。
（実装時期：未定（検討中）
）
項目

制御例
・新 G ビズ ID プライムに対し、G ビズ ID プライム

該当法人の過去の申請状況を閲覧可能とするか否か
・旧 G ビズ ID プライムに対し、該当法人の過去の申請状況を閲覧可能とするか否か