iboss

このドキュメントでは、iboss を Google SecOps と統合する方法について説明します。

ユースケース

1. 拡充アクションを実行する - iboss からデータを取得して、Google Security Operations アラートのデータを拡充します。
2. アクティブなアクションを実行する - Google SecOps から iboss の IP または URL をブロックします。

プロダクトの権限

認証を行うために、アクションは 2 つのリクエストを実行します。最初のリクエストはトークンを取得するためのもので、2 番目のリクエストは特別な XSRF トークンを取得するためのものです。

Google SecOps で iboss 統合を構成する

Google SecOps で統合を構成する方法について詳しくは、統合を構成するをご覧ください。

統合のパラメータ

次のパラメータを使用して統合を構成します。

注: iboss は API ルートを随時変更する場合があります。最新バージョンに更新されていることを確認してください。

パラメータの表示名	種類	デフォルト値	必須	説明
インスタンス名	文字列	なし	いいえ	統合を構成するインスタンスの名前。
説明	文字列	なし	いいえ	インスタンスの説明。
Cloud API ルート	文字列	https://cloud.iboss.com/	○	iboss Cloud APIs ルートを指定します。
Account API Root	文字列	https://accounts.iboss.com/	○	iboss アカウント API ルートを指定します。
ユーザー名	文字列	なし	○	iboss アカウントのユーザー名を指定します。
パスワード	パスワード	なし	○	iboss アカウントのパスワードを指定します。
SSL を確認する	チェックボックス	オフ	いいえ	有効になっている場合は、iboss パブリック クラウド サーバーへの接続用の SSL 証明書が有効であることを確認します。
リモートで実行	チェックボックス	オン	いいえ	構成した統合をリモートで実行するには、フィールドのチェックボックスをオンにします。オンにすると、リモート ユーザー（エージェント）を選択するオプションが表示されます。

注: 必要に応じて、後の段階で変更できます。構成が完了すると、インスタンスはハンドブックで使用できます。複数のインスタンスの構成とサポートの詳細については、複数のインスタンスのサポートをご覧ください。

アクション

Ping

説明

Google SecOps Content Hub ページの統合構成ページで提供されているパラメータを使用して、iboss への接続性をテストします。

実行

このアクションはエンティティに対しては実行されず、必須入力パラメータもありません。

アクションの結果

スクリプトの結果

スクリプトの結果名	値のオプション	例
is_success	True/False	is_success:False

ケースウォール

結果のタイプ	値 / 説明	種類
出力メッセージ *	アクションが失敗したり、ハンドブックの実行が停止したりすることはありません。 成功した場合: 「指定された接続パラメータを使用して iboss サーバーに正常に接続されました」と出力されます。 アクションが失敗し、ハンドブックの実行が停止します。 成功しなかった場合: 「iboss サーバーへの接続に失敗しました」と出力します。エラーは {0}」.format(exception.stacktrace)	全般

ポリシー ブロックリストに URL を追加する

説明

URL を iboss ブロックリストに追加します。

カテゴリ ID を確認する方法

1. [Web Security] -> [Policy Layers] に移動します。
2. デベロッパー ツールのコンソールを開きます（Google Chrome では Ctrl+Shift+I）。
3. [Network] タブに移動します。
4. 必要なブロックリストを編集してみます。

コンソールに、行われているリクエストが表示されます。これらのリクエストの中から、customCategoryId=xxxx パラメータを検索します。

パラメータ

パラメータの表示名	種類	デフォルト値	必須	説明
カテゴリ ID	Integer	1001	○	URL を追加するポリシー カテゴリを指定します。
優先度	Integer	50	○	ブロックする必要がある URL の優先度を指定します。
方向	DDL	宛先 値は次のいずれかです。 宛先 ソース 宛先とソース	○	URL の方向を指定します。
開始ポート	Integer	なし	いいえ	ブロックする必要がある URL に関連する開始ポートを指定します。注: 「開始ポート」または「終了ポート」のみが指定されている場合、値は両方のアクション パラメータに追加されます。
移行を終了	Integer	なし	いいえ	ブロックする必要がある URL に関連する終了ポートを指定します。注: 「開始ポート」または「終了ポート」のみが指定されている場合、その値は両方のアクション パラメータに追加されます。
注	文字列	なし	いいえ	ブロックする必要がある URL に関連するメモを追加します。
正規表現	チェックボックス	オフ	いいえ	有効にすると、URL は正規表現と見なされます。
ストリップ スキーム	チェックボックス	オフ	いいえ	有効にすると、URL に関連するスキームが削除されます。

