Duaer

Integrations

Set up Microsoft credentials in Duaer

Store Microsoft 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.

Register an app in Microsoft Entra

Every Duaer Microsoft OAuth2 credential, such as Outlook, Excel, OneDrive, Teams, or To Do, uses the Client ID and Client Secret of an Entra app registration:

  1. In the Microsoft Entra admin center, open App registrations > New registration.
  2. Pick the supported account types. The credential’s default authorization URLs use the common tenant, which needs accounts in any organizational directory and personal Microsoft accounts.
  3. Under Redirect URI, choose Web and enter the OAuth Redirect URL shown in the Duaer credential dialog. Register.
  4. Copy Application (client) ID from Overview into Client ID.
  5. Under Certificates & secrets, create a client secret and copy the Value column, not Secret ID, into Client Secret.
  6. In Duaer, click Connect my account, sign in with the Microsoft account the nodes should act as, and accept.

When the app allows only accounts in your organization, replace common with your tenant ID in Authorization URL and Access Token URL, or sign-in fails with AADSTS50194.

Each type lists the scopes it requests by default below. If your organization requires admin consent, ask an admin to grant it under API permissions. Client secrets expire; create a new one and update the credential before that.

Microsoft Dynamics OAuth2 API

In Duaer, choose Microsoft Dynamics OAuth2 API when you create a credential, then fill in these fields:

  • Authorization URL: Default: a preset value.
  • Access Token URL: Default: https://login.microsoftonline.com/common/oauth2/v2.0/token.
  • Client ID (required)
  • Authentication: How Duaer authenticates to Microsoft Entra when exchanging and refreshing tokens. Certificate signs a client assertion (private_key_jwt) instead of sending a client secret. Default: Client Secret. Options: Client Secret, Certificate.
  • Client Secret (required, secret): Shown when Authentication is Client Secret.
  • Private Key (required, secret): PEM-encoded RSA private key paired with the certificate uploaded to the Entra app registration. Use the multiline editor, in standard PEM format: -----BEGIN PRIVATE KEY----- KEY DATA GOES HERE -----END PRIVATE KEY-----. Shown when Authentication is Certificate.
  • Certificate (required, secret): PEM-encoded public certificate registered on the Entra app registration (Certificates & secrets). Used to derive the x5t thumbprint that tells Entra which key verifies the assertion. Shown when Authentication is Certificate.
  • Subdomain (required)
  • Region: Default: North America (NAM). Options: Asia Pacific (APAC/ APJ), Australia (OCE), Canada (CAN), China (CHN), Europe, Middle East, Africa (EMEA/ EUR), France (FRA), and 12 more.
  • Custom Scopes: Define custom scopes. Default: off.
  • Enabled Scopes: Scopes that should be enabled. Use {subdomain} and {region} as placeholders that will be replaced with the Subdomain and Region values. Default: openid offline_access https://{subdomain}.{region}/.default. Shown when Custom Scopes is on.

Duaer uses the OAuth2 Authorization Code grant for this type.

In the provider’s app settings, register the OAuth Redirect URL that the Duaer credential dialog shows (https://<your-duaer-host>/rest/oauth2-credential/callback). Then click Connect my account in Duaer and approve access.

By default, Duaer requests these scopes: openid offline_access https://{subdomain}.{region}/.default.

Optional settings shared by every Duaer OAuth2 credential: Ignore SSL Issues (Insecure), Token Expired Status Code, Encrypted Tokens (JWE), JWKS URI. They are described under OAuth2 API.

Duaer nodes that use it: Microsoft Dynamics CRM.

Microsoft Excel OAuth2 API

In Duaer, choose Microsoft Excel OAuth2 API when you create a credential, then fill in these fields:

  • Authorization URL: Default: a preset value.
  • Access Token URL: Default: https://login.microsoftonline.com/common/oauth2/v2.0/token.
  • Client ID (required)
  • Authentication: How Duaer authenticates to Microsoft Entra when exchanging and refreshing tokens. Certificate signs a client assertion (private_key_jwt) instead of sending a client secret. Default: Client Secret. Options: Client Secret, Certificate.
  • Client Secret (required, secret): Shown when Authentication is Client Secret.
  • Private Key (required, secret): PEM-encoded RSA private key paired with the certificate uploaded to the Entra app registration. Use the multiline editor, in standard PEM format: -----BEGIN PRIVATE KEY----- KEY DATA GOES HERE -----END PRIVATE KEY-----. Shown when Authentication is Certificate.
  • Certificate (required, secret): PEM-encoded public certificate registered on the Entra app registration (Certificates & secrets). Used to derive the x5t thumbprint that tells Entra which key verifies the assertion. 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).
  • Custom Scopes: Define custom scopes. Default: off.
  • Enabled Scopes: Scopes that should be enabled. Default: openid offline_access Files.ReadWrite. Shown when Custom Scopes is on.

