セキュリティ ストアで Microsoft Security Copilot エージェントまたは Microsoft Sentinel Data Lake ノートブック ジョブを公開する

セキュリティ Copilot エージェントまたは分析ソリューションを正常に発行するには、デプロイ ファイルを構造化された準拠形式でパッケージ化することが不可欠です。

エージェント マニフェスト、Microsoft Sentinel Data Lake ノートブック、および必要なMicrosoft Azure リソースを含む有効な .zip パッケージを作成する手順については、この記事を参照してください。 また、Mac ユーザーが、公開プロセスを誤って中断する可能性のある非表示のシステム ファイルを回避するための手順も提供します。

推奨されるフォルダー構造とメタデータの要件に従うことで、ソリューションはサービスとしてのソフトウェア (SaaS) オファーの種類を使用してセキュリティ ストアに登録する準備が整います。

パッケージを作成する

エージェントまたは分析ソリューションを構築したら、エージェント マニフェスト YAML と、Microsoft Sentinel Data Lake ノートブックやMicrosoft Azure リソースなどの他の依存関係を .zip 構造に配置します。

各パッケージには、1 つのエージェント マニフェストが含まれている必要があります。 必要なすべてのサブフォルダーを、親フォルダー内ではなく、.zip ファイルのルートに直接配置します。

サンプルの .zip 構造のスクリーンショット。

Note

Mac ユーザーの場合: この場合、既定の macOS アーカイブ/zip ツールを使用することはできません。これは、追加の予期しないファイルとフォルダーが追加されるためです。 新しい ZIP アーカイブを作成するときは、zip コマンドを使用して、.DS_Store や__MACOSXなどの隠しファイルなしでファイルを圧縮/zip できます。

  1. ターミナル アプリを開きます。
  2. zip するファイルが含まれているフォルダーに移動します。
  3. 次のコマンドを入力するか、ターミナルに貼り付けます: zip -r data.zip . -x ".*" -x "__MACOSX"
  4. Enter キーを押して実行します。
ファイルパス 説明 その他のドキュメント
PackageManifest.yaml [必須] ルート フォルダー内のマニフェスト ファイルは、.zip のフォルダー構造と、各フォルダーに配置ファイルの種類を記述します。 zip 内のサブフォルダーと、それぞれの種類 (たとえば、Copilot エージェント) を一覧表示します。 次のスキーマに従います。

manifest:
- id: "copilot_agent1"
description: "My Awesome Copilot Agent"
type: CopilotAgent
schema:
version: "1.0.0"

サポートされている種類: Copilot エージェント: CopilotAgent;Microsoft Sentinel Lake リソース (ノートブックなど): SentinelLake;Microsoft Azure リソース: AzureArmDeployment (注: Azure デプロイの UI 構成は現在サポートされていません)

-
[CopilotAgentName]/AgentManifest.yaml [必須] エージェントの定義。には、エージェント スコープの詳細な説明が含まれています。 パッケージごとに 1 つのエージェント マニフェスト ファイルのみが存在する必要があります。 複数のエージェントと、最上位のエージェントで必要なサブスキル (プラグインや GPT など) を含めることができます。 GPT、KQL、OpenAPI の仕様ファイルは、同じフォルダーに含まれており、エージェント マニフェスト ファイルによって参照されます。 このファイルには、.yaml 形式または .json 形式を指定できます。 -
[CopilotAgentName]/openapispec_<あなたの番号>.yaml [省略可能] オプションの copilot API プラグイン仕様。 このファイルには、.yaml 形式または .json 形式を指定できます。 Microsoft Security Copilotの API プラグイン
[CopilotAgentName]/template_<あなたの番号>.txt [省略可能] オプションの copilot GPT または KQL プラグイン の仕様 Microsoft Security Copilotの GPT プラグインと、Microsoft Security Copilot の Kusto クエリ言語 (KQL) プラグイン
[SentinelLakeFolderName]/ Microsoft Sentinel Data Lakeデプロイ ファイルをここに配置します。 Microsoft Sentinel Data Lake VS Code 拡張機能を使用している場合は、.zip全体が作成されます。 -
[AzureResourcesFolderName]/mainTemplate.json [省略可] このAzure リソース テンプレートでは、エージェントが機能するために必要なAzure リソース (ロジック アプリなど) について説明します。 Azure リソースのデプロイを計画している場合は、ARM テンプレートについて説明します

