platform-service.md
1 --- 2 title: Platform Service 3 sidebar_position: 265 4 --- 5 6 # Platform Service 7 8 The Platform Service is a backend microservice responsible for management operations in Solace Agent Mesh. It operates independently from other components, allowing it to scale separately. 9 10 ## What Does It Provide? 11 12 The Platform Service provides the backend infrastructure for: 13 14 - **Agent Builder** *(Enterprise)* - Create, read, update, and delete AI agents 15 - **Connector Management** *(Enterprise)* - Manage database connectors that enable agents to query SQL databases 16 - **Deployment Orchestration** *(Enterprise)* - Deploy agents to runtime environments 17 - **Deployer Monitoring** *(Enterprise)* - Track health and availability of deployer services 18 19 ## Running the Platform Service 20 21 A sample Platform Service configuration is automatically generated when you run: 22 23 ```bash 24 sam init --gui 25 ``` 26 27 When prompted to enable the WebUI Gateway, select **Yes**. This will generate `configs/services/platform.yaml` with all necessary configuration. 28 29 Start the Platform Service using the SAM CLI: 30 31 ```bash 32 sam run configs/services/platform.yaml 33 ``` 34 35 The service runs on **port 8001** by default. 36 37 :::note 38 A Platform Service instance is only required when running the WebUI Gateway in combination with Agent Mesh Enterprise. 39 ::: 40 41 ## Authentication and Authorization 42 43 The Platform Service shares the same authentication and authorization infrastructure as the WebUI Gateway. Both services use the same OAuth2 middleware to validate bearer tokens and the same RBAC configuration to enforce permissions. 44 45 To ensure both services use the same authorization configuration, set the `SAM_AUTHORIZATION_CONFIG` environment variable. This variable applies globally to all services in the process and is the recommended way to configure RBAC. If you configure authorization only in the WebUI Gateway's YAML file without setting this environment variable, the Platform Service will not inherit that configuration and will default to denying all access. 46 47 For details on how this shared model works and how to troubleshoot it, see [Authentication and Authorization](../enterprise/platform-service-auth.md). 48