カスタムファイル分類用のMicrosoftファイル共有プラグイン

このドキュメントでは、Microsoft ファイル共有 v1.1.0 の設定方法について説明します。Netskope Cloud Exchangeプラットフォームのカスタム ファイル分類 (CFC) モジュールを備えたプラグイン。 このプラグインは リモートのWindowsサーバー上の指定されたディレクトリから画像またはzipファイルを取得します。 このプラグインは、SMBプロトコル（バージョン2.0.2～3.1.1）の両方をサポートしています。ファイル転送にはSFTPプロトコルを使用します。

Prerequisites

設定を完了するには、以下が必要です。

• Netskopeテナント（または、例えば本番環境と開発／テスト環境など、複数のテナント）。
• Netskopeテナント上のカスタムファイル分類器。
• Netskope Cloud Exchangeテナントには、テナントプラグインとカスタムファイル分類プラグインが既に設定済みです。
• SFTP/SMBプロトコルが設定され、SSHサービスが有効になっているWindows Serverでファイルを取得するためのアクセスが可能になっている。
• CFCハッシュ生成のために処理されるデータを含む、Microsoftサーバーに保存されているイメージファイルまたはイメージファイルのアーカイブ。

For the SMB Protocol

• ネットワーク共有が有効になっている（SMB/CIFSサービスが稼働している）Microsoftサーバー。
• 適切なアクセス権限が設定された共有フォルダ。
• SMBポート（通常は445番）を介したMicrosoftサーバーへのネットワーク接続。

For the SFTP Protocol

• OpenSSHサービスが有効化され、設定されているMicrosoftサーバー。
• SSHサービスが稼働しており、Cloud Exchangeからアクセス可能です。
• SFTPプロトコル（通常はポート22）を介したMicrosoftサーバーへのネットワーク接続。

Microsoft File Share CFC Plugin Support

このプラグインは リモートのWindowsサーバー上の指定されたディレクトリから画像またはzipファイルを取得します。 このプラグインは、SMBプロトコル（バージョン2.0.2～3.1.1）の両方をサポートしています。ファイル転送にはSFTPプロトコルを使用します。

権限

プラグインの設定にはこの権限が必要です。SSHユーザーは、指定されたファイルへの参照アクセス権を持っている必要があります。

Microsoft Server Permissions

Required Permissions

プラグインの設定には、以下の権限が必要です。

For the SMB Protocol

• ネットワーク共有が有効になっている（SMB/CIFSサービスが稼働している）Microsoftサーバー。
• 適切なアクセス権限が設定された共有フォルダ。
• SMBポート（通常は445番）を介したMicrosoftサーバーへのネットワーク接続。

For the SFTP Protocol

• OpenSSHサービスが有効化され、設定されているMicrosoftサーバー。
• SSHサービスが稼働しており、Cloud Exchangeからアクセス可能です。
• SFTPプロトコル（通常はポート22）を介したMicrosoftサーバーへのネットワーク接続。

import paramiko

ssh_connection = paramiko.SSHClient()

ssh_connection.set_missing_host_key_policy(paramiko.AutoAddPolicy())

ssh_connection.connect(

    hostname=configuration.get("sftp_server_ip", ""),

    username=configuration.get("sftp_username", ""),

    password=configuration.get("sftp_password", ""),

    port=configuration.get("sftp_port", 22)

)

with ssh_connection.open_sftp() as sftp_session:

sftp_session.get(

    data.get("path", ""),

    os.path.join(

    file_path, data.get("file", "")))

try:

    file_attributes = sftp_session.stat(directory_path)

    if not stat.S_ISDIR(file_attributes.st_mode):

        # Handle custom error

except FileNotFoundError:

    # Handle file not found error    pass

ssh_connection.close()

Performance Matrix

以下は、これらの仕様を持つ大規模Cloud Exchangeインスタンス上で、10K個のファイルメタデータ（各ファイルサイズは約5.4MB、合計ファイルサイズは約52.5GB）を取得および保存する際に実施したパフォーマンス測定結果です。

ワークフロー

1. Microsoftサーバーを構成します。
2. Microsoftファイル共有CFCプラグインを設定します。
3. Microsoftファイル共有用のビジネスルールを設定します。
4. Microsoft ファイル共有の共有設定を行います。
5. Microsoftファイル共有CFCプラグインの検証。

動画を見る

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

Microsoft ServerをSFTPプロトコルで構成する