実行

このアクションは次のエンティティに対して実行されます。

• URL
• ホスト名

アクションの結果

スクリプトの結果

スクリプトの結果名	値のオプション	例
is_success	True/False	is_success:False

ケースウォール

結果のタイプ	値 / 説明	種類
出力メッセージ *	アクションが失敗したり、ハンドブックの実行を停止したりすることはありません。 成功し、指定された URL の少なくとも 1 つがブロックされた場合（is_success = true）: 「ID {0} の iboss カテゴリで次の URL を正常にブロックしました: \n {1}」と出力します。format(category_id, entity.identifier list) 特定の URL のブロックに失敗した場合（is_success = true）: 「アクションが ID {0}\n: {1}".format(category_id, [entity.identifier]) の iboss カテゴリで以下の URL をブロックできませんでした」を印刷します。 すべてのエンティティで拡充に失敗した場合（is_success = false）: print: 「ID {0} の iboss カテゴリでブロックされた URL はありません。」.format(category_id) ポリシーがブロックリストでない場合（is_success = false）: print "Category with ID {category_id} is not associated with a Block list." アクションが失敗し、ハンドブックの実行が停止します。 認証情報が誤っている、サーバーへの接続がないなど、致命的なエラーの場合、その他: 「アクション「ポリシー ブロックリストに URL を追加」の実行エラー。理由: {0}」.format(error.Stacktrace)	全般

ポリシー ブロックリストに IP を追加する

説明

IP を iboss ブロックリストに追加します。

カテゴリ ID を確認する方法

1. [Web Security] -> [Policy Layers] に移動します。
2. デベロッパー ツールのコンソールを開きます（Google Chrome では Ctrl+Shift+I）。
3. [Network] タブに移動します。
4. 必要なブロックリストを編集してみます。

コンソールに、行われているリクエストが表示されます。これらのリクエストの中から、customCategoryId=xxxx パラメータを検索します。

パラメータ

パラメータの表示名	種類	デフォルト値	必須	説明
カテゴリ ID	Integer	1001	○	URL を追加するポリシー カテゴリを指定します。
優先度	Integer	50	○	ブロックする必要がある URL の優先度を指定します。
方向	DDL	宛先 値は次のいずれかです。 宛先 ソース 宛先とソース	○	URL の方向を指定します。
開始ポート	Integer	なし	いいえ	ブロックする必要がある URL に関連する開始ポートを指定します。注: 「開始ポート」または「終了ポート」のみが指定されている場合、値は両方のアクション パラメータに追加されます。
移行を終了	Integer	なし	いいえ	ブロックする必要がある URL に関連する終了ポートを指定します。注: 「開始ポート」または「終了ポート」のみが指定されている場合、その値は両方のアクション パラメータに追加されます。
注	文字列	なし	いいえ	ブロックする必要がある URL に関連するメモを追加します。
正規表現	チェックボックス	False	いいえ	有効にすると、URL は正規表現とみなされます。

実行

このアクションは IP アドレス エンティティに対して実行されます。

アクションの結果

スクリプトの結果

スクリプトの結果名	値のオプション	例
is_success	True/False	is_success:False

ケースウォール

結果のタイプ	値 / 説明	種類
出力メッセージ *	アクションが失敗したり、ハンドブックの実行を停止したりすることはありません。 成功し、指定された URL の少なくとも 1 つがブロックされた場合（is_success = true）: 「ID {0} の iboss カテゴリで次の URL を正常にブロックしました: \n {1}」と出力します。format(category_id, entity.identifier list) 特定の URL のブロックに失敗した場合（is_success = true）: 「アクションが ID {0}\n: {1}".format(category_id, [entity.identifier]) の iboss カテゴリで以下の URL をブロックできませんでした」を印刷します。 すべてのエンティティで拡充に失敗した場合（is_success = false）: print: 「ID {0} の iboss カテゴリでブロックされた URL はありません。」.format(category_id) ポリシーがブロックリストでない場合（is_success = false）: print "Category with ID {category_id} is not associated with a Block list." アクションが失敗し、ハンドブックの実行が停止します。 認証情報が誤っている、サーバーへの接続がないなど、致命的なエラーの場合、その他: 「アクション「ポリシー ブロックリストに URL を追加」の実行エラー。理由: {0}」.format(error.Stacktrace)	全般

ポリシー ブロックリストに IP を追加する

説明

IP を iboss ブロックリストに追加します。

カテゴリ ID を確認する方法

