Integrations
Set up Microsoft Entra ID (Azure Active Directory) credentials in Duaer
Store Microsoft Entra ID (Azure Active Directory) 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 Entra app
The Duaer Microsoft Entra ID (Azure Active Directory) API credential calls Microsoft Graph as you to manage users and groups:
- In the Microsoft Entra admin center, create an app registration under App registrations and add the Duaer OAuth Redirect URL as a Web Redirect URI under Authentication.
- Create a client secret under Certificates & secrets and use it with Authentication set to Client Secret; with Certificate, fill in the uploaded certificate and its PEM private key instead.
- Under API permissions, add the Microsoft Graph delegated permissions Duaer requests by default, such as users, groups, and directory, and have an admin click Grant admin consent.
- Put Client ID in the credential, pick Microsoft Graph API Base URL for your cloud, and click Connect my account.
Microsoft Entra ID (Azure Active Directory) API fields in Duaer
In Duaer, choose Microsoft Entra ID (Azure Active Directory) 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 AccessReview.ReadWrite.All Directory.ReadWrite.All NetworkAccessPolicy.ReadWrite.All DelegatedAdminRelationship.ReadWrite.All EntitlementManagement.ReadWrite.All User.ReadWrite.All Directory.AccessAsUser.All Sites.FullControl.All GroupMember.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 Entra ID.
Save the connection in Duaer
Open Credentials and create Microsoft Entra ID (Azure Active Directory). 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. The matching node is under the related node.
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 Entra ID (Azure Active Directory) secret values appear in Duaer node parameters?
No. In Duaer, Microsoft Entra ID (Azure Active Directory) 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 ID (Azure Active Directory) 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 ID (Azure Active Directory) 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.