ユーザーリスク交換用Mimecastプラグイン

このドキュメントでは、 Netskope Cloud Exchangeで User Risk Exchange を使用してMimecastプラグインを構成する方法について説明します。 このプラグインは、 Mimecastプラットフォームからのユーザー リスク スコアの取得をサポートしています。 このプラグインは、ユーザーに対して「グループに追加」「グループから削除」「何もしない」などの操作を実行する機能をサポートしています。

前提条件

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

CEバージョンの互換性

Netskope CE v4.2.0, v5.0.1

Mimecastプラグインのサポート

このプラグインは ユーザーのリスクスコアを取得し、ユーザーに対してアクションを実行します。

取得したデータの種類	ユーザー
サポートされているアクションの種類	グループに追加 グループから削除 No Action

マッピング

プルマッピング

Netskope CE Fields	Mimecast・フィールズ
score	risk
uid	emailAddress

スコアマッピング

リスクの高いユーザーに対するスコアマッピングは、他のユーザーとは異なります。Mimecastはグレードの形でスコアを提供しており、各グレードはCEで定義された数値スコアに対応付けられています。その数値スコアは以下のとおりです。

Netskope CE Score	Mimecastスコア
800	A
600	B
400	C
200	D
1	F

権限

• 管理コンソールへのアクセス
• ユーザーを作成する権限
• 作成したユーザーを基本管理者ロールに追加する権限
• 管理コンソールへのアクセス

APIの詳細

使うAPI一覧

APIエンドポイント	方法	使うケース
/api/account/get -アカウント	得る	クレデンシャルを検証するため。
/api/awarenessトレーニング/会社/安全スコアの詳細を取得	役職	OS SAFEスコアのユーザーレベルの詳細とユーザーリスクスコアを取得します。
/api/directory/findグループ	役職	Mimecastプラットフォームで利用可能なすべてのグループを取得します。
/api/directory/addグループメンバー	役職	ユーザーをMimecastの指定されたグループに追加する。
/api/directory/removeグループメンバー	役職	指定されたMimecastグループからユーザーを削除します。

クレデンシャルを検証する

API Endpoint: <Mimecast Base URL>/api/account/get-account
Method: GET
Request Headers

{
“authorization”: “A signature includes a user specific Access Key and a combination of unique
                        values signed with a user specific Secret Key using HMAC-SHA1 encryption.”
“x-mc-req-id”: “A randomly generated GUID, for example”
“x-mc-app-id”: “The Application ID provided with your Registered API Application.”
“x-mc-date”: “Current date and time in UTC”
}

Request Body:

{
 "data": []
}

API Request Endpoint: <Mimecast Base URL>/api/account/get-account
Sample API Response:

{
 "fail": [], 
 "meta": {
  "status": 200
 }, 
 "data": [
  {
   "maxRetention": 30, 
   "accountCode": "String", 
   "domain": "String", 
   "automatedSegmentPurge": false, 
   "databaseCode": "String", 
   "supportCode": "String", 
   "region": "String", 
   "accountName": "String", 
   "maxRetentionConfirmed": false, 
   "archive": false, 
   "gateway": true, 
   "policyInheritance": false, 
   "passphrase": "String", 
   "type": "String", 
   "mailPlatform": "String", 
   "packages": [
    "String"
   ], 
   "mimecastId": "String", 
   "adminEmail": "String", 
   "userCount": 20
  }
 ]
}

ユーザーとスコアを取得

API Endpoint: <Mimecast Base URL>/api/awareness-training/company/get-safe-score-details

Method: 役職

Request Headers

{
“authorization”: “A signature includes a user specific Access Key and a combination of unique
                        values signed with a user specific Secret Key using HMAC-SHA1 encryption.”
“x-mc-req-id”: “A randomly generated GUID, for example”
“x-mc-app-id”: “The Application ID provided with your Registered API Application.”
“x-mc-date”: “Current date and time in UTC”
}

Request Body:

{
 "data": [
  {
   "filterBy": [
    {
     "fieldName": "String", 
     "value": "String"
    }
   ], 
   "attributeIds": [
    "String"
   ], 
   "searchBy": {
    "fieldName": "String", 
    "value": "String"
   }
  }
 ]
}

Sample API Response:

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

利用可能なグループを取得する

