# 基本4情報自動最新化API

<br>

## **概要**

基本4情報自動最新化APIとは、日次で電子証明書の失効情報を確認し、利用者から同意を取得している署名用電子証明書が失効していた場合に、基本4情報（氏名・住所・生年月日・性別）を自動で取得するためのAPIです。  
基本4情報自動最新化を設定することで、同意を取得している署名用電子証明書の失効情報と併せて基本4情報（氏名・住所・生年月日・性別）をバッチ処理で取得し、サービスプロバイダ事業者へ提供します。  
これにより、日次で失効情報を確認し、対象となる署名用電子証明書に対して基本4情報（氏名・住所・生年月日・性別）を自動取得を実現できます。

:::check[確認]
死亡、海外転出、証明書更新、カード紛失の場合は、基本4情報（氏名・住所・生年月日・性別）提供ではなく、電子証明書の失効理由を通知します。
:::

## **処理の流れ**

<Tabs>
    <Tab title="基本4情報自動最新化の登録">
        <Steps>
            <Step title="基本4情報自動最新化の登録要求（サービスプロバイダ事業者）">
              サービスプロバイダ事業者は、基本4情報自動最新化の通知先URL（Webhook URL）を指定して、APIでリクエストを送信します。
            </Step>
            <Step title="基本4情報自動最新化先の登録処理（プラットフォーム事業者）">
              受信した登録情報に基づき、プラットフォーム事業者は通知先URLの情報をデータベースに登録します。
            </Step>
            <Step title="登録結果の返却（プラットフォーム事業者）">
              基本4情報自動最新化の通知先の登録処理が正常に完了した場合は、設定内容を含むレスポンスを返却します。
            </Step>
        </Steps>
    </Tab>
    <Tab title="基本4情報自動最新化">
        <Steps>
            <Step title="署名用電子証明書の失効情報確認（プラットフォーム事業者）">
              日次のバッチ処理でCRLによる失効情報確認を行います。なお、電子証明書が失効していない場合は、これ以降の処理は行いません。
            </Step>
            <Step title="基本4情報（氏名・住所・生年月日・性別）の取得（プラットフォーム事業者）">
              失効している電子証明書情報の取得後、利用者からの同意を事前に取得している署名用電子証明書が失効していた場合のみ、続けて基本4情報（氏名・住所・生年月日・性別）の取得を行います。なお、死亡などが理由で失効している場合は、基本4情報は取得せず、失効理由をサービスプロバイダ事業者へ通知します。
            </Step>
            <Step title="基本4情報（氏名・住所・生年月日・性別）の送信（プラットフォーム事業者）">
              プラットフォーム事業者は、失効情報と併せて取得した基本4情報（氏名・住所・生年月日・性別）をサービスプロバイダ事業者に送信します。サービスプロバイダ事業者は、受信した基本4情報を用いることで基本4情報の自動最新化を実現できます。
            </Step>
        </Steps>
    </Tab>
    <Tab title="基本4情報自動最新化の解除">
        <Steps>
            <Step title="基本4情報通知取得の通知先の解除要求（サービスプロバイダ事業者）">
              サービスプロバイダ事業者は、登録済みの基本4情報自動最新化の解除を行うため、APIでリクエストを送信します。
            </Step>
            <Step title="基本4情報通知取得の通知先の解除処理（プラットフォーム事業者）">
              受信した解除要求に基づき、プラットフォーム事業者は対応する通知先URLの情報をデータベースから削除します。
            </Step>
            <Step title="解除結果の返却（プラットフォーム事業者）">
              基本4情報自動最新化の解除処理が正常に完了した場合は、解除結果を返却します。
            </Step>
        </Steps>
    </Tab>
</Tabs>

## **シーケンス図**

<Tabs>
    <Tab title="基本4情報自動最新化の登録">
```mermaid
    %%{init:{'theme':'natural'}}%%
    sequenceDiagram
    participant 利用者
    participant SDK
    participant サービスプロバイダ事業者
    participant プラットフォーム事業者
    participant J-LIS

    サービスプロバイダ事業者->>プラットフォーム事業者: 基本4情報自動最新化の登録要求 
    プラットフォーム事業者->>プラットフォーム事業者: 基本4情報自動最新化の登録
    プラットフォーム事業者->>サービスプロバイダ事業者: 登録結果の返却
```

    </Tab>
    <Tab title="基本4情報自動最新化">
```mermaid
    %%{init:{'theme':'natural'}}%%
    sequenceDiagram
    participant 利用者
    participant SDK
    participant サービスプロバイダ事業者
    participant プラットフォーム事業者
    participant J-LIS

    プラットフォーム事業者->>J-LIS: CRLの取得リクエスト送信
    J-LIS->>プラットフォーム事業者: CRLの返却
    プラットフォーム事業者->>プラットフォーム事業者: 電子証明書の有効性確認
    alt 同意取得済みの署名用電子証明書が失効している場合
        プラットフォーム事業者->>J-LIS: 署名用電子証明書の送信
        J-LIS->>J-LIS: 同意状況の確認
        J-LIS->>プラットフォーム事業者: 基本4情報（氏名・住所・生年月日・性別）を取得
        プラットフォーム事業者->>サービスプロバイダ事業者: 失効情報と基本4情報（氏名・住所・生年月日・性別）を送信
    else 死亡・海外転出などが理由で失効している場合
        プラットフォーム事業者->>サービスプロバイダ事業者: 失効理由を送信
    end
```
    </Tab>
    <Tab title="基本4情報自動最新化の解除">
```mermaid
    %%{init:{'theme':'natural'}}%%
    sequenceDiagram
    participant 利用者
    participant SDK
    participant サービスプロバイダ事業者
    participant プラットフォーム事業者
    participant J-LIS

    サービスプロバイダ事業者->>プラットフォーム事業者: 基本4情報自動最新化の解除要求   
    プラットフォーム事業者->>プラットフォーム事業者: 基本4情報自動最新化の削除
    プラットフォーム事業者->>サービスプロバイダ事業者: 解除結果の返却
```
    </Tab>
</Tabs>

<br>