1. [Web Security] -> [Policy Layers] に移動します。
2. デベロッパー ツールのコンソールを開きます（Google Chrome では Ctrl+Shift+I）。
3. [Network] タブに移動します。
4. 必要なブロックリストを編集してみます。

コンソールに、行われているリクエストが表示されます。これらのリクエストの中から、customCategoryId=xxxx パラメータを検索します。

パラメータ

パラメータの表示名	種類	デフォルト値	必須	説明
カテゴリ ID	Integer	1001	○	IP を追加するポリシー カテゴリを指定します。
優先度	Integer	50	○	ブロックする必要がある IP の優先度を指定します。
方向	DDL	宛先 値は次のいずれかです。 宛先 ソース 宛先とソース	○	IP の方向を指定します。
開始ポート	Integer	なし	いいえ	ブロックする必要がある IP に関連する開始ポートを指定します。注: 「開始ポート」または「終了ポート」のみが指定されている場合、値は両方のアクション パラメータに追加されます。
移行を終了	Integer	なし	いいえ	ブロックする必要がある IP に関連する終了ポートを指定します。注: 「開始ポート」または「終了ポート」のみが指定されている場合、値は両方のアクション パラメータに追加されます。
注	文字列	なし	いいえ	ブロックする必要がある IP に関連するメモを追加します。
正規表現	チェックボックス	オフ	いいえ	有効にすると、IP は正規表現とみなされます。

実行

このアクションは IP アドレス エンティティに対して実行されます。

アクションの結果

スクリプトの結果

スクリプトの結果名	値のオプション	例
is_success	True/False	is_success:False

ケースウォール

結果のタイプ	値 / 説明	種類
出力メッセージ *	アクションが失敗したり、ハンドブックの実行を停止したりすることはありません。 成功し、指定された IP の少なくとも 1 つがブロックされた場合（is_success = true）: 「ID {0} の iboss カテゴリで次の IP を正常にブロックしました: \n {1}」と出力します。format(category_id, entity.identifier list) 特定の IP のブロックに失敗した場合（is_success = true）: 「アクションは、ID {0}\n: {1} の iboss カテゴリで次の IP をブロックできませんでした」.format(category_id, [entity.identifier]) を出力します。 すべてのエンティティで拡充に失敗した場合（is_success = false）: print: 「ID {0} の iboss カテゴリでブロックされた IP はありません。」.format(category_id) ポリシーがブロックリストでない場合（is_success = false）: print "Category with ID {category_id} is not associated with a Block list." アクションが失敗し、ハンドブックの実行が停止します。 認証情報が誤っている、サーバーへの接続がないなど、致命的なエラーの場合、その他: 「アクション「ポリシー ブロックリストに IP を追加」の実行エラー」を出力します。理由: {0}」.format(error.Stacktrace)	全般

ポリシー ブロックリストのエントリを一覧表示する

説明

特定のグループの iboss ブロックリスト エントリを返します。

カテゴリ ID を確認する方法

1. [Web Security] -> [Policy Layers] に移動します。
2. デベロッパー ツールのコンソールを開きます（Google Chrome では Ctrl+Shift+I）。
3. [Network] タブに移動します。
4. 必要なブロックリストを編集してみます。

コンソールに、行われているリクエストが表示されます。これらのリクエストの中から、customCategoryId=xxxx パラメータを検索します。

パラメータ

パラメータの表示名	種類	デフォルト値	必須	説明
カテゴリ ID	Integer	1001	○	拒否リストのエントリを一覧表示するポリシー カテゴリを指定します。
返されるエントリの最大数	Integer	50	○	返されるエントリの数を指定します。

実行

このアクションはエンティティに対しては実行されません。

アクションの結果

スクリプトの結果

スクリプトの結果名	値のオプション	例
is_success	True/False	is_success:False

JSON の結果

{
    "entries": [
       {
          "direction": 0,
          "endPort": 0,
          "isRegex": 0,
          "note": "",
          "priority": 0,
          "startPort": 0,
          "type": 0,
          "url": "asaa.com",
          "weight": 501
       }
    ],
    "message": ""
}

ケースウォール