Duaer uses the OAuth2 Authorization Code grant for this type.

In the provider’s app settings, register the OAuth Redirect URL that the Duaer credential dialog shows (https://<your-duaer-host>/rest/oauth2-credential/callback). Then click Connect my account in Duaer and approve access.

By default, Duaer requests these scopes: openid offline_access Files.ReadWrite.

Optional settings shared by every Duaer OAuth2 credential: Ignore SSL Issues (Insecure), Token Expired Status Code, Encrypted Tokens (JWE), JWKS URI. They are described under OAuth2 API.

Duaer nodes that use it: Microsoft Excel (OneDrive).

Microsoft Graph Security OAuth2 API

In Duaer, choose Microsoft Graph Security OAuth2 API when you create a credential, then fill in these fields:

  • Authorization URL: Default: a preset value.
  • Access Token URL: Default: https://login.microsoftonline.com/common/oauth2/v2.0/token.
  • Client ID (required)
  • Authentication: How Duaer authenticates to Microsoft Entra when exchanging and refreshing tokens. Certificate signs a client assertion (private_key_jwt) instead of sending a client secret. Default: Client Secret. Options: Client Secret, Certificate.
  • Client Secret (required, secret): Shown when Authentication is Client Secret.
  • Private Key (required, secret): PEM-encoded RSA private key paired with the certificate uploaded to the Entra app registration. Use the multiline editor, in standard PEM format: -----BEGIN PRIVATE KEY----- KEY DATA GOES HERE -----END PRIVATE KEY-----. Shown when Authentication is Certificate.
  • Certificate (required, secret): PEM-encoded public certificate registered on the Entra app registration (Certificates & secrets). Used to derive the x5t thumbprint that tells Entra which key verifies the assertion. 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).
  • Custom Scopes: Define custom scopes. Default: off.
  • Enabled Scopes: Scopes that should be enabled. Default: SecurityEvents.ReadWrite.All offline_access. Shown when Custom Scopes is on.

Duaer uses the OAuth2 Authorization Code grant for this type.

In the provider’s app settings, register the OAuth Redirect URL that the Duaer credential dialog shows (https://<your-duaer-host>/rest/oauth2-credential/callback). Then click Connect my account in Duaer and approve access.

By default, Duaer requests these scopes: SecurityEvents.ReadWrite.All offline_access.

Optional settings shared by every Duaer OAuth2 credential: Ignore SSL Issues (Insecure), Token Expired Status Code, Encrypted Tokens (JWE), JWKS URI. They are described under OAuth2 API.

Duaer nodes that use it: Microsoft Graph Security.

Microsoft OAuth2 API

In Duaer, choose Microsoft OAuth2 API when you create a credential, then fill in these fields:

  • Authorization URL: Default: a preset value.
  • Access Token URL: Default: https://login.microsoftonline.com/common/oauth2/v2.0/token.
  • Client ID (required)
  • Authentication: How Duaer authenticates to Microsoft Entra when exchanging and refreshing tokens. Certificate signs a client assertion (private_key_jwt) instead of sending a client secret. Default: Client Secret. Options: Client Secret, Certificate.
  • Client Secret (required, secret): Shown when Authentication is Client Secret.
  • Private Key (required, secret): PEM-encoded RSA private key paired with the certificate uploaded to the Entra app registration. Use the multiline editor, in standard PEM format: -----BEGIN PRIVATE KEY----- KEY DATA GOES HERE -----END PRIVATE KEY-----. Shown when Authentication is Certificate.
  • Certificate (required, secret): PEM-encoded public certificate registered on the Entra app registration (Certificates & secrets). Used to derive the x5t thumbprint that tells Entra which key verifies the assertion. Shown when Authentication is Certificate.
  • Scope: Separate the scopes with spaces. Include offline_access so Duaer can refresh the access token. Include openid so Duaer can identify the signed-in account. Then add the scopes the node needs. The Microsoft credential documentation lists them.
  • 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).

