リリースノート
1.1.0(最小 Cloud Exchange バージョン 6.0.0 が必要)
Added
- デフォルトのマッピングに、コンテンツとデバイスのアラートタイプ、クライアントステータスのイベントタイプ、およびWebTx v2タイプのサポートが追加されました。
- JSON形式のオプションが追加されました。
- エラーログに関する解決策を追加しました。
Changed
- オブジェクトファイル名の形式を <epoch>_<thread_id>_<uuid>.<extension> に更新し、データが全く同時に取り込まれた際にデータが上書きされるのを防ぎます。
Fixed
- NLSを使用してWebTxデータを共有する際に発生するエラーを修正しました。
- アップロードが失敗したときに一時ファイルが削除されない問題を修正しました。
1.0.0
Added
- 初回リリース。
このドキュメントでは、Scality v1.1.0の構成方法を説明します。プラグインをNetskope Cloud ExchangeプラットフォームのLog Shipperモジュールで動作させます。このプラグインは、以下の取り込みをサポートします。
- アラート(DLP、マルウェア、ポリシー、侵害されたクレデンシャル、悪意のあるサイト、検疫、修復、セキュリティ評価、ウォッチリスト、UBA、CTEP、デバイス、コンテンツ)。
- イベント(ページ、アプリケーション、監査、インフラストラクチャ、ネットワーク、インシデント、エンドポイント、クライアントステータス)。
- WebTx data.
データはScalityバケットに取り込まれます。このプラグインはJSON形式のログのみを送信します。
前提条件
この設定を完了するには、以下が必要です。
- Netskopeテナント(または、例えば本番環境と開発/テスト環境など、複数のテナント)。
- Netskope Cloud Exchangeテナントには、テナントプラグインとログシッパープラグインが既に設定済みです。
- AWS Netskope Log StreamingまたはAzure Netskope Log Streamingプラグインが既に構成されているNetskope Cloud Exchangeテナント(Netskope Log Streamingプラグインからアラート、イベント、WebTxを取り込むため)。
- ScalityインスタンスのURL、アクセスキー、シークレットアクセスキー、およびScalityバケット名。
- Scalityインスタンスとバケットへのアクセス権。
- ユーザーに対する Scality バケットの権限は以下の通りです。
- ListBucket
- CreateBucket
- ListAllMyBuckets
- GetBucketPolicy
- GetBucketPublicAccessBlock
- PutEncryptionConfiguration
- PutBucketPublicAccessBlock
- PutBucketPolicy
- Secrets Managerを使うには、このドキュメントを参照してください。Azure Key Vaultをセットアップするには、このドキュメントを参照してください。
Scalityプラグインのサポート
このプラグインは、アラート、イベント、および WebTx データの Scality バケットへの取り込みをサポートしています。このプラグインは、JSON 形式での取り込みのみをサポートしています。
| データ型 | サポート |
|---|---|
| イベント | はい(ページ、アプリケーション、監査、インフラストラクチャ、ネットワーク、インシデント、エンドポイント、クライアントステータス) |
| アラート | はい (DLP、マルウェア、ポリシー、侵害されたクレデンシャル、マルサイト、検疫、修復、セキュリティ評価、ウォッチリスト、UBA、CTEP、デバイス、コンテンツ) |
| ウェブテキサス | はい(Netskope Log Streaming経由) |
注記
- Google Pub Sub Lite をベースにした CLS WebTX は非推奨となりました。Netskope製品のサポート終了/サポート終了に関するお知らせについては、Netskopeナレッジポータルをご覧ください。
- WebTXログをSIEM、SOAR、XDR、データレイクなどのログ配信先に取り込むには、 AWS Netskope Log StreamingまたはAzure Netskope Log Streamingプラグインを使用します。
- エンドポイントイベントタイプの取り込みは、Cloud Exchange バージョン 5.1.0 以降でサポートされています。
権限
イベント、アラート、およびウェブトランザクションログをバケットに送信するためのユーザーへの Scality バケット権限が必要です。
APIの詳細
使うAPI一覧
このプラグイン Scalityでファイルオブジェクトを作成するためのPythonライブラリ
ライブラリ:AWS SDK for Python(Boto3)
使用方法:AWS SDK for Python(Boto3)を使用して、Amazon Elastic Compute Cloud(Amazon EC2)やAmazon Simple Storage Service(Amazon S3)などのAWSサービスを作成、構成、管理します。SDKは、オブジェクト指向APIと、AWSサービスへの低レベルアクセス機能を提供します。
クライアントを作成する
s3_client = boto3.client(
"s3",
aws_access_key_id=access_key,
aws_secret_access_key=secret_access_key,
endpoint_url=endpoint_url,
region_name=region_name, # only for an AWS style endpoint
config=Config(
proxies=proxy,
user_agent=user_agent,
read_timeout=300,
retries={"max_attempts": 3, "mode": "standard"},
),
)
バケットを作成する
s3_client.create_bucket(Bucket=bucket_name) # us-east-1
s3_client.create_bucket(
Bucket=bucket_name,
CreateBucketConfiguration={"LocationConstraint": region_name},
)
バケットにファイルをアップロードする
s3_client.upload_file(
file_name,
bucket_name,
object_name,
)
AWSリソースを取得する
s3_resource = boto3.resource(
"s3",
aws_access_key_id=access_key,
aws_secret_access_key=secret_access_key,
endpoint_url=endpoint_url,
region_name=region_name, # only for an AWS style endpoint
config=Config(
proxies=proxy,
user_agent=user_agent,
retries={"max_attempts": 0, "mode": "standard"},
),
)
パフォーマンスマトリックス
このパフォーマンスの読み取りは、これらの VM 仕様でテストされた Large Stack CE 用です。
| デスクリプション | 仕様 |
|---|---|
| スタックの詳細 | サイズ:大 RAM:32 GB CPU:16コア |
| SIEMに取り込まれたアラート/イベント | ~185K EPM |
| SIEMに取り込まれたWebTx(Netskope Log Streaming経由) | ~155K EPM |
ユーザーエージェント
netskope-ce-7.0.0-cls-scality-v1.1.0
ワークフロー
- Scalityバケットを作成します。
- Scalityプラグインを設定します。
- Scality のビジネスルールを構成します。
- Scalityのログ配信を設定します。
- プラグインを検証してください。
動画を見る
再生ボタンをクリックして動画をご覧ください。
Scalityでバケットを作成する
- Scalityインスタンスに移動します。