API Endpoint: <Mimecast Base URL>/api/directory/find-groups
Method: POST
Request Headers:

{
“authorization”: “A signature includes a user specific Access Key and a combination of unique
                        values signed with a user specific Secret Key using HMAC-SHA1 encryption.”
“x-mc-req-id”: “A randomly generated GUID, for example”
“x-mc-app-id”: “The Application ID provided with your Registered API Application.”
“x-mc-date”: “Current date and time in UTC”
}

Request Body:

{
 "meta": {
  "pagination": {
   "pageToken": "String", 
   "pageSize": 25
  }
 }, 
 "data": [
  {
   "query": "String", 
   "source": "String"
  }
 ]
}

Sample API Response:

{
 "fail": [], 
 "meta": {
  "status": 200, 
  "pagination": {
   "pageSize": 1
  }
 }, 
 "data": [
  {
   "folders": [
    {
     "description": "String", 
     "source": "String", 
     "folderCount": 0, 
     "parentId": "String", 
     "id": "String", 
     "userCount": 10
    }
   ], 
   "source": "String", 
   "query": "String"
  }
 ]
}

ユーザーをグループに追加する

API Endpoint: {Mimecast Base URL}/api/directory/add-group-member
Method: ポスト
Request Headers:

{
“authorization”: “A signature includes a user specific Access Key and a combination of unique
                        values signed with a user specific Secret Key using HMAC-SHA1 encryption.”
“x-mc-req-id”: “A randomly generated GUID, for example”
“x-mc-app-id”: “The Application ID provided with your Registered API Application.”
“x-mc-date”: “Current date and time in UTC”
}

Request Body:

{
 "data": [
  {
   "domain": "String", 
   "emailAddress": "String", 
   "id": "String"
  }
 ]
}

Sample API Response:

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

グループからユーザーを削除する

API Endpoint: <Mimecast Base URL>/api/directory/remove-group-member
Method: POST
Request Headers:

{
“authorization”: “A signature includes a user specific Access Key and a combination of unique values signed with a user specific Secret Key using HMAC-SHA1 encryption.”
“x-mc-req-id”: “A randomly generated GUID, for example”
“x-mc-app-id”: “The Application ID provided with your Registered API Application.”
“x-mc-date”: “Current date and time in UTC”
}

Request Body:

{
 "data": [
  {
   "domain": "String", 
   "emailAddress": "String", 
   "id": "String"
  }]}

Sample API Response:

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

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

これらの測定は、前述の仕様を満たす大規模なCEスタック上で、50万人のユーザーとそのリスクスコアを取得することによって実施されます。

スタックの詳細	サイズ：大 RAM：32 GB CPU：16コア
Mimecastから取得したユーザー	500K
ユーザーのリスクスコアを取得して保存するのにかかる時間	約60分

ユーザーエージェント

netskope-ce-5.0.1-ure-mimecast-v1.0.3

ワークフロー

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

新しいユーザーの作成

1. MimecastにログインしてDirectories > Internal Directories .
   にアクセスしてください。
2. 新しいユーザーを作成する内部ディレクトリSelect 。
   
3. メニューバーのNew Addressをクリックしてください。
   
4. 新しい電子メール アドレス、ユーザーのパスワード、電話番号 (2FA に必須) を入力して、新しいアドレス フォームに記入します。 SaveをクリックしてからExitをクリックして、指定された情報で新しいユーザーを作成してください。

   注記

   パスワードのコピーを保管してください。 後で認証トークンを取得する際に必要になります。

   

新しく作成したユーザーを管理ロールに追加する

1. Account > Rolesに移動して役割ページを表示してください。
   
2. 基本管理者ロールを右クリックし、 Add users to the role .
   を選択します。
3. 参照または検索して、以前に作成した新しいユーザーを見つけます。
4. ユーザー名の左側にあるチェックボックスSelect 。
5. Add Selected Usersをクリックしてユーザーをロールに追加します。
   

新しいグループを作成し、ユーザーを追加します。

1. Directories > Profile Groupsに移動して、プロファイルグループページを表示してください。
2. グループを作成したい親フォルダーのプラスアイコンを選択して、新しいグループを作成します。これにより、新しいフォルダーという名前の新しいグループが作成されます。
3. グループの名前を変更するには、新しく作成された「新しいフォルダー」グループを選択します。 次に、[グループの編集] テキストボックスにフォルダーに付けたい名前を入力し、 Enterキーを押して変更を適用します。
4. 選択したグループで、[ビルド] ドロップダウン メニューをクリックし、 Add Email Addresses .
   を選択します。
