Skip to main content

How to Configure Custom SAML SSO with Microsoft Entra ID

Connect Microsoft Entra ID to AutoRFP by creating a custom SAML 2.0 Enterprise Application, then verify the connection, enforce it, and optionally enable SCIM.

Written by Dilinder Garcha

Estimated Time

20–40 minutes, including a pilot check to verify your setup before enforcing SSO organization-wide.


Prerequisites

This guide is written for an AutoRFP.ai organization Administrator working alongside someone with Application Administrator or Global Administrator rights in Microsoft Entra ID—the permissions required to create Enterprise Applications and configure SAML.

Before you begin, make sure you have:

  • Administrator permissions in AutoRFP.

  • Application Administrator or Global Administrator rights (or equivalent) in Microsoft Entra ID — sufficient to create an Enterprise Application and configure SAML single sign-on.

  • Knowledge of which AutoRFP region your organization uses (app.autorfp.ai, us.autorfp.ai, or eu.autorfp.ai) — this determines the Reply URL, Entity ID, and Relay State you'll enter in Entra.

  • Confirmation that every AutoRFP user's account email matches (or can be made to match) the email or User Principal Name (UPN — the username format Entra uses to sign users into Microsoft services, usually written like an email address) that Entra will assert for that person.

  • Access to both the AutoRFP admin panel and the Microsoft Entra admin center, ideally in separate browser tabs.

‼️ Important: SSO is an organization-wide change. Once you enforce it, every AutoRFP user in your organization must sign in through Microsoft Entra ID, and AutoRFP password-based login stops working. Email/UPN mismatches are the single most common cause of failed logins after enforcement — reconcile them before you enforce.

📝 Note on terminology: Microsoft Entra ID was previously called Azure Active Directory (Azure AD). Some Microsoft screens, error messages, and older documentation still use the old name — Entra ID and Azure AD refer to the same product.


Choose Your AutoRFP Region Values

AutoRFP runs in three regions, each with its own set of SAML connection values.

Using the wrong region's values is one of the most common setup mistakes, so before you make any changes in Entra, confirm which hostname your organization signs in at (app.autorfp.ai, us.autorfp.ai, or eu.autorfp.ai).

The table below lists the values for each region:

  • Reply URL (also called the Assertion Consumer Service, or ACS, URL) — the address Entra sends the SAML response to.

  • Entity ID (also called the Identifier) — the unique name AutoRFP uses to identify itself to Entra.

  • Relay State — an optional value that tells AutoRFP which page to return the user to after sign-in.

Region

AutoRFP hostname

Reply URL (ACS URL)

Identifier (Entity ID)

Relay State

APAC / Default

app.autorfp.ai

https://auth.app.autorfp.ai/__/auth/handler

sp:autorfp.ai

https://app.autorfp.ai/

United States

us.autorfp.ai

https://auth.us.autorfp.ai/__/auth/handler

sp:us.autorfp.ai

https://us.autorfp.ai/

Europe

eu.autorfp.ai

https://auth.eu.autorfp.ai/__/auth/handler

sp:eu.autorfp.ai

https://eu.autorfp.ai/

📝 About the screenshots in this guide. The walkthrough below was captured in the United States region (us.autorfp.ai), so the screenshots show sp:us.autorfp.ai, https://auth.us.autorfp.ai/__/auth/handler and https://us.autorfp.ai/. The screens are identical in every region. If your organization signs in at app.autorfp.ai or eu.autorfp.ai, substitute your own row from the table above.

💡 Tip: AutoRFP's Custom SSO wizard (Part 1, below) also displays these values for your specific workspace when you open it. If anything here looks different from what the wizard shows, use the wizard's values — they reflect your live configuration.

📝 Confirm: Both the email claim and the Name ID have been verified end to end in a live Entra ↔ AutoRFP connection.

The screenshots below use user.mail. If your tenant's mail attribute is empty, or differs from the address on the AutoRFP account, use user.userprincipalname instead and map both the email claim and the Name ID to it consistently.


Step-by-Step Instructions

Setting up custom SAML SSO touches three places: the AutoRFP Custom SSO wizard, the Microsoft Entra admin center, and (for user assignment) both. Work through the parts in order.


