Skip to main content

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

KnowBe4 は、従業員、トレーニング、フィッシングシミュレーションに関する成果を提供できます。確認済みの例は次のとおりです。
  • training.completed — セキュリティトレーニングを完了する
  • training.past.due — トレーニングが期限切れになっている
  • phishing.simulation.clicked — 報告せずにシミュレーションをクリックした
これらの例は、Living Security が利用できる正規化されたアクティビティの種類を示しています。連携データがシグナルになる仕組みを参照してください。

​
Living Security に必要な情報

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

​
前提条件

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

​
パート A — KnowBe4 での作業

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

Reporting API を有効化してトークンを生成する

  1. KnowBe4 コンソールにサインインします。
  2. 右上のアカウント名をクリックし、Account Settings を選択します。
  3. 左側のナビゲーションで API を選択します。
  4. Reporting API が有効になっていない場合は有効にし、新しい API トークンを生成します。
コンソールで用途の入力を求められた場合は、トークンの用途が分かる名前(例: Living Security Platform)を指定してください。
KnowBe4 では、API トークンの値は生成時に一度だけ表示されます。すぐにコピーして、パスワードボールトやシークレット管理ツールなどの安全な場所に保管してください。コピーせずに画面を移動した場合は、新しいトークンを生成する必要があります。
Reporting API は読み取り専用です。ユーザー、トレーニングの受講登録、フィッシングセキュリティテストの結果を公開します。これらは Living Security がスコアリングとレポート作成のために取り込むデータです。書き込みアクセスは必要ありません。
2

Living Security のエグレス IP を Allowed IP Addresses リストに追加する

KnowBe4 では、Reporting API へのアクセスを特定の送信元 IP アドレスに制限できます。この設定はトークンと同じ場所にあります。
  1. KnowBe4 コンソールで Account Settings → API → Allowed IP Addresses に移動します。
  2. 各Living Security のエグレス IP アドレスを許可リストに追加します。すべてのリージョンで同じ 4 つのアドレスが適用されます。
Allowed IP Addresses リストが設定されている場合、ネットワーク層で適用されます。 接続ダイアログでは認証に成功しますが、Living Security のエグレス IP が許可リストに追加されるまで、データ同期は失敗します(ネットワーク層でブロックされ、通常は 403 として表示されます)。このリストにアドレスを 1 つでも追加する場合は、Living Security の範囲も追加する必要があります。追加しないと、トークンが有効であってもリクエストは拒否されます。
Living Security のエグレス IP アドレスは、インフラストラクチャの更新時に変更されることがありますが、そのような変更はまれです。以前は正常だったデータ同期が失敗し始めた場合は、連携のエグレス IP アドレスの設定を確認し、Allowed IP Addresses リストが一致していることを確認してください。
3

KnowBe4 のサーバーリージョンを確認する

KnowBe4 は、リージョンごとに異なるホストから Reporting API を提供しています。ホスト名を入力する必要はなく、接続ダイアログでリージョンを選択します。お使いのアカウントがどのリージョンを使用しているか不明な場合は、KnowBe4 コンソールの URL のドメインを確認するか、KnowBe4 の管理者にお問い合わせください。
Living Security が接続できるのは、これら 5 つのリージョンです。お使いの KnowBe4 アカウントが別のサーバー(たとえば米国政府向けインスタンス)にある場合は、接続を開始する前に Living Security のサポートにお問い合わせください。

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

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

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

API トークンが無効か、有効期限が切れています。トークンが正しいこと、および Account Settings → API で再生成されていないことを確認してください。
トークンに Reporting API へのアクセス権がないか、リクエスト元の IP が Allowed IP Addresses リストに含まれていません。Reporting API が有効になっていること、および 4 つすべてのLiving Security のエグレス IP アドレスが許可リストに含まれていることを確認してください。
Reporting API にまだ返せるデータがないか、トークンのアカウントに Living Security が取り込むユーザーやキャンペーンへの可視性がない可能性があります。トークンが Account Admin によって生成されたことを確認してください。