PolarDB:Enterprise Service Platform

準備 1: RAM ユーザーの AccessKey ペアの取得

PolarDB Agent Enterprise Service Platform は、AccessKey ペアを使用して Alibaba Cloud API を呼び出し、リソースを管理します。最小権限の原則に従い、専用の RAM ユーザーと AccessKey ペアを使用してください。

1. カスタムポリシーを作成します。

   1. RAM コンソールにログインします。左側メニューで、[権限] > [ポリシー] を選択します。

   2. [ポリシーの作成] をクリックし、[JSON] タブに切り替えます。

   3. 次の JSON ポリシーをポリシーエディターに貼り付け、[OK] をクリックします。

      クリックして完全な JSON ポリシーを表示

      {
        "Version": "1",
        "Statement": [
          {
            "Effect": "Allow",
            "Action": [
              "polardb:DescribeDBClusters",
              "polardb:DescribeAIDBClusters",
              "polardb:DescribeDBClusterAttribute",
              "polardb:DescribeDBClusterEndpoints",
              "polardb:DescribeRegions",
              "polardb:DescribeHistoryEvents",
              "polardb:DescribePolarAgents",
              "polardb:DescribeApplications",
              "polardb:CreateApplication",
              "polardb:DeleteApplication",
              "polardb:DescribeApplicationAttribute",
              "polardb:OperateApplication",
              "polardb:UpgradeApplicationVersion",
              "polardb:DescribeApplicationParameters",
              "polardb:ModifyApplicationParameter",
              "polardb:ModifyApplicationDescription",
              "polardb:ModifyApplicationWhitelist",
              "polardb:CreateApplicationEndpointAddress",
              "polardb:DeleteApplicationEndpointAddress",
              "polardb:DescribePolarClawSkills",
              "polardb:ModifyPolarClawSkill",
              "polardb:DescribeApplicationPerformance",
              "polardb:DescribeApplicationBackupPolicy",
              "polardb:ModifyApplicationBackupPolicy",
              "polardb:DescribeApplicationBackups",
              "polardb:CreateApplicationBackup",
              "polardb:DeleteApplicationBackup",
              "polardb:RestoreApplicationByBackupSet",
              "polardb:DescribeApplicationPrompts",
              "polardb:CreateApplicationPrompt",
              "polardb:ModifyApplicationPrompt",
              "polardb:DeleteApplicationPrompt",
              "polardb:ApplyApplicationPrompts",
              "polardb:ModifyApplicationPromptStatus",
              "polardb:DescribeApplicationLogs",
              "polardb:DescribeApplicationSessionIds",
              "polardb:DescribeApplicationSessionLogs",
              "polardb:DescribePolarClawSkillsMarket",
              "polardb:DescribePolarClawSkillTemplates",
              "polardb:DescribePolarClawSkillTemplate",
              "polardb:DescribePolarClawSkillAssessment",
              "polardb:CreatePolarClawSkillTemplate",
              "polardb:DeletePolarClawSkillTemplate",
              "polardb:CreatePolarClawSkill",
              "polardb:GetPolarClawSkillRegion",
              "polardb:CheckPolarClawSkill",
              "polardb:DeletePolarClawSkill",
              "polardb:CreateBatchTask",
              "polardb:DescribeBatchTasks",
              "polardb:DescribeBatchTask",
              "polardb:DescribeGatewayList",
              "polardb:DescribeAIGatewayInstances",
              "polardb:DescribeAIGatewayAttribute",
              "polardb:ListAIGatewayModelApis",
              "polardb:GetAIGatewayModelApiCreationOptions",
              "polardb:CreateAIGatewayModelApi",
              "polardb:ModifyAIGatewayModelApi",
              "polardb:DeleteAIGatewayModelApi",
              "polardb:ListAIGatewayModelServices",
              "polardb:CreateAIGatewayModelService",
              "polardb:ListAIGatewayConsumerGroups",
              "polardb:CreateAIGatewayConsumerGroup",
              "polardb:DeleteAIGatewayConsumerGroup",
              "polardb:ModifyAIGatewayConsumerGroup",
              "polardb:ListAIGatewayConsumers",
              "polardb:DescribeAIGatewayConsumer",
              "polardb:CreateAIGatewayConsumer",
              "polardb:ResetAIGatewayConsumerApiKey",
              "polardb:DeleteAIGatewayConsumer",
              "polardb:ListAIGatewayRateLimitPolicies",
              "polardb:CreateAIGatewayRateLimitPolicy",
              "polardb:DeleteAIGatewayRateLimitPolicy",
              "polardb:ModifyAIGatewayRateLimitPolicy",
              "polardb:ListAIGatewayBudgetPolicies",
              "polardb:CreateAIGatewayBudgetPolicy",
              "polardb:DeleteAIGatewayBudgetPolicy",
              "polardb:ModifyAIGatewayBudgetPolicy",
              "polardb:DescribeGatewayAttribute",
              "polardb:DescribeBudgetStats",
              "polardb:DescribeCostRules",
              "polardb:CreateCostRule",
              "polardb:ModifyCostRule",
              "polardb:DeleteCostRule",
              "polardb:StartAIGateway",
              "polardb:StopAIGateway",
              "polardb:RestartAIGateway",
              "polardb:ReleaseAIGateway",
              "polardb:CreateAIGatewayPublicEndpoint",
              "polardb:DescribeAIGatewaySecurityGroups",
              "polardb:DescribeAIGatewayIPArrayList",
              "polardb:ModifyAIGatewaySecurityIPs",
              "polardb:DescribeAIGatewayPerformance",
              "polardb:ListAIGatewayEvents",
              "polardb:ListTagResourcesForRegion",
              "polardb:TagResources",
              "polardb:UntagResources",
              "polardb:DescribeModelServices",
              "polardb:DescribeModelApis",
              "polardb:DescribeConsumerGroups",
              "polardb:DescribeRateLimitPolicy"
            ],
            "Resource": "*"
          },
          {
            "Effect": "Allow",
            "Action": [
              "ecs:DescribeSecurityGroups"
            ],
            "Resource": "*"
          },
          {
            "Effect": "Allow",
            "Action": [
              "tag:ListTagKeys",
              "tag:ListTagValues"
            ],
            "Resource": "*"
          },
          {
            "Effect": "Allow",
            "Action": [
              "oss:PutBucketPolicy",
              "oss:GetBucketPolicy",
              "oss:PutObject"
            ],
            "Resource": "*"
          },
          {
            "Effect": "Allow",
            "Action": [
              "bss:Refund*"
            ],
            "Resource": "*"
          },
          {
            "Effect": "Allow",
            "Action": [
              "bss:Renew*"
            ],
            "Resource": "*"
          },
          {
            "Effect": "Allow",
            "Action": [
              "bss:ModifyInstance"
            ],
            "Resource": "*"
          }
        ]
      }

   4. ポリシーに名前 (例：PolarDB Agent ExpressSaaSMinimalAccess) を入力し、作成を完了します。