パートナー センターでオファーを発行する

新しいオファーのボタンを示すMicrosoft Partner Centerホーム ページのスクリーンショット。

オファーを作成して、Security Store にアプリケーションの一覧表示を開始します。

次に、オファーの種類を選択するときに、[ サービスとしてのソフトウェア] を選択します。 エージェントを一覧表示する場合でも、SaaS は Security Store のすべてのセキュリティ アプリケーションに使用されるオファーの種類です。 SaaS オファーの種類には、エージェントの収益化とデプロイオーケストレーションを有効にするのに役立つ拡張可能なフレームワークがあります。

メッセージが表示されたら、わかりやすいわかりやすいエイリアスを選択して、オファー名とオファーの動作を記憶します。

[はい、Microsoftを通じて販売し、代わりにMicrosoftホスト トランザクションを行います]、[いいえ、自分で顧客ライセンスを管理する]、[マイ オファーは Microsoft Security サービスと統合されます] という入力のスクリーンショット。

  • Microsoftで販売しますか? [はい] 選択します。 Security Store では、このオプションのみがサポートされます。 ソリューションに対して課金しない場合は、$0 USD の価格を設定できます。
  • ライセンス管理サービスMicrosoft使用しますか? [いいえ] を選択します。 この質問は、Microsoft Graph/Microsoft 365 と統合されたビジネス アプリケーションに固有です。
  • 潜在顧客: ソリューションの無料試用版から取得したリードを保存するために CRM を接続することを選択できます。 詳細については、Microsoft コマーシャル マーケットプレース - Marketplace パブリッシャーからのリード管理に関するページを参照してください。
  • Microsoft統合: オファーが Microsoft Security サービスと統合されたことを示すチェック ボックスをオンにします。 他のチェック ボックスにはチェックを入れないでください。

Tip

下書きを保存すると、左側のメニューに Microsoft Security Services が表示されます。

メタデータ プロパティのスクリーンショット。

メタデータのプロパティを入力する

  • カテゴリ: プライマリ カテゴリから [セキュリティ ] または [コンプライアンス ] を選択します。
  • 業界: このオプションは空白のままにします。 業界 は AppSource にのみ関連します。

一般的な条件を定める 標準契約 を使用するか、独自の条件を提供するか選択できます。

オファーの一覧

オファー登録情報の詳細を入力します。 検索結果の概要で、エージェントの機能を 1 行にまとめます (Copilotを使用して集計できます)。 説明には、次のものが含まれます。

  • エージェント タスク: タスクはコンマ区切りにする必要があります。
  • エージェント ワークフロー: 次の 2 つのセクションを作成します。
    • 入力: このセクションをコンマ区切りにします。
    • 出力: このセクションをコンマ区切りにします。

特にエージェント ワークフローで発生したエラーについては、オファーの一覧を参照してください。

[検索結果の概要] と [説明] が正しく入力されたオファーの一覧の詳細のスクリーンショット。

Security Store メタデータを追加し、.zip ファイルを提供する

[オファーのセットアップ] に移動し、ソリューションがMicrosoft Security サービスと統合されていることを示すチェック ボックスをオンにします。

[Save draft (ドラフトを保存)] を選択します。 左側のメニューに、Microsoft Security サービスと呼ばれる新しいメニュー項目が表示されます。

Microsoft Securityサービスを選択します。 セキュリティ ストアに固有のメタデータの入力を求める新しいページが表示されます。

