Duaer

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:

  1. 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.
  2. 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.
  3. 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.
  4. 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