Integrations
Set up Microsoft Entra Service Principal credentials in Duaer
Store Microsoft Entra Service Principal connection details in Duaer for digital-organization nodes to use at runtime. Secrets are protected by the instance encryption key and are not written into node parameters.
Set up app-only access
The Duaer Microsoft Entra Service Principal credential signs in as no user, so the Excel, OneDrive, Outlook, SharePoint, Teams, and To Do nodes can run unattended:
- Create an app registration in the Microsoft Entra admin center; it needs no Redirect URI.
- Under API permissions, add Microsoft Graph application permissions (not delegated), such as Files.ReadWrite.All or Mail.Send, and have an admin grant consent.
- Put the Directory (Tenant) ID and Application (Client) ID from the overview in the credential, plus a client secret, or the uploaded certificate with its private key.
The credential dialog notes the connection test only checks that the app can sign in; a missing or unconsented permission shows up when a node runs. App-only access has no current user, so name the user, site, or team explicitly in the node.
Microsoft Entra Service Principal fields in Duaer
In Duaer, choose Microsoft Entra Service Principal when you create a credential, then fill in these fields:
- Authentication: Default: Client Secret. Options: Client Secret, Certificate.
- Directory (Tenant) ID (required): The Directory (tenant) ID from your app registration overview in the Microsoft Entra admin center.
- Application (Client) ID (required): The Application (client) ID from your app registration overview.
- Client Secret (required, secret): A client secret created under Certificates & secrets. Shown when Authentication is Client Secret.
- Private Key (required, secret): The PEM-encoded RSA private key matching the certificate uploaded to the app registration. Line breaks may be flattened. Shown when Authentication is Certificate.
- Certificate (required): The PEM-encoded public certificate uploaded under Certificates & secrets on the app registration. Shown when Authentication is Certificate.
- Microsoft Graph API Base URL: Select the endpoint for your Microsoft cloud environment. Default: Global (https://graph.microsoft.com). Options: Global (https://graph.microsoft.com), US Government (https://graph.microsoft.us), US Government DOD (https://dod-graph.microsoft.us), China (https://microsoftgraph.chinacloudapi.cn).
Note from the dialog: App-only access uses application permissions that an admin must consent to on the app registration. The connection test only checks that the app can sign in. A missing or unconsented permission shows up as an error when a node runs, not here.
When you save, Duaer tests the connection with these values.
Duaer nodes that use it: Microsoft Excel (OneDrive), Microsoft Excel (SharePoint), Microsoft OneDrive, Microsoft OneDrive Trigger, Microsoft Outlook, Microsoft Outlook Trigger, Microsoft SharePoint, Microsoft SharePoint Trigger, Microsoft Teams, Microsoft Teams Trigger, Microsoft To Do.
Save the connection in Duaer
Open Credentials and create Microsoft Entra Service Principal. Fill in the key, OAuth, or server fields. After you save, digital-organization nodes reference this credential instead of putting the secret in a parameter.
Credential values are protected by the instance encryption key. If you change or lose that key, stored credentials cannot be decrypted. See the hosting notes on encryption keys.
Who can use this credential
Who can see or edit it follows projects and roles. Do not paste secrets into chat or variables. External vaults are covered under external secrets.
Allow app-only online meetings
When the Duaer Microsoft Teams node manages online meetings with a Microsoft Entra Service Principal credential, it needs two grants:
- In the Entra app registration, add the Microsoft Graph application permission OnlineMeetings.ReadWrite.All under API permissions (OnlineMeetings.Read.All is enough for Get only), and grant admin consent.
- Create an application access policy in Teams PowerShell and grant it to the meeting organizer, or globally:
New-CsApplicationAccessPolicy -Identity Duaer-Meetings -AppIds "<Application (Client) ID>"
Grant-CsApplicationAccessPolicy -PolicyName Duaer-Meetings -Identity "<organizer user ID>"
# Or tenant-wide: Grant-CsApplicationAccessPolicy -PolicyName Duaer-Meetings -GlobalThe policy can take up to about 30 minutes to apply. Without it, Graph denies access to that organizer’s meetings even with the right permissions.
Questions
Do Microsoft Entra Service Principal secret values appear in Duaer node parameters?
No. In Duaer, Microsoft Entra Service Principal secrets stay in the credential. Nodes only reference the credential. Execution records should not show the plaintext secret either.
What usually stops a Microsoft Entra Service Principal credential from saving in Duaer?
Wrong fields, an OAuth callback that does not match the instance URL, or a role that cannot create credentials. Check the fields Microsoft Entra Service Principal expects, then confirm you can create credentials in that project.
In this section
Built-in integrations in Duaer
Built-in triggers, actions, and credentials in Duaer. Triggers start a workflow. Actions run a step after it has started.
IntegrationsRisks of community nodes in Duaer
Before you install a community node in Duaer, know the code comes from a source the instance admin trusts, and know what permissions it gets.
IntegrationsTroubleshoot community nodes in Duaer
When a Duaer community node will not install or run, check the version, permissions, and node docs, then the instance logs.
IntegrationsMake custom API calls for an app in Duaer
When a Duaer app node does not expose the API you need, use HTTP Request and reuse that app’s saved authentication.
IntegrationsIntegrations in Duaer
Built-in triggers, actions, and credentials in Duaer. Community nodes are extra packages. Custom operations reuse saved authentication with HTTP Request.
CredentialsBuilt-in credentials in Duaer
Per-service credential notes for Duaer built-ins. The create flow is in the credentials overview; node docs link to the matching service page.
Create nodesCreate a custom node for Duaer
Write a node package for Duaer when built-in nodes and custom operations are not enough and you will reuse the step.