Skip to main content
Procore

Configure Single Sign-On in the Company Admin Tool

Objective

To configure Single Sign On (SSO) in the Company level Admin tool. 

Background

Procore supports SP-initiated and IdP-initiated SSO with Okta, OneLogin, and Microsoft Azure AD. See What is the difference between SP- and IdP-Initiated SSO? Procore also supports SSO with other service providers that are SAML 2.0 and SHA 256 compliant.

Term SP-Initiated Context IdP-Initiated Context
Identity Provider (IdP) Authenticates the user after receiving a request from Procore. Authenticates the user directly within the IdP portal and initiates the session.
Service Provider (SP) Procore—initiates the login request and consumes the returned assertion. Procore—receives and validates the unsolicited assertion from the IdP.
Issuer URL (Entity ID) Identifies Procore as the entity requesting authentication. Identifies your IdP as the entity issuing the authentication assertion.
Target URL The IdP endpoint where Procore sends the SAML AuthnRequest. The IdP app tile/launch URL that routes the user directly to Procore.
SAML Protocol used to pass requests to the IdP and assertions back to Procore. Protocol used to push pre-generated authentication assertions directly to Procore.
X.509 Certificate Verifies signatures on both outgoing requests and incoming assertions. Verifies the IdP's digital signature on the incoming authentication assertion.

Things to Consider

  • Required User Permissions:
    • 'Admin' level permissions on the Company level Admin tool. 
  • Additional Information:
    • Please contact your SSO service provider if you need assistance locating the Issuer URL, Target URL, and x509 Certificate.

Prerequisites

  • Configure the Procore application in your identity provider's SSO software or solution.
  • Obtain the required SSO Settings from your identity provider's SSO software or solution.

Steps

  1. Navigate to the Company level Admin tool.
  2. Under 'Company Settings,' click Single Sign On Configuration. 
    Note: The data you enter on the page below is always obtained from the issuer (e.g. Okta, OneLogin or Microsoft Azure AD).
     Tip

    See the links below for more detailed instructions about configuring SSO with Okta, OneLogin, Azure Active Directory, and Google.


    admin-sso-configuration.png
  3. Enter the Single Sign On Issuer URL. This is commonly referred to as the issuer and is a unique URL that identifies the provider issuing a SAML request.
  4. Enter the Single Sign On Target URL. This is the URL that will receive SAML requests from the provider.
  5. Enter the Single Sign On x509 Certificate. This is the encrypted digital certificate information.

     

  6. Click Save Changes.
  7. Reach out to Procore Support or your company's Procore point of contact to request to target the email domains of users who will be authenticating through SSO.
  8. After you receive confirmation that the SSO configuration is ready, mark the Enable Single Sign On checkbox on the 'Single Sign On Configuration' page.
  9. Click Save Changes.