- クレデンシャルを入力してログインします。

- Create Bucketをクリックし、データをインジェストするバケットの名前を入力します。Createをクリックします。

Scalityプラグインの設定
-
Cloud Exchange で、 Settings > Plugin Storeに移動します。Scality v1.1.0 (CLS)プラグインを検索して選択してください。

-
構成名を入力し、要件に従ってマッピングを設定します。

-
Nextをクリックして、設定パラメータを入力してください。
- Scality Endpoint URL: Scality インスタンスのエンドポイントURL。例: https://s3-your.domain.com/
- Access Key: Scalityインスタンスへのアクセスキー。
- Secret Access Key: Scalityインスタンスのシークレットアクセスキー。
- Scality Bucket Name: ログオブジェクトが格納されるScalityバケットの名前。バケットはScality上に既に存在している必要があります。

-
[Save]をクリックします。新しいプラグインは、[Log Shipper]>[Plugins]ページに表示されます。

Scality のログシッパービジネスルールを設定する
- Log ShipperでBusiness Rulesに移動します。
- デフォルトでは、すべてのアラートとイベントをフィルタリングするビジネスルールがあります。特定の種類のアラートやイベントを除外する場合は、Create New Rule をクリックし、ルール名と希望するフィルタを追加して新しいビジネスルールを構成します。

- Saveをクリックしてください。

Scality の Log Shipper ログ配信の設定
- Log Shipper > Log Deliveryに移動してAdd Log Delivery Configurationをクリックしてください。
- アラートとイベントについては、ソースプラグイン(Netskope CLSまたはその他のソースプラグイン)、宛先プラグイン(CLS Scality)、ビジネスルールを選択し、Saveをクリックします。
- WebTx の場合は、ソース プラグイン (AWS Netskope Log Streaming または Azure Netskope Log Streaming) と宛先プラグイン (CLS Scality)、ビジネス ルールを選択し、 Saveをクリックします。

- ログ配信構成が追加された後、データは Netskope テナントまたはソースプラットフォームからプル、変換され、Scality に取り込まれ始めます。
Scalityプラグインを検証する
プルを検証する
Netskopeテナントからのアラート、イベント、WebTxのプルを検証します。
Netskope CEのロギングに移動します。取得したログを検索します。





プッシュ通知を検証する
Cloud Exchange でプラグインのワークフローを検証するには:
Loggingに移動し、フィルターメッセージに ingested が含まれているものを使用して、取り込まれたイベント、アラート、および WebTx を検索します。
取り込まれたログはフィルタリングされます。





Scalityへのプッシュを検証するには:
- Scalityにログインしてください。

- バケットをクリックしてください。

- [Alerts]フォルダをクリックします。




- [Events]フォルダをクリックします。




- WebTx フォルダをクリックします。



カスタムマッピングで取り込まれたデータのサンプルは次のとおりです。

注記
- アラートとイベントの場合、フォルダ構造はalerts/feedname/year/month/day/hour/filename.txtのようになります。
- WebTxの場合、フォルダ構造はwebtx/feedname/year/month/day/hour/filename.gzのようになります。
- File names use the format <epoch>_<thread_id>_<uuid>.<extension>, where the extension is .txt for alerts and events and .gz for WebTx.
Example: demobucket/alerts/feedname=マルウェア/year=2023/month=11/day=30/hour=9/1792588265_132874188526208_37862b2b68994795874100a37cc8e2cf.txt
Scalityプラグインのトラブルシューティング
プラグインの設定中に問題が発生しています
このエラーは、Scality クレデンシャルまたはバケット名が無効な場合、構成中に発生する可能性があります。


What to do:
- Scality エンドポイント URL、アクセス キー、およびシークレット アクセス キーが有効であることを確認してください。
- プラグインに入力されたバケットがScalityプラットフォームに存在することを確認してください。詳細については、バケットの作成を参照してください。

