> ## 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.

# KnowBe4 連携のセットアップ

> KnowBe4 を 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 EgressIpSafelist = ({system}) => <Note>
    <strong>Living Security の同期用の送信元 IP アドレス 4 つすべてを</strong>、{system} の許可リストに追加してください。{system} が CIDR 表記を要求する場合は、各アドレスを単一ホストとして <code>/32</code> を付けて入力してください。
    <br />
    <code>52.34.139.153/32</code>, <code>54.69.127.183/32</code>, <code>44.247.133.183/32</code>,{' '}
    <code>52.26.211.56/32</code>
    <br />
    <br />
    トラフィックは 4 つのいずれからも送信される可能性があるため、一部のみを許可リストに追加すると、同期が断続的に失敗します。これら 4 つのアドレスは、Living Security のすべてのリージョンで共通です。完全な一覧、変更ポリシー、トラブルシューティングについては、{' '}
    <a href="/ja/integrations/managing/egress-ip-addresses">
      連携の送信元 IP アドレスの設定
    </a>{' '}
    を参照してください。
  </Note>;

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="KnowBe4" />

## この連携で提供されるデータ

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

* `training.completed` — セキュリティトレーニングを完了する
* `training.past.due` — トレーニングが期限切れになっている
* `phishing.simulation.clicked` — 報告せずにシミュレーションをクリックした

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

## Living Security に必要な情報

| 認証情報 | 説明 |
| - | - |
| **API キー** | **Account Settings → API** で生成される Reporting API のベアラートークンです。すべてのリクエストで `Authorization: Bearer` ヘッダーに付与して送信されます。 |
| **Reporting API server region** | お使いの KnowBe4 アカウントがプロビジョニングされているリージョンです。一覧(US、EU、Canada、UK、Germany)から選択します。 |

**スコープ:** 設定は不要です。KnowBe4 の Reporting API トークンは設計上読み取り専用であり、スコープは設定されません。このトークンにより、ユーザー、トレーニングの受講登録、フィッシングセキュリティテストの結果への読み取りアクセスが付与されます。これは同期で読み取るデータそのものです。

**必要なロール:** KnowBe4 の **Account Admin**(アカウント管理者のみが **Account Settings → API** にアクセスできます)

### 前提条件

* KnowBe4 コンソールに **Account Admin** ロールでサインインしている必要があります。アカウント管理者のみが **Account Settings → API** にアクセスして、Reporting API を有効化し、トークンを生成できます。

***

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

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

<Steps>
  <Step title="Reporting API を有効化してトークンを生成する">
    1. KnowBe4 コンソールにサインインします。
    2. 右上のアカウント名をクリックし、**Account Settings** を選択します。
    3. 左側のナビゲーションで **API** を選択します。
    4. **Reporting API** が有効になっていない場合は有効にし、新しい API トークンを生成します。

    コンソールで用途の入力を求められた場合は、トークンの用途が分かる名前(例: `Living Security Platform`)を指定してください。

    <Warning>
      KnowBe4 では、API トークンの値は生成時に**一度だけ**表示されます。すぐにコピーして、パスワードボールトやシークレット管理ツールなどの安全な場所に保管してください。コピーせずに画面を移動した場合は、新しいトークンを生成する必要があります。
    </Warning>

    <Note>
      Reporting API は読み取り専用です。ユーザー、トレーニングの受講登録、フィッシングセキュリティテストの結果を公開します。これらは Living Security がスコアリングとレポート作成のために取り込むデータです。書き込みアクセスは必要ありません。
    </Note>
  </Step>

  <Step title="Living Security のエグレス IP を Allowed IP Addresses リストに追加する">
    KnowBe4 では、Reporting API へのアクセスを特定の送信元 IP アドレスに制限できます。この設定はトークンと同じ場所にあります。

    1. KnowBe4 コンソールで **Account Settings → API → Allowed IP Addresses** に移動します。
    2. 各[Living Security のエグレス IP アドレス](/ja/integrations/managing/egress-ip-addresses)を許可リストに追加します。すべてのリージョンで同じ 4 つのアドレスが適用されます。

    <EgressIpSafelist system="KnowBe4" />

    <Warning>
      **Allowed IP Addresses リストが設定されている場合、ネットワーク層で適用されます。** 接続ダイアログでは認証に成功しますが、Living Security のエグレス IP が許可リストに追加されるまで、データ同期は失敗します(ネットワーク層でブロックされ、通常は `403` として表示されます)。このリストにアドレスを 1 つでも追加する場合は、Living Security の範囲も追加する必要があります。追加しないと、トークンが有効であってもリクエストは拒否されます。
    </Warning>

    <Note>
      Living Security のエグレス IP アドレスは、インフラストラクチャの更新時に変更されることがありますが、そのような変更はまれです。以前は正常だったデータ同期が失敗し始めた場合は、[連携のエグレス IP アドレスの設定](/ja/integrations/managing/egress-ip-addresses)を確認し、Allowed IP Addresses リストが一致していることを確認してください。
    </Note>
  </Step>

  <Step title="KnowBe4 のサーバーリージョンを確認する">
    KnowBe4 は、リージョンごとに異なるホストから Reporting API を提供しています。ホスト名を入力する必要はなく、接続ダイアログでリージョンを選択します。

    | リージョン | Reporting API ホスト |
    | - | - |
    | 米国 | `us.api.knowbe4.com` |
    | 欧州 | `eu.api.knowbe4.com` |
    | カナダ | `ca.api.knowbe4.com` |
    | 英国 | `uk.api.knowbe4.com` |
    | ドイツ | `de.api.knowbe4.com` |

    お使いのアカウントがどのリージョンを使用しているか不明な場合は、KnowBe4 コンソールの URL のドメインを確認するか、KnowBe4 の管理者にお問い合わせください。

    <Note>
      Living Security が接続できるのは、これら 5 つのリージョンです。お使いの KnowBe4 アカウントが別のサーバー(たとえば米国政府向けインスタンス)にある場合は、接続を開始する前に Living Security のサポートにお問い合わせください。
    </Note>
  </Step>
</Steps>

***

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

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

<Steps>
  <ConnectInPlatform tile="KnowBe4">
    | フィールド | 値 |
    | - | - |
    | **API キー** | パート A のステップ 1 で取得した Reporting API トークン |
    | **Reporting API server region** | パート A のステップ 3 で確認したリージョン(例: United States) |
  </ConnectInPlatform>
</Steps>

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

***

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

<AccordionGroup>
  <Accordion title="401 Unauthorized">
    API トークンが無効か、有効期限が切れています。トークンが正しいこと、および **Account Settings → API** で再生成されていないことを確認してください。
  </Accordion>

  <Accordion title="403 Forbidden">
    トークンに Reporting API へのアクセス権がないか、リクエスト元の IP が Allowed IP Addresses リストに含まれていません。Reporting API が有効になっていること、および 4 つすべての[Living Security のエグレス IP アドレス](/ja/integrations/managing/egress-ip-addresses)が許可リストに含まれていることを確認してください。
  </Accordion>

  <Accordion title="空の結果(200 OK だがデータがない)">
    Reporting API にまだ返せるデータがないか、トークンのアカウントに Living Security が取り込むユーザーやキャンペーンへの可視性がない可能性があります。トークンが Account Admin によって生成されたことを確認してください。
  </Accordion>
</AccordionGroup>

<PublicIntegrationNextSteps />


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