結果のタイプ	値 / 説明	種類
出力メッセージ *	アクションが失敗したり、ハンドブックの実行を停止したりすることはありません。 成功し、データが返された場合（is_success = true）: 「ID '{0}' のカテゴリの iboss ブロックリストからエントリが正常に一覧表示されました」.format(category_id) 返されたがデータがない場合（is_success = false）: 「ID {0} の iboss カテゴリにブロックリスト エントリが見つかりませんでした」という出力を表示します。format(category_id) ポリシーがブロックリストでない場合:（is_success = false） 「Category with ID {category_id} is not associated with a Block list.」という出力を表示します。 アクションが失敗し、ハンドブックの実行が停止します。 認証情報が誤っている、サーバーへの接続がないなど、致命的なエラーの場合、その他: 「アクション「ポリシー ブロックリスト エントリの一覧表示」の実行エラー」を出力します。理由: {0}」.format(error.Stacktrace)	全般
CSV ケースウォール	名前: 「Block List Entries. カテゴリ {0}」.format(Category) 列: 名前（URL としてマッピング） 優先度（priority としてマッピング） 重量（weight としてマッピング） 目的地（direction としてマッピング。アクションの動作を確認する） 開始ポート（startPort としてマッピング） 終了ポート（endPort としてマッピング） メモ（note としてマッピング） 正規表現（isRegex としてマッピング）。1 = True、0 = False）

ポリシー ブロックリストから URL を削除する

説明

iboss ブロックリストから URL を削除します。

カテゴリ ID を確認する方法

1. [Web Security] -> [Policy Layers] に移動します。
2. デベロッパー ツールのコンソールを開きます（Google Chrome では Ctrl+Shift+I）。
3. [Network] タブに移動します。
4. 必要なブロックリストを編集してみます。

コンソールに、行われているリクエストが表示されます。これらのリクエストの中から、customCategoryId=xxxx パラメータを検索します。

パラメータ

パラメータの表示名	種類	デフォルト値	必須	説明
カテゴリ ID	Integer	1001	○	URL を削除するポリシー カテゴリを指定します。
開始ポート	Integer	なし	いいえ	削除する必要がある URL に関連する開始ポートを指定します。目的の URL に開始ポートが定義されている場合、このパラメータは必須です。これは iboss の制限です。
移行を終了	Integer	なし	いいえ	削除する必要がある URL に関連する終了ポートを指定します。目的の URL に終了ポートが定義されている場合、このパラメータは必須です。これは iboss の制限です。
ストリップ スキーム	チェックボックス	オフ	いいえ	有効にすると、URL に関連するスキームが削除されます。

実行

このアクションは次のエンティティに対して実行されます。

• URL
• ホスト名

アクションの結果

スクリプトの結果

スクリプトの結果名	値のオプション	例
is_success	True/False	is_success:False

ケースウォール

結果のタイプ	値 / 説明	種類
出力メッセージ *	アクションが失敗したり、ハンドブックの実行を停止したりすることはありません。 成功し、指定された URL の少なくとも 1 つが削除された場合（is_success = true）: 「ID {0} の iboss カテゴリから次の URL を正常に削除しました: \n {1}」と出力します。format(category_id, entity.identifier list) 特定の URL の削除に失敗した場合（is_success = true）: print "Action was not able to remove the following URLs from the category with ID {0}\n: {1}".format(category_id, [entity.identifier]) すべてのエンティティで拡充に失敗した場合（is_success = false）: 印刷: 「ID {0} の iboss カテゴリから URL が削除されませんでした」.format(category_id) ポリシーがブロックリストでない場合（is_success = false）: 「Category with ID {category_id} is not associated with a Block list.」という出力を表示します。 アクションが失敗し、ハンドブックの実行が停止します。 認証情報の誤り、サーバーへの接続がないなど、致命的なエラーの場合: 「ポリシー ブロックリストから URL を削除する」アクションの実行中にエラーが発生しました。理由: {0}」.format(error.Stacktrace)	全般

ポリシー ブロックリストから IP を削除する

説明

iboss のブロックリストから IP を削除します。

カテゴリ ID を確認する方法

1. [Web Security] -> [Policy Layers] に移動します。
2. デベロッパー ツールのコンソールを開きます（Google Chrome では Ctrl+Shift+I）。
3. [Network] タブに移動します。
4. 必要なブロックリストを編集してみます。

コンソールに、行われているリクエストが表示されます。これらのリクエストの中から、customCategoryId=xxxx パラメータを検索します。

パラメータ

パラメータの表示名	種類	デフォルト値	必須	説明
カテゴリ ID	Integer	1001	○	IP を削除するポリシー カテゴリを指定します。
開始ポート	Integer	なし	いいえ	削除する必要がある IP に関連する開始ポートを指定します。目的の URL に開始ポートが定義されている場合、このパラメータは必須です。これは iboss の制限です。
移行を終了	Integer	なし	いいえ	削除する必要がある IP に関連する終了ポートを指定します。目的の IP に終了ポートが定義されている場合、このパラメータは必須です。これは iboss の制限です。

