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, oreu.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 |
|
|
|
|
United States |
|
|
|
|
Europe |
|
|
|
|
📝 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
Sign in to AutoRFP as an organization Administrator.
Go to Organizational Settings → Integrations.
In the SSO section, find Custom and select Setup.
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
Open the .Microsoft Entra admin center
Go to Identity → Applications → Enterprise applications.
Select New application → Create your own application.
Enter a name: "AutoRFP.ai".
Select Integrate any other application you don't find in the gallery (Non-gallery).
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
In the new application, open Single sign-on.
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. |
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. |
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 |
|
| Preferred when the user's |
|
| 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.mailoruser.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 |
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.
In the Enterprise Application, open Users and groups.
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
Return to the AutoRFP Custom SSO wizard → Step 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
Select Verify. AutoRFP opens a Microsoft sign-in popup to test the connection.
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:
The Reply URL / Entity ID entered in Entra belong to the wrong AutoRFP region.
The certificate is missing its PEM
-----BEGIN CERTIFICATE-----/-----END CERTIFICATE-----wrapper.The signed-in Entra account isn't assigned to the Enterprise Application.
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
Continue to Enforce SSO. Review the table of AutoRFP users the wizard displays.
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.
Notify your organization in advance that sign-in is moving to Microsoft and that AutoRFP passwords will stop working once you enforce.
Select Enforce SSO and confirm.
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
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.
Reconcile AutoRFP user account emails so they match the email or UPN Entra will assert.
Pilot with a small assigned group in Entra — include at least one administrator and one standard user.
Notify all users of the cutover date and what to expect (see "What changes for users" above).
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:
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>.In the Microsoft Entra admin center, go to Enterprise applications → New application → Create your own application (or reuse an existing entry) and, under Single sign-on, select Linked instead of SAML.
Enter the bookmark URL you copied as the sign-on page.
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 |
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 |
SCIM provisioning shows a "quarantined" status with repeated errors | This is commonly caused by Entra also attempting to call AutoRFP's |
SCIM shows repeated "Success (Update)" entries on every sync cycle | Entra's default attribute mapping includes |
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, oreu) 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.mailoruser.userprincipalname) you'll use consistently for both the SAML claim and the SCIMuserNamemapping.
✋🏼 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