5. 以前作成した新しいユーザーの名前を入力してください。
6. SaveをクリックしてExitして新しいユーザーをグループに追加してください。
   

新しい認証プロファイルを作成する

1. Services > Applicationsに移動すると、アプリケーション設定ページが表示されます。
2. Authentication Profilesをクリックしてください。
3. New Authentication Profile .
   をクリックしてください
4. 新しいプロファイルのデスクリプションを入力します。
5. 認証TTL設定を「期限切れなし」に設定してください。これにより、認証トークンを作成した際に、トークンが期限切れになってアプリのデータ収集に影響を与えることがなくなります。
6. その他の設定はすべてデフォルトのままにして、 SaveとExitをクリックしてプロファイルを作成します。

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

1. Services > Applicationsに移動すると、アプリケーション設定ページが表示されます。
2. New Application Settings .
   をクリックしてください
3. デスク リプションを入力し、[グループ検索] ボタンを使用して、前に作成したグループを選択します。
4. 認証プロファイル検索ボタンをクリックして、以前に作成した認証プロファイルを選択します。
5. その他の設定はすべてデフォルトのままにしてください。
6. SaveをクリックしてExitして、新しいグループとユーザーにアプリケーション設定を作成・適用してください。

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

1. 利用可能なAPIアプリケーションを表示するには、 Services > API and Platform Integrationsメニュー項目に移動してください。
   
2. Mimecast API 1.0 > Generate Keysをクリックしてください。
3. 適切な情報を入力してください。Enable Extended Sessionをチェックしてください。これにより、APIトークンの有効期限が切れることがなくなります。カテゴリとしてOther Select 、次にNextをクリックしてください。
   
4. 適切な開発者名を入力し、 以前に作成したアドレスを入力してください。これにより、ユーザーのアプリケーション/プロファイル設定がAPIアプリケーションにリンクされます。 Next .
   をクリックしてください
5. 入力した設定パラメータを確認し、必要に応じて編集してください。Addをクリックしてください。
6. APIアプリケーションが作成され、その詳細が表示されます。アプリケーションキーを表示するには、アプリケーションキーの横にある小さな目のアイコンをクリックしてください。アプリケーションIDとアプリケーションキーをコピーしてください。 これらはプラグインの設定時に必要になります。
   

アクセスキーとシークレットキーを入手してください。

1. 利用可能なAPIアプリケーションを表示するには、 Services > API and Platform Integrationsにアクセスしてください。
2. 新しく作成したAPIアプリケーションをクリックし、次に上部メニューからCreate Keysをクリックします。
3. 先ほど作成したユーザーの電子メールアドレスを入力し、 Nextをクリックします。
   
4. タイプにはCloud Select 、以前に作成したユーザーのパスワードを入力してください。 Next .
   をクリックしてください。
5. 小さな目のボタンを押して両方のキーをコピーし、 Closeをクリックします。これらはプラグインの設定に使う。
   

Mimecastプラグインのユーザーリスク交換ビジネスルールを設定する

アクションを実行したいユーザーをフィルタリングするためのビジネスルール。 ビジネスルールを設定するには、以下の手順に従ってください。

1. User Risk Exchange > Business Rulesに移動してCreate New Ruleをクリックしてください。
2. 要件に基づいてフィルターを追加し、 Saveをクリックしてください。

Mimecastプラグインのユーザーリスク交換アクションを設定する

Mimecastは、「グループに追加」、「グループから削除」、「何もしない」の3つの機能をサポートしています。いずれかの操作を追加および実行するには、以下の手順に従ってください。

グループに追加

アクションがトリガーされるたびに、このアクションは、アクション構成の作成時に定義されたグループにユーザーを追加します。

1. User Risk Exchange > Actionsに移動してAdd Action Configurationをクリックしてください。
2. ビジネスルール、構成（ Mimecastプラグイン） Select 、アクションとしてAdd to Groupを選択します。
3. 既存のグループにユーザーを追加するには、グループドロップダウンで既存のグループSelectか、 Create new groupを選択してグループ名を入力します（グループパラメーターで「新しいグループを作成」オプションを選択した場合）。
4. Saveをクリックしてください。

   注記

   Cloud Exchange から新しいグループを作成する場合、Mimecast 上でサブグループを作成することはできません。

