Xiao Du Integration
Integrating your IoT solution with the Xiao Du voice assistant requires linking your IoT application user account with their Xiao Du account. Once linked, when a user speaks to a physical Xiao Du device, the platform can identify and control the IoT devices belonging to that specific user.
To facilitate this, your application must provide an OAuth 2.0 authorization page. Users will typically initiate this account-linking process directly from the Xiao Du mobile app.
Note
Please be aware that during our testing, we observed that when XiaoDu invokes the token endpoint, it transmits parameters redundantly in both the query parameters and the form body. This duplication prevents SiX IDaaS & IAM from correctly processing the request; therefore, our integration layer includes specific handling to normalize these requests.
Steps to Configure User Linkage
Create an IdP (Identity Provider): Set up a dedicated Identity Provider within your SiX IDaaS & IAM workspace to manage authentication.
Configure an OAuth 2.0 Client: Create a specific OAuth client dedicated to the Xiao Du integration and associate it with the IdP created in Step 1. Note that while your main IoT application and the Xiao Du integration share the same IdP, they should use distinct OAuth clients for security and tracking.
Map API Endpoints: Map the endpoints provided in the API documentation below to the corresponding configuration fields in the Xiao Du Developer Console.
Note
To complete the integration, please replace your Identity Provider's (IdP) standard token endpoint with the specialized endpoint listed below.
Configure the following token endpoint from the xiao-du-cloud-to-cloud-controller section within your XiaoDu Developer Console:
API Endpoints Documentation: Xiao Du Integration APIs