

# Update the SAML application configuration
<a name="update-saml-app-config"></a>

After deploying the Data stack, update the SAML 2.0 application you created earlier with the actual ACS URL and audience values from the Data stack outputs. To enable IdP-initiated sign-in from the AWS access portal, you also set the **Application start URL** to the solution’s web UI URL.

1. Sign in to the [AWS CloudFormation console](https://console.aws.amazon.com/cloudformation/) in the **Hub** account.

1. Choose the Data stack, and then choose the **Outputs** tab.

1. Note the values for `CognitoAcsUrl` and `CognitoAudience`.

1. Choose the Compute stack, choose the **Outputs** tab, and note the web UI URL (the `CloudFrontDistributionUrl` value). If you configured a custom domain, use that domain instead. For more information, see [Logging into the web UI](log-in-webui.md).

1. Sign in to the [AWS IAM Identity Center console](https://console.aws.amazon.com/singlesignon/) in the account where IAM Identity Center is configured.

1. From the left pane, under **Application assignments**, choose **Applications**.

1. On the Applications page, on the **Customer managed** tab, choose the SAML application you created in [Create a SAML 2.0 application](create-saml-app.md).

1. Choose **Actions**, then choose **Edit configuration**.

1. Under **Application metadata**, update the following fields:


<table>
<thead>
  <tr><th>Field</th><th>Value</th></tr>
</thead>
<tbody>
  <tr><td>Application ACS URL</td><td>The <code>CognitoAcsUrl</code> value from the Data stack outputs (for example, <code>https://&lt;namespace&gt;-isb.auth.&lt;region&gt;.amazoncognito.com/saml2/idpresponse</code>)</td></tr>
  <tr><td>Application SAML audience</td><td>The <code>CognitoAudience</code> value from the Data stack outputs (for example, <code>urn:amazon:cognito:sp:&lt;user-pool-id&gt;</code>)</td></tr>
  <tr><td>Application start URL</td><td>The solution’s web UI URL — the <code>CloudFrontDistributionUrl</code> value from the Compute stack outputs, or your custom domain (for example, <code>https://isb.example.com</code>). This URL is where the AWS access portal sends users when they start sign-in from the portal.</td></tr>
</tbody>
</table>


1. Choose **Submit** to save the updated configuration.

**Note**  
The **Application start URL** enables IdP-initiated sign-in, so users can launch the solution from the AWS access portal. If you leave it empty, service provider-initiated sign-in (starting from the web UI URL) still works, but the application does not appear as a launchable tile in the AWS access portal.

**Important**  
If these values do not match the Data stack outputs, users will receive a *SAML assertion audience mismatch* error when attempting to sign in to the web application.