> ## Documentation Index
> Fetch the complete documentation index at: https://docs.livingsecurity.com/llms.txt
> Use this file to discover all available pages before exploring further.

# NINJIO 統合のセットアップ

> NINJIO を Living Security Platform に接続して、従業員のセキュリティ意識向上トレーニングの結果とフィッシングシミュレーションの成果をインポートします。

export const PublicIntegrationNextSteps = () => <>
    <hr />
    <h2>関連リソース</h2>
    <ul>
      <li>
        <a href="/ja/signals/data-sources">連携データがヒューマンリスクマネジメントのシグナルになる仕組みを確認する</a>
      </li>
      <li>
        <a href="https://www.livingsecurity.com/integrations">Living Security の連携を探す</a>
      </li>
      <li>
        <a href="https://app.livingsecurity.ai/">Living Security Platform を開く</a>
      </li>
      <li>
        <a href="https://www.livingsecurity.com/request-demo/">Living Security のデモをリクエストする</a>
      </li>
    </ul>
  </>;

export const ConnectInPlatform = ({tile, children}) => <Step title="Living Security Platform で認証情報を入力します">
    <p>
      この手順は、Living Security にアクセスできる担当者(プログラムオーナー、または招待されている場合はシステム管理者(委任によるセットアップ))が実施します。
    </p>
    <ol>
      <li>
        <strong>設定 → 連携 → カタログ</strong>に移動し、<strong>{tile}</strong> タイルを見つけて、<strong>接続</strong>をクリックします。
      </li>
      <li>
        以下のフィールドに入力し、<strong>接続</strong>をクリックします。
      </li>
    </ol>
    {children}
  </Step>;

export const SystemAdminBanner = ({system, recommendDelegated}) => <Note>
    <p>
      <strong>このガイドは、{system} の管理者様向けです。</strong>ここでは、{system} 内で API 認証情報を作成する手順を説明します。この作業には、Living Security Platform ではなく、{system} の管理者権限が必要です。
    </p>
    <p>
      Living Security の<strong>プログラムオーナー</strong>であり、{system} の管理者ではない場合は、このページを {system} の管理者にお送りください。管理者はパート A を完了し、認証情報をお客様に引き渡します（プラットフォームに招待済みの場合は、管理者が認証情報を直接入力することもできます）。
      {recommendDelegated && <>
          {' '}セットアップでは機密性の高いキー情報が生成されるため、シークレットがお客様に送信されることのないよう、<strong>委任セットアップ</strong>の方法を推奨します。
        </>}
    </p>
  </Note>;

<SystemAdminBanner system="NINJIO" />

## この統合で提供されるデータ

NINJIO は、従業員、トレーニング、およびフィッシングシミュレーションの成果を提供できます。確認済みの例は次のとおりです。

* `training.assigned` — セキュリティトレーニングが割り当てられている
* `training.completed` — セキュリティトレーニングを完了した
* `training.passed` — セキュリティトレーニングの評価に合格した
* `phishing.simulation.clicked` — 報告せずにシミュレーションをクリックした
* `phishing.simulation.reported` — フィッシングシミュレーションを報告した

これらの例は、Living Security が利用できる正規化されたアクティビティの種類を示しています。[統合データがシグナルになる仕組み](/ja/signals/data-sources)を参照してください。

## Living Security に必要な情報

| 認証情報 | 説明 |
| - | - |
| **API キー** | 従業員、トレーニング、フィッシングの各アクセスポイントに対する読み取りアクセス権を持つ NINJIO の API キーです。Living Security はすべてのリクエストでこのキーを送信します。 |

**スコープ:** NINJIO では、API キーごとに*アクセスポイント*単位で読み取り権限と書き込み権限が個別に設定されます。Living Security には、従業員、トレーニング、フィッシングの 3 つに対する**読み取り**権限が必要です。書き込みアクセスは不要であり、付与しないでください。

**必要なロール:** NINJIO アカウントの**管理者**。キーを作成する Integration 領域にアクセスできるのは管理者のみです。

<Warning>
  **NINJIO は、新しいキーを作成した時点で 1 度しか表示しません。** 画面を移動する前に、キーをそのまま Living Security Platform またはパスワードボールトにコピーしてください。コピーしなかったキーは取得できないため、新しいキーを生成し直す必要があります。
</Warning>

### Living Security が取得するデータ

| データ | 詳細 |
| - | - |
| **受講者** | NINJIO の従業員ディレクトリ: 氏名、メールアドレス、部署、役職、マネージャー、国、支店、アクティブステータス。 |
| **トレーニング** | 各トレーニングの割り当て対象者と完了者。完了日、試験スコア、エンゲージメントスコアを含みます。 |
| **フィッシング** | フィッシングシミュレーションメールを操作した人と報告した人、およびその発生時刻。 |

<Note>
  **受講者の電話番号は保存されません。** NINJIO は従業員レコードに電話番号を含めて返します。Living Security の機能では電話番号を使用しないため、保存前に破棄されます。
</Note>

### 前提条件

