マネージド コネクタを設定する

Office 365 Outlook、Microsoft Teams、Google Gmail、Yammer/Viva Engage、Box、Confluence、OneDrive、SharePointなどの外部サービスに対して認証済み接続を作成し、ツールごとの承認コントロールやパラメータロックを適用します。 エージェントは、構成したガバナンス設定で有効にした操作にのみアクセスできます。

Prerequisites

• Azure SRE エージェント ポータル のエージェント
• エージェントの SRE エージェント作成者 または 管理者 ロール ( ユーザー ロールを参照)
• 接続したいサービスのアカウント(例:Microsoft 365アカウント、Google Gmailアカウント、Viva Engageアクセス、Boxワークスペースメンバーシップなど)

マネージドコネクタがあなたの認証情報をどのように保護するか

コネクタを認証すると、SREエージェントはエージェントランタイムとは別の安全な接続リソースにトークンや鍵を保存します。 実行時には、エージェント自身のアイデンティティを使って認証し、その接続を通じてサービスを呼び出します。 エージェントはあなたの資格情報を見ることはありません。 エージェントの環境が侵害されても、トークンは露出しません。 自分のパスワードを変えずにエージェントのアクセスを取り消すことができます。

接続したサービスは、接続を承認したIDを依然として認識しています。 エージェントが行うメール送信やチャンネル更新などの行動は、あなたの名前で表示されます。

手順 1: マネージド コネクタ ウィザードを開く

1. Azure SRE エージェント ポータルでエージェントを開きます。
2. 左側のサイドバーで[ビルダー]を展開 します。
3. [コネクタ] を選択します。
4. [ コネクタの追加] を選択します。

コネクタピッカーが開き、タブごとに利用可能なコネクタが表示されます: テレメトリ、 通知、 MCP、 インシデント、 デプロイ、 その他。

プレビューコネクターカードには プレビュー バッジが表示されます。 検索ボックスを使用して、すべてのタブでコネクタを名前で検索します。

手順 2: マネージド コネクタを選択して認証する

接続するサービスのコネクタ カードを選択し、[ 次へ] を選択します。

認証手順が表示されます。 表示される内容は、コネクタによって異なります。

OAuth コネクタ (ほとんどのサービス)

Office 365 Outlook、Microsoft Teams、Google Gmail、Yammer/Viva Engage、Box、Confluence、OneDrive、SharePointなどのサービスについては:

1. [ サインイン ] (または [サービス] にサインイン) を選択します。
2. OAuth ポップアップが開きます。 そのサービスのアカウントでサインインします。
3. ポップアップが閉じると、接続カードに緑色のチェックマークと認証された名前が表示されます。

マルチオーソコネクター

一部のコネクタは、ラジオボタンとして複数の認証方法を提供しています:

1. 自分の好みの方法を選びましょう。
2. ウィザードが表示するサインイン、トークン、アプリ、または管理IDフィールドを記入してください。

ランタイム定義コネクタ

一部のコネクタはセットアップ時に管理APIから認証方法や操作を取得します。 固定された認証リストを前提にせず、ウィザードが示す選択肢に従ってください。

トークンおよびヘッダーベースのコネクタ

1. コネクタが表示するトークン、ヘッダー、または接続の値を入力します。
2. 接続を選択します。

認証が成功したら、[ 次へ ] を選択して続行します。

ステップ3:ツールの設置

ツールの設定ステップでは、ツール名、パラメータポリシー、権限の列とともに、コネクター用の利用可能なすべてのツールをテーブルで表示します。

1. エージェントに使わせたい各操作のチェックボックスを選択してください。
2. ツール名ヘッダーのチェックボックスを使って、現在フィルターされているすべての操作を選択したりクリアしたりしてください。
3. 検索ボックスを使って、ツールの名前や説明で絞り込みましょう。

選択された数(例えば 47個中12個)は、利用可能な工具の中からどれだけの道具を選んだかを示します。

同じテーブル内で選択した各操作ごとにガバナンスを設定します:

パラメーター値のロック (パラメーター ポリシー)

1. 選択したツールの パラメータポリシー スイッチをオンにします。
2. ツールが展開され、すべてのパラメーターが表示されます。
3. 任意のパラメーター フィールドに値を入力してロックします。 エージェントは毎回この正確な値を使用します。
4. エージェントがコンテキストに基づいて実行時に入力するフィールドは空のままにします。

