カスタムSaaSアプリのオンボーディング

カスタムSaaSアプリとは、 Netskope SSPMで標準サポートされていない、公開されているか社内で構築されたかを問わず、あらゆるSaaSアプリを指します。 Bring Your Own App (BYOA) を使用すると、SSPM の監視機能をカスタム SaaS アプリケーションに拡張できます。これにより、監視対象となる構成属性を定義したり、カスタムルールを作成したり、カスタムアプリの継続的な監視とレポートを作成したりすることが可能になります。

メリット

• Extended coverageSSPMの監視機能をカスタムSaaSアプリケーションにも拡張できます。

• Centralized monitoringSSPMでサポートされているSaaSアプリとカスタムアプリを1つの画面で表示します。

• Integrated reporting: 統合されたレポート機能とアラート機能を利用することで、様々なメリットが得られます。

SSPMにカスタムアプリを追加する

SSPMにカスタムアプリを追加するには、まずSSPMにアプリを登録する必要があります。登録が完了したら、SSPM UIでカスタムアプリのインスタンスを作成し、そのインスタンスの構成データをSSPMに送信します。継続的な監視のためのカスタムルールを作成し、これらのルールをポリシーに紐付けます。ポリシーが適用されたら、SSPM はカスタム アプリ インスタンスの結果の生成を開始します。

考慮事項

カスタムアプリをSSPMに統合する手順の中には、APIを利用したものもあります。API ドキュメントを参照するには、SSPM テナント > Settings > Tools > REST API v2 > API DOCUMENTATIONリンクに移動してください。「spm」を探して SPM エンドポイントを見つけ、API エンドポイントに「customapps」を含むエンドポイントを特定します。

Procedure

Netskope SSPMにカスタムアプリを追加するには、以下の詳細な手順に従ってください。

• Step 1 : Register Your Custom Application – このステップでは、カスタムアプリのメタデータをSSPMに登録します。使う API、 app name とオプションで app logoを提供することで新しいカスタムアプリを作成します。 アプリのロゴを提供しない場合は、デフォルトの Netskope アイコンが使うになります。

  app nameは以下の条件を満たす必要があります。

  • “EXT” prefix

  • アルファベットと数字だけを使う

  • スペースは許可されていません

  • 最大25文字

  For example: EXTCustomApp

  Logo 必須ではありませんが、存在する場合は次のようになります。

  • ロゴのサイズは120×120ピクセル未満である必要があります。

  • svg format

  API Endpoint: /api/v2/spm/customapps

• Step 2 : Onboard an Instance of your Custom App ステップ1でアプリを登録すると、オンボーディングのためにSSPM UIにカスタムアプリが表示されます。

  • アプリは、SSPM テナント > Configure App Access > Next Gen > Security Posture > Custom Apps リストに表示されます。

    

     

  • 登録済みのカスタムアプリのセキュリティ態勢インスタンスをセットアップするには、以下を提供します。 Instance Name and Administrator Email.

    

    これにより、カスタムアプリのインスタンスが作成されます。

• Step 3: Define App Specific Configurations – SSPMは、ユーザー、ロール、グループ、およびサードパーティ製アプリ向けに、事前定義された属性のリストをサポートしています。

  Users:

  Resource Type: Users

  Supported Attributes:

  • email_id [必須]
  • name
  • user_type : 値は内部値または外部値になります
  • user_status : values can be enabled or disabled
  • administrator : values can be yes or no
  • last_login_time
  • group_ids
  • role_ids
  • created_time
  • modified_time
  • additional_metadata

  Roles:

  Resource Type役割

  Supported Attributes:

  • id
  • name
  • description
  • permissions
  • created_time
  • modified_time

  Groups:

  Resource Typeグループ

  Supported Attributes:

  • id
  • name
  • description
  • role_ids
  • created_time
  • modified_time

  3rd Party Apps:

  Resource Type: アプリケーション

  Supported Attributes:

  • application_id
  • name [必須]
  • description
  • risk_score リスクスコアを指定しない場合、デフォルトで0が設定され、これは低リスクと解釈されます。
  • created_time
  • modified_time

  これらに加えて、カスタム構成属性を定義することもできます。Account Settings はリソースタイプです。これらの設定を定義するには、以下を提供する必要があります。

  • Name: 属性名

  • Data type: この属性が受け入れるデータ型。サポートされているデータ型は、文字列、数値、ブール値、および文字列リストです。

  • Description: 属性を説明する

  以下に、設定属性の例をいくつか示します。

  • is_mfa_enabled（ブール値）

  • tags (list of string)

  • external_user_permission (文字列)

  • public_link_sharing (文字列)

  API Endpoint: /api/v2/spm/contentdef/customapps/{app_name}/accountsettings

  現在、最大30個の構成属性を監視できます。

• Step 4 : Push Data for Your Custom App Instance – API を使用すると、ユーザー、ロール、グループ、サードパーティ アプリの属性、カスタム構成のデータのプッシュを開始できます。

  API Endpoint:

  • /api/v2/spm/ingestor/customapps/ {appname}/instances/{instancename}/users 

  • /api/v2/spm/ingestor/customapps/ {appname}/instances/{instancename}/groups

  • /api/v2/spm/ingestor/customapps/ {appname}/instances/{instancename}/roles 

  • /api/v2/spm/ingestor/customapps/ {appname}/instances/{instancename}/thirdpartyapps

  • /api/v2/spm/ingestor/customapps/ {appname}/instances/{instancename}/accountsettings

• Step 5 : Create Custom Rules and Policies – 今、 Netskope Governance Language (NGL) を使うカスタム ルールを作成し、これらのルールをポリシーに追加して、インスタンスの監視を有効にすることができます。
  

  カスタムルールの例：

  EXTCustomApp AccountSetting should-have external_sharing = “disabled”

カスタムアプリのSSPMへの統合が完了すると、SSPMのその他のすべての機能を利用できるようになります。これには、監視対象のすべてのSaaSアプリ、ポスチャスコア、 Advanced Analyticsレポート、アラート、監視などに関する単一のビューが含まれます。

参考文献

• NGLを使うカスタムルールの作成

• ポリシーを作成する