Part 1: Start the AutoRFP Custom SSO Wizard

  1. Sign in to AutoRFP as an organization Administrator.

  2. Go to Organizational SettingsIntegrations.

  3. In the SSO section, find Custom and select Setup.

  4. Keep this wizard open in its own tab — you'll copy values from Step 1 of the wizard into Entra, then paste Entra's values back into the wizard's Step 2.

Organization Settings > Integrations. Use the Custom card, not the Microsoft card.


Part 2: Create the Enterprise Application in Entra

📝 Note: the wizard's field names don't match Entra's. AutoRFP's Custom SSO wizard never says "Reply URL" or "Entity ID" — it labels these same three values Single Sign On URL, Audience URI (SP Entity ID), and Default Relay State (Okta's naming convention, reused for every provider). When copying from the wizard into Entra's Basic SAML Configuration, map them as follows:

  • Wizard Single Sign On URL → Entra Reply URL (Assertion Consumer Service URL)

  • Wizard Audience URI (SP Entity ID) → Entra Identifier (Entity ID)

  • Wizard Default Relay State → Entra Relay State (Optional)

Don't confuse this with the later, separate step where you copy Entra's own Login URL back into the wizard (Part 2, Step 5) — that's a different value that happens to carry a similarly-named label.

Step 1: Create a non-gallery application

  1. Open the .Microsoft Entra admin center

  2. Go to IdentityApplicationsEnterprise applications.

  3. Select New applicationCreate your own application.

  4. Enter a name: "AutoRFP.ai".

  5. Select Integrate any other application you don't find in the gallery (Non-gallery).

  6. Select Create, and wait for the application to be created.

Enterprise apps > New application > Create your own application. Choose the non-gallery option.

Step 2: Enable SAML single sign-on

  1. In the new application, open Single sign-on.

  2. Select SAML.

In your new application, open Single sign-on and select SAML.

Step 3: Configure Basic SAML Configuration

Select Edit on Basic SAML Configuration and enter the values for your region from the table above:

Entra field

Value

Identifier (Entity ID)

The Identifier from the regional table, e.g. sp:us.autorfp.ai (United States)

Reply URL (Assertion Consumer Service URL)

The Reply URL from the regional table

Relay State

The Relay State from the regional table, including the trailing slash

Sign on URL (optional)

Your AutoRFP login URL, e.g. https://us.autorfp.ai/login

Identifier, Reply URL and Relay State for the US region. Substitute your own region's values, then Save.

Select Save.

Expected result: The Basic SAML Configuration panel shows your saved Identifier, Reply URL, and Relay State when you reopen it.

Step 4: Configure Attributes & Claims

AutoRFP needs one email-shaped claim asserted for each user. In Attributes & Claims, make sure one of the following claim names is sent, mapped to the user's email or UPN:

Claim name

Suggested Entra source attribute

Notes

email

user.mail

Preferred when the user's mail attribute matches their AutoRFP account email.

userPrincipalName

user.userprincipalname

Use when your users sign in with their UPN and that value matches their AutoRFP account email.

📝 Confirm: Both the email claim and the Name ID have been verified end to end in a live Entra ↔ AutoRFP connection. The screenshots below use user.mail. If your tenant's mail attribute is empty, or differs from the address on the AutoRFP account, use user.userprincipalname instead and map both the email claim and the Name ID to it consistently.

‼️ Important: Email alignment. The value Entra asserts must exactly match the email address on the user's existing AutoRFP account (case is normalized, but the local part and domain must match). If your organization's mail address differs from UPN for some users, pick the source attribute that matches AutoRFP and map it consistently for everyone — a mismatch is the most common cause of a failed sign-in after enforcement.

Add a claim named email, sourced from user.mail. Leave the namespace blank.

Set the Name ID (the SAML value that uniquely identifies the user) as follows:

  • Name identifier format: Email address

  • Source attribute: the same attribute you mapped above (user.mail or user.userprincipalname)

Set the Name ID format to Email address and point the source attribute at user.mail.

Your Attributes & Claims should look like this before you collect the IdP values.

Step 5: Collect Entra's IdP values

Still on the SAML setup page, copy these three values — you'll paste them into AutoRFP's wizard in Part 4:

AutoRFP field

Where to find it in Entra

Single Sign-On URL

The Login URL shown under "Set up <App Name>" (also called the Identity Provider SSO URL)

Entity ID / Identity Provider Issuer

The Microsoft Entra Identifier

Certificate

Under SAML Certificates, select Download next to Certificate (Base64). This saves a .cer file. Do not double-click it — that opens the Windows certificate viewer, which will not show you the text. Instead open it with a plain text editor (Notepad, TextEdit, VS Code), select all, and copy. The text already includes the -----BEGIN CERTIFICATE----- and -----END CERTIFICATE----- lines. |

Download Certificate (Base64) from section 3, then copy the Login URL and Microsoft Entra Identifier from section 4.


Part 3: Assign Users in Entra

Before you verify the connection, assign at least yourself — and ideally a small pilot group — to the Enterprise Application. Entra only lets assigned users complete SAML sign-in.

  1. In the Enterprise Application, open Users and groups.

  2. Select Add user/group, choose the pilot users, and select Assign.

Users and groups > Add user/group. Assign yourself before you verify, or the test sign-in will fail.

Expected result: Your pilot users appear in the Users and groups list for the application.

📝 Note: Users who are not assigned to the Enterprise Application cannot complete SAML sign-in once you enforce SSO, even if their email matches perfectly. If a user reports they can't sign in after enforcement, check assignment first, then check email alignment.


Part 4: Complete the AutoRFP Wizard — Enter IdP Details and Verify

  1. Return to the AutoRFP Custom SSO wizard → Step 2.

  2. Paste the three values you collected from Entra:

    • Single Sign-On URL — from Entra's Login URL

    • Entity ID — from Entra's Microsoft Entra Identifier

    • Certificate — the PEM-formatted signing certificate

  3. Select Verify. AutoRFP opens a Microsoft sign-in popup to test the connection.

  4. Sign in with the Entra account that matches your AutoRFP admin account's email and is assigned to the application.

Paste the three values from Entra, then select Verify. The certificate must keep its BEGIN and END lines.

‼️ Important: popup blockers. The Verify step relies on a Microsoft sign-in popup window. If your browser or an extension blocks popups for AutoRFP, errors may occur, or Verify may simply appear to do nothing when you select it. Allow popups for your AutoRFP region's domain and try again.

Expected result: After signing in through the popup, the wizard shows a success state and advances to the Enforce step.

If Verify fails, the most common causes are:

  1. The Reply URL / Entity ID entered in Entra belong to the wrong AutoRFP region.

  2. The certificate is missing its PEM -----BEGIN CERTIFICATE----- / -----END CERTIFICATE----- wrapper.

  3. The signed-in Entra account isn't assigned to the Enterprise Application.

  4. The email or UPN Entra asserts doesn't match the signed-in user's AutoRFP account email.

Fix these before enforcing.


Part 5: Review Users and Enforce SSO

  1. Continue to Enforce SSO. Review the table of AutoRFP users the wizard displays.

  2. Confirm each listed user is assigned to the Entra Enterprise Application — export the list as CSV from the wizard if that's easier to cross-check.

  3. Notify your organization in advance that sign-in is moving to Microsoft and that AutoRFP passwords will stop working once you enforce.

  4. Select Enforce SSO and confirm.

  5. You'll be signed out. Sign back in through Entra to confirm SSO is working end to end.

Check every listed user is assigned in Entra before you enforce. Export as CSV to work through it with your IT team.

Expected result: You're signed out, and signing back in redirects you to Microsoft for authentication rather than showing an AutoRFP password field. This confirms enforcement succeeded.

‼️ Please notify users in advance. The most common support requests after SSO enforcement come from users surprised by the one-time password prompt (see below) or the redirect to Microsoft. A short heads-up before you enforce removes almost all of them.


What Changes for Users After Enforcement

The table below explains what changes for AutoRFP users once you enforce custom SAML SSO with Microsoft Entra ID.

Aspect

After enforcement

Signing in

Users enter their work email on the AutoRFP sign-in screen and are redirected to Microsoft to authenticate.

Passwords

AutoRFP passwords are no longer used for sign-in. Access is governed by your Entra directory and any Conditional Access / MFA policies you have configured there.

First sign-in after enforcement

A user who previously signed in with an AutoRFP password may be asked to enter that AutoRFP password one final time to migrate their account to SSO. This is expected and happens only once.

Joiners and leavers

Control access by assigning or removing users from the Enterprise Application in Entra. You can automate this further with SCIM (see below).

Disabling SSO

An administrator can turn SSO back off from AutoRFP's Integrations settings. This restores password-based sign-in, but any user who signed in via SSO while it was active will need to reset their password to sign in with a password again.


Recommended Rollout

  1. Complete the Entra and AutoRFP configuration in Parts 2–4 above and pass Verify, but hold off on Enforce if you want a quiet pilot first.

  2. Reconcile AutoRFP user account emails so they match the email or UPN Entra will assert.

  3. Pilot with a small assigned group in Entra — include at least one administrator and one standard user.

  4. Notify all users of the cutover date and what to expect (see "What changes for users" above).

  5. Assign the remaining users or groups in Entra, then select Enforce SSO in AutoRFP.


Microsoft Entra ID-Specific Capabilities: IdP-Initiated Access and My Apps

Microsoft Entra ID lets users launch applications from the My Apps portal (myapps.microsoft.com) or from the Microsoft 365 app launcher. For most SAML applications, clicking the tile in My Apps triggers Entra to generate and send an IdP-initiated SAML response directly to the application — a response the application never asked for, as opposed to the normal flow where the application (the "service provider," or SP) requests it first.

AutoRFP's custom SAML connection is service-provider-initiated only: it expects to start every sign-in itself and does not accept an unsolicited, IdP-initiated SAML response. This means the default My Apps tile behavior for a SAML-mode Enterprise Application will not work for AutoRFP — clicking it is expected to produce an error rather than signing the user in.

To give users a working shortcut from My Apps, use Entra's Linked single sign-on mode instead of relying on the SAML app's own tile:

  1. After enforcement, open AutoRFP's Custom SSO settings and copy the bookmark-style sign-in URL, in the form https://<your-region-host>/login?idp=<your-saml-provider-id>.

  2. In the Microsoft Entra admin center, go to Enterprise applicationsNew applicationCreate your own application (or reuse an existing entry) and, under Single sign-on, select Linked instead of SAML.

  3. Enter the bookmark URL you copied as the sign-on page.

  4. Select Save, then assign the same users or groups you assigned to the SAML application.

Expected result: Users see a working AutoRFP tile in My Apps. Clicking it opens the bookmark URL, which starts AutoRFP's own (service-provider-initiated) sign-in flow and redirects to Entra normally — this is functionally the same experience as a bookmark or favorite, not true federated single sign-on through Entra, but it gets users to the right starting point.

Linked mode does not perform authentication itself — Microsoft's own documentation describes it as "adding a link" rather than providing sign-on functionality — so the actual authentication still happens through the SAML Enterprise Application you configured in Part 2.


Troubleshooting

The table below lists SAML and SCIM problems administrators run into with Microsoft Entra ID and AutoRFP, and how to resolve each one.

Symptom

Likely cause / resolution

Verify popup fails or does nothing

A popup blocker is preventing the Microsoft sign-in window from opening. Allow popups for your AutoRFP region's domain and retry.

Verify popup opens but fails immediately

The signed-in Entra account isn't assigned to the Enterprise Application, or the Reply URL / Entity ID entered in Entra are from the wrong AutoRFP region.

Certificate rejected by AutoRFP

The certificate text is missing its -----BEGIN CERTIFICATE----- / -----END CERTIFICATE----- wrapper, or the wrong certificate download option was used.

Authentication succeeds in Entra, but AutoRFP rejects the user

The email or UPN Entra asserted doesn't match the user's AutoRFP account email. Align the claim mapping (Part 2, Step 4) and retry.

Some users can sign in, others can't

Almost always an email/UPN mismatch for the affected users, or those users aren't assigned to the Enterprise Application.

A user is asked for their AutoRFP password once, after enforcement

Expected. This is the one-time migration prompt for a user who previously signed in with a password — it does not recur.

Microsoft My Apps tile shows an error instead of signing the user in

Expected for the SAML application's default (IdP-initiated) tile behavior — AutoRFP requires service-provider-initiated sign-in. Use the AutoRFP bookmark URL or a Linked-mode My Apps entry instead (see "Microsoft Entra ID-Specific Capabilities" above).

Wrong Microsoft tenant or personal account error

The user signed in with a personal Microsoft account (MSA) or the wrong work tenant. Have them sign in with the workforce account in the tenant where the Enterprise Application is configured.

A user's email changed in Entra after enforcement, and they can no longer sign in

AutoRFP account emails cannot currently be edited directly by an administrator in the AutoRFP user management screen. Contact AutoRFP support (live chat or [email protected]) with a confirmed list of old/new email pairs — support can update the stored account email on request, without recreating the account or losing the user's existing projects and content.

SCIM provisioning shows a "quarantined" status with repeated errors

This is commonly caused by Entra also attempting to call AutoRFP's /Groups endpoint, which the AutoRFP SCIM implementation does not support (Users only). In the Entra provisioning application, remove or disable the group-provisioning mapping so only Users are synced, then restart provisioning to clear the quarantine state.

SCIM shows repeated "Success (Update)" entries on every sync cycle

Entra's default attribute mapping includes emails[type eq "work"].value, usually sourced from mail. AutoRFP never stores or returns that attribute, so every cycle looks like a change. Delete that mapping and keep userName mapped as your login email — see the Entra SCIM guide's attribute-mapping step.

A user disabled in Entra stays active in AutoRFP

If a user was disabled in Entra before their first SCIM sync, Entra may treat them as out of scope for provisioning and never send AutoRFP a deactivate instruction, even though they're assigned to the app. Either re-enable the user, let one sync cycle complete, then disable them again — or deactivate the user directly in AutoRFP.


Frequently Asked Questions

Do I need a separate Entra Enterprise Application for SCIM?

Yes. The Enterprise Application you create for SAML sign-in does not support SCIM provisioning — opening Provisioning on that application returns an error stating that automatic provisioning isn't supported out of the box. Create a second, dedicated non-gallery Enterprise Application in Entra specifically for SCIM, and connect that one to AutoRFP's SCIM endpoint.

Will enabling SSO create new AutoRFP accounts, or preserve existing users and roles?

Custom SAML SSO on its own authenticates existing AutoRFP accounts by matching the email or UPN Entra asserts to an account's existing email — it does not create new AutoRFP accounts. A user without a matching AutoRFP account cannot sign in via SAML; you (or SCIM, if enabled) still need to create or invite that user in AutoRFP first. Existing roles and permissions in AutoRFP are unaffected by enabling SSO — roles are managed inside AutoRFP, not by the SAML connection.

Can we keep a password-based break-glass administrator?

No — there's no dedicated break-glass mechanism. Password-based login is disabled organization-wide once SSO is enforced, with no admin exception. If every administrator is ever locked out (for example, if Entra becomes unreachable), contact AutoRFP support directly — they can access and correct the account configuration on your behalf.

What happens if an AutoRFP email does not match the Entra email or UPN?

Sign-in fails for that user, even though they authenticated successfully in Entra — AutoRFP can't connect the asserted identity to an existing account. There is currently no self-service way for an administrator to edit a user's account email directly in AutoRFP. If a user's email changes in Entra (for example, during a company rename or domain migration) after SSO was enforced, contact AutoRFP support with a confirmed list of old and new email pairs; support can update the stored account email for you without the user losing access to their existing projects or content.

Can Entra groups assign AutoRFP roles through SCIM?

No. AutoRFP's SCIM implementation does not support role assignment or group resources. Group membership in Entra can control who is provisioned into AutoRFP as a user, but it cannot set what that user can do inside AutoRFP — roles are managed entirely within AutoRFP itself.

Will enabling SCIM affect existing users or pending invitations?

No. Turning on SCIM provisioning does not change or interrupt users who are already active in AutoRFP, and it does not affect invitations that are already pending. SCIM only manages account lifecycle going forward for the users you assign to the provisioning application.

Why can some users sign in while others cannot?

This almost always comes down to one of two things: the affected users either aren't assigned to the Entra Enterprise Application, or the email/UPN Entra asserts for them doesn't match their AutoRFP account email. Check assignment first (Part 3), then check the claim mapping (Part 2, Step 4) for the affected users.

Why does the Microsoft My Apps SAML tile fail?

Because AutoRFP's SAML connection only accepts service-provider-initiated sign-in, but the default My Apps tile for a SAML-mode Enterprise Application sends an unsolicited, IdP-initiated SAML response. AutoRFP rejects that unsolicited response, so the tile shows an error instead of signing the user in. Use Entra's Linked sign-on mode with AutoRFP's bookmark sign-in URL instead — see "Microsoft Entra ID-Specific Capabilities" above.

Can SSO be disabled temporarily, and what happens afterward?

Yes. An administrator can select Disable SSO from AutoRFP's Integrations settings at any time, which restores password-based sign-in for the organization. However, any user who signed in via SSO while it was active will need to reset their password before they can sign in with a password again — their old password does not automatically start working.


💡 Tips & Best Practices

  • Confirm which AutoRFP region (app, us, or eu) your organization uses before you start configuring Entra, and copy the Reply URL, Entity ID, and Relay State directly from the Custom SSO wizard for that region.

  • Reconcile every user's AutoRFP account email against their Entra email/UPN before you enforce SSO, not after.

  • Assign a small pilot group first — including at least one admin and one standard user — and complete Verify before you enforce for everyone.

  • Keep the AutoRFP wizard and the Entra admin center open in separate tabs; you'll go back and forth between them.

  • If you plan to add SCIM later, decide up front which attribute (user.mail or user.userprincipalname) you'll use consistently for both the SAML claim and the SCIM userName mapping.


✋🏼 Common Mistakes to Avoid

  • Copying Reply URL / Entity ID / Relay State values from the wrong AutoRFP region.

  • Enforcing SSO before reconciling email/UPN mismatches — this is the top cause of post-enforcement support requests.

  • Forgetting to assign the admin (or pilot users) to the Enterprise Application before running Verify.

  • Pasting a certificate without its PEM -----BEGIN CERTIFICATE----- / -----END CERTIFICATE----- header and footer.

  • Trying to enable SCIM provisioning on the same Enterprise Application used for SAML sign-in, instead of creating a second, dedicated application.

  • Relying on the SAML application's default My Apps tile for user launch, instead of setting up a Linked-mode entry with the AutoRFP bookmark URL.

  • Enforcing SSO for the whole organization without notifying users about the one-time password prompt and the Microsoft redirect.


Final Setup Checklist

The table below is a quick reference for tracking a custom SAML SSO rollout with Microsoft Entra ID from start to finish.

Step

Typical owner

Done?

Confirm your AutoRFP region (AP / US / EU)

Customer IT

Confirm admin rights in both AutoRFP and Entra

Customer IT

Create the non-gallery Enterprise Application in Entra

Customer IT

Configure Basic SAML Configuration and Attributes & Claims

Customer IT

Assign pilot users in Entra

Customer IT

Paste IdP values into AutoRFP and Verify

Joint

Reconcile user email/UPN alignment

Joint

Notify the organization of the cutover date

Customer

Enforce SSO

AutoRFP admin

(Optional) Set up a Linked My Apps entry with the bookmark URL

Customer IT

(Optional) Set up SCIM provisioning with a separate Enterprise Application

Customer IT


Related Guides

Guide

Link

Enable SSO with the Microsoft/Google OAuth button

learn.autorfp.ai/en/articles/10110112

Configure SAML SSO with Okta (SAML pattern reference)

learn.autorfp.ai/en/articles/10224813

Configure IdP-initiated SSO in Okta

learn.autorfp.ai/en/articles/10307781

Activate SCIM in AutoRFP

learn.autorfp.ai/en/articles/13262307

Enable SCIM 2.0 Provisioning with Microsoft Entra ID (full walkthrough)

learn.autorfp.ai/en/articles/13271391

SCIM 2.0 Technical Reference

learn.autorfp.ai/en/articles/14014019

Safety and Security FAQ

learn.autorfp.ai/en/articles/8492368


Need Help?

💬 Live Chat: Available in-app — type "human" to reach the team directly.

📚 Learning Centre: learn.autorfp.ai/en

Did this answer your question?