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

# Adaptive Securityの連携設定

> Adaptive Securityを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="Adaptive Security" />

## この連携で取り込まれる内容

Adaptive Securityからは、従業員、トレーニング、およびマルチチャネルのシミュレーション成果を取り込むことができます。確認済みの例は次のとおりです。

* `phishing.simulation.clicked` — 模擬メールをクリックし、報告しなかった
* `phishing.simulation.credential.submitted` — 模擬サインインページに認証情報を入力した
* `phishing.simulation.attachment.opened` — 模擬メールの添付ファイルを開いた
* `phishing.simulation.reported` — 模擬メールを報告した
* `smishing.simulation.replied` — 模擬テキストメッセージに返信した
* `vishing.simulation.succeeded` — 模擬音声通話の発信者の指示に従った
* `training.assigned` — セキュリティトレーニングが割り当てられた
* `training.completed` — セキュリティトレーニングを完了した
* `training.past.due` — トレーニングの期限を過ぎた

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

<Note>
  **Adaptiveは3つのチャネルでシミュレーションを行い、Living Securityはそれぞれを個別にスコアリングします。**
  メールの成果はフィッシング、テキストメッセージの成果はスミッシング、音声通話の成果はビッシングとしてスコアリングされます。模擬メールをクリックした人と模擬テキストメッセージに返信した人は、それぞれが行った判断が異なるため、同じ行動としては測定されません。
</Note>

## Living Securityに必要なもの

| 認証情報 | 説明 |
| - | - |
| **APIトークン** | Adaptive SecurityのAPIトークンです。Living Securityは、すべてのリクエストでこのトークンをベアラートークンとして送信します。 |

**必要なロール:** **設定 → API**にアクセスできる、Adaptive Securityアカウントの管理者。Adaptiveはロールベースの権限でAPIアクセスを管理しているため、トークンはユーザー、フィッシング、トレーニングを読み取れるロールに属している必要があります。

**アクセス:** 読み取り専用です。Living SecurityはAdaptive Securityからの読み取りのみを行い、お客様のアカウント内の情報を作成、変更、削除することはありません。

### Living Securityが取得する内容

| データ | 詳細 |
| - | - |
| **人** | Adaptiveのユーザーディレクトリ: 氏名、メールアドレス、部署、役職、上長の氏名とメールアドレス、所在地、事業部、雇用ステータス、入社日。 |
| **メールシミュレーション** | シミュレーションごと、個人ごと: メッセージが配信された日時、開封、クリック、返信、添付ファイルの開封、QRコードのスキャン、認証情報の入力、または報告が行われた日時。 |
| **テキストシミュレーション** | シミュレーションごと、個人ごと: 配信、開封、クリック、返信、認証情報の入力、または報告。 |
| **音声シミュレーション** | シミュレーションごと、個人ごと: 配信された誘導内容、発信先の番号、発信者の指示に従ったかどうか、報告したかどうか。 |
| **トレーニング** | キャンペーンごと、個人ごと: 登録日時、期限、開始日時、完了日時、およびキャンペーンポリシーを確認したかどうか。 |

<Note>
  **電話番号は保存されません。** Adaptiveは、ユーザーレコードに会社の電話番号と携帯電話番号を含めて返します。Living Securityの機能ではどちらも使用しないため、Living Securityは何かを保存する前に両方を破棄します。
</Note>

<Note>
  **Adaptive独自のリスクスコアは記録されますが、スコアリングには使用されません。** Adaptiveは個人ごとに`current_risk_score`を算出します。Living Securityは、2つのシステムを並べて比較できるようにこれを保持しますが、人的リスク指数は常に、観察された行動に基づき、Living Securityが公開している独自のモデルを使用して算出されます。他社の総合スコアが使用されることはありません。
</Note>

### 前提条件