パラメーター ロックのしくみの詳細については、「 マネージド コネクタ」を参照してください。

承認要件を設定する（権限）

選択した各ツールについて、 以下の間で許可を 切り替えます:

• 許可: エージェントは自由に実行されます (既定)。 読み取り操作に使用します。
• 質問: エージェントは、各実行の前に一時停止し、承認を要求します。 リソースを作成、変更、または削除する書き込み操作に使用します。

ツールを選択しガバナンスを設定した後、 次 を選択します。

手順 4: 確認して作成する

「レビュー&作成」ステップには要約が表示されます:

• MCPサーバー 名(自動生成)
• コネクターと運用
• 操作とパラメータカウント

1. 概要を確認します。
2. を選択してを作成します。

SREエージェントはすぐにコネクタを作成します。 コネクターリストに表示され、エージェントはすぐに有効化されたツールを使い始めることができます。

コネクタが動作することを確認する

コネクタを作成した後:

1. コネクタの一覧を確認します。 新しいコネクタに [接続済み ] 状態が表示されます。
2. エージェントとのチャットを開き、有効な操作のいずれかを使用するように依頼します。

例えば、送信操作を有効にした通知サービスを接続した場合:

「直近の事件の概要をオンコールチャンネルに送れ」

コネクタを編集または削除する

[編集]

既存のマネージド コネクタを選択して、ウィザードを再度開きます。 有効にする操作の変更、パラメーター値の更新、承認設定の変更を行うことができます。

削除

コネクタを削除するには、コネクタの一覧からコネクタを選択し、[削除] を選択 します。

REST API を使用してマネージド コネクタを設定する

REST API を使用して、マネージド コネクタをプログラムで作成および管理することもできます。

1. トークンを取得する

TOKEN=$(az account get-access-token --resource https://azuresre.dev --query accessToken -o tsv)
ENDPOINT="https://{agentEndpoint}"

2. 使用可能なコネクタを一覧表示する

curl -s -H "Authorization: ******" \
  "$ENDPOINT/api/v2/connectorV2/managedApis"

3. コネクタの操作を取得する

CONNECTOR_NAME="{connectorName}"
curl -s -H "Authorization: ******" \
  "$ENDPOINT/api/v2/connectorV2/connectors/$CONNECTOR_NAME/operations"

操作応答を操作名やパラメータの真実の情報源として使用します。 プレビューコネクターは返す内容を変えることができます。

4. 接続を作成する (OAuth コネクタにはポータルのサインインが必要)

curl -X PUT -H "Authorization: ******" \
  -H "Content-Type: application/json" \
  "$ENDPOINT/api/v2/connectorV2/connections/$CONNECTOR_NAME" \
  -d '{ "properties": {} }'

5. ガバナンスを使用して MCP サーバー構成を作成する

curl -X PUT -H "Authorization: ******" \
  -H "Content-Type: application/json" \
  "$ENDPOINT/api/v2/connectorV2/mcpservers/$CONNECTOR_NAME" \
  -d '{
    "properties": {
      "description": "Managed connector",
      "state": "Enabled",
      "connectors": [{
        "name": "{connectorName}",
        "connectionName": "{connectorName}",
        "displayName": "{Connector display name}",
        "operations": [
          {
            "name": "{ReadOperationName}",
            "displayName": "{Read operation display name}",
            "agentParameters": []
          },
          {
            "name": "{WriteOperationName}",
            "displayName": "{Write operation display name}",
            "requiresApproval": true,
            "userParameters": [
              { "name": "{DestinationParameter}", "value": "{Locked destination}" }
            ],
            "agentParameters": []
          }
        ]
      }]
    }
  }'

この例では、リード操作は承認なしで実行されます。 書き込み操作は承認(requiresApproval: true)を必要とし、宛先パラメータをロックします。

エンドポイントの完全な一覧については、 API リファレンスを参照してください。

Troubleshooting

関連するコンテンツ

• ソースコードサービスを接続する
• 通知サービスを接続する
• テレメトリーソースを接続します
• マネージド コネクタ
• MCP コネクタとツール