リスクエクスチェンジ用Mimecastプラグイン

このドキュメントでは、Mimecast v2.1.0を設定する方法について説明します。Netskope Cloud ExchangeプラットフォームのRisk Exchangeモジュールを備えたプラグイン。このプラグインは、Mimecastプラットフォームの Engage > Reporting and Insights > Training レポート ページからユーザーを取得します。このプラグインは、Mimecastユーザーに対して「グループに追加」、「グループから削除」、「アクションなし」などのアクションを実行することをサポートします。

ユーザーに対するNetskope正規化スコアの計算：グレードA：800、グレードB：600、グレードC：400、グレードD：200、グレードF：1。

前提条件

この統合を完了するには、以下が必要です。

• Netskopeテナント（または、例えば本番環境と開発／テスト環境など、複数のテナント）。
• Netskope Cloud Exchangeテナントには、テナントプラグインとリスクエクスチェンジプラグインが既に設定済みです。
• Mimecastプラットフォーム クレデンシャル。
• 少なくとも「Awareness Training | Dashboard | Read」、「Directories | Groups | Edit」、および「Accounts | Dashboard | Read」の権限を持つMimecast管理者。
• アクセス管理者およびEngage Core概要アクセス権を持つMimecastプラットフォーム。詳細については、次のドキュメントを参照してください。
  • Mimecastナレッジハブ
  • Engage Core
• 以下のホストへの接続: https://login.mimecast.com/ 。

Mimecastプラグインのサポート

このプラグインは、Mimecastプラットフォームの Engage > Reporting and Insights > Training レポート ページからユーザーを取得します。このプラグインは、Mimecastユーザーに対して「グループに追加」、「グループから削除」、「何もしない」などのアクションを実行します。

マッピング

マッピングは、取得したユーザーとその詳細を表示するために使うされます。プラグイン設定中にマッピングされたフィールドは、データがプルされた後に「レコード」ページに表示されます。プラグインを設定する際に使う推奨マッピングは次のとおりです。

プルマッピング

スコアマッピング

リスクの高いユーザーのスコアマッピングは、他のプラグインとは異なります。Mimecastはスコアをグレードとしてレポートし、各グレードはCloud Exchangeの数値スコアとリスクカテゴリにマップされます（以下を参照）。

権限

• 管理コンソールへのアクセス。
• ユーザーを作成する権限。
• 作成されたユーザーをBasic Administratorロールに追加する権限。

{
    "access_token": "V9RteK0pwTxPscMCCd6xs20f05Ob",
    "token_type": "Bearer",
    "expires_in": 1799,
    "scope": ""
}

{
    "meta": {
        "status": 200
    },
    "data": [
        {
            "region": "us",
            "archive": false,
            "gateway": true,
            "passphrase": "",
            "supportCode": "5656",
            "maxRetention": 30,
            "maxRetentionConfirmed": true,
            "minRetentionEnabled": false,
            "automatedSegmentPurge": true,
            "type": "full",
            "policyInheritance": false,
            "databaseCode": "test",
            "searchReason": false,
            "contentAdministratorDefaultView": "",
            "adminSessionTimeout": 720,
            "exportApi": false,
            "exgestAllowQuery": false,
            "exgestAllowExtraction": true,
            "expressAccount": false,
            "cybergraphV2Enabled": true,
            "accountCode": "",
            "accountName": "",
            "adminEmail": "",
            "contactEmail": "testuser@gmail.com",
            "domain": "",
            "userCount": 10,
            "umbrellaAccounts": [
                "CU2A110,CUSA131A2,CUSA133A2,CUSA42A10,CUS"
            ],
            "mimecastId": "01-1234-123",
            "contactName": "test user",
            "telephone": "123-123-123",
            "packages": [
                "Auto Responders (Site) [1005]",
                "Impersonation Protection [1060]",
                "Engage Core [1124]"
            ]
        }
    ],
    "fail": []
}

{
    "meta": 
    {
        "pagination": {
            "pageSize": 100,
            "pageToken": ""
        }
    }
}

