Chats
Calendar
Meetings
Contacts
Mail
Docs
Drive
AI Table
AI Minutes
Attendance
Approval
YiDA
Admin ConsoleStep 1: Create a Connector
1
Step 1
Sign in to the YiDA workbench as an admin.
2
Step 2
Click Platform management in the upper-right corner to open the platform management page. 
3
Step 3
In the left-side menu, click Connector Factory, click Create connector, and then select HTTP connector.
1
Configure the basic information for the connector by referring to the following details, and then click Next
2
Configure the Authentication type by referring to the following details
| Authentication type | Description |
|---|---|
| No authentication | No credentials are required to call the API. This is typically used for public APIs. |
| Basic authentication | Standard HTTP Authorization. The request header contains credentials that the server uses to verify the identity of the user agent. Add the Base64-encoded account and password to the header, for example, Authorization: Basic YWxhZGRpbjpvcGVuc2VzYW1l.Encoding format: account:password.You only need to configure the labels for the account and password fields, which tell users what to enter when registering credentials. • username label • password label |
| API key | The API key authentication method. The API key is valid long-term (store it securely). The requester generates a secret key in the target system, and developers can then use this credential to call public APIs that support this authentication method. • Parameter label: Displayed as a prompt when configuring credentials. • Parameter name: The apiKey name required by the system. • Parameter location: Choose whether to send the credential as a query parameter or in the header, based on what the target system requires. |
| Alibaba Cloud API Gateway | After you create the connector, add a credential template. Once the App Code is entered in the template, you can call the corresponding Alibaba Cloud API. For more information, see Call APIs by using AppCode authentication.  |
| DingTalk Open Platform authentication | After you create the connector, add a credential template. Once the App Key and App Secret are entered in the template, you can call DingTalk Open Platform APIs (including some YiDA APIs).After the credential template is added, YiDA automatically generates the access_token through authentication and adds it to the Header parameter x-acs-dingtalk-access-token for each request. You do not need to generate it again.For more information, see DingTalk app development process. |
| DingTalk Zero Trust Gateway | For details on how to use the DingTalk Zero Trust Gateway, see DingTalk Open Platform - Zero Trust Gateway authentication. |
Step 2: Create an Action
On the action page, click Create action, and then configure the settings based on the following information.
Step 3: Configure Authentication
Every custom connector must have a corresponding request authentication scheme, even for No authentication.- Create an account
- Enter the account display name, App Key, App Secret, and other information, and then click Confirm.
Step 4: Test the Connector
1
On the connector details page, click Test in the upper-right corner
2
Select the authentication to use, and configure the test parameters
3
Click Test. If the expected result appears, the configuration is successful
