---
title: Obtain the Heroku SAML 2.0 Metadata XML
description: This guide uses a metadata XML file to assist in configuring many settings in the service provider (SP) connection. When asked during the configuration steps, import the saml-metadata.xml built in the following steps.
component: heroku
page_id: heroku::pf_heroku_integration_obtain_the_heroku_saml_20_metadata_xml
canonical_url: https://docs.pingidentity.com/integrations/heroku/pf_heroku_integration_obtain_the_heroku_saml_20_metadata_xml.html
revdate: February 24, 2025
section_ids:
  about-this-task: About this task
  steps: Steps
---

# Obtain the Heroku SAML 2.0 Metadata XML

## About this task

This guide uses a metadata XML file to assist in configuring many settings in the service provider (SP) connection. When asked during the configuration steps, import the `saml-metadata.xml` built in the following steps.

## Steps

1. Copy the following sample metadata into a text editor.

   ```xml
   <?xml version="1.0" encoding="UTF-8" standalone="yes"?>
        <md:EntityDescriptor
         xmlns:md="urn:oasis:names:tc:SAML:2.0:metadata"

         entityID="https://sso.heroku.com/saml/<ORGANIZATION_NAME>" cacheDuration="PT1440M"

         ID="nYtE3pu8fofN4a5Z_ST5F8jDObh">
          <md:SPSSODescriptor
         AuthnRequestsSigned="false"  WantAssertionsSigned="true"
         protocolSupportEnumeration="urn:oasis:names:tc:SAML:2.0:protocol">

         <md:NameIDFormat>urn:oasis:names:tc:SAML:1.1:nameid-format:emailAddress</md:NameIDFormat>
          <md:AssertionConsumerService
         isDefault="true"

         Binding="urn:oasis:names:tc:SAML:2.0:bindings:HTTP-POST"

         Location="https://sso.heroku.com/saml/<ORGANIZATION_NAME>/finalize"
           index="0" />
         </md:SPSSODescriptor>

       </md:EntityDescriptor>
   ```

2. Replace the instances of *\<ORGANIZATION\_NAME>* with the organization name for the Heroku account.

   For example, if the URL you use to access your Heroku team account is

   ```
   https://dashboard.heroku.com/orgs/myOrgName/settings
   ```

   then your *\<ORGANIZATION\_NAME>* is `myOrgName`.

3. Once you have updated the file, save `saml-metadata.xml`.