Overview
This page mirrors the FUYL Entra SSO connection wizard as of August 14th 2025. The connection wizard itself will always be the most up-to-date reference. This page should only be used in scenarios where:
- Non-FUYL Admins are required to review the connection process
- Internal documentation requires a local copy of any processes undertaken
Preparation
Before you begin, ensure you have:
- Administrative access to the Microsoft Entra admin center.
- Access to the FUYL.io portal to begin this wizard.
- The necessary permissions to create and configure Enterprise Applications, set SAML parameters, and assign users or groups.
- A test user account to validate the SSO configuration before going live.
Guide
Create an Enterprise Application
Sign in to the Microsoft Entra admin center.
In the left navigation menu, expand the Identity section. Expand the Applications sub-section. Select the Enterprise applications tab. Click New application.
On the Browse Microsoft Entra Gallery page, click Create your own application.
Enter an appropriate app name, such as "FUYL.io". Select the Integrate any other application you don’t find in the gallery (Non-gallery) option. Click Create.
Basic SAML Configuration
In the left navigation menu, select the Single Sign-On tab. Click on the SAML tile.
The Setup Single Sign-On with SAML page will open. Locate the Basic SAML Configuration section. Click on the Edit icon in the top right corner of the step.
Copy the Identifier (Entity ID) and the Reply URL (Assertion Consumer Service URL) below and paste them into the Basic SAML Configuration panel. Click Save. Close the edit panel.
Identifier (Entity ID):
https://auth.lockncharge.com/AUniqueEntityURLReply URL (Assertion Consumer Service URL):
https://auth-api.fuyl.io/sso/saml/acs/AUniqueACSURL
Configure Attributes and Claims
Locate the Attributes & Claims section. Click on the Edit icon in the top right corner of the step.
Ensure that the required claims listed below are configured. The claims may or may not already be configured, depending on your current configuration.
| Name | Source Attribute |
|---|---|
| emailaddress* | user.mail |
| givenname* | user.givenname |
| name* | user.userprincipalname |
| surname* | user.surname |
* Indicates a required attribute
Below is an example of how to format your claim within the Azure claim editor. Make sure the Namespace value ends in /claims.
Assign Users and Groups
In the left navigation menu, select the Users and groups tab. Click Add user/group.
Select appropriate users and groups to add to the SAML application.
When finished, click Assign to add the selected users and groups to your SAML application.
Add an Application Logo
Optionally, you can add a logo to serve as the app’s entry point on the Microsoft Entra My Apps portal. Including a logo helps users easily identify and access FUYL.io.
In the left navigation menu, select the Properties tab. Locate the Logo field. Click on the blue folder icon to upload the logo image. Click Save.
Set Identity Provider Metadata
The configuration wizard allows for a "Dynamic" or "Manual" flow at this stage. Documented below is "Dynamic".
In the left navigation menu, select the Single Sign-On tab. Scroll down to the SAML Signing Certificate section. Locate the App Federation Metadata Url. Click on the field to copy.
Paste the value into the Identity provider metadata URL field below to continue to the next step.
The configuration wizard prompts for the Identity provider metadata URL here.
Test Single Sign-On
Test signing in with Entra ID to verify that the single sign-on connection was configured correctly.