2. RAM ユーザーを作成し、権限を付与します。

   1. 左側メニューで、[ID] > [ユーザー] を選択し、RAM ユーザーを選択または作成します。

      1. 既存のユーザーを選択する：ユーザー詳細ページに移動し、[AccessKey] タブで既存の AccessKey ペアを使用するか、新しいペアを作成します。新しい AccessKey ペアを作成するには、[ローカル開発用] を選択し、生成された AccessKey ID と AccessKey Secret を安全に保存します。

      2. 新しいユーザーを作成する：[ユーザーの作成] ページで、[基本情報] を入力し、[永続的な AccessKey を使用してアクセス] を選択します。ユーザーが作成された後、RAM ユーザーの AccessKey ID と AccessKey Secret を保存します。

   2. ユーザー詳細ページで、[権限] タブに切り替え、[権限の付与] をクリックします。前の手順で作成した PolarDB Agent ExpressSaaSMinimalAccess ポリシーをユーザーにアタッチします。

準備 2: エンタープライズアプリケーションの認証情報 (App ID と App Secret) の取得

PolarDB Agent Enterprise Service Platform は、カスタムエンタープライズアプリケーション (Lark、DingTalk、WeCom など) を使用してユーザーを認証します。

ステップ 1: PolarDB Agent エンタープライズサービスプラットフォームの作成