{
 "meta": {
        "pagination": {
            "pageSize": 19,
            "totalCount": 19
        },
        "status": 200
    },, 
 "data": [
  {
   "humanError": "String", 
   "emailAddress": "String", 
   "name": "String", 
   "sentiment": "String", 
   "department": "String", 
   "engagement": "A", 
   "knowledge": "A", 
   "risk": "A"
  }
 ],
    "fail": []
}

{
    "meta": 
    {
        "pagination": {
            "pageSize": 100,
            "pageToken": ""
        }
    }
}

{
    "meta": {
        "pagination": {
            "pageSize": 100,
            "totalCount": 120,
            "next": ""
        },
        "status": 200
    },
"data": [
        {
            "source": "cloud",
            "folders": [
                {
                    "id": "string",
                    "description": "demo",
                    "source": "cloud",
                    "parentId": "string",
                    "userCount": 2,
                    "folderCount": 0
                },
],
    "fail": []
}

{
    "data":[
        {
            "id": "string",
            "emailAddress":"abc@test.com"
        },
        {
            "id": "string",
            "emailAddress":"test@gmail.com"
        }
    ]
}

{
    "fail": [],
    "meta": {
        "status": 200
    },
    "data": [
        {
            "folderId": "String",
            "emailAddress": "String",
            "id": "String",
            "internal": true
        }
    ]
}

{
    "data":[
        {
            "id": "string",
            "emailAddress":"abc@test.com"
        },
        {
            "id": "string",
            "emailAddress":"test@gmail.com"
        }
    ]
}

{
    "fail": [],
    "meta": {
        "status": 200
    },
    "data": [
        {
            "folderId": "String",
            "emailAddress": "String",
            "id": "String",
            "internal": true
        }
    ]
}

{
    "data": [
        {
        "description": "Created Group"
        }
    ]
}

{
    "meta": {
        "status": 200
    },
    "data": [
        {
            "id": "string",
            "description": "Created Group",
            "source": "cloud",
            "userCount": 0,
            "folderCount": 0
        }
    ],
    "fail": []
}

パフォーマンスマトリックス

次のパフォーマンスマトリックスは、50万人のユーザーをプルしながら大規模な Cloud Exchange スタックで測定されました。

ユーザーエージェント

netskope-ce-7.0.0-cre-mimecast-v2.1.0

ワークフロー

1. 新しいユーザーを作成し、そのユーザーを管理者の役割に追加します。
2. APIアプリケーションを作成して、Client IDとClient Secretを取得します。
3. Mimecastプラグインを設定します。
4. ビジネスルールを設定します。
5. アクションを設定します。
6. プラグインを検証してください。

動画を見る

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

新しいユーザーの作成とロールの割り当て

1. Mimecastにログインし、Users and Groups > Internal Directoriesに移動します。

   

2. 新しいユーザーを作成する内部ディレクトリを選択してください。

   

3. メニューバーのNew Addressをクリックしてください。

   

4. 新しいアドレスフォームに、新しい電子メールアドレス、基本管理者ロール、パスワード、および電話番号（2FAに必要）を入力し、Save and Exitをクリックします。

   設定したパスワードを忘れないようにしてください。これは、後で認証トークンを取得する際に使用します。

   

新しい API アプリケーションを作成する

1. 利用可能なAPIアプリケーションを表示するには、Integrations > API and Platform Integrationsに移動します。

   

2. Mimecast API 2.0 > Generate Keysをクリックしてください。

   

3. Create New Integrationをクリックしてください。

   

4. アプリケーション名を入力し、すべての製品を選択し、ロールをBasic Administratorに設定して、デスクリプションを入力します。

   

5. Notificationsの下に、以前に作成したユーザーの開発者名と電子メールを入力します。これにより、ユーザーのアプリケーションとプロファイル設定がAPIアプリケーションにリンクされます。

6. 設定パラメーターを確認し、必要に応じて編集してから、Saveをクリックします。

7. アプリケーション詳細ページに表示されているクライアントIDとクライアントシークレットをコピーします。これらを使用して、Cloud Exchange で Mimecast プラグインを設定します。

   

Mimecastプラグインの設定

1. Cloud Exchangeで、Settings > Plugin Storeに移動します。Mimecast v2.1.0 (CRE)プラグインを検索して選択します。ボックス

   

2. [構成名]を入力し、必要に応じて[同期間隔]を設定します。

   

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

   • API Base URL: MimecastプラットフォームのAPIベースURL。例えば https://api.services.mimecast.com。
   • Client ID: 以前に取得したMimecast APIクライアントID。
   • Client Secret: 以前に取得したMimecast APIクライアントシークレット。

   

4. Nextをクリックし、「Entity」ドロップダウンからエンティティを選択します。Schema Editorページからエンティティを作成するか、エンティティドロップダウンから+ Add New Entityを選択します。エンティティの下に新しいフィールドを作成するには、CREフィールドのドロップダウンで+ Add Fieldをクリックします。

   

   新しいフィールドを作成するには、CRE Fieldドロップダウンから「Add field」ボタンをクリックします。

   

   必要に応じて、フィールドラベル、データ型、正規化、集計戦略を指定します。

   

   
   フィールドマッピングを指定します。推奨されるマッピングについては、「マッピング」セクションを参照してください。

   ユーザーをプルし、プルされたユーザーに対してアクションを実行するには、ユーザーの電子メールフィールドが必要です。

   

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

   

Mimecast用のRisk Exchangeビジネスルールを設定する

1. Risk ExchangeでBusiness Ruleに移動し、 Create New Ruleをクリックします。

2. ルール名を入力し、Mimecastプラグイン用にフィールドが設定されているエンティティを選択し、要件に従ってクエリを設定します。

   

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

   

Mimecastのリスクエクスチェンジアクションを追加する

Mimecastは、次のアクションタイプをサポートしています：

• Add to Group: アクション設定で指定されたグループにユーザーを追加します。
• Remove from Group: アクション設定で指定されたグループからユーザーを削除します。
• No Action: Mimecastに対してアクションを実行しません。Ticket Orchestratorでアラートを生成するには、このアクションの「アラートを生成」トグルを有効にします。

グループに追加

1. Risk ExchangeでActionsに移動し、 Add Action Configurationをクリックします。

2. Select a ビジネスルールとMimecastプラグイン設定を選択し、アクションとしてAdd to GroupをSelectします。

3. Enter the action parameters:

   • User Email: アクションを実行するユーザーの電子メールアドレス。電子メールアドレスを含むソースフィールドをマッピングするか、静的な値を指定します。
   • Group: Select既存のグループを選択するか、Select Create 新しい Groupを選択してグループを作成し、ユーザーをそのグループに追加します。静的フィールドのドロップダウンから[Group]のみを選択します。
   • New Group Name: 作成するグループの名前。グループで「新しいグループを作成」が選択されている場合にのみ必要です。この値を静的フィールドに入力します。

   

4. アクションがホストで実行される前に承認が必要な場合は、Require Approvalを有効にします。

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

   このアクションは、Mimecast上でのサブグループの作成をサポートしていません。

グループから削除

1. Risk ExchangeでActionsに移動し、 Add Action Configurationをクリックします。

2. Select a ビジネスルールとMimecastプラグイン設定を選択し、アクションとしてRemove from GroupをSelectします。

3. Enter the action parameters:

   • User Email: アクションを実行するユーザーの電子メールアドレス。電子メールアドレスを含むソースフィールドをマッピングするか、静的な値を指定します。
   • Group: ユーザーを削除するグループ。「静的」フィールドのドロップダウンから「グループ」のみを選択します。

   

4. アクションがホストで実行される前に承認が必要な場合は、Require Approvalを有効にします。

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

No Action

このアクションは、Cloud ExchangeのTicket Orchestratorモジュールでアラートを生成します。

1. Risk ExchangeでActionsに移動し、 Add Action Configurationをクリックします。

2. Select a ビジネスルールとMimecastプラグイン設定を選択し、アクションとしてNo ActionをSelectします。

   

3. アクションがホストで実行される前に承認が必要な場合は、Require Approvalを有効にします。

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

Mimecastプラグインを検証する

Cloud Exchangeで検証する

1. Risk Exchange で「Records」に移動し、フィールドマッピングを設定したエンティティを選択して、取得したユーザーを表示します。

   

2. 「Logging」に移動し、プラグインログを検索します。

   

3. ログを確認し、アクションがユーザーに対して実行されたことを確認します。

   

   

4. Risk ExchangeのAction Logsに移動し、最近実行されたアクションのログを確認します。

   

Mimecastで検証する

このプラグインは、MimecastのEngage > Reporting and Insights > Training Reportsページからユーザーをプルします。プルを検証するには、そのページに移動します。

Mimecastで実行されたアクションを検証する

左パネルからUsers and Groups > Profile Groupsに移動して、グループのリストを表示します。Mimecastプラグインは、このページのグループに対するユーザーの追加と削除を行います。

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

Awareness Trainingパッケージの取得が、設定されたアカウントで有効になっていません。エラー

すでに構成されているプラグインを編集したり、新しいプラグインを構成したりするときにこのエラーが発生する可能性があります。これは、Mimecastが「Awareness Training」モジュールを削除し、「Engage」という新しいモジュールを導入したためです。詳細については、Mimecast Knowledge HubのMimecast移行ガイドおよびEngage Coreドキュメントを参照してください。

What to do:

プラグインを Mimecast v2.1.0 にアップグレードします。これは、Awareness Training ではなく、Engage Core パッケージに対して検証されます。

プラグインのアップグレード後、プラグインの設定が機能しなくなりました。

プラグインをアップグレードした後、構成されたプラグインに関連するログが表示されません。

What to do:

プラグインの設定を無効にしてから、再度有効にします。

Mimecastプラグインを設定できません

プラグインが設定されていません。クレデンシャルが正しくないか削除されているか、ユーザーロールが不十分である可能性があります。

What to do:

生成されたクレデンシャルを確認し、十分なロールが追加されていることを確認してください。

ユーザーまたはそのリスクスコアを取得できません

Cloud Exchangeでユーザーやスコアをプルできません。これは以下のいずれかの理由で発生する可能性があります。

• プラットフォームにはプルできるユーザーが存在しません。
• ユーザーのスコアはCloud Exchangeには反映されません。
• エンティティソースページでプラグインを設定するときにマッピングが追加されませんでした。

What to do:

1. プラグインからユーザーが取得されない場合は、Mimecastからプルするユーザーとスコアがあることを確認してください。
2. プラグインを構成する際に、マッピングが追加され、ユーザー電子メールフィールドがマッピングされていることを確認してください。

ユーザーに対してアクションを実行できません

アクションを実行できず、エラーが表示されました。これは、次のいずれかの理由で発生する可能性があります。

• アクションが実行されるユーザーは、すでにグループに追加されているか、グループから削除されています。
• アクションが実行されるユーザーがMimecastに存在しません。
• ユーザーが追加または削除されるグループは、プラットフォームに存在しません。

What to do:

1. ユーザーとグループがMimecastに存在することを確認してください。
2. 両方が存在する場合は、ユーザーがすでにグループに追加アクションのグループに存在するか、削除アクションのグループからすでに削除されているかを確認してください。ユーザーがすでに期待された状態にある場合、プラグインはエラーをスローします。

レコードのユーザー詳細を表示できません

レコードテーブルでユーザー詳細を表示できません。これは以下の理由のいずれかで発生する可能性があります。

• プラグインの設定時に、すべてのMimecastフィールドのマッピングが提供されませんでした。
• 抽出されたユーザーは、カンマ区切りの値で一行に表示されます。

What to do:

1. プラグインの設定時には、必要なマッピングを必ず指定してください。
2. エンティティに作成されたフィールドが［マッピング］セクションと一致していることを確認します。

エラーを受信：プロキシサーバーまたはMimecastサーバーに到達できません

プラグインの設定中、またはプラグイン設定後の任意の時点でこのエラーが表示されます。プラグインがMimecastプラットフォームに接続できないか、Cloud Exchangeがプロキシを使用している場合はプロキシサーバーに到達できません。

What to do: Mimecastに到達できない場合は、待機して再試行するか、Mimecastサポートチームにコンタクトしてください。プロキシサーバに到達できない場合は、ITチームにコンタクトして根本的な原因を調査してください。