グループから削除

アクションがトリガーされるたびに、このアクションは、アクション構成の作成時に定義されたグループからユーザーを削除します。

1. User Risk Exchange > Actionsに移動してAdd Action Configurationをクリックしてください。
2. ビジネスルール、構成（ Mimecastプラグイン） Select 、アクションとしてRemove from groupを選択します。
3. 既存のグループからユーザーを削除するには、グループのドロップダウンメニューからグループSelect 。
4. Saveをクリックしてください。

No Action

この操作はCloud Exchangeの Ticket Orchestrator モジュールでアラートを生成するためのものです。 この操作を設定および実行するには、以下の手順に従ってください。

1. User Risk Exchange > Actionsに移動してAdd Action Configurationをクリックしてください。
2. ビジネスルール、構成（ Mimecastプラグイン） Select 、アクションとしてNo Actionを選択します。
3. Save .
   をクリックしてくださいアクションの設定は「アクション」ページに表示されます。
   

Mimecastプラグインを検証する

CEでの検証

ユーザーとそのリスクスコアの取得を検証するには、 Logging にアクセスし、Mimecastプラグインのログをフィルタリングしてください。

[ユーザー] に移動し、 Mimecastプラットフォームから取得したユーザーとそのスコアを確認します。

アクションが正常に実行されたことを検証するには、 Loggingに移動し、ログを次のようにフィルタリングします。メッセージに Mimecast が含まれていること、およびメッセージにアクションが正常に実行されたことが含まれていること。

ユーザーリスクエクスチェンジのAction Logsにアクセスして、最近実行されたアクションのログを確認することもできます。

Mimecastで検証する

Mimecastのリスクセンターからユーザーとそのリスクスコアを取得することができます。それを検証するには、 Awareness Training > Reporting and Insights > Risk Centerにアクセスしてください。右下隅のView Detailsをクリックして、利用可能なユーザーとそのスコアを確認してください。

「ディレクトリ」＞「プロファイルグループ」に移動すると、グループの一覧が表示されます。このページでは、グループへのユーザーの追加と削除を行うことができます。

トラブルシューティング

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

プラグインが設定されていない場合は、クレデンシャルが間違っているか削除されているか、ユーザーの役割が不十分である可能性があります。
What to do:
生成されたクレデンシャルを確認し、十分なロールが追加されているかどうかを確認します。

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

CEでユーザーやスコアを取得できない場合は、以下のシナリオを確認してください。

• プラットフォーム上でユーザーがプルできます
• ユーザー評価はCEでは取得されません。

What to do:
プラグインからユーザーが取得できない場合は、Mimecastから取得できるユーザーとそのスコアが存在するかどうかを確認してください。

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

何らかの操作を実行できず、操作中にエラーが発生する場合は、根本原因を確認してください。以下のいずれかの問題である可能性があります。

• 操作対象のユーザーは、既にグループに追加／削除されています。
• 操作対象のユーザーはMimecast上に存在しません。
• ユーザーを追加/削除するグループをプラットフォーム上に存在しません。

What to do:

• 問題の根本原因を特定するには、まずMimecast上に該当のユーザーとグループが存在するかどうかを確認してください。
• 両方が存在する場合は、「グループに追加」アクションの場合、ユーザーが既にグループに存在するかどうかを確認します。 ユーザーが既にグループに存在している状態で、同じユーザーに対して「グループに追加」アクションが実行された場合、そのユーザーは既にグループに存在しているため、プラグインはエラーをスローします。グループからの除名についても同様です。

受信エラー: プロキシサーバーまたはMimecastサーバーに接続できません

プラグインの設定中、またはプラグインの設定後に上記のエラーが表示される場合。これは、プラグインがMimecastプラットフォームに接続できないか、CE がプロキシを使用している場合はプロキシ サーバーに到達できないことを意味します。
What to do: Mimecastに接続できない場合は、待つか、プロキシ サーバーに接続できない場合はMimecastサポート チームに問い合わせて、IT チームに連絡して根本原因を突き止めるしかありません。