1. PowerShellを管理者として起動します（右クリック > 管理者として実行）。
2. 以下のコマンドを実行してください。 Add-WindowsCapability -Online -Name OpenSSH.Server~~~~0.0.1.0
3. 出力結果で「状態: インストール済み」となっていることを確認して、インストールが成功したことを確認してください。
4. PowerShellを管理者として起動します。
5. SSH サービスを開始します。 Start-Service sshd
6. 起動時にサービスが自動的に開始されるように構成します。 Set-Service -Name sshd -StartupType 'Automatic'
7. サービスが実行されていることを確認してください。 Get-Service sshd
8. SSH設定ディレクトリに移動してください。 cd 'C:\ProgramData\ssh'
9. ポートを変更したり、ユーザーを許可したりする場合は、設定ファイルをメモ帳で開いてください。
10. 設定ファイルを保存した後、サービスを再起動して変更を適用してください。 Restart-Service sshd
11. 「開始」メニューから「セキュリティが強化された Windows Defender ファイアウォール」を開きます。
12. 左側のペインでInbound Rulesクリックし、次に右側のペインでNew Ruleクリックしてください。
13. ルールタイプとしてポートをSelectし、Nextをクリックします。
14. Select TCP, enter port 22 (or your custom port), and click Next.
15. Select Allow the Connection and click Next.
16. 該当するプロファイル(ドメイン、プライベート、パブリック)をSelectし、Nextをクリックします。
17. Name the rule Allow SFTP and click Finish.
18. WinSCPなどの標準的なSFTPクライアントを使用して接続を確認してください。 接続が確立されれば、共有ディレクトリのパスを表示できるようになります。

Microsoft ServerをSMBプロトコルで構成する

1. SMBプロトコルに対応するようにネットワーク共有を設定します。

2. このプラグインの一部として取得したい画像が含まれているディレクトリを右クリックします。「共有」タブに移動して、 Advanced Sharingをクリックします。

   

3. 「フォルダーを共有」オプションをチェックして、 Permissionsをクリックします。

   

4. ネットワーク共有を設定したいユーザーが「グループ名またはユーザー名」セクションにない場合は、 Addをクリックしてください。Advanced 、 Find Nowをクリックして、ユーザーを追加します。

   

5. ユーザーがアクセス許可ダイアログボックスに表示されていることを確認し、ディレクトリに対するアクセス許可を持っていることを確認してください。

   

6. 設定変更を適用し、ネットワークパス内でディレクトリ名がコンピュータ名／マシン名の直後に表示されることを確認してください。マシン上に同じ名前のディレクトリが既に設定されている場合、ネットワークパス内のディレクトリ名の後にインデックスが追加され、SMBプロトコルを通じて一意に識別されます。この場合は、プラグインの設定時にインデックスを含むディレクトリ名を必ず指定してください。

   

7. SFTPプロトコルを使用するには、Windowsサーバー上でOpenSSHサービスを有効にしてください。

   • WindowsサーバーでOpenSSHサービスを有効にするには、以下の手順に従ってください
     https://learn.microsoft.com/en-us/windows-server/administration/openssh/openssh_install_firstuse?tabs=gui
   • 古いバージョンのWindowsの場合、オプション機能にOpenSSHが見つからない場合は、次のドキュメントに従ってOpenSSHサービスをインストールしてください：
     https://github.com/PowerShell/Win32-OpenSSH/releases/
   • 設定するユーザーが OpenSSHサービスにアクセスできることを確認してください。

Microsoftファイル共有CFCプラグインを構成する

1. Cloud Exchange で、 Settings > Plugin Storeに移動します。

2. Microsoft File Share v 1.1.0 (CFC)プラグインを検索して選択してください。

   

3. 基本情報を入力してください：

   • Configuration Name: 統合内容に適した名前を入力してください。
   • Sync Interval: プラグインソースからデータを取得する間隔。12時間以上保管することをお勧めします。（デフォルト：12時間）

   

4. 要件に応じてプロトコルSelect 。

   

5. Next をクリックして、設定パラメータを入力してください。

   For the SFTP Protocol

   • Server IP/Hostname: ファイルを取得するWindowsマシンのホスト名またはIPアドレス。
   • Username: 設定されている Windows マシンのユーザー名 マシン上の OpenSSH サービス。
   • Password: 指定されたユーザー名のパスワード。
   • Port: マシン上のOpenSSHサービスに接続するためのTCPポート番号。

   

   For the SMB Protocol

   • Server IP/Hostname: ファイルを取得するサーバーのホスト名またはIPアドレス。
   • Machine Name: サーバーのNetBIOSマシン名。
   • Username: 共有ディレクトリへのアクセス権を持つリモートマシンのユーザー名。
   • Password: 指定されたユーザー名のパスワード。

   

   SMBプロトコル用のカスタムファイル分類には、SMBプラグインをお勧めします。

