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

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

前提条件

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

Netskopeテナント（または、例えば本番環境と開発／テスト環境など、複数のテナント）。
Netskope Cloud Exchangeテナントには、テナントプラグインとリスクエクスチェンジプラグインが既に設定済みです。
Mimecastプラットフォームへの接続。
Mimecast管理者アクセス権限（少なくとも「Awareness Training | Dashboard |」権限が必要です。
Mimecast管理者権限（少なくとも「ディレクトリ｜グループ｜編集」権限）が必要です。
Mimecast管理者は、少なくともアカウント | 権限を持つ管理者アクセス権を持っています。ダッシュボード | 読む許可。
次のホストへの接続: https://login.mimecast.com/u/login/?gta=administration#/login 。

CEバージョンの互換性

Netskope CE v4.2.0, v5.0.1

Mimecastプラグインのサポート

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

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

マッピング

プルマッピング

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

スコアマッピング

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

注記

定義されたスコアの最小値は、Mimecastのスコア評価に基づいてCEにマッピングされます。Mimecastの評価がAの場合、CEのスコアは800になります。

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

ワークフロー

新しいユーザーを作成し、そのユーザーを管理者ロールに追加します。
新しいグループを作成し、ユーザーをグループに追加します。
認証ロールを作成します。
アプリケーション設定を作成します。
APIアプリケーションを作成します。
アクセスキーとシークレットキーを入手してください。
Mimecastプラグインを設定します。
ビジネスルールを設定します。
アクションを設定します。
プラグインを検証してください。

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

新しいユーザーの作成

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

注記

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

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

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

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

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

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

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

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

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

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

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

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

注記

これらのキーは、新しいAPIアプリケーションを作成してから30分以内にのみ生成できます。

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

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

Settings > Pluginsへ移動してください。
プラグイン作成ページを開くには、 Mimecastプラグインボックスを検索して選択してください。
構成名を入力してください。
同期間隔を適切な値に調整してください。推奨時間は5分以上です。
Nextをクリックして、これらのパラメータを入力してください。
ベースURLを入力してください。これは以前取得したMimecastの基本URLです。詳細については、 https://www.mimecast.com/tech-connect/documentation/api-overview/global-base-urls/を参照してください。
Mimecastから提供されたアプリケーションIDとアプリケーションキーを入力してください。
Mimecastから提供されたアクセスキーとシークレットキーを入力してください。
Nextをクリックしてください。
総合得点の適切な範囲Select 。
Saveをクリックしてください。新しいMimecastプラグインが [プラグイン] ページに表示されます。

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

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

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

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

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

グループに追加

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

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

注記

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

グループから削除

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

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

No Action

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

User Risk Exchange > Actionsに移動してAdd Action Configurationをクリックしてください。
ビジネスルール、構成（ Mimecastプラグイン） Select 、アクションとしてNo Actionを選択します。
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 チームに連絡して根本原因を突き止めるしかありません。