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

# Zscaler ZIA Cloud NSS の設定

> Cloud NSS フィードを使用して、Zscaler Internet Access の Web ログを Living Security に送信します。

Zscaler Internet Access (ZIA) の Cloud Nanolog Streaming Service (NSS) フィードを接続して、Web ログを Living Security に送信します。これはプッシュ型の連携であり、プル型の [Zscaler Client Connector](/ja/integrations/catalog/zscaler-client-connector-custom) 連携とは別のものです。

## この連携で提供される情報

Web ログフィードでは、Web アクティビティに関与したユーザーとデバイスを特定できます。また、ブロックされたリクエスト、悪意のある宛先、データ転送のブロック、生成 AI の利用といった正規化されたアクティビティを提供できます。結果は、Zscaler で設定したフィールドとフィルターによって異なります。

## 始める前に

次のものが必要です。

* ZIA Cloud NSS のサブスクリプション、および Cloud NSS フィードを管理する権限
* Living Security で連携とアクセスキーを管理する権限
* 対象の Living Security 組織のリージョン
* 生成されたアクセスキーを保管するための安全な場所

Zscaler では、HTTPS の Cloud NSS 宛先に、公的に信頼された TLS 証明書が必要です。Living Security のリージョン別エンドポイントはこの要件を満たしています。

## 1. Living Security を準備する

<Steps>
  <Step title="ソースとストリームを作成する">
    **設定 → 連携 → カタログ** に移動し、**Custom Push Source** を追加して、次のルーティングキーをそのまま使用します。

    | フィールド | 値 |
    | - | - |
    | Data Source Name | `zscaler-nss-feed` |
    | Stream Name | `web_logs` |

    `web_logs` のアンダースコアは必須です。異なる組み合わせでもデータは受け付けられる場合がありますが、保守されている Zscaler NSS インタープリターは使用されません。
  </Step>

  <Step title="アクセスキーを作成する">
    **設定 → Access Keys** に移動し、**Push Ingest** スコープのアクセスキーを作成して、その値をすぐにコピーします。
  </Step>

  <Step title="宛先 URL を作成する">
    Living Security のリージョンに対応する URL を使用します。

    * 米国: `https://api.us-east-1.livingsecurity.ai/api/v1/push-ingest/zscaler-nss-feed/web_logs`
    * 欧州連合: `https://api.eu-west-1.livingsecurity.ai/api/v1/push-ingest/zscaler-nss-feed/web_logs`
  </Step>
</Steps>

## 2. Cloud NSS フィードを作成する

