Duaer

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:

  1. Create an app registration in the Microsoft Entra admin center; it needs no Redirect URI.
  2. Under API permissions, add Microsoft Graph application permissions (not delegated), such as Files.ReadWrite.All or Mail.Send, and have an admin grant consent.
  3. 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:

  1. 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.
  2. 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 -Global

The 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