6. Next をクリックして、ディレクトリ構成パラメータを入力してください。

   • Directory Path: ファイルを取得するディレクトリのパス。画像ファイルやZIPファイルに関連する拡張子を持つファイルをサポートしています。
   • Filename Filter: 取得する画像ファイルをフィルタリングする正規表現。フィルターが有効な正規表現であることを確認してください。
     • 値が空の場合、ディレクトリからすべてのファイルを取得します。
     • このフィルターは、指定されたディレクトリに直接保存されている画像のみを取得します。

   

   Microsoftファイル共有プラグインでは、複数のディレクトリを追加できます。

7. Nextをクリックすると、設定済みのディレクトリのファイルスキャン結果をプレビューできます。プラグインによって取得されるファイルの数とサイズが正しいことを確認し、合計ファイル数の制限（10,000）と合計ファイルサイズの制限（約78.125 GB）を超えないようにしてください。

   

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

   

Microsoftファイル共有用のCFCビジネスルールを構成する

CFCモジュールでは、Netskopeテナントとファイルデータを共有するためにビジネスルールが必要です。ファイル名、サイズ、拡張子、ソースなどでファイルをフィルタリングするルールを追加できます。複数のルールをグループ化することで、高度なフィルタリングが可能になります。

1. Custom File Classification > Business Rulesへ移動してください。

2. Create New Ruleをクリックして、以下のパラメータを入力してください。

   • Rule Name: ビジネスルールに固有の名前を付ける。
   • Rule: 条件に基づいてフィルターを設定し、ファイルのグループを作成します。
   • Folder Name: 複数のビジネスルールをグループ化するために、フォルダ名またはサブフォルダ名を指定してください。構造化されたビジネスルールの一覧を表形式で表示すると分かりやすくなるでしょう。

   

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

   

Microsoft ファイル共有のリスク交換共有を構成する

1. Custom File Classification > Sharingへ移動してください。

2. Add Sharing Configurationをクリックし、ソース構成としてMicrosoft File Share CFCプラグインを選択します。

3. 宛先構成としてNetskope CFCプラグインSelect 。

4. 宛先は、宛先設定に基づいてデフォルトで選択されます。

5. ビジネスルール、ファイル分類器、およびトレーニングタイプのマッピングをSelect 。 1つの共有設定で複数のビジネスルールをマッピングできます。ファイル分類子には、Netskopeテナント上で作成されたカスタムファイル分類子のみが表示されます。

   

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

   

共有設定の同期または削除

• 同期アイコンをクリックして、共有設定を同期してください。これにより、実際のイベントが発生するのを待たずに、共有プロセスが即座に開始されます。
• ゴミ箱アイコンをクリックして、共有設定を削除してください。

Microsoftファイル共有CFCプラグインを検証する

プルを検証する

共有設定が完了したら、設定済みのMicrosoftファイル共有CFCプラグインの次回のプラグインライフサイクル実行が正常に完了するまで待つ必要があります。

「共有とアップロードの管理」ページで、Microsoft ファイル共有プラグインの状態を確認してください。カスタムファイル分類 > 共有とアップロード管理に移動します。

共有設定の状態は、以下のいずれかになります。

• スケジュール済み：これは、共有設定は完了しているものの、まだキューに入っており、初回実行を待っている状態であることを示します。
• ハッシュ生成中：これは、ハッシュ生成処理が進行中であることを示します。 
• ハッシュのアップロード：これは、ハッシュが正常に生成され、設定された宛先への共有処理が進行中であることを示します。
• 完了：これは、生成されたハッシュが宛先構成と正常に共有されたことを示します。
• 失敗:プロセスがデータ取得、ハッシュデータ、またはハッシュアップロードのいずれかに失敗したことを示します。

Clicking View Metadata will redirect you to the Files Metadata page.

Validate Sharing on the Netskope Tenant

1. Netskopeテナントにログインしてください。

2. Policies > DLP > File Classifiersへ移動してください。

   

   

3. 共有設定時に選択した分類子Select 、受信したファイルハッシュがここに表示されます。

   

Microsoftファイル共有CFCプラグインのトラブルシューティング

Microsoftファイル共有CFCプラグインを構成できません

ユーザーが Microsoft ファイル共有 CFC プラグインを構成できない場合、以下のいずれかの理由が考えられます。

• 間違ったクレデンシャルが提供されました。
• ユーザーにはファイルのアクセス権がありません。
• ホスト名またはサーバーIPアドレスが間違っています。
• 指定されたポート値はサーバー上で無効になっています。
• ディレクトリパスが間違っています。

何をするか：

1. 必ず正しいクレデンシャルを入力してください。
2. ユーザーがファイルにアクセスするために必要な権限を持っていることを確認してください。 ファイル。
3. 正しいホスト名／サーバーIPアドレスが入力されていることを確認してください。
4. ポートが有効になっていて、リスニングモードになっていることを確認してください。
5. 指定されたパスに画像ファイルデータが存在することを確認してください。