現行の ZIA Admin Portal で、**Logs → Log Streaming → Internet Log Streaming — Nanolog Streaming Service** に移動し、**Cloud NSS Feeds** を開いて **Add Cloud NSS Feed** を選択します。古いバージョンの ZIA ポータルでは、メニューのラベルが異なる場合があります。ポータルの操作手順については、Zscaler の [Cloud NSS Web ログの手順](https://help.zscaler.com/zia/adding-cloud-nss-feeds-web-logs)が正式な情報です。

フィードを次のように設定します。

| Zscaler のフィールド | 値 |
| - | - |
| Feed Name | `Living Security web logs` など、識別しやすい名前 |
| NSS Type | **NSS for Web** |
| Status | 設定中は **Disabled**。確認後に有効化します |
| SIEM Rate | 組織のポリシーでより低いレートが必要な場合を除き、**Unlimited** |
| SIEM Type | **Other** |
| OAuth 2.0 Authentication | **Disabled** |
| Max Batch Size | **512 KB** |
| API URL | 手順 1 で作成した Living Security のリージョン別 URL |
| HTTP Header 1 | `Authorization` = `Bearer <access-key>` |
| HTTP Header 2 | `Content-Type` = `application/json` |
| Log Type | **Web Log** |
| Feed Output Type | **JSON** |
| JSON Array Notation | **Enabled** |
| Feed Escape Character | `,\"` |

<Warning>
  `x-api-key` は使用しないでください。また、従来の API キーとシークレットをピリオドで連結して使用しないでください。現在の Living Security のプッシュインジェストでは、スコープ付きアクセスキーのみが `Authorization: Bearer …` ヘッダーで受け付けられます。
</Warning>

次の、階層のない **Feed Output Format** を 1 行でそのまま使用します。

```text theme={null}
{"datetime":"%d{yy}-%02d{mth}-%02d{dd} %02d{hh}:%02d{mm}:%02d{ss}","reason":"%s{reason}","event_id":"%d{recordid}","protocol":"%s{proto}","action":"%s{action}","transactionsize":"%d{totalsize}","responsesize":"%d{respsize}","requestsize":"%d{reqsize}","urlcategory":"%s{urlcat}","serverip":"%s{sip}","requestmethod":"%s{reqmethod}","refererURL":"%s{ereferer}","useragent":"%s{eua}","product":"NSS","location":"%s{elocation}","ClientIP":"%s{cip}","status":"%s{respcode}","user":"%s{elogin}","url":"%s{eurl}","vendor":"Zscaler","hostname":"%s{ehost}","clientpublicIP":"%s{cintip}","threatcategory":"%s{malwarecat}","threatname":"%s{threatname}","filetype":"%s{filetype}","appname":"%s{appname}","riskscore":"%d{riskscore}","department":"%s{edepartment}","urlsupercategory":"%s{urlsupercat}","appclass":"%s{appclass}","dlpengine":"%s{dlpeng}","urlclass":"%s{urlclass}","threatclass":"%s{malwareclass}","dlpdictionaries":"%s{dlpdict}","fileclass":"%s{fileclass}","bwthrottle":"%s{bwthrottle}","contenttype":"%s{contenttype}","unscannabletype":"%s{unscannabletype}","deviceowner":"%s{deviceowner}","devicehostname":"%s{devicehostname}","keyprotectiontype":"%s{keyprotectiontype}"}
```

<Warning>
  すべてのフィールドを最上位に配置してください。廃止された Unify のガイドでは、これらのフィールドが `event` オブジェクト内にラップされ、`sourcetype` が追加されていました。このエンベロープは JSON としては受け付けられる場合がありますが、現在のインタープリターと一致しないため、ユーザーもアクティビティも生成されません。
</Warning>

Zscaler のイベントを確認する際に運用チームが想定しているタイムゾーンを選択してください。Living Security は、フィードから提供される `datetime` の値を解析します。

## 3. フィードをフィルターして有効化する

Zscaler の **Policy Action** フィルターと **Policy Reason** フィルターを使用して、ヒューマンリスクプログラムに必要な Web アクティビティを送信します。トラフィックの急増時にログが破棄される可能性があるため、1 秒あたりのイベント数を低く設定することは避けてください。組織でフィードに上限を設ける必要がある場合は、調整中に Zscaler の配信状況と Living Security の Push History の両方を監視してください。

フィードを保存し、Zscaler の接続テストを実行してから、**Status** を **Enabled** に設定します。

## 4. 配信と解釈を確認する

1. Living Security で、**設定 → 連携 → 接続されました → zscaler-nss-feed** を開きます。
2. **Push History** で、最近の `web_logs` の実行に想定どおりのレコード数が表示されていることを確認します。
3. 最近の Zscaler のユーザーまたはデバイスの IP が、想定される担当者に関連付けられていること、および Web アクティビティが下流で利用できることを確認します。
4. 実行は受け付けられたがアクティビティが表示されない場合は、ソース、ストリーム、階層のない出力フォーマットが正確であることを再確認してください。

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

| 症状 | 確認事項 |
| - | - |
| `401 Unauthorized` | `Authorization` を値 `Bearer <access-key>` で使用します。期限切れまたは失効したキーはローテーションしてください |
| `403 Forbidden` | **Push Ingest** スコープでキーを作成します |
| `404 Not Found` | `zscaler-nss-feed` と `web_logs` を登録し、その URL をそのまま使用します |
| `400 Bad Request` | JSON Array Notation を有効にし、出力が階層のないオブジェクトの最上位配列であることを確認します |
| `202` だがユーザーもアクティビティも表示されない | 従来の `sourcetype` / `event` ラッパーを削除し、ルーティングキーが正確であることを確認します |
| `429` | 一時的な IP レベルのスロットリングが解除されるまで待機し、`Retry-After` がある場合はそれに従ってください |
| `503` | バッチを保持して再試行に備え、`Retry-After` まで待機してから、変更せずに再送信します |
| 接続テストが失敗する | リージョン別のホスト名、Bearer ヘッダー、キーのステータス、および公的 TLS インスペクションポリシーを確認します |

API が受け付けるのは、1 リクエストあたり最大 10,000 レコードおよび 10 MB までで、組織ごとに 60 秒あたり 600 リクエストまでです。レスポンスと再試行の仕様の詳細については、[Custom Push Source API](/ja/integrations/custom-push-source) を参照してください。

## 関連情報

<CardGroup cols={2}>
  <Card title="Custom Push Source API" icon="arrow-up-from-bracket" href="/ja/integrations/custom-push-source">
    認証、ペイロードの制限、レスポンス、再試行、実行の確認について説明します。
  </Card>

  <Card title="Zscaler Client Connector" icon="laptop" href="/ja/integrations/catalog/zscaler-client-connector-custom">
    デバイスとポスチャーのデータ用に、別の Client Connector API を接続します。
  </Card>
</CardGroup>


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