Duaer uses the OAuth2 Authorization Code grant for this type.

In the provider’s app settings, register the OAuth Redirect URL that the Duaer credential dialog shows (https://<your-duaer-host>/rest/oauth2-credential/callback). Then click Connect my account in Duaer and approve access.

Optional settings shared by every Duaer OAuth2 credential: Ignore SSL Issues (Insecure), Token Expired Status Code, Encrypted Tokens (JWE), JWKS URI. They are described under OAuth2 API.

Duaer nodes that use it: Microsoft Excel (OneDrive), Microsoft Excel (SharePoint), Microsoft Graph Security, Microsoft OneDrive, Microsoft OneDrive Trigger, Microsoft Outlook, Microsoft Outlook Trigger, Microsoft SharePoint, Microsoft SharePoint Trigger, Microsoft Teams, Microsoft Teams Trigger, Microsoft To Do.

Microsoft Drive OAuth2 API

In Duaer, choose Microsoft Drive OAuth2 API when you create a credential, then fill in these fields:

  • Authorization URL: Default: a preset value.
  • Access Token URL: Default: https://login.microsoftonline.com/common/oauth2/v2.0/token.
  • Client ID (required)
  • Authentication: How Duaer authenticates to Microsoft Entra when exchanging and refreshing tokens. Certificate signs a client assertion (private_key_jwt) instead of sending a client secret. Default: Client Secret. Options: Client Secret, Certificate.
  • Client Secret (required, secret): Shown when Authentication is Client Secret.
  • Private Key (required, secret): PEM-encoded RSA private key paired with the certificate uploaded to the Entra app registration. Use the multiline editor, in standard PEM format: -----BEGIN PRIVATE KEY----- KEY DATA GOES HERE -----END PRIVATE KEY-----. Shown when Authentication is Certificate.
  • Certificate (required, secret): PEM-encoded public certificate registered on the Entra app registration (Certificates & secrets). Used to derive the x5t thumbprint that tells Entra which key verifies the assertion. 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).
  • Custom Scopes: Define custom scopes. Default: off.
  • Enabled Scopes: Scopes that should be enabled. Default: openid offline_access Files.ReadWrite.All. Shown when Custom Scopes is on.

Duaer uses the OAuth2 Authorization Code grant for this type.

In the provider’s app settings, register the OAuth Redirect URL that the Duaer credential dialog shows (https://<your-duaer-host>/rest/oauth2-credential/callback). Then click Connect my account in Duaer and approve access.

By default, Duaer requests these scopes: openid offline_access Files.ReadWrite.All.

Optional settings shared by every Duaer OAuth2 credential: Ignore SSL Issues (Insecure), Token Expired Status Code, Encrypted Tokens (JWE), JWKS URI. They are described under OAuth2 API.

Duaer nodes that use it: Microsoft OneDrive, Microsoft OneDrive Trigger.

Microsoft Outlook OAuth2 API

In Duaer, choose Microsoft Outlook OAuth2 API when you create a credential, then fill in these fields:

  • Authorization URL: Default: a preset value.
  • Access Token URL: Default: https://login.microsoftonline.com/common/oauth2/v2.0/token.
  • Client ID (required)
  • Authentication: How Duaer authenticates to Microsoft Entra when exchanging and refreshing tokens. Certificate signs a client assertion (private_key_jwt) instead of sending a client secret. Default: Client Secret. Options: Client Secret, Certificate.
  • Client Secret (required, secret): Shown when Authentication is Client Secret.
  • Private Key (required, secret): PEM-encoded RSA private key paired with the certificate uploaded to the Entra app registration. Use the multiline editor, in standard PEM format: -----BEGIN PRIVATE KEY----- KEY DATA GOES HERE -----END PRIVATE KEY-----. Shown when Authentication is Certificate.
  • Certificate (required, secret): PEM-encoded public certificate registered on the Entra app registration (Certificates & secrets). Used to derive the x5t thumbprint that tells Entra which key verifies the assertion. 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).
  • Custom Scopes: Define custom scopes. Default: off.
  • Enabled Scopes: Scopes that should be enabled. Default: a preset value. Shown when Custom Scopes is on.
  • Use Shared Mailbox: Default: off.
  • User Principal Name: Target user's UPN or ID. Shown when Use Shared Mailbox is on.