1. PolarDB コンソールにログインします。左側メニューで、PolarDB AI > PolarDB Agent Express をクリックします。上部メニューで、目的の リージョンに切り替えます。

2. PolarDB Agent Express ページで、法人向けサービスプラットフォーム タブに切り替え、今すぐ作成 をクリックします。

3. 作成ページで、以下のコアパラメータを設定します。

   • Alibaba Cloud アカウントの AK/SK：「前提条件」で取得した AccessKey ID と AccessKey Secret を入力します。

   • VPC ネットワーク と ゾーンおよび vSwitch：PolarDB Agent Enterprise Service Platform をデプロイする VPC と vSwitch を選択します。

   • セキュリティグループ：セキュリティグループを選択し、そのインバウンドルールがポート 8080 へのアクセスを許可していることを確認します。

   • SaaS サービスのログイン方法：アプリケーションタイプ で [Lark]、[DingTalk]、または [WeCom] を選択し、「前提条件」で取得した対応するエンタープライズアプリケーションの認証情報を入力します。

4. [OK] をクリックして作成を開始します。

ステップ 2: ネットワークアクセスの設定

PolarDB Agent Enterprise Service Platform の作成後、デフォルトでは VPC 経由でのみアクセス可能です。PolarDB Agent Enterprise Service Platform が Lark、DingTalk、または WeCom の認証サービスとインターネット経由で通信し、インターネット経由でアクセスできるようにするには、次のようにネットワークを設定します。

1. インターネット NAT ゲートウェイの作成：インターネット NAT ゲートウェイ購入ページに移動します。作成時に、PolarDB Agent Enterprise Service Platform と同じ VPC と vSwitch を選択していることを確認してください。

2. SNAT エントリの設定：インターネット NAT ゲートウェイページに移動します。目的のゲートウェイの 操作 列の SNAT の構成 をクリックし、SNAT エントリの作成 をクリックします。パラメータを次のように設定します。

   • SNAT エントリの粒度：[VPC] を選択します。

   • Elastic IP Address の選択：ドロップダウンリストから、インターネットアクセスを提供する EIP を選択します。

   説明

   インターネットアクセスを有効にすると、インターネット NAT ゲートウェイとインターネットトラフィックに追加料金が発生します。料金の詳細については、「NAT ゲートウェイの課金」をご参照ください。

3. (任意) パブリックエンドポイントの申請
   インターネット経由で管理アプリケーションにアクセスしたい場合は、PolarDB コンソール の PolarDB Agent Enterprise Service Platform 詳細ページに戻り、パブリックエンドポイントの有効化 をクリックしてパブリックエンドポイントを申請します。
   
   

ステップ 3: エンタープライズアプリケーションのリダイレクト URL の設定

ステップ 4: Enterprise Service Platform へのアクセスと使用

1. アクセス用の IP ホワイトリストの設定
   PolarDB Agent Enterprise Service Platform のホワイトリスト設定で、アプリケーションへのアクセスを許可するクライアントの IP アドレスを追加します。
   
   

   • インターネット経由でアクセスする場合は、ローカルネットワークのパブリックアウトバウンド IP アドレスを追加します。

   • 内部ネットワーク経由でアクセスする場合は、VPC 内のクライアントの IP アドレスを追加します。

2. アプリケーションへのアクセス
   PolarDB Agent Enterprise Service Platform の詳細ページで、プライベートエンドポイントまたは申請したパブリックエンドポイントを見つけ、ブラウザでアクセスします。
   
   

3. サインインして PolarDB Agent Express テンプレートを作成
   最初にサインインしたユーザーには、自動的に管理者権限が付与されます。[アカウント管理] ページで、PolarDB Agent Express アプリケーション (Crayfish モジュール) の設定テンプレートを作成できます。たとえば、モデルソースを Bailian に設定し、対応する ModelFrom と ModelApiKey を入力します。
   
   

4. チームメンバーによる PolarDB Agent Express アプリケーションの作成
   テンプレートが設定された後、他のチームメンバーは Enterprise Service Platform にサインインし、[PolarDB Agent Express 管理] ページに移動して、テンプレートを選択することで、ワンクリックで独自の PolarDB Agent Express アプリケーションを作成できます。