# ServiceNow on-behalf-of token exchange with Bedrock AgentCore Gateway > Source: > Published: 2026-11-03 16:47:40+00:00 ## [Artificial Intelligence](https://aws.amazon.com/blogs/machine-learning/) # ServiceNow on-behalf-of token exchange with Bedrock AgentCore Gateway AI agents that interact with enterprise APIs on behalf of users need to maintain user identity throughout the request chain. Without identity propagation, API calls arrive at downstream services as the application itself rather than the user who initiated the action. This breaks audit trails, bypasses user-level access controls, and violates the principle of least privilege. Amazon Bedrock AgentCore is a platform to build, connect, and optimize agents at scale, with any framework or model. This post shows how to configure [AgentCore Gateway](https://docs.aws.amazon.com/bedrock-agentcore/latest/devguide/gateway.html), a capability of Amazon Bedrock AgentCore, for an on-behalf-of (OBO) token exchange with Microsoft Entra ID. An AI agent can then call the [ServiceNow REST API](https://www.servicenow.com/docs/r/api-reference/rest-apis/api-rest.html) while preserving the calling user’s identity. You configure the token exchange on the gateway target, and AgentCore Gateway performs the exchange on each request. The pattern can be applied to other REST APIs protected by OAuth. In production, you can additionally pair identity propagation with Amazon Bedrock Guardrails to filter harmful content and validate the agent’s inputs and outputs. ## Solution overview The architecture involves three key components connected through AgentCore Gateway: 1. An AI agent application, protected by Microsoft Entra ID through an OAuth application registration. 2. A Model Context Protocol (MCP) server, implemented using AgentCore Gateway, sitting between the agent and ServiceNow. 3. The ServiceNow REST API, configured with an inbound OAuth integration tied to Microsoft Entra ID. The following figure shows the end-to-end solution architecture, including components within AWS, Microsoft Entra ID, and ServiceNow. As shown in Figure 1, the user acquires a JSON Web Token (JWT) to invoke the agent 1. The agent authenticates to the gateway with a JWT token scoped to the agent’s own application registration 2. The gateway then exchanges that token, using the OBO flow, for a new token scoped to the ServiceNow API connector, with the original user’s identity preserved 3. ServiceNow receives a valid token whose `preferred_username` claim maps to an existing ServiceNow user and applies that user’s permissions to the API call 4. ## How OBO token exchange works in this context When the agent calls the gateway, it presents a JWT with an `audience` claim matching the agent’s client ID (for example, `3ff88e17-XXXX-XXXX-XXXX-XXXXXXXXXXXX`). ServiceNow, however, expects a token with an `audience` claim matching its own API connector client ID (`5d4a7a11-XXXX-XXXX-XXXX-XXXXXXXXXXXX`). The OBO flow bridges this gap. AgentCore Gateway sends the inbound token to the Entra token endpoint along with the agent application’s client credentials, the target scope, and a parameter `requested_token_use: on_behalf_of`. Entra validates that the calling user consented to the delegation, then issues a new token for the ServiceNow API with the original user’s claims intact. ## Prerequisites Before you begin, you need the following: - An AWS account with access to AgentCore Gateway. - A Microsoft Entra ID tenant with permissions to create [application registrations](https://learn.microsoft.com/en-us/entra/identity-platform/quickstart-register-app) . Your account needs at least the[Application Developer role](https://learn.microsoft.com/en-us/entra/identity/role-based-access-control/permissions-reference#application-developer) to register applications. - A ServiceNow instance with administrative access to configure inbound OAuth integrations. You can create a ServiceNow personal developer instance (PDI) at the ServiceNow personal developer instance signup page [https://developer.servicenow.com/](https://developer.servicenow.com/) . - Two Entra application registrations: one representing the AI agent, and one representing the ServiceNow API connector. ## Configuring Microsoft Entra ID Start by creating an application registration to represent the ServiceNow API connector. The following screenshot shows the application registration page for the ServiceNow API Connector in Microsoft Entra ID. After creating, in the Overview page note the **Application (client) ID.** In the navigation menu expand **Manage** and select **Expose an API** and add a scope named `user_impersonation` using the default Application ID URI. This scope is what the OBO flow requests when exchanging tokens. The following screenshot shows how to expose an API in Microsoft Entra ID. Next, create an application registration for the AI agent. The following screenshot shows the application registration page in Microsoft Entra ID for the ServiceNow Agent application. Note the Application (client) ID for the ServiceNowAgent. Create a client secret on this registration. The gateway needs these credentials to perform the OBO exchange. The following screenshot shows how you can create a client secret on the ServiceNow Agent application registration in Microsoft Entra ID. Then configure the agent application to have API permissions to call the ServiceNow API connector application. The following screenshot shows the API permissions that you need to configure on the ServiceNow Agent application registration in Microsoft Entra ID. No changes to the Entra configuration are needed beyond what you would set up for any standard OBO integration between two applications. ## Configuring ServiceNow In the ServiceNow administrative console, navigate to **System OAuth > Inbound Integrations** and create a new inbound integration (Third party ID token issued by OIDC supporting identity provider). Specify the client ID from the ServiceNow API connector application registration you created in Entra. The following screenshot shows the configuration of the inbound integration in ServiceNow. In the same screen, create a new OpenID Connect (OIDC) provider configuration and enter the OIDC metadata URL for your Entra tenant. Map the user claim to the appropriate user field. For example, if your Entra tenant places the user’s email in the `preferred_username` claim, map that to the **Email** field in ServiceNow. Clear JTI verification if your Entra tenant doesn’t include it in tokens. Entra uses an internal claim named `uti` on tokens it issues, which is equivalent to JTI. Consider mapping this `uti` claim to a `jti` claim to provide additional replay protection and denylisting. The following screenshot shows how to configure the OIDC provider in ServiceNow. Finally, in the same screen, create an auth scope for the integration (for example, `APIConnector`). The following screenshot shows how to create a new auth scope in ServiceNow. Limit the auth scope to the Table API, or whichever ServiceNow APIs your agent needs to access, as shown in the following screenshot. After this configuration is complete, ServiceNow accepts authorization tokens with an `audience` of your API connector’s client ID and resolves the calling user from the `preferred_username` claim. ## Configuring AgentCore Gateway With Entra and ServiceNow configured, you can now set up AgentCore Gateway to handle the OBO exchange natively. ### Step 1: Create an outbound auth configuration Create a new outbound auth configuration (choose **Build > Identity > Add Outbound Auth > Add OAuth client**) in AgentCore and select **Customized provider**. Enter the client ID and client secret from your agent application registration, along with the Entra discovery URL as shown in the following screenshot. Expand **Additional configurations** and select **JWT authorization grant** as shown in the following screenshot. This tells the gateway to use a JWT-based grant type for token exchange. ### Step 2: Create the gateway with MCP version 2025-11-25 Create a new AgentCore Gateway (**Build > Gateways > Create gateway**). When defining the gateway details, expand **Additional configurations — optional** and select MCP version **2025-11-25** as shown in the following screenshot. This version is required for native OBO support. You can’t turn on native OBO for gateways created with earlier MCP versions. Configure the inbound identity using your agent’s application registration (select **Use existing identity provider configurations**), as you would for any gateway that accepts Entra-authenticated requests. Under **JWT Authorization Configuration** add the Application ID we documented earlier for the **ServiceNowAgent** as shown in the following screenshot. ### Step 3: Add a target with token exchange Add a target to the gateway pointing to your ServiceNow REST endpoint. Define the schema inline. For example, to expose a tool called ListIncidents that calls the ServiceNow Table API, you can use the following OpenAPI specification (replace the server URL with that for your PDI).