Duaer uses the OAuth2 Authorization Code grant for this type.

In the provider’s app settings, register the OAuth Redirect URL that the Duaer credential dialog shows (https://<your-duaer-host>/rest/oauth2-credential/callback). Then click Connect my account in Duaer and approve access.

By default, Duaer requests these scopes: openid offline_access Contacts.Read Contacts.ReadWrite Calendars.Read Calendars.Read.Shared Calendars.ReadWrite Mail.ReadWrite Mail.ReadWrite.Shared Mail.Send Mail.Send.Shared MailboxSettings.Read.

Optional settings shared by every Duaer OAuth2 credential: Ignore SSL Issues (Insecure), Token Expired Status Code, Encrypted Tokens (JWE), JWKS URI. They are described under OAuth2 API.

Duaer nodes that use it: Microsoft Outlook, Microsoft Outlook Trigger.

Microsoft SharePoint OAuth2 API

In Duaer, choose Microsoft SharePoint OAuth2 API when you create a credential, then fill in these fields:

  • Authorization URL: Default: a preset value.
  • Access Token URL: Default: https://login.microsoftonline.com/common/oauth2/v2.0/token.
  • Client ID (required)
  • Authentication: How Duaer authenticates to Microsoft Entra when exchanging and refreshing tokens. Certificate signs a client assertion (private_key_jwt) instead of sending a client secret. Default: Client Secret. Options: Client Secret, Certificate.
  • Client Secret (required, secret): Shown when Authentication is Client Secret.
  • Private Key (required, secret): PEM-encoded RSA private key paired with the certificate uploaded to the Entra app registration. Use the multiline editor, in standard PEM format: -----BEGIN PRIVATE KEY----- KEY DATA GOES HERE -----END PRIVATE KEY-----. Shown when Authentication is Certificate.
  • Certificate (required, secret): PEM-encoded public certificate registered on the Entra app registration (Certificates & secrets). Used to derive the x5t thumbprint that tells Entra which key verifies the assertion. Shown when Authentication is Certificate.
  • Subdomain (required): You can extract the subdomain from the URL. For example, in the URL "https://tenant123.sharepoint.com", the subdomain is "tenant123".
  • Custom Scopes: Define custom scopes. Default: off.
  • Enabled Scopes: Scopes that should be enabled. Use {subdomain} as a placeholder that will be replaced with the Subdomain value. Default: a preset value. Shown when Custom Scopes is on.

Duaer uses the OAuth2 Authorization Code grant for this type.

In the provider’s app settings, register the OAuth Redirect URL that the Duaer credential dialog shows (https://<your-duaer-host>/rest/oauth2-credential/callback). Then click Connect my account in Duaer and approve access.

By default, Duaer requests these scopes: openid offline_access https://{subdomain}.sharepoint.com/.default.

Optional settings shared by every Duaer OAuth2 credential: Ignore SSL Issues (Insecure), Token Expired Status Code, Encrypted Tokens (JWE), JWKS URI. They are described under OAuth2 API.

Duaer nodes that use it: Microsoft SharePoint.

Microsoft Teams OAuth2 API

In Duaer, choose Microsoft Teams OAuth2 API when you create a credential, then fill in these fields:

  • Authorization URL: Default: a preset value.
  • Access Token URL: Default: https://login.microsoftonline.com/common/oauth2/v2.0/token.
  • Client ID (required)
  • Authentication: How Duaer authenticates to Microsoft Entra when exchanging and refreshing tokens. Certificate signs a client assertion (private_key_jwt) instead of sending a client secret. Default: Client Secret. Options: Client Secret, Certificate.
  • Client Secret (required, secret): Shown when Authentication is Client Secret.
  • Private Key (required, secret): PEM-encoded RSA private key paired with the certificate uploaded to the Entra app registration. Use the multiline editor, in standard PEM format: -----BEGIN PRIVATE KEY----- KEY DATA GOES HERE -----END PRIVATE KEY-----. Shown when Authentication is Certificate.
  • Certificate (required, secret): PEM-encoded public certificate registered on the Entra app registration (Certificates & secrets). Used to derive the x5t thumbprint that tells Entra which key verifies the assertion. 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).
  • Custom Scopes: Define custom scopes. Default: off.
  • Enabled Scopes: Scopes that should be enabled. Default: a preset value. Shown when Custom Scopes is on.

Duaer uses the OAuth2 Authorization Code grant for this type.

In the provider’s app settings, register the OAuth Redirect URL that the Duaer credential dialog shows (https://<your-duaer-host>/rest/oauth2-credential/callback). Then click Connect my account in Duaer and approve access.

By default, Duaer requests these scopes: openid offline_access User.Read.All Group.ReadWrite.All Chat.ReadWrite ChannelMessage.Read.All OnlineMeetings.ReadWrite ChannelMessage.ReadWrite TeamworkTag.Read TeamsActivity.Send TeamMember.Read.All.

Optional settings shared by every Duaer OAuth2 credential: Ignore SSL Issues (Insecure), Token Expired Status Code, Encrypted Tokens (JWE), JWKS URI. They are described under OAuth2 API.

Note from the dialog: Microsoft Teams Trigger runs on the default scopes. Per event: New Channel Message: ChannelMessage.Read.All New Chat, New Chat Message: Chat.ReadWrite New Team Member: TeamMember.Read.All New Channel, team and channel lists: covered by Group.ReadWrite.All and User.Read.All. With Custom Scopes, Channel.ReadBasic.All and Team.ReadBasic.All are the least privileged alternatives. Admin consent is needed for ChannelMessage.Read.All, TeamMember.Read.All, User.Read.All and Group.ReadWrite.All, not for Chat.ReadWrite, Channel.ReadBasic.All or Team.ReadBasic.All.

Duaer nodes that use it: Microsoft Teams, Microsoft Teams Trigger.

Microsoft To Do OAuth2 API

In Duaer, choose Microsoft To Do OAuth2 API when you create a credential, then fill in these fields:

  • Authorization URL: Default: a preset value.
  • Access Token URL: Default: https://login.microsoftonline.com/common/oauth2/v2.0/token.
  • Client ID (required)
  • Authentication: How Duaer authenticates to Microsoft Entra when exchanging and refreshing tokens. Certificate signs a client assertion (private_key_jwt) instead of sending a client secret. Default: Client Secret. Options: Client Secret, Certificate.
  • Client Secret (required, secret): Shown when Authentication is Client Secret.
  • Private Key (required, secret): PEM-encoded RSA private key paired with the certificate uploaded to the Entra app registration. Use the multiline editor, in standard PEM format: -----BEGIN PRIVATE KEY----- KEY DATA GOES HERE -----END PRIVATE KEY-----. Shown when Authentication is Certificate.
  • Certificate (required, secret): PEM-encoded public certificate registered on the Entra app registration (Certificates & secrets). Used to derive the x5t thumbprint that tells Entra which key verifies the assertion. 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).
  • Custom Scopes: Define custom scopes. Default: off.
  • Enabled Scopes: Scopes that should be enabled. Default: openid offline_access Tasks.ReadWrite. Shown when Custom Scopes is on.

Duaer uses the OAuth2 Authorization Code grant for this type.

In the provider’s app settings, register the OAuth Redirect URL that the Duaer credential dialog shows (https://<your-duaer-host>/rest/oauth2-credential/callback). Then click Connect my account in Duaer and approve access.

By default, Duaer requests these scopes: openid offline_access Tasks.ReadWrite.

Optional settings shared by every Duaer OAuth2 credential: Ignore SSL Issues (Insecure), Token Expired Status Code, Encrypted Tokens (JWE), JWKS URI. They are described under OAuth2 API.

Duaer nodes that use it: Microsoft To Do.

Save the connection in Duaer

Open Credentials and create Microsoft. 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.

Questions

Do Microsoft secret values appear in Duaer node parameters?

No. In Duaer, Microsoft secrets stay in the credential. Nodes only reference the credential. Execution records should not show the plaintext secret either.

What usually stops a Microsoft 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 expects, then confirm you can create credentials in that project.

In this section