Configure IdP-Initiated SSO for Microsoft Entra ID
Notes
-
To complete setup, you will need to gather these parameters from your Microsoft Entra ID Enterprise application configuration: SSO Issuer URL, SSO Target URL, and SSO x509 Certificate
-
If you use Portfolio Financials and Capital Planning in Procore, contact your Procore point of contact or Contact Support for assistance with Microsoft Entra ID setup.
Background
If your company manages your users with Microsoft Entra ID, you can leverage its SSO capabilities. This gives your end users the ability to authenticate their identify for the Procore application using their Microsoft Entra ID account. With this SSO integration, you can:
- Leverage Microsoft Entra ID for SSO access to Procore.
- Simplify your entire organization's password management process.
- Avoid problematic user password management.
Things to Consider
- Authentication Protocol:
- You can integrate the Procore application with Microsoft Entra ID using the Security Assertion Markup Language (SAML 2.0).
- Requirements:
- Microsoft Entra ID
- Required Permissions:
- Global Administrator rights to Microsoft Entra ID.
- 'Admin' level permissions to the Company Admin tool.
Steps
Important Requirement for Successful SSO
A user's Microsoft Entra ID primary email address must match their Procore login email address. To update a primary email address or alias to match Procore, follow the Microsoft documentation to Change a user name and email address.
Step 1: Add Procore as an Enterprise App in Microsoft Entra ID
- In the left navigation menu for the Procore Enterprise application, under Manage, select Single sign-on.
- In the Select a single sign-on method page, select SAML to open the Set Up Single Sign-On with SAML page for editing.
- In the Basic SAML Configuration card, click Edit.
- Update these fields:
- Identifier (Entity ID):
- Change the value from:
https://app.procore.com - Change the value to:
https://login.procore.comNote: Values for Portfolio Financials and Capital Planning
If you are using Portfolio Financials and Capital Planning:- Change the value from:
https://www.honestbuildings.com/pfcp/app/#!/login - Change the value to:
https://login.procore.com
- Change the value from:
- Change the value from:
- Reply URL (Assertion Consumer Service URL):
- Enter the following:
https://login.procore.com/saml/consume
- Enter the following:
- Sign On URL:
- Leave this field blank. You do NOT need to enter a value in this field.
- Identifier (Entity ID):
- Click Save. A message confirms your updates were saved.
- Close the Basic SAML Configuration page.
- Under SAML Signing Certificate, click the Download link for the Certificate (Base64) file.
This downloads a file named PublicCertificate.cer to your downloads folder. Open the file in a text editor and leave it open. Later, you will copy the code between the ---BEGIN CERTIFICATE--- and ---END CERTIFICATE--- tags into Procore.
Step 3: Assign Users and Groups to the Procore Enterprise App
Note
This step is only required if the 'User Assignment Required' setting is enabled in the Procore Enterprise Application under Manage > Properties. This setting is disabled by default in the Procore application.- In the Overview page for your new enterprise application, under Manage, click Users and groups.
- Click +Add user/group from the top menu.
- On the Add Assignment page, under Users, select None Selected.
- Search for and select the users or groups to whom you will grant access to Procore. The selected names will appear under the Selected items list.
- Click Select at the bottom of the page.
Tip
Want to test the integration before deploying it to your end users? If so, add only your own user account. After completing the configuration steps and testing the integration, return to this section to assign the rest of your organization's users to Procore. - Under Select a role, select None Selected, choose an appropriate role (if applicable), and click Select.
- Click the Assign button at the bottom left of the page to finalize the assignment.
Step 4: Add the Microsoft Entra ID Settings to Procore
- Log in to the Procore web application.
Important
You must log in using a Procore account with 'Admin' level permissions on the Company level Admin tool - Navigate to the Company Admin tool.
- Under Company Settings, click Single Sign On Configuration.
- Enter the following information:
- Single Sign-On Issuer URL: Paste the Microsoft Entra Identifier copied from the Microsoft Entra ID portal.
- Single Sign-On Target URL: Paste the Login URL copied from Microsoft Entra ID. Although optional for IdP-initiated flows, completing this field simplifies any future transition to SP-initiated SSO.
- Single Sign-On x509 Certificate: Paste the base64 certificate text downloaded from the Microsoft Entra IDvportal.
Important
Do NOT copy the ------------BEGIN CERTIFICATE------------ and ------------END CERTIFICATE------------ header and footer lines. Copy only the encoded text string between them.
- Click Update.
- Contact your Procore point of contactor Contact Support to request the addition of the domain(s) you want to target for SSO authentication. Procore must enter these domains on your behalf into the Single Sign-On Domain(s) field.
- Once Procore adds your domain(s), return to the Single Sign On Configuration page, place a checkmark in the Enable Single Sign-On box at the top, and click Update to finalize and enable SSO.
PROCORE SUPPORT: INTERNAL NOTE
Perform the steps below when notified by the Procore Administrator that the SSO configuration is complete:
- When notified by the Procore Administrator that the SSO configuration is complete, please be sure that the following fields are filled out:
- Single Sign On Issuer URL
- Single Sign On Target URL
- Single Sign On x509 Certificate
- Once confirmed, the domain(s) will need to be filled out by any employee on the @sup_sso ping. Please reach out to the @sup_sso team in #dept-cs-core.
- Once done, the client will be able to check the box for 'Enable Single Sign On'. When they do, they will see the following two options: ' Allow Password Login' (refers to IdP-Initiated) and 'Service Provider Forward' (refers to SP-initiated). We typically recommend they try 'Allow Password Login' first to test the connection.