実行

このアクションは IP アドレス エンティティに対して実行されます。

アクションの結果

スクリプトの結果

スクリプトの結果名	値のオプション	例
is_success	True/False	is_success:False

ケースウォール

結果のタイプ	値 / 説明	種類
出力メッセージ *	アクションが失敗したり、ハンドブックの実行を停止したりすることはありません。 成功し、指定された URL の少なくとも 1 つが削除された場合（is_success = true）: print "Successfully removed the following IPs from the iboss category with ID {0}: \n {1}".format(category_id, entity.identifier list) 特定の URL の削除に失敗した場合（is_success = true）: print "Action was not able to remove the following IPs from the iboss category with ID {0}\n: {1}".format(category_id, [entity.identifier]) すべてのエンティティで拡充に失敗した場合（is_success = false）: print: 「ID {0} の iboss カテゴリから IP が削除されませんでした。」.format(category_id) ポリシーがブロックリストでない場合:（is_success = false） 「Category with ID {category_id} is not associated with a Block list.」という出力を表示します。 アクションが失敗し、ハンドブックの実行が停止します。 認証情報が誤っている、サーバーへの接続がないなど、致命的なエラーの場合、その他: 「ポリシー ブロックリストから IP を削除する」アクションの実行中にエラーが発生しました。理由: {0}」.format(error.Stacktrace)	全般

URL の検索

説明

URL ルックアップを実行します。

パラメータ

パラメータの表示名	種類	デフォルト値	必須	説明
グループ ID	Integer	なし	いいえ	URL ルックアップを実行するグループを指定します。何も指定しない場合、「Default」グループが使用されます。

実行

このアクションは次のエンティティに対して実行されます。

• URL
• ホスト名

アクションの結果

エンティティ拡充

拡充フィールド名	ソース（JSON キー）	ロジック - 適用するタイミング
IBOSS_group_{group_id}_categories	categories	JSON で利用可能な場合
IBOSS_group_{group_id}_action	アクション	JSON で利用可能な場合
IBOSS_group_{group_id}_message	メッセージ	JSON で利用可能な場合

スクリプトの結果

スクリプトの結果名	値のオプション	例
is_success	True/False	is_success:False

JSON の結果

{
    "action": "Not Blocked",
    "categories": "Pornography/Nudity",
    "message": "Url Known."
}

ケースウォール

結果のタイプ	値 / 説明	種類
出力メッセージ *	アクションが失敗したり、ハンドブックの実行を停止したりすることはありません。 成功し、指定された URL の少なくとも 1 つが検索された場合（is_success = true）: print "Successfully retrieved information about the following URLs: \n {0}".format( entity.identifier list) 特定の URL の検索に失敗した場合（is_success = true）: 「Action was not able to retrieve information about the following URLs\n: {0}」を出力します。format([entity.identifier]) すべてのエンティティのルックアップに失敗した場合（is_success = false）: 「URL に関する情報は取得されませんでした」と出力します。 アクションが失敗し、ハンドブックの実行が停止します。 認証情報が誤っている、サーバーへの接続がないなど、致命的なエラーの場合、その他: 「エラー実行アクション 「URL 検索」を印刷します。理由: {0}」.format(error.Stacktrace)	全般

URL の再分類

説明

再分類のために URL を送信します。

実行

このアクションは URL エンティティに対して実行されます。

アクションの結果

スクリプトの結果

スクリプトの結果名	値のオプション	例
is_success	True/False	is_success:False

ケースウォール

結果のタイプ	値 / 説明	種類
出力メッセージ *	アクションが失敗したり、ハンドブックの実行を停止したりすることはありません。 成功し、指定された URL の少なくとも 1 つが送信された場合（is_success = true）: 「再分類のために次の URL を正常に送信しました: \n {0}」.format( entity.identifier list) を印刷します。 特定の URL の削除に失敗した場合（is_success = true）: 「アクションが再分類のために以下の URL を送信できませんでした\n: {0}」を出力します。format([entity.identifier]) すべてのエンティティで拡充に失敗した場合（is_success = false）: print: "No URLs were submitted for recategorization." アクションが失敗し、ハンドブックの実行が停止します。 認証情報が誤っている、サーバーへの接続がないなど、致命的なエラーの場合、その他: 「アクション「URL の再分類」の実行エラー」を出力します。理由: {0}」.format(error.Stacktrace)	全般

さらにサポートが必要な場合 コミュニティ メンバーや Google SecOps のプロフェッショナルから回答を得ることができます。