メタデータ 入力
統合セキュリティ サービス (必須) Microsoft Securityとの主な統合 (Microsoft Sentinel、Microsoft Security Copilot、Microsoft Entraなど) を選択します。 エージェントの場合、Microsoft Security Copilotは常にチェックする必要があります。
Microsoft Security製品の前提条件 (省略可能) ソリューションに必要なその他の前提条件を選択します。 たとえば、主要な統合が Security Copilot エージェントであっても、そのエージェントが機能を実行するための前提条件として Microsoft Sentinel を必要とする場合は、それを記載してください。
認定 (省略可能) 使用しているコンプライアンス認定 (SOC2 Type 2、ISO 27001、PCI DSS、FedRamp など) を選択し、ドキュメントへのリンクを追加して詳細情報を提供します。 この情報は、ソリューションで信頼を築くために、Security Store の顧客に提供されます。
ソリューションの種類 (必須) 展開可能なソリューション: 顧客のMicrosoft セキュリティ サービス環境 (Security Copilot など) にデプロイするエージェントを選択します。 ISV でホストされるソリューション: ホストしている既存の SaaS ソリューションを一覧表示または更新するかどうかを選択します。

[配置可能なソリューション] を選択すると、[ライセンス管理] の下にさらにフィールドが表示されます。

デプロイ可能なソリューションでは、ライセンス管理が必須です。

ライセンス メタデータ 入力オプション Mandatory
ライセンス管理 Security Store を通じてエージェントの料金を請求する場合は、はい、Microsoft に顧客ライセンスの管理を任せますを選択してください。 サブスクリプション ライセンス料金は、ここで請求できます。 Microsoftは、ライセンスの課金とプロビジョニングを管理します。
[いいえ] を選択します。Security Store を通じて販売するエージェントを提供したくない場合は、 SaaS を通じて顧客ライセンスを自分で管理 します。 エージェントが連携する SaaS ソリューションを使用して顧客ライセンスを自分で管理することも、無料で提供することもできます。 はい
Security Copilot エージェント エージェントを発行するときに、このチェック ボックスをオンにします。 このチェック ボックスをオンにすると、セキュリティ ストアと Security Copilot の [エージェント] カテゴリでオファーを検出できます。 はい
ソリューション パッケージ 前のセクションで作成した .zip パッケージをアップロードします。 現時点では、オファーごとにアップロードできるパッケージは 1 つだけです。 はい

プランと価格を作成する

Microsoft Partner Centerの左側のメニューで [プランの概要] を選択します。 プランは、パッケージと価格の詳細を指定するオファリングの一部です。

プランに 名前説明を付け、[ 市場の編集] を選択します。 [ 市場の編集] リンクを使用すると、このエージェントを提供する世界の場所を指定できます。

次に、エージェントの料金モデルと価格を設定するよう求められます。 オファーが発行されると価格モデルを変更することはできません。オファー内のすべてのプランで同じ価格モデルが使用されるため、ここで少し時間を取ります。 2 つの選択肢があります。

  • 定額: 使用量に関係なく、SaaS ソリューションの固定料金を顧客に請求できます。 定額モデルは、価格が消費によって変わらない単純なオファリングに最適です。

  • ユーザーごと: SaaS ソリューションにアクセスできるライセンスユーザーごとに固定料金を請求します。 各ユーザーにはライセンスがあり、合計コストはライセンスあたりの価格とユーザー数を乗算して計算されます。 パートナーは、各プランの最小ユーザー制限と最大ユーザー制限を定義できます。 このソリューションは、各ユーザーに個別の値を提供します。 ユーザー数に基づいて予測可能な課金にユーザーごとに使用するか、チームまたは組織間でアクセスをスケーリングする必要がある場合に使用します。

プランが特定のエージェントを無料で提供する場合でも、価格が必要です。 これが無料プランの場合、価格は $0 USD である必要があります。

Contract(サブスクリプション型契約)による有料エージェントの料金設定

ソリューションのデプロイ時Microsoftエージェント ライセンスの管理を許可することを選択した場合、Security Store のエージェントでサポートされる価格モデルはコントラクト (サブスクリプション別) のみです。

契約によってライセンス料金が作成され、月単位または年単位で課金できます。 Microsoftは、ライセンスの課金とプロビジョニングを管理します。