* APIが有効化されているAdaptive Securityアカウント。
* [admin.adaptivesecurity.com](https://admin.adaptivesecurity.com)への管理者アクセス。
* 接続されている他のシステムで使用されているアドレスと一致する、Adaptive内のユーザーのメールアドレス。Living Securityは、メールアドレスによってAdaptiveのユーザーと個人を照合します。

***

## パートA — Adaptive Securityでの作業

*これらの手順は、Adaptive Securityの管理者が実施します。*

<Steps>
  <Step title="API設定を開く">
    1. 管理者として[admin.adaptivesecurity.com](https://admin.adaptivesecurity.com)にサインインします。
    2. **設定 → API**に移動します。
  </Step>

  <Step title="APIトークンを生成する">
    1. 新しいAPIトークンを生成します。
    2. 後で識別できる名前を付けます。例: `Living Security`。
    3. トークンのロールが、ユーザー、フィッシングキャンペーン、トレーニングキャンペーンを読み取れることを確認します。
    4. トークンをコピーします。

    <Warning>
      ページを離れる前にトークンをコピーしてください。Adaptiveアカウントでトークンに有効期限が設定されている場合は、その日付を控えておいてください。有効期限が切れるとLiving Securityはデータを取得できなくなり、新しいトークンで接続を更新する必要があります。
    </Warning>
  </Step>
</Steps>

***

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

*この手順は、プログラム責任者が実施します。委任設定を使用する場合は、システム管理者が実施します。*

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

これでAdaptive Securityに接続されました。

***

## データの取得頻度

| データ | スケジュール |
| - | - |
| 人 | 6時間ごと |
| シミュレーションの成果（メール、テキスト、音声） | 6時間ごと |
| トレーニング結果 | 6時間ごと |

AdaptiveのレポートAPIには「前回以降の変更分」を取得するフィルターがないため、Living Securityは、各シミュレーションおよびトレーニングキャンペーンを、成果が生成され続けている間は読み取り、終了してから2週間が経過した時点で読み取りを停止します。これにより、遅れて発生したクリックや報告も取り込まれ、終了したキャンペーンが永久に再読み取りされ続けることもありません。

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

***

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

<AccordionGroup>
  <Accordion title="401 Unauthorized">
    APIトークンが正しくないか、有効期限が切れているか、失効されています。このエラーではAdaptiveが空のレスポンスボディを返すため、確認できる詳細情報はありません。**設定 → API**で新しいトークンを生成し、そのトークンで再接続してください。トークンが一部しかコピーされていない場合も同じエラーになり、これが最も多い原因です。
  </Accordion>

  <Accordion title="403 Forbidden">
    トークンの認証には成功しましたが、そのロールでは要求されたデータを読み取れません。同じトークンを貼り付け直しても解決しません。Adaptiveで、トークンのロールにユーザー、フィッシング、トレーニングの読み取りアクセス権があることを確認するか、その権限を持つロールからトークンを発行してください。
  </Accordion>

  <Accordion title="429 Too Many Requests">
    Adaptiveが接続をレート制限しました。Living Securityはその実行を停止し、次回のスケジュール実行で同じ位置から再開するため、データが失われることはありません。件数の増加に時間がかかるだけです。この状態が数日間続く場合は、Adaptive Securityのサポートに連絡し、お客様のアカウントに適用されているレート制限について問い合わせてください。
  </Accordion>

  <Accordion title="ユーザーは表示されるが、シミュレーションの成果が表示されない">
    想定しているキャンペーンが実際に実行されたことを確認してください。Adaptiveは送信済みのシミュレーションについてのみ登録情報を報告するため、ステータスが**ドラフト**または**予定**のままのキャンペーンは、送信されるまで何も取り込まれません。Living Securityは、実際の成果があるキャンペーンにリクエスト枠を使用できるよう、意図的にこれらを読み取りません。
  </Accordion>

  <Accordion title="音声またはテキストのシミュレーションが見つからない">
    Living Securityは、各成果に関連付けられたシナリオから、その成果のチャネルを判断します。シミュレーションの実行後にAdaptiveでシナリオが削除された場合、チャネルを読み取れなくなるため、その成果はメールチャネルとして記録されます。使用を終了したシナリオは削除せずAdaptiveに残しておくことで、この状況を避けることができます。
  </Accordion>
</AccordionGroup>

<PublicIntegrationNextSteps />


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