Log Shipper 用 Scality プラグイン

このドキュメントでは、 Netskope Cloud Exchangeの Log Shipper モジュールを使用して Scality プラグインを構成する方法について説明します。 このプラグインは、アラート (異常、DLP、マルウェア、ポリシー、侵害されたクレデンシャル、訴訟ホールド、マルサイト、検疫、修復、セキュリティ評価、ウォッチリスト、UBA、および CTEP)、イベント (ページ、アプリケーション、監査、インフラストラクチャ、ネットワーク、インシデント、およびエンドポイント)、および WebTx ( Netskope LogStreaming 経由) ログを Scality プラットフォームに送信するために使用されます。 このプラグインにアクセスするには、Scality のクレデンシャルが必要です。 このプラグインは、生の（JSON形式の）ログをScalityに送信するように設計されていることに注意してください。

前提条件

• Netskopeテナント（または、例えば本番環境と開発／テスト環境など、複数のテナント）。
• Netskope Cloud Exchangeテナントには、テナントプラグインとログシッパープラグインが既に設定済みです。
• Netskope Cloud Exchangeテナントには、 AWS Netskope Log StreamingまたはAzure Netskope Log Streamingプラグインが既に構成されています（Netskope Log StreamingプラグインからWebTxを取得するため）。
• ScalityインスタンスのURL、アクセスキー、シークレットアクセスキー、およびScalityバケット名。
• Scalityインスタンスとバケットへのアクセス権。
• ユーザーに対するScalityバケットの権限。
  • ListBucket
  • CreateBucket
  • ListAllMyBuckets
  • GetBucketPolicy
  • GetBucketPublicAccessBlock
  • PutEncryptionConfiguration
  • PutBucketPublicAccessBlock
  • PutBucketPolicy

Scalityプラグインのサポート

Scality プラグインは、 Netskopeイベント、 Netskopeアラート、ウェブ トランザクション データ ( Netskope LogStreaming 経由) を Scality Bucket に取り込むために使用されます。

データ型	サポート
イベント	はい
アラート	はい
ウェブテキサス	はい（Netskope Log Streaming経由）

権限

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=self.scality_public_key,
                aws_secret_access_key=self.scality_private_key,
                aws_session_token=self.scality_session_token,
                endpoint_url=endpoint_url
                config=Config(proxies=self.proxy, user_agent=self.useragent),
            )

バケットを作成する

bucket = s3_client.create_bucket(
                        Bucket=bucket_name,
                        CreateBucketConfiguration=location,
                    )

バケットにファイルをアップロードする

s3_client.upload_file(
                file_name,
                bucket_name,
                object_name,
            )

AWSリソースを取得する

s3_resource = boto3.resource(
                "s3",
                aws_access_key_id=self.scality_public_key,
                aws_secret_access_key=self.scality_private_key,
                endpoint_url=endpoint_url
                config=Config(proxies=self.proxy, user_agent=self. user-agent),
            )

ワークフロー

1. Scalityバケットを作成します。
2. Scalityプラグインを設定します。
3. Scality 用のログシッパービジネスルールを設定します。
4. Scalityのログ配信を設定します。
5. プラグインを検証してください。

再生ボタンをクリックして動画をご覧ください。

バケットを作成する

1. Scalityインスタンスにログインしてください。

   

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

   

3. Create Bucketをクリックして、データを取り込むバケット名を入力してください。

   

Scalityプラグインの設定

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

   

2. 構成名を入力し、Scalityデフォルトマッピング（推奨）ファイルが選択されていることを確認してください。

   

3. Nextをクリックして、設定パラメータを入力してください。
   • Scality Endpoint URL: エンドポイント あなたのScalityインスタンスのURL(例えば) https://s3-your.domain.com/)
   • Access Key: Scalityインスタンスへのアクセスキー。
   • Secret Access Key: Scalityインスタンスの秘密アクセスキー。
   • Scality Bucket Name: ログオブジェクトが保存されるScalityバケット名。（指定された名前のバケットがScality上に存在しない場合、バケットは作成されません。）
   • Maximum File Size (in MBs)バケットに保存される WebTx[Netskope LogStreaming 経由] データオブジェクトの最大サイズ。（値は1～100の範囲で入力してください。）
   • Maximum Duration (in Seconds):WebTx[Netskope LogStreaming経由] データオブジェクトはバケットに保存される必要があります。

4. Saveをクリックしてください。新しいプラグインはLog Shipper > Pluginsページで利用可能になります。

Scality のログシッパービジネスルールを設定する

1. Log ShipperでBusiness Rulesに移動します。
2. デフォルトでは、すべてのアラートとイベントをフィルタリングするビジネスルールが設定されています。特定のアラートやイベントを除外したい場合は、 Create New Rule をクリックして、ルール名と希望するフィルターを追加して新しいビジネスルールを設定してください。完了したら、 Saveをクリックしてください。

   

Scality の Log Shipper ログ配信の設定

1. Log Shipper > Log Deliveryに移動してAdd Log Delivery Configurationをクリックしてください。
2. アラートやイベントについては、Sourceプラグイン(Netskope CLS)、Destinationプラグイン(CLS Scality)、ビジネスルールを選択し、 Saveをクリックします。
3. WebTx の場合は、ソース プラグイン (AWS Netskope Log Streaming または Azure Netskope Log Streaming) と宛先プラグイン (CLS Scality)、ビジネス ルールを選択し、 Saveをクリックします。
4. Log Delivery 構成が追加されると、 Netskopeテナントからのデータの取得、変換、Scality への取り込みが開始されます。

Scalityプラグインを検証する

プルを検証する

Netskopeテナントからインジケーターが取得されたことを検証するには、Cloud ExchangeのLoggingに移動し、取得されたログを検索してください。

プッシュ通知を検証する

Cloud Exchange でプラグインのワークフローを検証するには：

1. Loggingに移動し、フィルターメッセージに ingested が含まれているものを使用して、取り込まれたイベント、アラート、および WebTx を検索します。
2. 取り込まれたログはフィルタリングされます。

   

Scalityへのプッシュを検証するには：

1. Scalityにログインしてください。

   

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

   

3. Alertsフォルダをクリックしてください。

   

4. Eventsフォルダをクリックしてください。

   

5. WebTxフォルダをクリックしてください。

   

ご了承ください：

• アラートとイベントの場合、フォルダ構造はAlerts/feedname/year/month/day/hour/filename.txtのようになります。
• WebTxの場合、フォルダ構造はAlerts/feedname/year/month/day/hour/filename.gzのようになります。

Example: demobucket/alerts/feedname=マルウェア/year=2023/month=11/day=30/hour=9/1701336881_139977276685128.txt

Scalityプラグインのトラブルシューティング

プラグインの設定中に問題が発生しています

このエラーは、Scality クレデンシャルまたはバケット名が無効な場合、構成中に発生する可能性があります。

What to do:

1. Scality エンドポイント URL、アクセス キー、およびシークレット アクセス キーが有効であることを確認してください。
2. プラグインに入力されたバケットが Scality プラットフォーム上に存在することを確認してください。