* API アクセスが有効な NINJIO アカウント。
* [admin.goninjio.com](https://admin.goninjio.com/) への管理者アクセス。
* 接続済みの他のシステムで使用されているメールアドレスと一致する、NINJIO 上の受講者メールアドレス。Living Security は、メールアドレスを使用して NINJIO の受講者を個人と照合します。

***

## パート A — NINJIO での作業

*NINJIO の管理者が次の手順を実施します。*

<Steps>
  <Step title="Integration 領域を開く">
    1. 管理者として [admin.goninjio.com](https://admin.goninjio.com/) にサインインします。
    2. 画面右上の **Integration** を選択します。
  </Step>

  <Step title="API キーを作成する">
    1. **New API Key** を選択します。
    2. 後で識別できる名前をキーに付けます。例: `Living Security`。
    3. **employee**、**training**、**phishing** の各アクセスポイントに対する**読み取り**アクセスを付与します。
    4. 書き込みアクセスは選択しないでください。Living Security は NINJIO からの読み取りのみを行います。
    5. **Generate Key** を選択します。

    <Warning>
      今すぐキーをコピーしてください。NINJIO はキーを 1 度しか表示せず、再表示することはできません。
    </Warning>
  </Step>
</Steps>

***

## パート B — Living Security Platform での作業

*プログラムオーナーがこの手順を実施します。委任セットアップを使用する場合は、システム管理者が実施します。*

<Steps>
  <ConnectInPlatform tile="NINJIO">
    | フィールド | 値 |
    | - | - |
    | **API キー** | パート A で生成したキー |
  </ConnectInPlatform>
</Steps>

これで NINJIO に接続されました。

***

## データ取得の頻度

| データ | スケジュール |
| - | - |
| 受講者 | 毎日 |
| トレーニング結果 | 6 時間ごと |
| フィッシング結果 | 6 時間ごと |

初回接続時には、過去 12 か月分のトレーニング完了データを取得し、その後は差分で更新を続けます。フィッシングシミュレーションは 1 回ずつ読み取られ、終了後 2 週間は再確認されるため、遅れて発生したクリックや報告も取得されます。

<Note>
  大規模な NINJIO アカウントで初回接続を行うと、すべてのデータの読み取りが完了するまでに、スケジュールされた実行が複数回必要になる場合があります。各実行では可能な範囲まで読み取り、次の実行が中断した位置から再開するため、件数は一度にすべて表示されるのではなく、最初の 1～2 日かけて増えていきます。
</Note>

***

## トラブルシューティング

<AccordionGroup>
  <Accordion title="401 Unauthorized">
    API キーが正しくないか、不完全です。最もよくある原因は、キーの一部しかコピーされていないことです。NINJIO はキーを 1 度しか表示しないため、途中で切れた状態で貼り付けてしまいやすく、後からそれに気付くことはできません。NINJIO で新しいキーを生成し、そのキーで再接続してください。
  </Accordion>

  <Accordion title="403 Forbidden">
    これは認証情報の問題では**ありません**。キーの認証は成功していますが、必要なアクセスポイントのいずれかに読み取り権限が付与されていません。

    同じキーを貼り付け直しても解決しません。NINJIO で、employee、training、phishing の 3 つのアクセスポイントすべてに**読み取り**アクセスを持つキーを作成し、そのキーで再接続してください。
  </Accordion>

  <Accordion title="接続は成功したがトレーニングデータがない">
    NINJIO で、少なくとも 1 つのトレーニングキャンペーンが**アクティブ**であり、シミュレーションが関連付けられていることを確認してください。シミュレーションが関連付けられていないキャンペーンは非アクティブのままで、何も配信されないため、取得できる結果がありません。

    キャンペーンがアクティブな場合は、対象の受講者の NINJIO レコードにメールアドレスが登録されていることを確認してください。メールアドレスのない受講者は個人と照合できないため、スキップされます。
  </Accordion>

  <Accordion title="トレーニングが割り当て済みと表示され、完了にならない">
    受講者がまだ修了していないトレーニングについては、これが想定される表示です。Living Security は、NINJIO のシミュレーションが開始された時点で割り当てを記録し、NINJIO が完了日を報告した時点で完了を別途記録します。
  </Accordion>

  <Accordion title="一部の受講者が表示されない">
    Living Security は、**メールアドレス**によって NINJIO の受講者を個人と照合します。NINJIO 上のメールアドレスが、ディレクトリに登録されているアドレスと異なる場合 (個人用アドレス、旧ドメイン、入力ミスなど) は、照合されません。

    NINJIO でアドレスを修正すると、次回のスケジュールされた取得時に照合されます。
  </Accordion>

  <Accordion title="以前のシミュレーションのフィッシング結果がない">
    Living Security は、フィッシングシミュレーションの終了後 2 週間は再確認を行い、その後は停止します。この期間を過ぎてから NINJIO に記録された結果は取得されません。以前のシミュレーションの再読み取りが必要な場合は、サポートにお問い合わせください。
  </Accordion>
</AccordionGroup>

<PublicIntegrationNextSteps />


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.