エージェントの契約/サブスクリプション経由で課金するには、次の構成オプションを選択します。

  • 価格モデル: [定額] を選択します。
  • 契約期間: 1 か月 または 1 ~ 5 年から選択します。 契約期間によって、顧客がエージェントにアクセスできる期間が決まります。 月単位のサブスクリプションの場合は、 1 か月を選択します。
  • 請求頻度: 契約全体または毎月の請求に対する 1 回限りの支払いから選択します。 たとえば、毎月請求される 1 年間の契約を提供できます。つまり、顧客は毎月 12 か月間請求されます。

その他のオプション

注意する必要がある最終的なメタデータをいくつか次に示します。

  • マーケットプレース メータリング サービスのディメンション: この場合は、このセクションをスキップしてください。 測定は、エージェントを収益化するためのオプションとしてまだ提供されていません。 オプションは将来変更される可能性があります。
  • 無料試用版: 1 か月間の無料試用版を提供するには、このボックスをオンにします。 無料試用版は、試用版の終了時に自動的に有料サブスクリプションに変換されます。 試用期間が終了する前に顧客がサブスクリプションをキャンセルした場合、この自動移行は行われません。 Microsoft Marketplace オファーのプランと価格を参照してください。
  • 可視性を計画する: セキュリティ ストアでソリューションを検出できるようにするには、 パブリック に設定します。 また、[ プライベート ] に設定して、テナント ID を指定して顧客を選択するソリューションを配布することもできます。

このセクションを完了したら、オファリングの下書きを保存します。

技術的な構成

オファーがエージェントの場合は、説明に従ってこのセクションに入力します。 適切な技術的構成により、Security Store はエージェントを正常にデプロイし、そのライフサイクルを管理できます。

プログラムによる通知が必要な場合は、接続 Webhook を独自の Webhook に置き換えます。たとえば、顧客がエージェントを購入したときに通知が必要な場合などです。 Webhook を開発する方法の詳細については、「 SaaS サービスでの Webhook の実装 - Marketplace パブリッシャー」を参照してください。

技術的な構成:

  1. ランディング ページの URL: https://securitystore.microsoft.com/mysolutions
  2. 接続Webhook: Webhook URLをコピーして貼り付けてください。
  3. Microsoft Entraテナント ID: Microsoft Entraテナント ID をここにコピーして貼り付けます。
  4. Microsoft Entraアプリケーション ID: Microsoft Entraアプリケーション ID をここにコピーして貼り付けます。 別の SaaS オファー用に作成した Microsoft Entra アプリケーション ID が既にある場合は、ここで再利用できます。 それ以外の場合は、4 つの手順でMicrosoft Entraアプリケーション ID に登録します

プレビューとテスト

公開する前に、リストをプレビューし、プレビュー対象ユーザー機能を使用してエンド ツー エンドでテストすることをお勧めします。 オファーをプレビューしてテストできる対象ユーザーを設定するには、Secure Store のオファー掲載情報をプレビューしてテストする方法を参照してください。

オファーを NIST CSF 2.0 の結果にマップする

エージェントまたは分析ソリューションを発行したら、 https://aka.ms/SecureExchangeNISTSelfAttestation で調査を完了して送信し、エージェントまたはソリューションをセキュリティ ストアの NIST CSF 2.0 ビューに表示します。 これにより、お客様は、エージェントまたはソリューションがサポートするサイバーセキュリティの成果をすばやく把握できます。

Important

ソリューションのバージョンを更新する必要がありますか? バージョンを更新するには、新しいパッケージをアップロードし、更新されたバージョン番号を指定します。

バージョン番号は、セマンティック バージョン管理に従う必要があります。これは、X がメジャー バージョンである X.Y.Z の形式で、Y がマイナー バージョン、Z がパッチ バージョンです。 Microsoft Security Copilotエージェントは常に最新バージョンに自動的に更新されます。 Microsoft Sentinel Data Lake Notebook ジョブでは、最新バージョンを使用するために明示的に再デプロイする必要があります。