Admin: Tenant Integrations
Tenant Integrations connect AZExecute to the systems that your automations, application governance, DNS workflows, and certificate deployments need to reach. They keep credentials, validation status, agent bindings, and provider metadata in one tenant-admin area instead of scattering setup across individual tasks.
Who can use a connection?
Every integration editor includes Available globally in this tenant. It is selected by default, including for existing connections after upgrade. Global availability preserves existing behavior; users still need permission to open the relevant feature, edit or run the task, and perform the provider operation.
Clear the checkbox to restrict a connection to groups. Open a group's Manage membership → Integrations tab and link the connection. A caller must have an active membership in an active linked group. People and API service principals can be user members; a service principal also qualifies through its application's membership when the registered service-principal object ID matches the caller. Application ownership alone does not grant the owner's personal identity access.
Restricted connections with no active linked group are unavailable for use. Disabling a group or removing a membership revokes access through that group. Another active group can still provide access. Tenant administrators can always manage connections and group links; administration does not make a restricted connection available in ordinary task selectors.
Automation and unattended runs
Task selectors and directory lookups show connections available to the caller. Saving a step and starting a run also check access, including requests made through the customer API. Access is checked again before each integration step starts, so a saved task or an approval does not preserve revoked membership.
Interactive runs use the requesting person's or service principal's identity. Unattended runs use the execution identity recorded by the server when the task definition is saved. Before changing an existing connection to group-only, add that identity to a linked group. In Run configuration, choose Use my identity for scheduled runs to establish or replace the saved identity, including for older tasks. Runs without an eligible identity cannot use a restricted connection. Existing global connections continue to work.
Example: team-only TOPdesk and Entra
For certificate DNS integrations, the saved DNS credential's author must retain membership. TOPdesk event and application-request actions use the initiating identity. An event with no eligible identity cannot use a restricted connection. A mailbox used for tenant-wide system notifications must remain global; use a separate restricted mailbox for team automation.
Create a support group, add the support users and API service principal, link the TOPdesk and Entra integrations, and clear global availability on both connections. Eligible authors can select those connections in incident, change, and Entra directory steps. Grant access to the automation task separately. Provider credentials, directory consent, and provider permissions remain configured on the integration.
Service principals that have already registered through the customer API appear in the group member search with a service-principal label. Choosing an agent to execute a task does not replace the requesting user's integration permissions with the agent's group memberships.
For automation started by an event listener, integration access follows the listener's authorized author, matching the identity recorded on the run. Tenant backups preserve the saved scheduled execution identity; its group membership is still checked after restore.
Agent work is checked before integration credentials are sent and again when the agent claims the step. AgentIntegrationAccessDenied (7217) identifies a rejected agent step using the same tenant, actor, task run, and step run identifiers.
Server workers also check the connections in their loaded step before calling a provider. AutomationLoadedIntegrationAccessDenied (7218) reports denial if access changed or the loaded definition differs from the current task.
If a queued step fails after membership changes, review the run's requesting identity and the active group links. Operators can correlate AutomationIntegrationAccessDenied (7211) with the tenant, actor, task run, and step run IDs. EventIntegrationAccessDenied (8665) identifies rejected event actions. These logs contain identifiers, not integration credentials.
Self-service groups and shared connections
Users can create groups and manage their members. They can add or remove applications they also own. With the Integrations feature licensed, group owners can create AWS, Vercel, and GitHub.com integrations without administrator access.
Users can link enabled integrations they created through a group. Editing also requires ownership of a linked group. Administrators manage other providers, GitHub Enterprise Server, machine membership, and changes outside a group owner's permissions.
Allow application owners to create and link integrations applies to the older direct application setup. Group setup does not require this setting. Existing application-created connections keep their editing restrictions.
GroupsWhy Integrations Matter
AZExecute is most useful when it can safely bridge cloud resources, on-premises agents, service-management systems, DNS providers, and deployment platforms. Tenant Integrations are the trust and discovery layer for that work.
• They make task steps easier to configure because operators select a validated connection instead of re-entering credentials.
• They centralize validation state, so stale credentials or offline agents are visible before production workflows depend on them.
• They give administrators a clean boundary between platform setup and reusable automation design.
• They support the smart parts of AZExecute: dynamic dropdowns, output variables, incident creation, DNS updates, certificate deployment, and cross-cloud secret delivery.
Available Integration Areas
Cloud and Application Delivery
• Amazon Web Services: connect AWS accounts through OIDC federation and role assumption for AWS Secrets Manager, Parameter Store, and Route 53 DNS workflows.
• Vercel: connect Vercel teams so application integrations can update environment variables and optionally trigger redeployments.
• GitHub: connect GitHub App installations for repository or environment Actions secrets, variables, and workflow dispatch automation.
• NetScaler: configure API-driven certificate deployment and binding for Citrix ADC / NetScaler targets when preview features are enabled.
Agent-Based Enterprise Systems
• Active Directory: bind a connected Windows agent to directory lookup and object-management automation.
• SCOM: use a Windows agent with the OperationsManager module to look up managed computers and control maintenance mode.
• Windows DNS: query and manage Windows-hosted or AD-integrated DNS zones through an agent that can reach the DNS server.
• Cisco Umbrella: run internal domain and destination-list automation through a selected agent.
• Cisco Secure Access: run internal domain and destination-list automation through a selected agent.
Service Management and DNS Providers
• TOPdesk: create, update, assign, close, or classify incidents and changes from task steps, event listeners, and application request workflows.
• Simply.com: manage zones and DNS records for ACME DNS authorization and reusable DNS automation.
Entra ID and Power Platform Workload Identities
Entra ID supports the AZExecute broker, a customer-owned broker, or a connected AZExecute agent. The preview Power Platform integration is simpler: use the read-only AZExecute broker or a connected AZExecute agent for read and write operations.
• AZExecute Broker: Entra access is read-only. It cannot create, update, or delete users or groups, or change group membership.
• Customer Broker: available for Entra ID only; select your own application registration and grant the permissions required by your workflows.
• Agent identity: use your own connected agent for Entra lookups and read or write task steps, according to the permissions you grant its managed identity. We recommend this option when your Entra workflows need to make changes.
Follow the Entra ID Integration guide for agent selection, automatic or manual permission setup, and checking access.
Agent identity setup
1. Make the required managed identity available to the AZExecute agent.
2. Assign Microsoft Graph application roles directly to that identity for Entra operations, or assign Power Platform RBAC to the identity's enterprise object ID for Power Platform operations.
3. Enable the agent's live connection and select it in the integration. On Azure VMs, you can optionally enter a user-assigned managed identity client ID. Leave it blank for the system-assigned identity; Azure Arc-enabled servers support only system-assigned identities.
4. Run Check and review the connection and permission results before using the integration.
TOPdesk Integration Usage
A TOPdesk integration can be reused across automation tasks, event listeners, and application request workflows. Configure the connection once, validate it, and then select it where a workflow needs to create, update, assign, close, cancel, archive, or classify TOPdesk records.
• Automation Tasks: TOPdesk steps can create or update records and expose created ticket numbers for later steps
• Event Listeners: platform events can create follow-up TOPdesk incidents with values from the event payload
• Application Requests: request submission, approval, and rejection can create, update, or close a linked TOPdesk incident or change
Agent-Based Integration Pattern
Several integrations intentionally run through an AZExecute agent instead of calling the target system directly from the web application. This is important for internal systems such as Active Directory, Windows DNS, SCOM, and network-restricted tooling.
1. Install and connect the AZExecute agent on a machine that can reach the target system.
2. Configure the integration and select that machine as the execution or lookup agent.
3. Validate the integration from the admin page so connectivity issues are caught early.
4. Use the integration in task steps, custom integration parameters, event listeners, or certificate workflows.
Recommended Setup Order
1. Enable any required tenant-level feature flags in System Configuration, API Connections, Automation Settings, or Application Settings.
2. Configure provider credentials or agent bindings from TenantAdmin - Integrations.
3. Validate the integration immediately and record any provider-side prerequisites in the integration description.
4. Use the integration in one small task or application workflow before scaling it into production automations.
5. Revalidate after credential rotation, agent migration, DNS/server changes, or provider permission changes.